Parâmetros da ferramenta MSIXMGR
Este artigo contém os parâmetros de linha de comando e sintaxe que você pode usar com a ferramenta MSIXMGR.
Pré-requisitos
Para usar a ferramenta MSIXMGR, você precisa:
- Faça o download da ferramenta MSIXMGR.
- Obtenha um aplicativo empacotado em MSIX (
.msixarquivo). - 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 específico do pacote.
-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
-Aplicar ACLs
Aplique ACLs a uma pasta de pacote (um pacote descompactado). Você também precisa especificar os seguintes subparâmetros necessários:
| Parâmetro necessário | Description |
|---|---|
-packagePath |
O caminho para o pacote a ser descompactado OU o caminho para um diretório que contém vários pacotes para descompactar |
-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"
-Desembalar
Descompacte um pacote em um dos formatos .appxde arquivo , .msix, .appxbundleou .msixbundle, e extraia seu conteúdo para uma pasta. Você também precisa especificar os seguintes subparâmetros necessários:
| Parâmetro necessário | Description |
|---|---|
-destination |
O diretório para colocar a(s) pasta(s) do pacote resultante(s). |
-fileType |
O tipo de arquivo para descompactar pacotes. Os tipos de ficheiro válidos incluem .vhd, .vhdx, .cim. Este parâmetro só é necessário ao descompactar em arquivos 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 raiz na imagem para descompactar pacotes. Este parâmetro só é necessário ao descompactar para 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 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 -Unpack parâmetro:
| Parâmetro opcional | Description | Exemplo |
|---|---|---|
-applyACLs |
Aplica ACLs à(s) pasta(s) de pacote resultante e à pasta 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 descompactar pacotes. Os tipos de ficheiro 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 descompactar pacotes. Este parâmetro é necessário ao descompactar para 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 descompactá-lo. Este parâmetro requer que o certificado do pacote esteja instalado na máquina. 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 apenas 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 necessários:
| Parâmetro necessário | Description |
|---|---|
-fileType |
O tipo de arquivo para descompactar pacotes. Os tipos de ficheiro 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 | Description | Exemplo |
|---|---|---|
-readOnly |
Booleano (verdadeiro de falso) indicando se a imagem deve ser montada como somente 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 necessários:
| Parâmetro necessário | Description |
|---|---|
-fileType |
O tipo de arquivo para descompactar pacotes. Os tipos de ficheiro 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 | Description | Exemplo |
|---|---|---|
-volumeId |
O GUID do volume (especificado sem chaves encaracoladas) associado à imagem a ser desmontada. Este parâmetro é opcional apenas para arquivos CIM. Você pode encontrar a 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. Este parâmetro é opcional e pode ser usado com qualquer outro parâmetro.
Aqui está um exemplo de como usar o -quietUX parâmetro com o -AddPackage parâmetro:
msixmgr.exe -AddPackage "C:\MSIX\myapp.msix" -quietUX
Próximos passos
Para saber mais sobre o aplicativo MSIX anexado, confira estes artigos: