Testar pacotes MSIX para Anexar Aplicação

Este artigo mostra-lhe como montar pacotes MSIX fora do Azure Virtual Desktop para ajudar a testar os pacotes para Anexação de Aplicações. As APIs que ligam a Aplicação estão disponíveis para Windows 11 Enterprise e Windows 10 Enterprise. Estas APIs podem ser utilizadas fora do Azure Virtual Desktop para fins de teste. No entanto, não existe um plano de gestão para Anexar Aplicações fora do Azure Virtual Desktop.

Para obter mais informações sobre a Anexação de Aplicações, veja Anexar Aplicações no Azure Virtual Desktop.

Pré-requisitos

Antes de poder testar um pacote para seguir as instruções neste artigo, precisa das seguintes coisas:

• Um dispositivo com Windows 11 Enterprise ou Windows 10 Enterprise.

• Uma aplicação que expandiu do formato MSIX para uma imagem que pode utilizar com a Anexação de Aplicações. Saiba como Criar uma imagem MSIX para utilizar com a Anexação de Aplicações no Azure Virtual Desktop.

• Se estiver a utilizar uma imagem cimFS, tem de instalar o módulo CimDiskImage PowerShell.

• Uma conta de utilizador que tenha permissão de administrador local no dispositivo que está a utilizar para testar o pacote MSIX.

Não precisa de uma implementação do Azure Virtual Desktop porque este artigo descreve um processo para testes fora do Azure Virtual Desktop.

Fases

Para utilizar pacotes MSIX fora do Azure Virtual Desktop, existem quatro fases distintas que tem de efetuar pela seguinte ordem:

1. Estágio
2. Registrar
3. Anular registo
4. Etapa final

O teste e a desativação são operações ao nível da máquina, enquanto o registo e o registo são operações ao nível do utilizador. Os comandos que precisa de utilizar variam consoante a versão do PowerShell que está a utilizar e se as imagens do disco estão no formato CimFS, VHDX ou VHD .

Preparar para preparar um pacote MSIX

O script de teste prepara o computador para receber o pacote MSIX e monta o pacote relevante no seu computador.

Selecione o separador relevante para a versão do PowerShell que está a utilizar.

Preparar um pacote MSIX

Agora que preparou o computador para preparar os pacotes MSIX, tem de montar a imagem do disco e, em seguida, concluir o teste do pacote MSIX.

Montar uma imagem de disco

O processo de montagem de uma imagem de disco varia consoante esteja a utilizar o formato CimFs, VHDX ou VHD para a sua imagem de disco. Selecione o separador relevante para o formato que está a utilizar.

Concluir a transição de uma imagem de disco

Por fim, tem de executar os seguintes comandos para todos os formatos de imagem para concluir o teste da imagem do disco. Este comando utiliza a $deviceId variável que criou quando montou a imagem do disco na secção anterior.

1. Na mesma sessão do PowerShell, obtenha as informações da aplicação ao executar os seguintes comandos:

   $manifest = Get-ChildItem -LiteralPath $deviceId -Recurse -File AppxManifest.xml
   $manifestFolder = $manifest.DirectoryName
   

2. Obtenha o nome completo do pacote MSIX e armazene-o numa variável ao executar os seguintes comandos. Esta variável é necessária para passos posteriores.

   $msixPackageFullName = $manifestFolder.Split('\')[-1]
   Write-Output $msixPackageFullName
   

3. Crie um URI absoluto para a pasta de manifesto para a API do Gestor de Pacotes ao executar os seguintes comandos:

   $folderUri = $maniFestFolder.Replace('\\?\','file:\\\')
   $folderAbsoluteUri = ([Uri]$folderUri).AbsoluteUri
   

4. Utilize o URI absoluto para preparar o pacote de aplicação ao executar os seguintes comandos:

   $asTask = ([System.WindowsRuntimeSystemExtensions].GetMethods() | Where-Object { $_.ToString() -eq 'System.Threading.Tasks.Task`1[TResult] AsTask[TResult,TProgress](Windows.Foundation.IAsyncOperationWithProgress`2[TResult,TProgress])' })[0]
   $asTaskAsyncOperation = $asTask.MakeGenericMethod([Windows.Management.Deployment.DeploymentResult], [Windows.Management.Deployment.DeploymentProgress])
   
   $packageManager = New-Object -TypeName Windows.Management.Deployment.PackageManager
   
   $asyncOperation = $packageManager.StagePackageAsync($folderAbsoluteUri, $null, "StageInPlace")
   

5. Monitorize o progresso de teste do pacote de aplicação ao executar os seguintes comandos. O tempo necessário para preparar o pacote depende do tamanho. A Status propriedade da $stagingResult variável será RanToCompletion quando o teste estiver concluído.

   $stagingResult = $asTaskAsyncOperation.Invoke($null, @($asyncOperation))
   
   while ($stagingResult.Status -eq "WaitingForActivation") {
       Write-Output "Waiting for activation..."
       Start-Sleep -Seconds 5
   }
   
   Write-Output $stagingResult
   

Assim que o seu pacote MSI for testado, pode registar o seu pacote MSIX.

Registar um pacote MSIX

Para registar um pacote MSIX, execute os seguintes comandos na mesma sessão do PowerShell. Este comando utiliza a $msixPackageFullName variável criada numa secção anterior.

$manifestPath = Join-Path (Join-Path $Env:ProgramFiles 'WindowsApps') (Join-Path $msixPackageFullName AppxManifest.xml)
Add-AppxPackage -Path $manifestPath -DisableDevelopmentMode -Register

Agora que o pacote MSIX está registado, a sua aplicação deve estar disponível para utilização na sua sessão. Agora pode abrir a aplicação para testes e resolução de problemas. Quando tiver terminado, terá de anular o registo e anular o seu pacote MSIX.

Anular o registo de um pacote MSIX

Quando tiver terminado o seu pacote MSIX e estiver pronto para o remover, primeiro tem de o anular. Para anular o registo do pacote MSIX, execute os seguintes comandos na mesma sessão do PowerShell. Estes comandos obtêm novamente o parâmetro do DeviceId disco e removem o pacote com a $msixPackageFullName variável criada numa secção anterior.

$appPath = Join-Path (Join-Path $Env:ProgramFiles 'WindowsApps') $msixPackageFullName
$folderInfo = Get-Item $appPath
$deviceId = '\\?\' + $folderInfo.Target.Split('\')[0] +'\'
Write-Output $deviceId #Save this for later

Remove-AppxPackage $msixPackageFullName -PreserveRoamableApplicationData

Desenarnar um pacote MSIX

Por fim, para desestar o pacote MSIX, tem de desmontar a imagem do disco, execute o seguinte comando na mesma sessão do PowerShell para garantir que o pacote ainda não está registado para nenhum utilizador. Este comando utiliza a $msixPackageFullName variável criada numa secção anterior.

Remove-AppxPackage -AllUsers -Package $msixPackageFullName -ErrorAction SilentlyContinue

Desmontar a imagem dos discos

Para concluir o processo de desativação, tem de desmontar os discos do sistema. O comando que precisa de utilizar depende do formato da sua imagem de disco. Selecione o separador relevante para o formato que está a utilizar.

Dismount-CimDiskImage -DeviceId $deviceId

Dismount-DiskImage -DevicePath $deviceId.TrimEnd('\')

Depois de concluir a desmontagem dos discos, removeu o pacote MSIX em segurança.

Configurar scripts de simulação para o agente de Anexação de Aplicações

Se quiser adicionar e remover pacotes MSIX automaticamente ao seu dispositivo, pode utilizar os comandos do PowerShell neste artigo para criar scripts que são executados no arranque, início de sessão, fim de sessão e encerramento. Para saber mais, veja Utilizar scripts de arranque, encerramento, início de sessão e início de sessão no Política de Grupo. Tem de se certificar de que todas as variáveis necessárias para cada fase estão disponíveis em cada script.

Cria um script para cada fase:

• O script de arranque executa o processo de fase .
• O script de início de sessão executa o processo de registo .
• O script de início de sessão executa o processo de registo .
• O script de encerramento executa o processo de preparação .

Utilizar pacotes offline

Se estiver a utilizar pacotes em dispositivos que não estão ligados à Internet, tem de se certificar de que as licenças de pacote estão instaladas no seu dispositivo para executar a aplicação com êxito. Se o seu dispositivo estiver online, as licenças necessárias devem ser transferidas automaticamente.

Para instalar os ficheiros de licença, tem de utilizar um script do PowerShell que chama a MDM_EnterpriseModernAppManagement_StoreLicenses02_01 classe no Fornecedor de Bridge WMI.

Eis como configurar uma licença para utilização offline:

1. Transfira o pacote de aplicação, a licença e as arquiteturas necessárias do Microsoft Store para Empresas. Precisa dos ficheiros de licença codificados e não codificados. Para saber como transferir uma aplicação licenciada offline, consulte Distribuir aplicações offline.

2. Execute os seguintes comandos do PowerShell como administrador. Pode instalar a licença no final da fase de teste. Tem de editar as seguintes variáveis:

   • $contentID é o valor ContentID do ficheiro de licença não codificado (.xml). Pode abrir o ficheiro de licença num editor de texto à sua escolha.

   • $licenseBlob é a cadeia completa do blob de licenças no ficheiro de licença codificada (.bin). Pode abrir o ficheiro de licença codificada num editor de texto à sua escolha.

     $namespaceName = "root\cimv2\mdm\dmmap"
     $className = "MDM_EnterpriseModernAppManagement_StoreLicenses02_01"
     $methodName = "AddLicenseMethod"
     $parentID = "./Vendor/MSFT/EnterpriseModernAppManagement/AppLicenses/StoreLicenses"
     
     #Update $contentID with the ContentID value from the unencoded license file (.xml)
     $contentID = "{'ContentID'_in_unencoded_license_file}"
     
     #Update $licenseBlob with the entire String in the encoded license file (.bin)
     $licenseBlob = "{Entire_String_in_encoded_license_file}"
     
     $session = New-CimSession
     
     #The final string passed into the AddLicenseMethod should be of the form <License Content="encoded license blob" />
     $licenseString = '<License Content='+ '"' + $licenseBlob +'"' + ' />'
     
     $params = New-Object Microsoft.Management.Infrastructure.CimMethodParametersCollection
     $param = [Microsoft.Management.Infrastructure.CimMethodParameter]::Create("param",$licenseString ,"String", "In")
     $params.Add($param)
     
     try
     {
          $instance = New-CimInstance -Namespace $namespaceName -ClassName $className -Property @{ParentID=$parentID;InstanceID=$contentID}
          $session.InvokeMethod($namespaceName, $instance, $methodName, $params)
     }
     catch [Exception]
     {
          Write-Host $_ | Out-String
     }
     

Scripts de demonstração

Pode encontrar scripts de demonstração para as quatro fases de teste de pacotes MSIX e ajuda de sintaxe para saber como utilizá-los no nosso repositório do GitHub. Estes scripts funcionam com qualquer versão do PowerShell e qualquer formato de imagem de disco.

Próximas etapas

Saiba mais sobre a Anexação de Aplicações no Azure Virtual Desktop:

• Anexar Aplicação no Azure Virtual Desktop.
• Adicione e faça a gestão das aplicações Anexar Aplicações.