Adicionar e gerenciar aplicativos de anexação de aplicativo e anexação de aplicativo MSIX na Área de Trabalho Virtual do Azure

Veja como adicionar uma imagem MSIX ou Appx ou um pacote de App-V como uma anexação de aplicativo usando o portal do Azure:

1. Entre no portal do Azure.

2. Na barra de pesquisa, digite Área de Trabalho Virtual do Azure e selecione a entrada de serviço correspondente para acessar a visão geral da Área de Trabalho Virtual do Azure.

3. Selecione Anexação de aplicativo e selecione + Criar.

4. Na guia Básico, complete as seguintes informações:

   Parâmetro	Descrição
   Assinatura	Selecione a assinatura à qual deseja adicionar uma imagem MSIX ou Appx ou um pacote de App-V a partir da lista suspensa.
   Grupo de recursos	Selecione um grupo de recursos existente ou selecione Criar e insira um nome.
   Pool de host	Selecione um pool de hosts existente na lista suspensa.
   Localidade	Selecione a região do Azure para seu pacote de anexação de aplicativo.

   Depois de concluir essa guia, selecione Avançar.

5. Na guia Caminho da imagem preencha as seguintes informações:

   Parâmetro	Descrição
   Caminho da imagem	Selecione Selecionar da conta de armazenamento se sua imagem estiver armazenada em Arquivos do Azure ou UNC de entrada para especificar um caminho UNC. Os campos subsequentes dependem da opção selecionada.
   Selecione na conta de armazenamento
   Conta de armazenamento	Selecione a conta de armazenamento em que sua imagem está.
   Compartilhamento de arquivo	Selecione Selecione um arquivo e navegue até o compartilhamento de arquivos e o diretório em que sua imagem está. Marque a caixa ao lado da imagem que você deseja adicionar, por exemplo, MyApp.cim, e selecione Selecionar.
   Pacote MSIX	Selecione o pacote MSIX ou Appx na imagem.
   UNC de entrada
   UNC	Insira o caminho UNC para o arquivo de imagem.
   Pacote MSIX	Selecione o pacote MSIX ou Appx na imagem.
   Qualquer uma das opções
   Nome de exibição	Insira um nome amigável para seu aplicativo.
   Versão	Verifique se o número da versão esperada é mostrado.
   Tipo de registro	Selecione o tipo de registro você deseja usar.
   Estado	Selecione o estado inicial para o pacote.
   Status da verificação de integridade em caso de falha	Selecione o status do pacote se ele não conseguir ser preparado em um host de sessão. Esse status é relatado para AppAttachHealthCheck para o status de verificação de integridade do host de sessão.

   Depois de concluir essa guia, selecione Avançar.

   Dica

   Depois de concluir essa guia, você pode continuar a atribuir opcionalmente o aplicativo a pools de hosts, usuários e grupos. Como alternativa, se você quiser configurar as atribuições separadamente, selecione Revisar + criar e vá para Atribuir um pacote de anexação de aplicativo.

6. Opcional: na guia Atribuições preencha as seguintes informações:

   1. Para Pool de hosts, selecione a quais pools de hosts você deseja atribuir o aplicativo. Se você já estiver usando anexar aplicativo MSIX com um pool de hosts, não poderá selecionar esse pool de hosts, pois não poderá usar as duas versões de anexação de aplicativo com o mesmo pool de hosts.

   2. Selecione Adicionar usuários ou grupos de usuários em seguida, procure e selecione os usuários ou grupos aos quais deseja atribuir o aplicativo. Quando terminar, selecione Selecionar.

   3. Revise as atribuições adicionadas e selecione Avançar.

7. Opcional: na guia Tags você pode inserir qualquer par nome/valor necessário e selecionar Revisar + criar.

8. Na guia Revisar + criar verifique se a validação passa e revisa as informações usadas durante a implantação e selecione Criar para adicionar o aplicativo.

Veja como adicionar uma imagem MSIX ou Appx ou um pacote de App-V como um pacote de anexação de aplicativo usando o módulo do PowerShell Az.DesktopVirtualization. Certifique-se de alterar os valores <placeholder> para os seus valores.

1. Abra o Azure Cloud Shell no portal do Azure com o tipo de terminal PowerShell ou execute o PowerShell em seu dispositivo local.

   • Se estiver usando o Cloud Shell, verifique se o contexto do Azure está definido para a assinatura que você deseja usar.

   • Se estiver usando o PowerShell localmente, primeiro conecte-se com o Azure PowerShell e, em seguida, certifique-se de que seu contexto do Azure está definido para a assinatura que você deseja usar.

2. Durante a visualização, verifique se você tem os cmdlets do PowerShell disponíveis executando os seguintes comandos:

   Import-Module Az.DesktopVirtualization
   Get-Command -Module Az.DesktopVirtualization -Noun "*AppAttach*"
   

   Sua saída deve ser semelhante à seguinte saída:

   CommandType     Name                                               Version    Source
   -----------     ----                                               -------    ------
   Function        Get-AzWvdAppAttachPackage                          4.2.1      Az.DesktopVirtualization
   Function        Import-AzWvdAppAttachPackageInfo                   4.2.1      Az.DesktopVirtualization
   Function        New-AzWvdAppAttachPackage                          4.2.1      Az.DesktopVirtualization
   Function        Remove-AzWvdAppAttachPackage                       4.2.1      Az.DesktopVirtualization
   Function        Update-AzWvdAppAttachPackage                       4.2.1      Az.DesktopVirtualization
   

3. Obtenha as propriedades da imagem MSIX e Appx ou um pacote de App-V que você deseja adicionar e armazenar em uma variável executando o seguinte comando. Você precisa especificar um pool de hosts, mas pode ser qualquer pool de hosts em que os hosts de sessão tenham acesso ao compartilhamento de arquivos.

   # Get the properties of the MSIX image, Appx image, or App-V package
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters
   

4. Verifique se você tem apenas um objeto nas propriedades do aplicativo executando os seguintes comandos:

   $app | FL *
   

   Opcional: se você tiver mais de um objeto na saída, por exemplo, uma versão x64 e uma versão x86 do mesmo aplicativo, poderá usar o parâmetro PackageFullName para especificar qual aplicativo deseja adicionar executando os seguintes comandos:

   # Specify the package full name
   $packageFullName = '<PackageFullName>'
   
   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters | ? ImagePackageFullName -like *$packageFullName*
   

5. Adicione a imagem ou um pacote como um pacote de anexação de aplicativo executando o comando a seguir. Neste exemplo, o estado do aplicativo é marcado como ativo, o registro do aplicativo é definido como sob demanda e status de verificação de integridade do host da sessão em caso de falha é definido como NeedsAssistance:

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
       Location = '<AzureRegion>'
       FailHealthCheckOnStagingFailure = 'NeedsAssistance'
       ImageIsRegularRegistration = $false
       ImageDisplayName = '<AppDisplayName>'
       ImageIsActive = $true
   }
   
   New-AzWvdAppAttachPackage -AppAttachPackage $app @parameters
   

   Não há saída quando o pacote é adicionado com êxito.

6. Você pode verificar se o pacote foi adicionado executando os seguintes comandos:

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdAppAttachPackage @parameters | FL Name, ImagePackageApplication, ImagePackageFamilyName, ImagePath, ImageVersion, ImageIsActive, ImageIsRegularRegistration, SystemDataCreatedAt
   

   A saída deve ser semelhante ao seguinte exemplo:

   Name                       : My App
   ImagePackageApplication    : {MyApp}
   ImagePackageFamilyName     : MyApp_abcdef123ghij
   ImagePath                  : \\fileshare\Apps\MyApp\MyApp.cim
   ImageVersion               : 1.0.0.0
   ImageIsActive              : True
   ImageIsRegularRegistration : True
   SystemDataCreatedAt        : 7/31/2023 3:03:43 PM
   

Veja como atribuir um pacote de aplicativo a pools de host, usuários e grupos usando o portal do Azure:

Pools de host

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Anexação de aplicativo em seguida, selecione o nome do pacote de anexação de aplicativo que você deseja atribuir.

2. Na seção Gerenciar, selecione Pools de hosts:

3. Selecione + Atribuir em seguida, selecione um ou mais pools de hosts na lista suspensa. Certifique-se de que todos os hosts de sessão no pool de hosts devem ter acesso leitura com sua conta de computador, conforme listado nos pré-requisitos.

4. Selecione Adicionar.

Grupos e usuários

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Anexação de aplicativo em seguida, selecione o nome do pacote de anexação de aplicativo que você deseja atribuir.

2. Na seção Gerenciar, selecione Usuários:

3. Selecione + Adicionar e, em seguida, selecione um ou mais grupos e/ou usuários na lista.

4. Escolha Selecionar.

Veja como atribuir um pacote de aplicativos a pools de hosts, bem como a grupos e usuários usando o módulo do PowerShell Az.DesktopVirtualization PowerShell.

