Parâmetros da ferramenta MSIXMGR
Esse artigo contém os parâmetros e a sintaxe da linha de comando que você pode usar com a ferramenta MSIXMGR.
Pré-requisitos
Para usar a ferramenta MSIXMGR, você precisa de:
- Baixe a ferramenta MSIXMGR.
- Obtenha um aplicativo (
.msixarquivo) empacotado em MSIX. - Um dispositivo Windows com permissões administrativas para criar a imagem MSIX.
-AddPackage
Adicione o pacote ao caminho do arquivo especificado.
-AddPackage <Path to the MSIX package>
or
-p <Path to the MSIX package>
Aqui está um exemplo de uso do parâmetro -AddPackage:
msixmgr.exe -AddPackage "C:\MSIX\myapp.msix"
-RemovePackage
Remova o pacote com o nome completo do pacote especificado.
-RemovePackage <Package name>
or
-x <Package name>
Aqui está um exemplo de uso do parâmetro -RemovePackage. Você pode encontrar o nome completo do pacote executando o cmdlet do PowerShell Get-AppxPackage.
msixmgr.exe -RemovePackage myapp_0.0.0.1_x64__8wekyb3d8bbwe
-FindPackage
Encontre um pacote com o nome completo do pacote específico.
-FindPackage <Package name>
Aqui está um exemplo de uso do parâmetro -FindPackage. Você pode encontrar o nome completo do pacote executando o cmdlet do PowerShell Get-AppxPackage.
msixmgr.exe -FindPackage myapp_0.0.0.1_x64__8wekyb3d8bbwe
-ApplyACLs
Aplique ACLs a uma pasta de pacote (um pacote descompactado). Você também precisa especificar os seguintes subparâmetros obrigatórios:
| Parâmetro obrigatório | Descrição |
|---|---|
-packagePath |
O caminho para o pacote a ser descompactado OU o caminho para um diretório contendo vários pacotes para descompactar |
-ApplyACLs -packagePath <Path to the package folder>
Aqui está um exemplo de uso do parâmetro -ApplyACLs:
msixmgr.exe -ApplyACLs -packagePath "C:\MSIX\myapp_0.0.0.1_x64__8wekyb3d8bbwe"
-Unpack
Descompacte um pacote em um dos formatos de arquivo .appx, .msix, .appxbundle, ou .msixbundle, e extraia seu conteúdo para uma pasta. Você também precisa especificar os seguintes subparâmetros obrigatórios:
| Parâmetro obrigatório | Descrição |
|---|---|
-destination |
O diretório no qual colocar as pastas do pacote resultante. |
-fileType |
O tipo de arquivo para o qual descompactar pacotes. Os tipos de arquivo válidos incluem .vhd, .vhdx, .cim. Esse parâmetro só é necessário ao descompactar arquivos CIM. |
-packagePath |
O caminho para o pacote a ser descompactado OU o caminho para um diretório que contém vários pacotes a serem descompactados. |
-rootDirectory |
Especifica o diretório raiz na imagem para o qual desempacotar os pacotes. Esse parâmetro só é necessário ao descompactar arquivos CIM novos e existentes. |
-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> -fileType <VHD | VHDX | CIM> -rootDirectory <Root directory on image to unpack packages to>
Aqui estão alguns exemplos de uso do parâmetro -Unpack:
Para descompactar um pacote em um diretório:
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp"Para descompactar um pacote em uma imagem de disco VHDX:
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.vhdx" -applyACLs -create -filetype VHDX -rootDirectory appsPara descompactar um pacote em uma imagem de disco CIM:
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.cim" -applyACLs -create -filetype CIM -rootDirectory apps
Aqui estão os parâmetros opcionais que você pode usar com o parâmetro -Unpack:
| Parâmetro opcional | Descrição | Exemplo |
|---|---|---|
-applyACLs |
Aplica ACLs à(s) pasta(s) do pacote resultante(s) e à pasta principal. | msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs |
-create |
Cria uma nova imagem com o tipo de arquivo especificado e descompacta os pacotes para essa imagem. Requer o parâmetro -filetype. |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType VHDX |
-fileType |
O tipo de arquivo para o qual descompactar pacotes. Os tipos de arquivo válidos incluem VHD, VHDX, CIM. Esse parâmetro é necessário ao descompactar arquivos CIM. Requer o parâmetro -create. |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType CIM -rootDirectory apps |
-rootDirectory |
Especifica o diretório raiz na imagem para descompactar os pacotes. Esse parâmetro é necessário ao descompactar arquivos CIM novos e existentes. | msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -filetype CIM -rootDirectory apps |
-validateSignature |
Valida o arquivo de assinatura do pacote antes de descompactar o pacote. Esse parâmetro requer que o certificado do pacote esteja instalado na máquina. Para obter mais informações, confira Repositórios de Certificados. |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\Myapp" -validateSignature -applyACLs |
-vhdSize |
O tamanho desejado do arquivo .vhd ou .vhdx em MB. Deve ter entre 5 MB e 2.040.000 MB. Use apenas para arquivos .vhd ou .vhdx. Requer os parâmetros -createe -filetype. |
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -create -fileType VHDX -vhdSize 500 |
-MountImage
Monte uma imagem VHD, VHDX ou CIM. Você também precisa especificar os seguintes subparâmetros obrigatórios:
| Parâmetro obrigatório | Descrição |
|---|---|
-fileType |
O tipo de arquivo para o qual descompactar pacotes. Os tipos de arquivo válidos incluem VHD, VHDX, CIM. |
-imagePath |
O caminho para o arquivo de imagem a ser montado. |
-MountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>
Aqui está um exemplo de uso do parâmetro -MountImage:
msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -fileType CIM
Aqui estão os parâmetros opcionais que você pode usar com o parâmetro -MountImage:
| Parâmetro opcional | Descrição | Exemplo |
|---|---|---|
-readOnly |
Booliano (verdadeiro ou falso) indicando se a imagem deve ser montada somente para leitura. Se não for especificado, a imagem será montada como somente leitura por padrão. | msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -filetype CIM -readOnly false |
-UnmountImage
Desmonte uma imagem VHD, VHDX ou CIM. Você também precisa especificar os seguintes subparâmetros obrigatórios:
| Parâmetro obrigatório | Descrição |
|---|---|
-fileType |
O tipo de arquivo para o qual descompactar pacotes. Os tipos de arquivo válidos incluem VHD, VHDX, CIM. |
-imagePath |
O caminho para o arquivo de imagem a ser montado. |
-UnmountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>
Aqui está um exemplo de uso do parâmetro -UnmountImage:
msixmgr.exe -UnmountImage -imagePath "C:\MSIX\myapp.vhdx" -fileType VHDX
Aqui estão os parâmetros opcionais que você pode usar com o parâmetro -UnmountImage:
| Parâmetro opcional | Descrição | Exemplo |
|---|---|---|
-volumeId |
O GUID do volume (especificado sem chaves) associado à imagem a ser desmontada. Esse parâmetro é opcional apenas para arquivos CIM. Você pode encontrar o ID do volume executando o cmdlet do PowerShell Get-Volume. | msixmgr.exe -UnmountImage -volumeId 199a2f93-99a8-11ee-9b0d-4c445b63adac -filetype CIM |
-quietUX
Suprime a interação do usuário ao executar a ferramenta MSIXMGR. Esse parâmetro é opcional e pode ser usado com qualquer outro parâmetro.
Aqui está um exemplo de uso do parâmetro -quietUX com o parâmetro -AddPackage:
msixmgr.exe -AddPackage "C:\MSIX\myapp.msix" -quietUX
Próximas etapas
Para saber mais sobre o anexação do aplicativo MSIX, confira estes artigos: