Atribuir funções do Azure RBAC ou funções do Microsoft Entra às entidades de serviços da Área de Trabalho Virtual do Azure

Vários recursos da Área de Trabalho Virtual do Azure exigem que você atribua funções de controle de acesso baseado em função do Azure (RBAC do Azure) ou funções do Microsoft Entra a uma das entidades de serviço da Área de Trabalho Virtual do Azure. Os recursos que você precisa para atribuir uma função a uma entidade de serviço da Área de Trabalho Virtual do Azure incluem:

• Anexação de aplicativo (ao usar os Arquivos do Azure e seus hosts de sessão ingressados ao Microsoft Entra ID).
• Dimensionamento automático.
• Atualização do host da sessão
• Iniciar VM ao Conectar.

Dica

Você pode localizar qual função ou funções você precisa atribuir a qual entidade de serviço no artigo de cada recurso. Para ver uma lista de todas as funções do RBAC do Azure disponíveis e criadas especificamente para a Área de Trabalho Virtual do Azure, consulte Funções de RBAC internas do Azure para a Área de Trabalho Virtual do Azure. Para saber mais sobre o RBAC do Azure, consulte Documentação do RBAC do Azure ou para funções do Microsoft Entra, consulte documentação de funções do Microsoft Entra.

Dependendo de quando você registrou o provedor de recursos Microsoft.DesktopVirtualization, os nomes das entidades de serviço começam com Área de Trabalho Virtual do Azure ou Área de Trabalho Virtual do Windows. Se você usou tanto a Área de Trabalho Virtual do Azure Clássico quanto a Área de Trabalho Virtual do Azure (Azure Resource Manager), você verá aplicativos com o mesmo nome. Você pode garantir de que está atribuindo funções à entidade de serviço correta verificando o ID do aplicativo. A ID do aplicativo para cada entidade de serviço está na tabela a seguir:

Entidade de serviço	Application ID
Azure Virtual Desktop Windows Virtual Desktop	9cdead84-a844-4324-93f2-b2e6bb768d07
Azure Virtual Desktop Client Windows Virtual Desktop Client	a85cf173-4192-42f8-81fa-777a763e6e2c
Azure Virtual Desktop ARM Provider Windows Virtual Desktop ARM Provider	50e95039-b200-4007-bc97-8d5790743a63

Este artigo mostra como você atribui as funções de RBAC do Azure ou do Microsoft Entra às entidades de serviço corretas da Área de Trabalho Virtual do Azure usando o portal do Azure, a CLI do Azure ou o Azure PowerShell.

Pré-requisitos

Antes de você poder atribuir uma função a uma entidade de serviço da Área de Trabalho Virtual do Azure, você precisa atender aos seguintes pré-requisitos:

• Para atribuir as funções do RBAC do Azure, você deve ter a permissão Microsoft.Authorization/roleAssignments/write para uma assinatura do Azure para atribuir funções nessa assinatura. Essa permissão deve ser parte das funções internas Proprietário ou Administrador de Acesso do Usuário.

• Para atribuir as funções do Microsoft Entra, é necessário ter a função de Administrador com função com privilégios ou Administrador global.

• Se você quiser usar o Azure PowerShell ou a CLI do Azure localmente, consulte Usar a CLI do Azure e o Azure PowerShell com a Área de Trabalho Virtual do Azure para garantir que você tenha o módulo do PowerShell Az.DesktopVirtualization ou a extensão da CLI do Azure desktopvirtualization instalados. Como alternativa, use o Azure Cloud Shell.

Atribuir uma função do RBAC do Azure a uma entidade de serviço da Área de Trabalho Virtual do Azure

Para atribuir uma função RBAC do Azure a uma entidade de serviço da Área de Trabalho Virtual do Azure, selecione a guia relevante para seu cenário e siga as etapas. Nesses exemplos, o escopo da atribuição de função é uma assinatura do Azure, mas você precisa usar o escopo e a função exigidos por cada recurso.

Azure portal

Veja como atribuir uma função RBAC do Azure a uma entidade de serviço da Área de Trabalho Virtual do Azure com escopo para uma assinatura usando o portal do Azure.

1. Entre no portal do Azure.

2. Na caixa de pesquisa, insira Microsoft Entra ID e selecione a entrada de serviço correspondente.

3. Na página Visão geral, na caixa de pesquisa Pesquise seu locatário, digite o ID do aplicativo da entidade de serviço que você deseja atribuir na tabela anterior.

4. Nos resultados, selecione o aplicativo empresarial correspondente para a entidade de serviço que você deseja atribuir, iniciando com a Área de Trabalho Virtual do Azure ou Área de Trabalho Virtual do Windows.

5. Em propriedades, anote o nome e a ID do objeto. A ID do objeto correlaciona-se à ID do aplicativo e é exclusiva do seu locatário.

6. Na caixa de pesquisa, insira Assinaturas e selecione a entrada de serviço correspondente.

7. Selecione a assinatura à qual você deseja adicionar a atribuição de função.

8. Selecione Controle de acesso (IAM) e escolha + Adicionar seguido por Adicionar atribuição de função.

9. Selecione a função que você deseja atribuir à entidade de serviço da Área de Trabalho Virtual do Azure e selecione Avançar.

10. Certifique-se de que Atribuir acesso a esteja definido como Usuário, grupo ou entidade de serviço do Microsoft Entra e selecione Selecionar membros.

11. Insira o nome do aplicativo empresarial que você anotou anteriormente.

12. Selecione a entrada correspondente nos resultados e selecione Selecionar. Se houver duas entradas com o mesmo nome, selecione ambas por enquanto.

13. Examine a lista de membros na tabela. Se você tiver duas entradas, remova a entrada que não corresponde à ID do objeto que você anotou anteriormente.

14. Selecione Próximo e depois selecione Examinar + atribuir para concluir a operação de atribuição de função.

PowerShell do Azure

Veja como atribuir uma função RBAC do Azure a uma entidade de serviço da Área de Trabalho Virtual do Azure com escopo para uma assinatura usando o módulo do PowerShell Az.DesktopVirtualization.

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. Localize o ID da assinatura à qual você deseja adicionar a atribuição de função listando tudo o que está disponível para você com o seguinte comando:

   Get-AzSubscription
   

3. Armazene a ID da assinatura em uma variável executando o seguinte comando, substituindo a ID da assinatura neste exemplo pela sua própria:

   $subId = "<SubscriptionID>"
   

4. Atribua a função a uma entidade de serviço da Área de Trabalho Virtual do Azure executando o seguinte comando, substituindo o valor do parâmetro RoleDefinitionName pelo nome da função que você precisa atribuir e o parâmetro ApplicationId pelo ID do aplicativo da entidade de serviço que você deseja atribuir da tabela anterior. Este exemplo atribui a função de Colaborador de Ligação e Desligamento da Virtualização da Área de Trabalho à entidade de serviço Área de Trabalho Virtual do Azure na assinatura:

   $parameters = @{
       RoleDefinitionName = "Desktop Virtualization Power On Off Contributor"
       ApplicationId = "9cdead84-a844-4324-93f2-b2e6bb768d07"
       Scope = "/subscriptions/$subId"
   }
   
   New-AzRoleAssignment @parameters
   

   Sua saída deve ser semelhante ao exemplo a seguir:

   RoleAssignmentName : c5221262-d1fa-4d32-9d60-8bd86f618d20
   RoleAssignmentId   : /subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Authorization/roleAssignments/c5221262-d1fa-4d32-9d60-8bd86f618d20
   Scope              : /subscriptions/00000000-0000-0000-0000-000000000000
   DisplayName        : Azure Virtual Desktop
   SignInName         : 
   RoleDefinitionName : Desktop Virtualization Power On Off Contributor
   RoleDefinitionId   : 40c5ff49-9181-41f8-ae61-143b0e78555e
   ObjectId           : 00000000-0000-0000-0000-000000000000
   ObjectType         : ServicePrincipal
   CanDelegate        : False
   Description        : 
   ConditionVersion   : 
   Condition          :
   

CLI do Azure

Veja como atribuir uma função RBAC do Azure a uma entidade de serviço da Área de Trabalho Virtual do Azure com escopo para uma assinatura usando uma extensão desktopvirtualization para CLI do Azure.

1. Abra o Azure Cloud Shell no portal do Azure com o tipo de terminal Bash ou execute a CLI do Azure 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 você estiver usando a CLI do Azure localmente, primeiro conecte-se com a CLI do Azure e, em seguida, certifique-se de que seu contexto do Azure está definido para a assinatura que você deseja usar.

2. Localize o ID da assinatura à qual você deseja adicionar a atribuição de função listando tudo o que está disponível para você com o seguinte comando:

   az account list --output table
   

3. Armazene o valor de SubscriptionId em uma variável executando o seguinte comando, substituindo a ID da assinatura neste exemplo pela sua própria:

   subId=00000000-0000-0000-0000-000000000000
   

4. Atribua a função a uma entidade de serviço da Área de Trabalho Virtual do Azure executando o seguinte comando, substituindo o valor do parâmetro role pelo nome da função que você precisa atribuir e o parâmetro assignee pelo ID do aplicativo da entidade de serviço que você deseja atribuir da tabela anterior. Este exemplo atribui a função de Colaborador de Ligação e Desligamento da Virtualização da Área de Trabalho à entidade de serviço Área de Trabalho Virtual do Azure na assinatura:

   az role assignment create \
       --assignee "9cdead84-a844-4324-93f2-b2e6bb768d07" \
       --role "Desktop Virtualization Power On Off Contributor" \
       --scope "/subscriptions/$subId"
   

   Sua saída deve ser semelhante ao exemplo a seguir:

   {
     "condition": null,
     "conditionVersion": null,
     "createdBy": null,
     "createdOn": "2023-06-22T13:50:22.978226+00:00",
     "delegatedManagedIdentityResourceId": null,
     "description": null,
     "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Authorization/roleAssignments/a211100e-aa52-4f8d-aac9-ad0833f969d0",
     "name": "a211100e-aa52-4f8d-aac9-ad0833f969d0",
     "principalId": "00000000-0000-0000-0000-000000000000",
     "principalType": "ServicePrincipal",
     "roleDefinitionId": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Authorization/roleDefinitions/40c5ff49-9181-41f8-ae61-143b0e78555e",
     "scope": "/subscriptions/00000000-0000-0000-0000-000000000000",
     "type": "Microsoft.Authorization/roleAssignments",
     "updatedBy": "effe20b0-5afb-4e68-a5d7-f8ef9873a070",
     "updatedOn": "2023-06-22T13:50:23.335229+00:00"
   }
   

Atribuir uma função do Microsoft Entra a uma entidade de serviço da Área de Trabalho Virtual do Azure

Para atribuir uma função do Microsoft Entra a uma entidade de serviço da Área de Trabalho Virtual do Azure, selecione a guia relevante para o seu cenário e siga as etapas. Nesses exemplos, o escopo da atribuição de função é uma assinatura do Azure, mas você precisa usar o escopo e a função exigidos por cada recurso.

Veja como atribuir uma função do Microsoft a uma entidade de serviço da Área de Trabalho Virtual do Azure com escopo para um locatário usando o portal do Azure.

1. Entre no portal do Azure.

2. Na caixa de pesquisa, insira Microsoft Entra ID e selecione a entrada de serviço correspondente.

3. Selecione Funções e administradores.

4. Pesquise e selecione o nome da função que você deseja atribuir. Se você quiser atribuir uma função personalizada, consulte Criar uma função personalizada para criá-la primeiro.

5. Selecione Adicionar atribuições.

6. Na caixa de pesquisa Pesquise seu locatário, digite o ID do aplicativo da entidade de serviço que você deseja atribuir na tabela anterior, por exemplo 9cdead84-a844-4324-93f2-b2e6bb768d07.

7. Marque a caixa ao lado da entrada correspondente e selecione Adicionar para concluir a atribuição de função.

Próximas etapas

Saiba mais sobre as funções internas do RBAC do Azure para a Área de Trabalho Virtual do Azure.