AVD MSIXMGR tool reorganized some parameters

Author: dknappettmsft

articles/virtual-desktop/msixmgr-tool-syntax-description.md

@@ -36,6 +36,10 @@ Add the package at specified file path.
 msixmgr.exe -AddPackage "C:\SomeDirectory\myapp.msix"
 ```
 
+|Optional parameters|Description|Example|
+| -------- | -------- | -------- |
+|-quietUX|Installs MSIX package silently, without any user interaction|`msixmgr.exe -AddPackage C:\SomeDirectory\myapp.msix -quietUX`|
+
 ### -RemovePackage or -x
 
 Remove the package with specified package full name.
@@ -50,6 +54,10 @@ Remove the package with specified package full name.
 msixmgr.exe -RemovePackage myapp_0.0.0.1_x64__8wekyb3d8bbwe
 ```
 
+|Optional parameters|Description|Example|
+| -------- | -------- | -------- |
+|-quietUX|Uninstalls MSIX package silently, without any user interaction|`msixmgr.exe -RemovePackage myapp_0.0.0.1_x64__8wekyb3d8bbwe -quietUX`|
+
 ### -FindPackage
 
 Find a package with specific package full name.
@@ -78,80 +86,80 @@ Applies ACLs to a package folder (an unpacked package).
 msixmgr.exe -ApplyACLs -packagePath "C:\SomeDirectory\name_version_arch_pub"
 ```
 
-### -MountImage
+### -Unpack
 
-Mounts the VHD, VHDX, or CIM image.
+Unpacks package (`.appx`, `.msix`, `.appxbundle`, `.msixbundle`) and extract its contents to a folder.
 
 ```
--MountImage -imagePath [Path to the MSIX image] -fileType [VHD | VHDX | CIM]
+-Unpack -packagePath [Path to package to unpack OR path to a directory containing multiple packages to unpack] -destination [Directory to place the resulting package folder(s) in]
 ```
 
 #### Example
 
+To unpack a package into a directory:
+
 ```
-msixmgr.exe -MountImage -imagePath "C:\SomeDirectory\myapp.cim" -fileType CIM
+msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\myapp"
 ```
 
-|Optional parameters|Description|Example|
-| -------- | -------- | -------- |
-|-readOnly|Boolean (true of false) indicating whether the image should be mounted as read only. If not specified, the image is mounted as read-only by default. |`msixmgr.exe -MountImage -imagePath "C:\SomeDirectory\myapp.cim" -filetype CIM -readOnly false`|
+To unpack a package into a VHDX disk image:
 
-### -quietUX
-
-Quiet mode, no user interaction. Use in conjunction with other parameters.
+> [!NOTE]
+> If you're using VHD or VHDX, we recommend the size is four times the size of MSIX package.
 
 ```
--quietUX
+msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -vhdSize 200 -filetype VHDX -rootDirectory apps
 ```
 
-#### Example
+To unpack a package into a CIM disk image:
 
 ```
-msixmgr.exe -AddPackage "C:\SomeDirectory\myapp.msix" -quietUX  
+msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -filetype CIM -rootDirectory apps
 ```
 
-### -UnmountImage
+|Optional parameters|Description|Example|
+| -------- | -------- | -------- |
+|-applyacls|Applies ACLs to the resulting package folder(s) and their parent folder. |`msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\myapp" -applyACLs` |
+|-create|Creates a new image with the specified -filetype and unpacks the packages to that image. |`msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType VHDX -vhdSize 200` |
+|-fileType|The type of file to unpack packages to. Valid file types include `VHD`, `VHDX`, `CIM`. This is a required parameter when unpacking to CIM files. |`msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType CIM -rootDirectory apps` |
+|-rootDirectory|Specifies root directory on image to unpack packages to. Required parameter for unpacking to new and existing CIM files. |`msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -filetype CIM -rootDirectory apps` |
+|-validateSignature|Validates a package's signature file before unpacking package. This parameter will require that the package's certificate is installed on the machine.<br /><br />For more information, see [Certificate Stores](/windows-hardware/drivers/install/certificate-stores).|`msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\Myapp" -validateSignature -applyACLs`|
 
-Unmounts the VHD, VHDX, or CIM image.
+### -MountImage
+
+Mounts the VHD, VHDX, or CIM image.
 
 ```
--UnmountImage -imagePath [Path to the MSIX image] -fileType [VHD | VHDX | CIM]
+-MountImage -imagePath [Path to the MSIX image] -fileType [VHD | VHDX | CIM]
 ```
 
-#### Example:
+#### Example
 
 ```
-msixmgr.exe -UnmountImage -imagePath "C:\SomeDirectory\myapp.vhdx" -fileType VHDX
+msixmgr.exe -MountImage -imagePath "C:\SomeDirectory\myapp.cim" -fileType CIM
 ```
 
 |Optional parameters|Description|Example|
 | -------- | -------- | -------- |
-|-volumeId|Specifies GUID (specified without curly braces) associated with image to unmount. This is an optional parameter only for CIM files. |`msixmgr.exe -UnmountImage -volumeId 0ea000fe-0021-465a-887b-6dc94f15e86e -filetype CIM`|
+|-readOnly|Boolean (true of false) indicating whether the image should be mounted as read only. If not specified, the image is mounted as read-only by default. |`msixmgr.exe -MountImage -imagePath "C:\SomeDirectory\myapp.cim" -filetype CIM -readOnly false`|
 
-### -Unpack
+### -UnmountImage
 
-Unpacks package (`.appx`, `.msix`, `.appxbundle`, `.msixbundle`) and extract its contents to a folder.
+Unmounts the VHD, VHDX, or CIM image.
 
 ```
--Unpack -packagePath [Path to package to unpack OR path to a directory containing multiple packages to unpack] -destination [Directory to place the resulting package folder(s) in]
+-UnmountImage -imagePath [Path to the MSIX image] -fileType [VHD | VHDX | CIM]
 ```
 
-> [!NOTE]
-> If you're using VHD or VHDX, we recommend the size is four times the size of MSIX package.
-
-#### Example
+#### Example:
 
 ```
-msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\myapp"
+msixmgr.exe -UnmountImage -imagePath "C:\SomeDirectory\myapp.vhdx" -fileType VHDX
 ```
 
 |Optional parameters|Description|Example|
 | -------- | -------- | -------- |
-|-applyacls|Applies ACLs to the resulting package folder(s) and their parent folder. |`msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\myapp" -applyACLs` |
-|-create|Creates a new image with the specified -filetype and unpacks the packages to that image. |`msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType VHDX -vhdSize 200` |
-|-fileType|The type of file to unpack packages to. Valid file types include `VHD`, `VHDX`, `CIM`. This is a required parameter when unpacking to CIM files. |`msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType CIM -rootDirectory apps` |
-|-rootDirectory|Specifies root directory on image to unpack packages to. Required parameter for unpacking to new and existing CIM files. |`msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -filetype CIM -rootDirectory apps` |
-|-validateSignature|Validates a package's signature file before unpacking package. This parameter will require that the package's certificate is installed on the machine.<br /><br />For more information, see [Certificate Stores](/windows-hardware/drivers/install/certificate-stores).|`msixmgr.exe -Unpack -packagePath "C:\SomeDirectory\myapp.msix" -destination "C:\Apps\Myapp" -validateSignature -applyACLs`|
+|-volumeId|Specifies GUID (specified without curly braces) associated with image to unmount. This is an optional parameter only for CIM files. |`msixmgr.exe -UnmountImage -volumeId 0ea000fe-0021-465a-887b-6dc94f15e86e -filetype CIM`|
 
 ### -?