Adicionar e gerir Aplicações Anexadas no Azure Virtual Desktop

Eis como adicionar uma imagem MSIX, uma imagem do Appx ou um pacote App-V como um pacote anexar aplicações com o portal do Azure:

1. Entre no portal do Azure.

2. Na barra de pesquisa, escreva Azure Virtual Desktop e selecione a entrada de serviço correspondente para aceder à descrição geral do Azure Virtual Desktop.

3. Selecione Anexar Aplicação e, em seguida, selecione + Criar.

4. No separador Informações básicas , preencha as seguintes informações:

   Parâmetro	Descrição
   Assinatura	Selecione a subscrição à qual pretende adicionar uma imagem MSIX, imagem do Appx ou pacote App-V a a partir da lista pendente.
   Grupo de recursos	Selecione um grupo de recursos existente ou selecione Criar novo e introduza um nome.
   Tipo do pool de organizador	Selecione um conjunto de anfitriões existente na lista pendente.
   Local	Selecione a região do Azure para o pacote Anexar Aplicação.

   Depois de concluir este separador, selecione Seguinte.

5. No separador Caminho da imagem, preencha as seguintes informações:

   Parâmetro	Descrição
   Caminho da imagem	Selecione a partir de Selecionar a partir da conta de armazenamento se a sua imagem estiver armazenada no Arquivos do Azure ou UNC de Entrada para especificar um caminho UNC. Os campos subsequentes dependem da opção que selecionar.
   Selecionar a partir da conta de armazenamento
   Conta de armazenamento	Selecione a conta de armazenamento na qual a imagem se encontra.
   Compartilhamento de arquivos	Selecione Selecionar um ficheiro e, em seguida, navegue para a partilha de ficheiros e diretório em que a imagem se encontra. Selecione a caixa junto à imagem que pretende adicionar, por exemplo MyApp.cim, e, em seguida, selecione Selecionar.
   Pacote MSIX	Selecione o pacote MSIX ou Appx na imagem.
   UNC de Entrada
   UNC	Introduza o caminho UNC para o ficheiro de imagem.
   Pacote MSIX	Selecione o pacote MSIX ou Appx na imagem.
   Qualquer uma das opções
   Nome de exibição	Introduza um nome amigável para a sua aplicação.
   Versão	Verifique se o número de versão esperado é apresentado.
   Tipo de Registro	Selecione o tipo de registo que pretende utilizar.
   Estado	Selecione o estado inicial do pacote.
   Marcar status de estado de funcionamento com falhas	Selecione o status do pacote se não conseguir realizar a fase num anfitrião de sessão. Este status é reportado para AppAttachHealthCheck para o estado de funcionamento do anfitrião da sessão marcar status.

   Depois de concluir este separador, selecione Seguinte.

   Dica

   Depois de concluir este separador, pode continuar a atribuir opcionalmente a aplicação a conjuntos de anfitriões, utilizadores e grupos. Em alternativa, se quiser configurar atribuições separadamente, selecione Rever + criar e, em seguida, aceda a Atribuir um pacote anexar a aplicação.

6. Opcional: no separador Atribuições , preencha as seguintes informações:

   1. Em Conjunto de anfitriões, selecione os conjuntos de anfitriões aos quais pretende atribuir a aplicação.

   2. Selecione Adicionar utilizadores ou grupos de utilizadores e, em seguida, procure e selecione os utilizadores ou grupos aos quais pretende atribuir a aplicação. Depois de terminar, selecione Selecionar.

   3. Reveja as tarefas que adicionou e, em seguida, selecione Seguinte.

7. Opcional: no separador Etiquetas , pode introduzir todos os pares nome/valor necessários e, em seguida, selecionar Rever + criar.

8. No separador Rever + criar , certifique-se de que a validação é aprovada e reveja as informações utilizadas durante a implementação e, em seguida, selecione Criar para adicionar a aplicação.

Eis como adicionar uma imagem MSIX, uma imagem do Appx ou um pacote App-V como um pacote de Anexação de Aplicações com o módulo Az.DesktopVirtualization do PowerShell. Certifique-se de que altera os <placeholder> valores dos seus próprios valores.

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

   • Se estiver a utilizar Cloud Shell, certifique-se de que o contexto do Azure está definido para a subscrição que pretende utilizar.

   • Se estiver a utilizar o PowerShell localmente, primeiro inicie sessão com Azure PowerShell e, em seguida, certifique-se de que o contexto do Azure está definido para a subscrição que pretende utilizar.

2. Durante a pré-visualização, marcar que tem os cmdlets do PowerShell disponíveis ao executar os seguintes comandos:

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

   O resultado deve ser semelhante ao seguinte resultado:

   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, imagem do Appx ou pacote App-V que pretende adicionar e armazene-as numa variável ao executar o seguinte comando. Tem de especificar um conjunto de anfitriões, mas pode ser qualquer conjunto de anfitriões onde os anfitriões de sessões tenham acesso à partilha de ficheiros.

   # 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 tem apenas um objeto nas propriedades da aplicação ao executar os seguintes comandos:

   $app | FL *
   

   Opcional: se tiver mais do que um objeto na saída, por exemplo, uma versão x64 e uma versão x86 da mesma aplicação, pode utilizar o parâmetro PackageFullName para especificar a aplicação que pretende adicionar ao executar 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 pacote como um pacote anexar a aplicação ao executar o seguinte comando. Neste exemplo, o estado da aplicação está marcado como ativo, o registo da aplicação está definido como a pedido e o estado de funcionamento do anfitrião da sessão marcar status em caso de falha está 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. Pode verificar se o pacote foi adicionado ao executar os seguintes comandos:

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

   O resultado 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
   

Eis como atribuir um pacote de aplicação a conjuntos de anfitriões, utilizadores e grupos com o portal do Azure:

Pools de hosts

1. Na descrição geral do Azure Virtual Desktop, selecione Anexar Aplicação e, em seguida, selecione o nome do pacote anexar a aplicação que pretende atribuir.

2. Na secção Gerir, selecione Conjuntos de anfitriões:

3. Selecione + Atribuir e, em seguida, selecione um ou mais conjuntos de anfitriões na lista pendente. Certifique-se de que todos os anfitriões de sessões no conjunto de anfitriões têm de ter acesso de leitura com a respetiva conta de computador, conforme indicado nos pré-requisitos.

4. Selecione Adicionar.

Grupos e utilizadores

1. Na descrição geral do Azure Virtual Desktop, selecione Anexar Aplicação e, em seguida, selecione o nome do pacote anexar a aplicação que pretende atribuir.

2. Na secção Gerir, selecione Utilizadores:

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

4. Selecione Selecionar.

Eis como atribuir um pacote de aplicação a conjuntos de anfitriões, bem como a grupos e utilizadores através do módulo Az.DesktopVirtualization do PowerShell.

Pools de hosts

1. Na mesma sessão do PowerShell, obtenha os IDs de recursos dos conjuntos de anfitriões aos quais pretende atribuir a aplicação e adicione-os a uma matriz ao executar 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. Assim que tiver os IDs de recursos dos conjuntos de anfitriões, pode atribuir-lhes o pacote de aplicação ao executar os seguintes comandos:

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

3. Para anular a atribuição do pacote de aplicações de todos os conjuntos de anfitriões, pode transmitir uma matriz vazia de conjuntos de anfitriões ao executar os seguintes comandos:

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

Grupos e utilizadores

Eis como atribuir uma aplicação a grupos e utilizadores com o módulo Az.DesktopVirtualization do PowerShell.

1. Obtenha o ID de objeto dos grupos ou utilizadores aos quais pretende adicionar ou remover da aplicação e adicione-os a uma matriz ao utilizar um dos seguintes exemplos. Recomendamos que atribua aplicações a grupos.

   1. Obtenha o ID de objeto do grupo ou grupos e adicione-os a uma matriz ao executar os seguintes comandos. Este exemplo utiliza o nome a apresentar 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 de objeto dos utilizadores e adicione-os a uma matriz ao executar os seguintes comandos. Este exemplo utiliza o nome principal de utilizador (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. Assim que tiver os IDs de objeto dos utilizadores ou grupos, pode adicioná-los ou removê-los da aplicação através de um dos seguintes exemplos, que atribui a função RBAC de Utilizador de Virtualização de Ambiente de Trabalho.

   1. Para adicionar os grupos ou utilizadores à aplicação, 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 utilizadores da aplicação, 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
      }
      

Eis como alterar o tipo e o estado de registo de um pacote com o portal do Azure:

1. Na descrição geral do Azure Virtual Desktop, selecione Anexar Aplicação. Deverá ver uma lista de todos os pacotes existentes no conjunto de anfitriões.

2. Selecione o nome do pacote que pretende alterar.

   1. Para alterar o tipo de registo, selecione A pedido ou Registar-se no início de sessão e, em seguida, selecione Guardar.

   2. Para alterar o estado, selecione Inativo ou Ativo e, em seguida, selecione Guardar.

Eis como alterar o tipo e o estado de registo de um pacote com o módulo Az.DesktopVirtualization do PowerShell.

1. Na mesma sessão do PowerShell, pode alterar o tipo e o estado de registo ao executar os seguintes comandos:

   1. Altere o tipo de registo ao executar o seguinte comando. Defina IsRegularRegistration como $truepara Registar no início de sessão ou $false em A pedido.

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

   2. Altere o estado ao executar o seguinte comando. Defina IsActive como $truepara Ativo ou $falsePara Inativo.

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

Eis como adicionar uma aplicação a partir do pacote que adicionou neste artigo a um grupo de aplicações RemoteApp com o portal do Azure:

1. Na descrição geral do Azure Virtual Desktop, selecione Grupos de aplicações e, em seguida, selecione o grupo de aplicações RemoteApp ao qual pretende adicionar uma aplicação.

2. Selecione Aplicações, selecione + Adicionar. Certifique-se de que tem, pelo menos, um anfitrião de sessão ligado no conjunto de anfitriões ao qual o grupo de aplicações está atribuído.

3. No separador Informações básicas , preencha as seguintes informações:

   Parâmetro	Valor/Descrição
   Fonte do aplicativo	Selecione Anexar Aplicação na lista pendente. Se quiser adicionar aplicações a partir do menu Iniciar ou ao especificar um caminho de ficheiro, veja Publicar aplicações com o RemoteApp.
   Pacote	Selecione um pacote disponível para o conjunto de anfitriões na lista pendente. Os pacotes regionais são provenientes da Anexação de Aplicações.
   Application	Selecione uma aplicação na lista pendente.
   Identificador da aplicação	Introduza um identificador exclusivo para a aplicação.
   Nome de exibição	Introduza um nome amigável para a aplicação que é para os utilizadores.
   Descrição	Introduza uma descrição para a aplicação.

   Depois de concluir este separador, selecione Seguinte.

4. No separador Ícone , selecione Predefinição para utilizar o ícone predefinido da aplicação ou selecione Caminho do ficheiro para utilizar um ícone personalizado. Para Caminho do ficheiro, selecione uma das seguintes opções:

   • Navegue Arquivos do Azure para utilizar um ícone de uma partilha de ficheiros do Azure. Selecione Selecionar uma conta de armazenamento, selecione a conta de armazenamento que contém o seu ficheiro de ícone e, em seguida, selecione Selecionar ficheiro de ícone. Navegue para a partilha de ficheiros e diretório onde se encontra o ícone, marcar a caixa junto ao ícone que pretende adicionar, por exemploMyApp.ico, e, em seguida, selecione Selecionar. Também pode utilizar um .png ficheiro. Para Índice de ícones, especifique o número do índice para o ícone que pretende utilizar. Normalmente, este número é 0.

   • Caminho do ficheiro UNC para utilizar um ícone de uma partilha de ficheiros. Para Caminho do ícone, introduza o caminho UNC para o ficheiro de ícone, por exemplo \\MyFileShare\MyApp.ico. Também pode utilizar um .png ficheiro. Para Índice de ícones, especifique o número do índice para o ícone que pretende utilizar. Normalmente, este número é 0.

   Depois de concluir este separador, selecione Rever + adicionar.

5. No separador Rever + adicionar , certifique-se de que a validação passa e reveja as informações utilizadas para adicionar a aplicação e, em seguida, selecione Adicionar para adicionar a aplicação ao grupo de aplicações RemoteApp.

Eis como adicionar uma aplicação a partir do pacote que adicionou neste artigo a um grupo de aplicações RemoteApp com o módulo Az.DesktopVirtualization do PowerShell.

1. Na mesma sessão do PowerShell, se existirem várias aplicações no pacote, terá de obter o ID da aplicação que pretende adicionar a partir do pacote ao executar 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 o ID da aplicação que pretende publicar (por exemplo, App), em seguida, execute os seguintes comandos para adicionar a aplicação ao grupo de aplicações 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 aplicações no grupo de aplicações ao executar os seguintes comandos:

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

Eis como atualizar um pacote existente com o portal do Azure:

1. Na descrição geral do Azure Virtual Desktop, selecione Anexar Aplicação. Deverá ver uma lista de todos os pacotes existentes.

2. Selecione o pacote que pretende atualizar e, em seguida, na descrição geral, selecione Atualizar.

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

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

   2. Selecione o Conjunto de anfitriões para o qual pretende atualizar o pacote.

   3. Selecione o caminho da imagem em Selecionar na conta de armazenamento ou Introduzir UNC. Os campos subsequentes dependem da opção que selecionar.

      1. Em Selecionar a partir da conta de armazenamento, selecione a Conta de armazenamento que contém a imagem atualizada. Selecione Selecionar um ficheiro e, em seguida, navegue para a partilha de ficheiros e diretório em que a imagem se encontra. Selecione a caixa junto à imagem que pretende adicionar, por exemplo MyApp.cim, e, em seguida, selecione Selecionar.
      2. Para Unc de Entrada, introduza o caminho UNC para o ficheiro de imagem.

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

4. Depois de concluir os campos, selecione Atualizar.

Eis como atualizar um pacote existente com o módulo Az.DesktopVirtualization do PowerShell.

1. Na mesma sessão do PowerShell, obtenha as propriedades da aplicação atualizada e armazene-as numa variável ao executar os seguintes comandos:

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

2. Verifique se tem apenas um objeto nas propriedades da aplicação ao executar os seguintes comandos:

   $app | FL *
   

   Se tiver mais do que um objeto na saída, por exemplo, uma versão x64 e uma versão x86 da mesma aplicação, pode utilizar o parâmetro PackageFullName para especificar qual pretende adicionar ao executar 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 ao executar o seguinte comando. A nova imagem do disco substitui a existente, mas as atribuições existentes são mantidas. Não elimine a imagem existente até que os utilizadores a tenham deixado de utilizar.

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

Eis como remover um pacote anexar a aplicação com o portal do Azure:

1. Na descrição geral do Azure Virtual Desktop, selecione Anexar Aplicação. Deverá ver uma lista de todos os pacotes existentes.

2. Selecione a caixa junto ao nome do pacote que pretende remover e, em seguida, selecione Remover. O pacote também é removido de todos os conjuntos de anfitriões a que está atribuído.

Eis como remover um pacote anexar a aplicação com 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 uma aplicação:

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