Partilhar via


Parâmetros da ferramenta MSIXMGR

Este artigo contém os parâmetros da linha de comandos e a sintaxe que pode utilizar com a ferramenta MSIXMGR.

Pré-requisitos

Para utilizar a ferramenta MSIXMGR, precisa de:

  • Transfira a ferramenta MSIXMGR.
  • Obter uma aplicação em pacote MSIX (.msix ficheiro).
  • Um dispositivo Windows com permissões administrativas para criar a imagem MSIX.

-AddPackage

Adicione o pacote no caminho de ficheiro especificado.

-AddPackage <Path to the MSIX package>

ou

-p <Path to the MSIX package>

Eis um exemplo de utilização 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>

Eis um exemplo de utilização do -RemovePackage parâmetro . Pode encontrar o nome completo do pacote ao executar o cmdlet do PowerShell Get-AppxPackage.

msixmgr.exe -RemovePackage myapp_0.0.0.1_x64__8wekyb3d8bbwe

-FindPackage

Localize um pacote com o nome completo do pacote específico.

-FindPackage <Package name>

Eis um exemplo de utilização do -FindPackage parâmetro . Pode encontrar o nome completo do pacote ao executar 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 desembalado). Também tem de especificar os seguintes subparâmetros necessários:

Parâmetro obrigatório Descrição
-packagePath O caminho para o pacote para desempacotar OU o caminho para um diretório que contém vários pacotes para descompactar
-ApplyACLs -packagePath <Path to the package folder>

Eis um exemplo de utilização do -ApplyACLs parâmetro :

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

-Descompactar

Descompacte um pacote num dos formatos .appxde ficheiro , .msix, .appxbundleou .msixbundlee extraia os respetivos conteúdos para uma pasta. Também tem de especificar os seguintes subparâmetros necessários:

Parâmetro obrigatório Descrição
-destination O diretório no qual colocar as pastas do pacote resultantes.
-fileType O tipo de ficheiro para o que descompactar pacotes. Os tipos de ficheiro válidos incluem .vhd, .vhdx, .cim. Este parâmetro só é necessário ao desempacotar ficheiros CIM.
-packagePath O caminho para o pacote para descompactar OU o caminho para um diretório que contém vários pacotes para descompactar.
-rootDirectory Especifica o diretório de raiz na imagem para o que descompactar pacotes. Este parâmetro só é necessário ao desempacotar para ficheiros 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>

Eis alguns exemplos da utilização do -Unpack parâmetro:

  • Para descompactar um pacote num diretório:

    msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp"
    
  • Para descompactar um pacote numa 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 descompactar um pacote numa imagem de disco CIM:

    msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp\myapp.cim" -applyACLs -create -filetype CIM -rootDirectory apps
    

Eis os parâmetros opcionais que pode utilizar com o -Unpack parâmetro :

Parâmetro opcional Descrição Exemplo
-applyACLs Aplica ACLs às pastas dos pacotes resultantes e à respetiva pasta principal. msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\myapp" -applyACLs
-create Cria uma nova imagem com o tipo de ficheiro 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 ficheiro para o que descompactar pacotes. Os tipos de ficheiro válidos incluem VHD, VHDX, CIM. Este parâmetro é necessário ao desempacotar ficheiros 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 de raiz na imagem para o que descompactar pacotes. Este parâmetro é necessário ao desempacotar para ficheiros 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 ficheiro de assinatura de um pacote antes de desempacotar o pacote. Este parâmetro requer que o certificado do pacote esteja instalado no computador.

Para obter mais informações, veja Arquivos de Certificados.
msixmgr.exe -Unpack -packagePath "C:\MSIX\myapp.msix" -destination "C:\Apps\Myapp" -validateSignature -applyACLs
-vhdSize O tamanho pretendido do .vhd ficheiro ou .vhdx em MB. Tem de estar entre 5 MB e 2040000 MB. Utilize apenas para .vhd ou .vhdx ficheiros. 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

Montar uma imagem VHD, VHDX ou CIM. Também tem de especificar os seguintes subparâmetros necessários:

Parâmetro obrigatório Descrição
-fileType O tipo de ficheiro para o que descompactar pacotes. Os tipos de ficheiro válidos incluem VHD, VHDX, CIM.
-imagePath O caminho para o ficheiro de imagem a montar.
-MountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>

Eis um exemplo de utilização do -MountImage parâmetro :

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

Eis os parâmetros opcionais que pode utilizar com o -MountImage parâmetro :

Parâmetro opcional Descrição Exemplo
-readOnly Booleano (verdadeiro de falso) que indica se a imagem deve ser montada como só de leitura. Se não for especificado, a imagem é montada como só de leitura por predefinição. msixmgr.exe -MountImage -imagePath "C:\MSIX\myapp.cim" -filetype CIM -readOnly false

-UnmountImage

Desmontar uma imagem VHD, VHDX ou CIM. Também tem de especificar os seguintes subparâmetros necessários:

Parâmetro obrigatório Descrição
-fileType O tipo de ficheiro para o que descompactar pacotes. Os tipos de ficheiro válidos incluem VHD, VHDX, CIM.
-imagePath O caminho para o ficheiro de imagem a montar.
-UnmountImage -imagePath <Path to the MSIX image> -fileType <VHD | VHDX | CIM>

Eis um exemplo de utilização do -UnmountImage parâmetro :

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

Eis os parâmetros opcionais que pode utilizar com o -UnmountImage parâmetro :

Parâmetro opcional Descrição Exemplo
-volumeId O GUID do volume (especificado sem chavetas) associado à imagem a desmontar. Este parâmetro é opcional apenas para ficheiros CIM. Pode encontrar o ID do volume ao executar o cmdlet Get-Volume do PowerShell. msixmgr.exe -UnmountImage -volumeId 199a2f93-99a8-11ee-9b0d-4c445b63adac -filetype CIM

-quietUX

Suprime a interação do utilizador ao executar a ferramenta MSIXMGR. Este parâmetro é opcional e pode ser utilizado com qualquer outro parâmetro.

Eis um exemplo de utilização do -quietUX parâmetro com o -AddPackage parâmetro :

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

Próximas etapas

Para saber mais sobre a Anexação de Aplicações, marcar estes artigos: