Configurar atribuição da área de trabalho pessoal

Importante

Este conteúdo se aplica à Área de Trabalho Virtual do Azure com objetos do Azure Resource Manager. Se você estiver usando a Área de Trabalho Virtual do Azure (clássica) sem objetos do Azure Resource Manager, confira este artigo.

Um pool de host pessoal é aquele que possui áreas de trabalho pessoais. As áreas de trabalho pessoais possuem mapeamento um para um, o que significa que um usuário único só pode ser atribuído a uma única área de trabalho pessoal. Sempre que o usuário entra, sua sessão de usuário é direcionada para o host da sessão de área de trabalho pessoal atribuída. Esse tipo de pool de host é ideal para clientes com cargas de trabalho com uso intensivo de recursos, pois a experiência do usuário e o desempenho da sessão irão melhorar se houver apenas uma sessão no host da sessão. Outro benefício desse tipo de pool de host é que as atividades, os arquivos e as configurações do usuário permanecem no disco do sistema operacional da máquina virtual (VM OS) após o usuário sair.

Os usuários devem ser atribuídos a uma área de trabalho pessoal para iniciar a sessão. Você pode configurar o tipo de atribuição de seu pool de hosts de área de trabalho pessoal para ajustar o ambiente da Área de Trabalho Virtual do Azure de forma a atender melhor as suas necessidades. Neste tópico, mostraremos como configurar a atribuição automática ou direta para seus usuários.

Observação

As instruções deste artigo se aplicam somente a pools de hosts da área de trabalho pessoal, e não a pools de hosts em pool, já que os usuários em pools de hosts em pool não são atribuídos a hosts de sessão específicos.

Pré-requisitos

Se você estiver usando o portal do Azure ou o método do PowerShell, precisará das seguintes coisas:

• Um pool de host pessoal com pelo menos um host da sessão.
• Uma conta do Azure com a função Colaborador de Virtualização de Área de Trabalho atribuída.
• Se você quiser usar a CLI do Azure ou o Azure PowerShell localmente, confira Usar a CLI do Azure e o Azure PowerShell com a Área de Trabalho Virtual do Azure para garantir que você tenha a extensão da CLI do Azure desktopvirtualization ou o módulo Az.DesktopVirtualization do PowerShell instalado. Como alternativa, use o Azure Cloud Shell.

Se você estiver atribuindo áreas de trabalho com o PowerShell, precisará baixar e instalar o módulo do PowerShell da Área de Trabalho Virtual do Azure , caso ainda não tenha feito isso.

Configurar a atribuição automática

A atribuição automática atribui aos usuários uma área de trabalho pessoal na primeira vez que eles se conectam. É o tipo de atribuição padrão para novos pools de hosts de área de trabalho pessoal que você cria em seu ambiente da Área de Trabalho Virtual do Azure. A atribuição automática de usuários não exige um host de sessão específico.

Para atribuir usuários automaticamente, primeiro atribua-os ao pool de hosts da área de trabalho pessoal para que eles possam ver a área de trabalho no próprio feed. Quando um usuário atribuído inicializar a área de trabalho no feed, a sessão de usuário terá balanceamento de carga para um host da sessão disponível se eles ainda não estiverem conectados ao pool de host. Você ainda pode atribuir um usuário diretamente a um host de sessão antes que ele se conecte, mesmo que o tipo de atribuição seja definido como automático.

Azure portal

Para configurar a atribuição automática no portal do Azure:

1. Entre no portal do Azure.

2. Na barra de pesquisa, insira Área de Trabalho Virtual do Azure e selecione a entrada de serviço correspondente.

3. Selecione Pools de host e, em seguida, selecione o pool de host pessoal que você deseja configurar a atribuição automática.

4. Em seguida, selecione Propriedades, vá para o menu suspenso Atribuição e selecione Automático.

5. Selecione Salvar.

PowerShell do Azure

Veja como configurar um pool de hosts para atribuir automaticamente usuários a VMs usando o módulo Az.DesktopVirtualization do PowerShell. 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. Execute o comando no seguinte exemplo para configurar um pool de hosts para atribuir automaticamente usuários a hosts de sessão:

   Update-AzWvdHostPool -ResourceGroupName <ResourceGroupName> -Name <HostPoolName> -PersonalDesktopAssignmentType Automatic
   

CLI do Azure

Veja como configurar um pool de hosts para atribuir automaticamente usuários a VMs usando o comando 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 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. Execute o comando no seguinte exemplo para configurar um pool de hosts para atribuir automaticamente usuários a hosts de sessão:

   az desktopvirtualization hostpool update \
       --resource-group <ResourceGroupName> \
       --name <HostPoolName> \
       --personal-desktop-assignment-type Automatic
   

Configurar a atribuição direta

Ao contrário da atribuição automática, quando você usa a atribuição direta, você atribui uma área de trabalho pessoal específica a um usuário primeiro. Você deve atribuir o usuário ao pool de hosts da área de trabalho pessoal e a um host de sessão específico antes que ele possa se conectar à área de trabalho pessoal. Se o usuário for atribuído apenas a um pool de hosts sem uma atribuição de host de sessão, ele não conseguirá acessar os recursos e verá a mensagem de erro Não há recursos disponíveis.

Azure portal

Para configurar a atribuição direta no 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.

3. Selecione Pools de host e, em seguida, selecione o pool de host pessoal que você deseja configurar a atribuição automática.

4. Em seguida, selecione Propriedades, vá para o menu suspenso Atribuição e selecione Direto.

5. Selecione Salvar.

PowerShell do Azure

Veja como configurar um pool de hosts para exigir a atribuição direta de usuários para hosts de sessão usando o módulo Az.DesktopVirtualization do PowerShell. 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. Execute o comando no seguinte exemplo para configurar um pool de hosts para exigir atribuição direta:

   Update-AzWvdHostPool -ResourceGroupName <ResourceGroupName> -Name <HostPoolName> -PersonalDesktopAssignmentType Direct
   

CLI do Azure

Veja como configurar um pool de hosts para atribuir automaticamente usuários a VMs usando o comando 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 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. Execute o comando no seguinte exemplo para configurar um pool de hosts para atribuir automaticamente usuários a hosts de sessão:

   az desktopvirtualization hostpool update \
       --resource-group <ResourceGroupName> \
       --name <HostPoolName> \
       --personal-desktop-assignment-type Direct
   

Atribuir diretamente usuários a um host da sessão

Veja como atribuir usuários diretamente a hosts de sessão usando o portal do Azure ou o Azure PowerShell. Você não pode atribuir usuários a hosts de sessão usando a CLI do Azure.

Azure portal

Para atribuir diretamente um usuário a um host de sessão no portal do Azure:

1. Entre no portal do Azure.

2. Insira Área de Trabalho Virtual do Azure na barra de pesquisa.

3. Em Serviços, selecione Área de Trabalho Virtual do Azure.

4. Na página da Área de Trabalho Virtual do Azure, acesse o menu no lado esquerdo da janela e selecione Pools de hosts.

5. Selecione o pool de hosts ao qual você deseja atribuir usuários.

6. Em seguida, vá para o menu no lado esquerdo da janela e selecione grupos de aplicativos.

7. Selecione o nome do grupo de aplicativos ao qual você deseja atribuir usuários e, em seguida, selecione Atribuições no menu no lado esquerdo da janela.

8. Selecione + Adicionar e, em seguida, selecione os usuários ou grupos de usuários que você deseja atribuir a este grupo de aplicativos.

9. Selecione atribuir VM na barra de informações para atribuir um host de sessão a um usuário.

10. Selecione o host de sessão que você deseja atribuir ao usuário e, em seguida, selecione atribuir. Atribuição>Atribuir usuário também pode ser selecionado.

11. Selecione o usuário ao qual você deseja atribuir o host de sessão da lista de usuários disponíveis.

12. Ao concluir, selecione Selecionar.

PowerShell do Azure

Veja como configurar um pool de hosts para atribuir um usuário a um host de sessão específico usando o módulo Az.DesktopVirtualization do PowerShell. 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. Execute o comando Update-AzWvdHostPool no exemplo a seguir para atribuir um usuário a um host de sessão. Para obter mais informações sobre os parâmetros, consulte a referência do Update-AzWvdHostPool.

   Update-AzWvdSessionHost -HostPoolName <HostPoolName> -Name <SessionHostName> -ResourceGroupName <ResourceGroupName> -AssignedUser <UserUPN>
   

Cancelar uma atribuição de uma área de trabalho pessoal

Veja como cancelar a atribuição de uma área de trabalho pessoal usando o portal do Azure ou o Azure PowerShell. Não é possível cancelar a atribuição de uma área de trabalho pessoal usando a CLI do Azure.

Azure portal

Para cancelar a atribuição de uma área de trabalho pessoal no portal do Azure:

1. Entre no portal do Azure.

2. Insira Área de Trabalho Virtual do Azure na barra de pesquisa.

3. Em Serviços, selecione Área de Trabalho Virtual do Azure.

4. Na página da Área de Trabalho Virtual do Azure, acesse o menu no lado esquerdo da janela e selecione Pools de hosts.

5. Selecione o pool de host para o qual você deseja modificar a atribuição de usuário.

6. Em seguida, vá para o menu no lado esquerdo da janela e selecione Hosts da sessão.

7. Marque a caixa de seleção ao lado do host da sessão para o qual você deseja cancelar a atribuição de um usuário, selecione as reticências no final da linha e, em seguida, selecione Cancelar a atribuição do usuário. Atribuição>Cancelar a atribuição do usuário também pode ser selecionado.

   

   

8. Selecione Cancelar a atribuição quando solicitado.

PowerShell do Azure

Veja como configurar um pool de hosts para cancelar a atribuição de uma área de trabalho pessoal. 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. Execute o comando Invoke-AzRestMethod no exemplo a seguir para cancelar a atribuição de uma área de trabalho pessoal. Para obter mais informações sobre os parâmetros, consulte a referência do Invoke-AzRestMethod.

   $unassignDesktopParams = @{
     Path = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DesktopVirtualization/hostPools/$hostPoolName/sessionHosts/$($sessionHostName)?api-version=2022-02-10-preview&force=true"
     Payload = @{
       properties = @{
         assignedUser = ''
       }} | ConvertTo-Json
     Method = 'PATCH'
   }
   Invoke-AzRestMethod @unassignDesktopParams
   

Reatribuir uma área de trabalho pessoal

Veja como reatribuir uma área de trabalho pessoal usando o portal do Azure ou o PowerShell. Você não pode reatribuir uma área de trabalho pessoal usando a CLI do Azure.

Azure portal

Para reatribuir uma área de trabalho pessoal no portal do Azure:

1. Entre no portal do Azure.

2. Insira Área de Trabalho Virtual do Azure na barra de pesquisa.

3. Em Serviços, selecione Área de Trabalho Virtual do Azure.

4. Na página da Área de Trabalho Virtual do Azure, acesse o menu no lado esquerdo da janela e selecione Pools de hosts.

5. Selecione o pool de host para o qual você deseja modificar a atribuição de usuário.

6. Em seguida, vá para o menu no lado esquerdo da janela e selecione Hosts da sessão.

7. Marque a caixa de seleção ao lado do host da sessão que você deseja reatribuir a um usuário diferente, selecione as reticências no final da linha e, em seguida, selecione Atribuir a um usuário diferente. Atribuição>Atribuir a um usuário diferente também pode ser selecionado.

   

   

8. Selecione o usuário ao qual você deseja atribuir o host de sessão da lista de usuários disponíveis.

9. Ao concluir, selecione Selecionar.

PowerShell do Azure

Veja como reatribuir uma área de trabalho pessoal usando o módulo Az.DesktopVirtualization do PowerShell. 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. Execute o seguinte comando para definir a variável $reassignUserUpn:

   $reassignUserUpn = <UPN of user you are reassigning the desktop to>
   

3. Execute o comando Invoke-AzRestMethod no exemplo a seguir para reatribuir uma área de trabalho pessoal. Para obter mais informações sobre os parâmetros, consulte a referência do Invoke-AzRestMethod.

   $reassignDesktopParams = @{
     Path = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DesktopVirtualization/hostPools/$hostPoolName/sessionHosts/$($sessionHostName)?api-version=2022-02-10-preview&force=true"
     Payload = @{
       properties = @{
         assigneduser = $reassignUserUpn
       }} | ConvertTo-Json
     Method = 'PATCH'
   }
   Invoke-AzRestMethod @reassignDesktopParams
   

Dê um nome amigável aos hosts da sessão em um pool de hosts pessoais

Você pode dar às áreas de trabalho pessoais que você cria nomes amigáveis para ajudar os usuários a distingui-las em seus feeds. No momento, o portal do Azure não é capaz de dar nomes amigáveis ao host da sessão.

1. Inicie o 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 estiver usando a CLI do o PowerShell localmente, primeiro Entre com o Azure PowerShell e verifique se o contexto do Azure está definido como a assinatura que você deseja usar.

2. Execute o seguinte comando no PowerShell para adicionar ou alterar o nome amigável de um host de sessão:

   $parameters = @{
      HostPoolName = 'HostPoolName'
      Name = 'SessionHostName'
      ResourceGroupName = 'ResourceGroupName'
      FriendlyName = 'SessionHostFriendlyName'
   }
   
   Update-AzWvdSessionHost @parameters
   

3. Para obter o nome amigável do host da sessão, execute o seguinte comando no PowerShell:

   $sessionHostParams = @{
      HostPoolName = 'HostPoolName'
      Name = 'SessionHostName'
      ResourceGroupName = 'ResourceGroupName'
   }
   
   Get-AzWvdSessionHost @sessionHostParams | FL Name, AssignedUser, FriendlyName
   

Próximas etapas

Agora que você configurou o tipo de atribuição de área de trabalho pessoal e deu um nome amigável ao host da sessão, você pode entrar em um cliente da Área de Trabalho Virtual do Azure para testá-lo como parte de uma sessão do usuário. Esses artigos mostrarão como se conectar a uma sessão usando o cliente de sua escolha:

• Conectar-se ao cliente da Área de Trabalho do Windows
• Conectar-se ao cliente Web
• Conectar-se ao cliente Android
• Conectar-se ao cliente iOS
• Conectar-se ao cliente macOS