Parâmetros da ferramenta MSIXMGR

Este artigo contém os parâmetros de linha de comando e a sintaxe que você pode usar com a ferramenta MSIXMGR.

Pré-requisitos

Para usar a ferramenta MSIXMGR, é necessário:

  • Baixe a ferramenta MSIXMGR.
  • Obtenha um aplicativo empacotado pelo MSIX (.msix arquivo).
  • Um dispositivo Windows com permissões administrativas para criar a imagem MSIX.

-AddPackage

Adicione o pacote no caminho de arquivo especificado.

-AddPackage <Path to the MSIX package>

ou

-p <Path to the MSIX package>

Aqui está um exemplo de uso do -AddPackage parâmetro:

msixmgr.exe -AddPackage "C:\MSIX\myapp.msix"

-RemovePackage

Remova o pacote com o nome completo do pacote especificado.

-RemovePackage <Package name>

ou

-x <Package name>

Aqui está um exemplo de uso do -RemovePackage parâmetro. 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 -FindPackage parâmetro. 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

Aplicar 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 desempacotado OU o caminho para um diretório que contém vários pacotes a serem desempacotados
-ApplyACLs -packagePath <Path to the package folder>

Aqui está um exemplo de uso do -ApplyACLs parâmetro:

msixmgr.exe -ApplyACLs -packagePath "C:\MSIX\myapp_0.0.0.1_x64__8wekyb3d8bbwe"

-Descompactar

Descompacte um pacote em um dos formatos .appxde arquivo , .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 a(s) pasta(s) do pacote resultante.
-fileType O tipo de arquivo para o qual desempacotar os pacotes. Os tipos de arquivo válidos incluem .vhd, .vhdx, .cim. Este parâmetro é necessário apenas ao descompactar em arquivos CIM.
-packagePath O caminho para o pacote a ser desempacotado OU o caminho para um diretório que contém vários pacotes a serem desempacotados.
-rootDirectory Especifica o diretório raiz na imagem para o qual desempacotar os pacotes. Este parâmetro é necessário somente ao desempacotar em 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 -Unpack parâmetro:

  • Para desempacotar um pacote em um diretório:

    msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp"
    
  • Para desempacotar 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 apps
    
  • Para desempacotar 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 -Unpack parâmetro:

Parâmetro opcional Descrição Exemplo
-applyACLs Aplica ACLs à(s) pasta(s) do pacote resultante e suas pastas pai. 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 -filetype parâmetro. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs -create -fileType VHDX
-fileType O tipo de arquivo para o qual desempacotar os pacotes. Os tipos de arquivo válidos incluem VHD, VHDX, CIM. Este parâmetro é necessário ao descompactar em arquivos CIM. Requer o -create parâmetro. 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 o qual desempacotar os pacotes. Este parâmetro é necessário ao descompactar em 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 de um pacote antes de desempacotar o pacote. Esse parâmetro requer que o certificado do pacote esteja instalado no computador.

Para obter mais informações, consulte Repositórios de certificados.
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\Myapp" -validateSignature -applyACLs
-vhdSize O tamanho desejado do .vhd arquivo ou .vhdx em MB. Deve ter entre 5 MB e 2040000 MB. Use somente para .vhd ou .vhdx arquivos. Requer os -create parâmetros e -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 desempacotar os 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 -MountImage parâmetro:

msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -fileType CIM

Aqui estão os parâmetros opcionais que você pode usar com o -MountImage parâmetro:

Parâmetro opcional Descrição Exemplo
-readOnly Boolean (true ou false) indicando se a imagem deve ser montada como somente leitura. Se não for especificada, 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 desempacotar os 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 -UnmountImage parâmetro:

msixmgr.exe -UnmountImage -imagePath "C:\MSIX\myapp.vhdx" -fileType VHDX

Aqui estão os parâmetros opcionais que você pode usar com o -UnmountImage parâmetro:

Parâmetro opcional Descrição Exemplo
-volumeId O GUID do volume (especificado sem chaves) associado à imagem a ser desmontada. Esse parâmetro é opcional somente para arquivos CIM. Você pode encontrar a ID do volume executando o cmdlet Get-Volume do PowerShell. 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 -quietUX parâmetro com o -AddPackage parâmetro:

msixmgr.exe -AddPackage "C:\MSIX\myapp.msix" -quietUX

Próximas etapas

Para saber mais sobre o App Attach, Marque estes artigos: