Adicionar e gerenciar aplicativos de Anexação de Aplicativo na Área de Trabalho Virtual do Azure

Veja como adicionar uma imagem MSIX, uma imagem Appx ou um pacote do App-V como um pacote de Anexo 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 ir para a visão geral da Área de Trabalho Virtual do Azure.

3. Selecione Anexar aplicativo e, em seguida, selecione + Criar.

4. Na guia Informações básicas , preencha as seguintes informações:

   Parâmetro	Descrição
   Assinatura	Selecione a assinatura à qual você deseja adicionar uma imagem MSIX, uma imagem Appx ou um pacote App-V na lista suspensa.
   Grupo de recursos	Selecione um grupo de recursos existente ou selecione Criar novo e insira um nome.
   Tipo do pool de organizador	Selecione um pool de hosts existente na lista suspensa.
   Local	Selecione a região do Azure para seu pacote de Anexo 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 em Selecione na conta de armazenamento se a imagem estiver armazenada nos Arquivos do Azure ou insira UNC para especificar um caminho UNC. Os campos subsequentes dependem da opção selecionada.
   Selecionar na conta de armazenamento
   Conta de armazenamento	Selecione a conta de armazenamento na qual sua imagem está.
   Compartilhamento de arquivos	Selecione Selecionar um arquivo e, em seguida, 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.
   Entrada UNC
   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 o aplicativo.
   Versão	Verifique se o número da versão esperada é mostrado.
   Tipo de Registro	Selecione o tipo de registro que você deseja usar.
   Estado	Selecione o estado inicial do pacote.
   Integridade marcar status em caso de falha	Selecione o status do pacote se ele falhar ao ser preparado em um host de sessão. Esse status é relatado para AppAttachHealthCheck para a marcar status 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 host, usuários e grupos. Como alternativa, se você quiser configurar as atribuições separadamente, selecione Examinar + criar e vá para Atribuir um pacote de anexo de aplicativo.

6. Opcional: Na guia Tarefas , preencha as seguintes informações:

   1. Em Pool de hosts, selecione a quais pools de hosts você deseja atribuir o aplicativo.

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

   3. Examine as atribuições que você adicionou e selecione Avançar.

7. Opcional: na guia Marcas , você pode inserir os pares de nome/valor necessários e selecionar Examinar + criar.

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

Veja como adicionar uma imagem MSIX, uma imagem Appx ou um pacote do App-V como um pacote de Anexo de Aplicativo usando o módulo do PowerShell Az.DesktopVirtualization . Certifique-se de alterar os <placeholder> seus próprios valores.

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

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

   • Se você estiver usando o PowerShell localmente, primeiro entre no Azure PowerShell e, em seguida, verifique se o contexto do Azure está definido para a assinatura que você deseja usar.

2. Durante a versão prévia, Marque se você tem os cmdlets do PowerShell disponíveis executando os seguintes comandos:

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

   A saída deve ser semelhante à seguinte:

   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, da imagem Appx ou do pacote App-V que você deseja adicionar e armazene-as em uma variável executando o comando a seguir. 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 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 o pacote como um pacote de Anexo 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 a marcar status de integridade do host de sessão em caso de falha é definida 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 exemplo a seguir:

   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 aplicativos a pools de host, usuários e grupos usando o portal do Azure:

Pools de hosts

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Anexação de Aplicativo e, 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 e selecione um ou mais grupos de host na lista suspensa. Certifique-se de que todos os hosts de sessão no pool de hosts tenham acesso de leitura com a 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 e, 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 selecione um ou mais grupos e/ou usuários da lista.

4. Selecione Selecionar.

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

Pools de hosts

1. Na mesma sessão do PowerShell, obtenha as IDs de recurso do(s) pool(s) de host aos quais você deseja atribuir o aplicativo e adicione-os 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 dos pools de host, você pode atribuir o pacote de aplicativos 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 Az.DesktopVirtualization do PowerShell.

1. Obtenha a ID de 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 de objeto do grupo ou grupos e adicione-os a uma matriz executando os comandos a seguir. 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 a ID de objeto do(s) usuário(s) e adicione-os a uma matriz executando os comandos a seguir. Este exemplo usa o nome UPN (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 de Usuário de Virtualização de Área de Trabalho .

   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 do 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 e o estado de registro de um pacote usando o portal do Azure:

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Anexar 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 e o estado de registro de um pacote usando o módulo Az.DesktopVirtualization do PowerShell.

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

   1. Altere o tipo de registro executando o comando a seguir. Defina IsRegularRegistration como $truepara 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 $trueAtivo ou $falseInativo.

      $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, em seguida, selecione o grupo de aplicativos RemoteApp ao qual você deseja adicionar um aplicativo.

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

3. Na guia Informações básicas , preencha as seguintes informações:

   Parâmetro	Valor/Descrição
   Fonte do aplicativo	Selecione Anexo de Aplicativo na lista suspensa. Se você quiser adicionar aplicativos no menu Iniciar ou especificar 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 do App Attach.
   Application	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 destinado aos 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 para o aplicativo ou selecione Caminho do arquivo para usar um ícone personalizado. Em Caminho do arquivo, selecione uma das seguintes opções:

   • Procurar Arquivos do Azure para usar um ícone de um compartilhamento de arquivo do Azure. Selecione Selecione uma conta de armazenamento e 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 diretório em que seu ícone está, marque a caixa ao lado do ícone que você deseja adicionar, por exemploMyApp.ico, e selecione Selecionar. Você também pode usar um .png arquivo. Em Índice do ícone, especifique o número de índice do ícone que você deseja usar. Esse número geralmente é 0.

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

   Depois de concluir essa guia, selecione Examinar + adicionar.

5. Na guia Revisar + adicionar , certifique-se de que a validação seja aprovada e revise as informações usadas para adicionar o aplicativo e, em seguida, selecione Adicionar para adicionar o aplicativo ao grupo de aplicativos do RemoteApp.

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

1. Na mesma sessão do PowerShell, se houver vários aplicativos no pacote, você precisará obter a ID do aplicativo 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 deseja publicar (por exemplo App) e execute os seguintes comandos para adicionar o aplicativo ao grupo de aplicativos do 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 Anexar Aplicativo. Você deve ver uma lista de todos os pacotes existentes.

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

3. Insira as informações para o pacote atualizado:

   1. A assinatura e o grupo de recursos são preenchidos previamente 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. Para Selecionar da conta de armazenamento, selecione a conta de armazenamento que contém a imagem atualizada. Selecione Selecionar um arquivo e, em seguida, 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. Em Input UNC (Entrada UNC), 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 Az.DesktopVirtualization do PowerShell.

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 x86 do mesmo aplicativo, poderá usar o parâmetro PackageFullName para especificar qual você 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 comando a seguir. 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 Anexo de Aplicativo usando o portal do Azure:

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Anexar 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 host aos quais ele está atribuído.

Veja como remover um pacote de Anexo de Aplicativo usando o módulo Az.DesktopVirtualization do 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