Pools de host

1. Na mesma sessão do PowerShell, obtenha as IDs de recurso do(s) pool(s) de host ao qual você deseja atribuir o aplicativo e adicione-as a uma matriz executando os seguintes comandos:

   # Add a comma-separated list of host pools names
   $hostPoolNames = "<HostPoolName1>","<HostPoolName2>"
   
   # Create an array and add the resource ID for each host pool
   $hostPoolIds = @()
   foreach ($hostPoolName in $HostPoolNames) {
       $hostPoolIds += (Get-AzWvdHostPool | ? Name -eq $hostPoolName).Id
   }
   

2. Depois de ter as IDs de recurso do(s) pool(s) de host, você pode atribuir o pacote de aplicativo a eles executando os seguintes comandos:

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
       Location = '<AzureRegion>'
       HostPoolReference = $hostPoolIds
   }
   
   Update-AzWvdAppAttachPackage @parameters
   

3. Para cancelar a atribuição do pacote de aplicativos de todos os pools de hosts, você pode passar uma matriz vazia de pools de hosts executando os seguintes comandos:

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
       Location = '<AzureRegion>'
       HostPoolReference = @()
   }
   
   Update-AzWvdAppAttachPackage @parameters
   

Grupos e usuários

Veja como atribuir um aplicativo a grupos e usuários usando o módulo do PowerShell Az.DesktopVirtualization PowerShell.

1. Obtenha a ID do objeto dos grupos ou usuários que você deseja adicionar ou remover do aplicativo e adicione-os a uma matriz usando um dos exemplos a seguir. Recomendamos que você atribua aplicativos a grupos.

   1. Obtenha a ID do objeto do grupo ou grupos e adicione-os a uma matriz executando os seguintes comandos. Este exemplo usa o nome de exibição do grupo:

      # Add a comma-separated list of group names
      $groups = "Group1","Group2"
      
      # Connect to Microsoft Graph
      Connect-MgGraph -Scopes 'Group.Read.All'
      
      # Create an array and add the ID for each group
      $Ids = @()
      
      foreach ($group in $groups) {
         $Ids += (Get-MgGroup | ? DisplayName -eq $group).Id
      }
      

   2. Obtenha o ID do objeto do(s) usuário(s) e adicione-os a uma matriz executando os seguintes comandos. Este exemplo usa o nome principal do usuário (UPN):

      # Add a comma-separated list of user principal names
      $users = "user1@contoso.com","user2@contoso.com"
      
      # Connect to Azure AD
      Connect-MgGraph -Scopes 'User.Read.All'
      
      # Create an array and add the ID for each user
      $userIds = @()
      
      foreach ($user in $users) {
          $userIds += (Get-MgUser | ? UserPrincipalName -eq $user).Id
      }
      

2. Depois de ter as IDs de objeto dos usuários ou grupos, você pode adicioná-las ou removê-las do aplicativo usando um dos exemplos a seguir, que atribui a função RBAC Desktop Virtualization User RBAC.

   1. Para adicionar os grupos ou usuários ao aplicativo, execute os seguintes comandos:

      $parameters = @{
         Name = '<AppName>'
         ResourceGroupName = '<ResourceGroupName>'
      }
      
      $appAttachPackage = Get-AzWvdAppAttachPackage @parameters
      
      foreach ($userId in $userIds) {
         New-AzRoleAssignment -ObjectId $userId -RoleDefinitionName "Desktop Virtualization User" -Scope $appAttachPackage.Id
      }
      

   2. Para remover os grupos ou usuários para o aplicativo, execute os seguintes comandos:

      $parameters = @{
         Name = '<AppName>'
         ResourceGroupName = '<ResourceGroupName>'
      }
      
      $appAttachPackage = Get-AzWvdAppAttachPackage @parameters
      
      foreach ($userId in $userIds) {
         Remove-AzRoleAssignment -ObjectId $userId -RoleDefinitionName "Desktop Virtualization User" -Scope $appAttachPackage.Id
      }
      

Veja como alterar o tipo de registro e o estado de um pacote usando o portal do Azure:

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Anexação de aplicativo. Você deve ver uma lista de todos os pacotes existentes no pool de hosts.

2. Selecione o nome do pacote que você deseja alterar.

   1. Para alterar o tipo de registro, selecione Sob demanda ou Registrar no logon e selecione Salvar.

   2. Para alterar o estado, selecione Inativo ou Ativo e selecione Salvar.

Veja como alterar o tipo de registro e o estado de um pacote usando o módulo Az.DesktopVirtualization PowerShell.

1. Na mesma sessão do PowerShell, você pode alterar o tipo de registro e o estado executando os seguintes comandos:

   1. Altere o tipo de registro executando o seguinte comando. Defina IsRegularRegistration como $true para Registrar no logon ou $false para sob demanda.

      $parameters = @{
          Name = '<Name>'
          ResourceGroupName = '<ResourceGroupName>'
          Location = '<AzureRegion>'
          IsRegularRegistration = $true
      }
      
      Update-AzWvdAppAttachPackage @parameters
      

   2. Altere o estado executando o seguinte comando. Defina IsActive como $true para Ativo ou $false para Inativo.

      $parameters = @{
          Name = '<Name>'
          ResourceGroupName = '<ResourceGroupName>'
          Location = '<AzureRegion>'
          IsActive = $true
      }
      
      Update-AzWvdAppAttachPackage @parameters
      

Veja como adicionar um aplicativo do pacote adicionado neste artigo a um grupo de aplicativos RemoteApp usando o portal do Azure:

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Grupos de aplicativos e selecione o grupo de aplicativos RemoteApp ao qual você deseja adicionar um aplicativo.

2. Selecione Aplicativos, selecione + Adicionar. Verifique se você tem pelo menos um host de sessão ativado no pool de hosts ao qual o grupo de aplicativos está atribuído.

3. Na guia Básico, complete as seguintes informações:

   Parâmetro	Valor/Descrição
   Origem do aplicativo	Selecione Anexar aplicativo na lista suspensa. Se você quiser adicionar aplicativos no menu Iniciar ou especificando um caminho de arquivo, consulte Publicar aplicativos com o RemoteApp.
   Pacote	Selecione um pacote disponível para o pool de hosts na lista suspensa. Os pacotes regionais são de app attach.
   Aplicativo	Selecione um aplicativo na lista suspensa.
   Identificador de aplicativo	Insira um identificador exclusivo para o aplicativo.
   Nome de exibição	Insira um nome amigável para o aplicativo que é para os usuários.
   Descrição	Insira uma descrição para o aplicativo.

   Depois de concluir essa guia, selecione Avançar.

4. Na guia Ícone selecione Padrão para usar o ícone padrão do aplicativo ou selecione Caminho do arquivo para usar um ícone personalizado. Para Caminho do arquivo, selecione uma das seguintes opções:

   • Procure Arquivos do Azure para usar um ícone de um compartilhamento de arquivos do Azure. Selecione Selecione uma conta de armazenamento selecione a conta de armazenamento que contém o arquivo de ícone e, em seguida, selecione Selecionar arquivo de ícone. Navegue até o compartilhamento de arquivos e o diretório em que seu ícone está, marque a caixa ao lado do ícone que você deseja adicionar, por exemplo, MyApp.ico, e selecione Selecionar. Você também pode usar um arquivo .png. Para Índice de ícones, especifique o número de índice para o ícone que você deseja usar. Esse número costuma ser 0.

   • Caminho do arquivo UNC para usar um ícone de um compartilhamento de arquivos. Para Caminho do ícone, insira o caminho UNC para o arquivo de ícone, por exemplo, \\MyFileShare\MyApp.ico. Você também pode usar um arquivo .png. Para Índice de ícones, especifique o número de índice para o ícone que você deseja usar. Esse número costuma ser 0.

   Depois de concluir esta guia, selecione Revisar + adicionar.

5. Na guia Revisar + adicionar verifique se a validação passa e revisa as informações usadas para adicionar o aplicativo e selecione Adicionar para adicionar o aplicativo ao grupo de aplicativos RemoteApp.

Veja como adicionar um aplicativo do pacote adicionado neste artigo a um grupo de aplicativos RemoteApp usando o módulo do PowerShell Az.DesktopVirtualization.

1. Na mesma sessão do PowerShell, se houver vários aplicativos no pacote, você precisará obter a ID do aplicativo que deseja adicionar do pacote executando os seguintes comandos:

   Write-Host "These are the application IDs available in the package. Many packages only contain one application." -ForegroundColor Yellow
   $app.ImagePackageApplication.AppId
   

2. Anote a ID do aplicativo que você deseja publicar (por exemplo, App) e execute os seguintes comandos para adicionar o aplicativo ao grupo de aplicativos RemoteApp:

   $parameters = @{
       Name = '<ApplicationName>'
       ApplicationType = 'MsixApplication'
       MsixPackageFamilyName = $app.ImagePackageFamilyName
       MsixPackageApplicationId = '<ApplicationID>'
       GroupName = '<ApplicationGroupName>'
       ResourceGroupName = '<ResourceGroupName>'
       CommandLineSetting = 'DoNotAllow'
   }
   
   New-AzWvdApplication @parameters
   

3. Verifique a lista de aplicativos no grupo de aplicativos executando os seguintes comandos:

   $parameters = @{
       GroupName = '<ApplicationGroupName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdApplication @parameters
   

Veja como atualizar um pacote existente usando o portal do Azure:

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Anexação de aplicativo. Você deve ver uma lista de todos os pacotes existentes.

2. Selecione o pacote que deseja atualizar e, na visão geral, selecione Atualizar.

3. Insira as informações do pacote atualizado:

   1. Assinatura e Grupo de recursos são pré-preenchidos com os valores do pacote atual.

   2. Selecione o Pool de hosts para o qual você deseja atualizar o pacote.

   3. Selecione o caminho da imagem em Selecionar da conta de armazenamento ou UNC de entrada. Os campos subsequentes dependem da opção selecionada.

      1. Em Selecionar da conta de armazenamento, selecione a Conta de armazenamento que contém a imagem atualizada. Selecione Selecione um arquivo e navegue até o compartilhamento de arquivos e o diretório em que sua imagem está. Marque a caixa ao lado da imagem que você deseja adicionar, por exemplo, MyApp.cim, e selecione Selecionar.
      2. Para UNC de entrada, insira o caminho UNC para o arquivo de imagem.

   4. Para pacote MSIX, selecione o pacote MSIX ou Appx na imagem.

4. Depois de preencher os campos, selecione Atualizar.

Veja como atualizar um pacote existente usando o módulo do PowerShell Az.DesktopVirtualization.

1. Na mesma sessão do PowerShell, obtenha as propriedades do aplicativo atualizado e armazene-as em uma variável executando os seguintes comandos:

   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters
   

2. Verifique se você tem apenas um objeto nas propriedades do aplicativo executando os seguintes comandos:

   $app | FL *
   

   Se você tiver mais de um objeto na saída, por exemplo, uma versão x64 e uma versão x86 do mesmo aplicativo, poderá usar o PackageFullName de parâmetros para especificar qual deseja adicionar executando os seguintes comandos:

   # Specify the package full name
   $packageFullName = '<PackageFullName>'
   
   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters | ? ImagePackageFullName -like *$packageFullName*
   

3. Atualize um pacote existente executando o seguinte comando. A nova imagem de disco substitui a existente, mas as atribuições existentes são mantidas. Não exclua a imagem existente até que os usuários parem de usá-la.

   $parameters = @{
       Name = '<PackageName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Update-AzWvdAppAttachPackage -AppAttachPackage $app @parameters
   

Veja como remover um pacote de anexação de aplicativo usando o portal do Azure:

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Anexação de aplicativo. Você deve ver uma lista de todos os pacotes existentes.

2. Marque a caixa ao lado do nome do pacote que você deseja remover e selecione Remover. O pacote também é removido de todos os pools de hosts aos quais está atribuído.

Veja como remover um pacote de anexação de aplicativo usando o módulo do PowerShell Az.DesktopVirtualization PowerShell.

1. Na mesma sessão do PowerShell, execute o seguinte comando para remover o pacote que contém um aplicativo:

   $parameters = @{
       Name = '<PackageName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Remove-AzWvdAppAttachPackage @parameters
   

Veja como adicionar uma imagem MSIX usando o portal do Azure:

1. Entre no portal do Azure.

2. Na barra de pesquisa, digite Área de Trabalho Virtual do Azure e selecione a entrada de serviço correspondente para acessar a visão geral da Área de Trabalho Virtual do Azure.

3. Selecione Pools de hosts em seguida, selecione o nome do pool de hosts ao qual você deseja adicionar uma imagem MSIX.

4. Na visão geral do pool de hosts, selecione pacotes MSIX e selecione + Adicionar.

5. Para caminho de imagem MSIX, insira um caminho UNC válido apontando para a imagem MSIX no compartilhamento de arquivos, por exemplo, \\fileshare\Apps\MyApp\MyApp.cim e selecione Adicionar, que verifica se o caminho é válido.

6. Depois que o caminho for verificado, mais campos serão exibidos. Preencha as seguintes informações:

   Parâmetro	Descrição
   Pacote MSIX	Selecione o nome do pacote MSIX relevante no menu suspenso.
   Aplicativos de pacote	Isso mostra App e não é configurável.
   Nome de exibição	Insira um nome amigável para o seu pacote.
   Versão	Verifique se o número da versão esperada é mostrado.
   Tipo de registro	Selecione o tipo de registro você deseja usar.
   Estado	Selecione o estado inicial para o pacote.

7. Depois de preencher os campos, selecione Adicionar.

Veja como adicionar um pacote MSIX usando o módulo do PowerShell Az.DesktopVirtualization. Certifique-se de alterar os valores <placeholder> para os seus valores.

1. Abra o Azure Cloud Shell no portal do Azure com o tipo de terminal PowerShell ou execute o PowerShell em seu dispositivo local.

   • Se estiver usando o Cloud Shell, verifique se o contexto do Azure está definido para a assinatura que você deseja usar.

   • Se estiver usando o PowerShell localmente, primeiro conecte-se com o Azure PowerShell e, em seguida, certifique-se de que seu contexto do Azure está definido para a assinatura que você deseja usar.

2. Obtenha as propriedades do aplicativo na imagem MSIX que você deseja adicionar e armazene-as em uma variável executando os seguintes comandos:

   # Get the properties of the MSIX image
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Uri = '<UNCaPathToFile>'
   }
   
   $app = Expand-AzWvdMsixImage @parameters
   

   A saída deve ser semelhante ao seguinte exemplo:

   Name
   ----
   hp01/expandmsiximage
   

3. Verifique se você tem apenas um objeto nas propriedades do aplicativo executando os seguintes comandos:

   $app | FL *
   

   Se você tiver mais de um objeto na saída, por exemplo, uma versão x64 e uma versão x86 do mesmo aplicativo, poderá usar o PackageFullName de parâmetros para especificar qual deseja adicionar executando os seguintes comandos:

   # Specify the package full name
   $packageFullName = '<PackageFullName>'
   
   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Uri = '<UNCPathToFile>'
   }
   
   $app = Expand-AzWvdMsixImage @parameters | ? PackageFullName -like *$packageFullName*
   

4. Adicione a imagem MSIX a um pool de hosts executando o comando a seguir. Neste exemplo, o estado do aplicativo é marcado como ativo.

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       PackageAlias = $app.PackageAlias
       DisplayName = '<DisplayName>'
       ImagePath = $app.ImagePath
       IsActive = $true
   }
   
   New-AzWvdMsixPackage @parameters
   

   Não há saída quando o pacote MSIX é adicionado com êxito.

5. Você pode verificar se o pacote MSIX foi adicionado executando os seguintes comandos:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdMsixPackage @parameters | ? PackageFamilyName -eq $app.PackageFamilyName | FL *
   

   A saída deve ser semelhante ao seguinte exemplo:

   DisplayName                  : My App
   Id                           : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/avd/providers/Microsoft.DesktopVirtualization/hostpools/hp01/msixpackages/MyApp_1.0.0.0_neutral__abcdef123ghij
   ImagePath                    : \\fileshare\Apps\MyApp\MyApp.cim
   IsActive                     : True
   IsRegularRegistration        : False
   LastUpdated                  : 7/27/2023 10:02:29 AM
   Name                         : hp01/MyApp_1.0.0.0_neutral__abcdef123ghij
   PackageApplication           : {MyApp}
   PackageDependency            : {}
   PackageFamilyName            : MyApp_abcdef123ghij
   PackageName                  : MyApp
   PackageRelativePath          : apps\MyApp_1.0.0.0_neutral__abcdef123ghij
   SystemDataCreatedAt          : 7/28/2023 9:04:00 AM
   SystemDataCreatedBy          : avdadmin@contoso.com
   SystemDataCreatedByType      : User
   SystemDataLastModifiedAt     : 7/28/2023 9:04:00 AM
   SystemDataLastModifiedBy     : avdadmin@contoso.com
   SystemDataLastModifiedByType : User
   Type                         : Microsoft.DesktopVirtualization/hostpools/msixpackages
   Version                      : 1.0.0.0
   

Veja como alterar o tipo de registro e o estado de um pacote usando o portal do Azure:

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Pools de hosts e selecione o nome do pool de hosts ao qual o pacote MSIX foi adicionado.

2. Na visão geral do pool de hosts, selecione pacotes MSIX. Você deverá ver uma lista de todos os pacotes MSIX existentes no pool dos hosts.

3. Selecione o nome do pacote MSIX que você deseja alterar.

   1. Para alterar o tipo de registro, selecione Sob demanda ou Registrar no logon e selecione Salvar.

   2. Para alterar o estado, selecione Inativo ou Ativo e selecione Salvar.

Veja como alterar o tipo de registro e o estado de um pacote usando o módulo Az.DesktopVirtualization PowerShell.

1. Na mesma sessão do PowerShell, obtenha uma lista de pacotes MSIX em um pool de hosts e seu tipo e estado de registro atuais executando os seguintes comandos:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdMsixPackage @parameters | Select-Object DisplayName, ImagePath, Name, Version, IsRegularRegistration, IsActive
   

   A saída deve ser semelhante ao seguinte exemplo:

   DisplayName ImagePath                        Name                                      Version IsRegularRegistration IsActive
   ----------- ---------                        -----------------                         ------- --------------------- --------
   My App      \\fileshare\Apps\MyApp\MyApp.cim hp01/MyApp_1.0.0.0_neutral__abcdef123ghij 1.0.0.0                 False     True
   

2. Localize o pacote que você deseja remover e use o valor do parâmetro Name, mas remova o nome do pool de hosts e / desde o início. Por exemplo, hp01/MyApp_1.0.0.0_neutral__abcdef123ghij se tornará MyApp_1.0.0.0_neutral__abcdef123ghij. Aqui estão alguns exemplos.

   1. Altere o tipo de registro executando o seguinte comando. Defina IsRegularRegistration como $true para Registrar no logon ou $false para sob demanda.

      $parameters = @{
          FullName = '<FullName>'
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          IsRegularRegistration = $true
      }
      
      Update-AzWvdMsixPackage @parameters
      

   2. Altere o estado executando o seguinte comando. Defina IsActive como $true para Ativo ou $false para Inativo.

      $parameters = @{
          FullName = '<FullName>'
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          IsActive = $true
      }
      
      Update-AzWvdMsixPackage @parameters
      

Veja como adicionar um aplicativo do pacote adicionado neste artigo a um grupo de aplicativos RemoteApp usando o portal do Azure:

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Grupos de aplicativos e selecione o grupo de aplicativos Área de Trabalho ou RemoteApp ao qual você deseja adicionar um aplicativo.

2. Selecione Aplicativos, selecione + Adicionar. Verifique se você tem pelo menos um host de sessão ativado no pool de hosts ao qual o grupo de aplicativos está atribuído.

3. Na guia Noções básicas as opções exibidas dependem se o grupo de aplicativos é para uma Área de Trabalho ou um RemoteApp:

   1. Para um grupo de aplicativos da área de trabalho, preencha as seguintes informações:

      Parâmetro	Valor/Descrição
      Origem do aplicativo	O pacote MSIX é automaticamente selecionado e acinzentado.
      Pacote	Selecione um pacote disponível para o pool de hosts na lista suspensa.
      Identificador de aplicativo	Insira um identificador exclusivo para o aplicativo.
      Nome de exibição	Insira um nome amigável para o aplicativo que é para os usuários.
      Descrição	Insira uma descrição para o aplicativo.

      Depois de concluir esta guia, selecione Revisar + adicionar.

   2. Para um grupo de aplicativos RemoteApp, preencha as seguintes informações:

      Parâmetro	Valor/Descrição
      Origem do aplicativo	Selecione Anexar aplicativo na lista suspensa. Se você quiser adicionar aplicativos no menu Iniciar ou especificando um caminho de arquivo, consulte Publicar aplicativos com o RemoteApp.
      Pacote	Selecione um pacote disponível para o pool de hosts na lista suspensa. Os pacotes do pool de hosts são do MSIX app attach.
      Aplicativo	Selecione um aplicativo na lista suspensa.
      Identificador de aplicativo	Insira um identificador exclusivo para o aplicativo.
      Nome de exibição	Insira um nome amigável para o aplicativo que é para os usuários.
      Descrição	Insira uma descrição para o aplicativo.

      Depois de concluir essa guia, selecione Avançar.

      Na guia Ícone selecione Padrão para usar o ícone padrão do aplicativo ou selecione Caminho do arquivo para usar um ícone personalizado. Para Caminho do arquivo, selecione uma das seguintes opções:

      • Procure Arquivos do Azure para usar um ícone de um compartilhamento de arquivos do Azure. Selecione Selecione uma conta de armazenamento selecione a conta de armazenamento que contém o arquivo de ícone e, em seguida, selecione Selecionar arquivo de ícone. Navegue até o compartilhamento de arquivos e o diretório em que seu ícone está, marque a caixa ao lado do ícone que você deseja adicionar, por exemplo, MyApp.ico, e selecione Selecionar. Você também pode usar um arquivo .png. Para Índice de ícones, especifique o número de índice para o ícone que você deseja usar. Esse número costuma ser 0.

      • Caminho do arquivo UNC para usar um ícone de um compartilhamento de arquivos. Para Caminho do ícone, insira o caminho UNC para o arquivo de ícone, por exemplo, \\MyFileShare\MyApp.ico. Você também pode usar um arquivo .png. Para Índice de ícones, especifique o número de índice para o ícone que você deseja usar. Esse número costuma ser 0.

      Depois de concluir esta guia, selecione Revisar + adicionar.

4. Na guia Revisar + adicionar verifique se a validação passa e revisa as informações usadas para adicionar o aplicativo e selecione Adicionar para adicionar o aplicativo ao grupo de aplicativos.

Veja como adicionar aplicativos MSIX a um grupo de aplicativos usando o módulo PowerShell Az.DesktopVirtualization PowerShell.

1. Na mesma sessão do PowerShell, adicione um aplicativo MSIX a um grupo de aplicativos executando os comandos em um dos exemplos a seguir.

   1. Para adicionar um aplicativo MSIX a um grupo de aplicativos da área de trabalho, execute os seguintes comandos:

      $parameters = {
          Name = '<ApplicationName>'
          ApplicationType = 'MsixApplication'
          MsixPackageFamilyName = $app.PackageFamilyName
          GroupName = '<ApplicationGroupName>'
          ResourceGroupName = '<ResourceGroupName>'
          CommandLineSetting = 'DoNotAllow'
      }
      
      New-AzWvdApplication @parameters
      

   2. Para adicionar um aplicativo MSIX a um grupo de aplicativos RemoteApp, se houver vários aplicativos no pacote, você precisará obter a ID do aplicativo que deseja adicionar do pacote executando os seguintes comandos:

      Write-Host "These are the application IDs available in the package. Many packages only contain one application." -ForegroundColor Yellow
      $app.ImagePackageApplication.AppId
      

      Anote a ID do aplicativo que você deseja publicar (por exemplo, App) e execute os seguintes comandos para adicionar o aplicativo ao grupo de aplicativos RemoteApp:

      $parameters = @{
          Name = '<ApplicationName>'
          ApplicationType = 'MsixApplication'
          MsixPackageFamilyName = $app.PackageFamilyName
          MsixPackageApplicationId = '<ApplicationID>'
          GroupName = '<ApplicationGroupName>'
          ResourceGroupName = '<ResourceGroupName>'
          CommandLineSetting = 'DoNotAllow'
      }
      
      New-AzWvdApplication @parameters
      

      Verifique a lista de aplicativos no grupo de aplicativos executando os seguintes comandos:

      $parameters = @{
          GroupName = '<ApplicationGroupName>'
          ResourceGroupName = '<ResourceGroupName>'
      }
      
      Get-AzWvdApplication @parameters
      

Veja como remover um pacote MSIX do pool de hosts usando o portal do Azure:

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Pools de hosts e selecione o nome do pool de hosts ao qual o pacote MSIX foi adicionado.

2. Na visão geral do pool de hosts, selecione pacotes MSIX. Você deverá ver uma lista de todos os pacotes MSIX existentes no pool dos hosts.

3. Marque a caixa ao lado do nome do pacote MSIX que você deseja remover e selecione Remover.

Veja como remover aplicativos usando o módulo do PowerShell Az.DesktopVirtualization.

1. Na mesma sessão do PowerShell, obtenha uma lista de pacotes MSIX em um pool de hosts executando os seguintes comandos:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdMsixPackage @parameters | Select-Object DisplayName, ImagePath, PackageFamilyName, Version
   

   A saída deve ser semelhante ao seguinte exemplo:

   DisplayName ImagePath                        Name                                      Version
   ----------- ---------                        -----------------                         -------
   My App      \\fileshare\Apps\MyApp\MyApp.cim hp01/MyApp_1.0.0.0_neutral__abcdef123ghij 1.0.0.0
   

2. Localize o pacote que você deseja remover e use o valor do parâmetro Name, mas remova o nome do pool de hosts e / desde o início. Por exemplo, hp01/MyApp_1.0.0.0_neutral__abcdef123ghij se tornará MyApp_1.0.0.0_neutral__abcdef123ghij. Em seguida, remova o pacote executando os seguintes comandos:

   $parameters = @{
       FullName = '<FullName>'
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Remove-AzWvdMsixPackage @parameters