Definir propriedades personalizadas do Protocolo de Área de Trabalho Remota (RDP) em um pool de hosts na Área de Trabalho Virtual do Azure

Quando os utilizadores iniciam sessão na Aplicação Windows ou na aplicação Ambiente de Trabalho Remoto, são apresentados os ambientes de trabalho e as aplicações a que têm acesso. Para cada área de trabalho e aplicativo, há um arquivo correspondente .rdp que contém todas as propriedades de conexão a serem usadas ao se conectar a uma sessão remota pelo protocolo RDP (Remote Desktop Protocol). Essas propriedades RDP são definidas por pool de hosts.

Cada pool de hosts tem um conjunto de propriedades e valores RDP padrão. Você pode adicionar outras propriedades ao conjunto padrão ou substituir os valores padrão definindo propriedades RDP personalizadas. Este artigo mostra como definir propriedades RDP personalizadas em um pool de hosts usando o portal do Azure, o Azure PowerShell e a CLI do Azure.

Propriedades RDP do pool de hosts padrão

Os pools de hosts têm as seguintes propriedades e valores RDP por padrão:

Propriedade RDP	Detalhes
audiomode:i:0	Determina se a máquina local ou remota reproduz áudio.
devicestoredirect:s:*	Determina quais periféricos que usam o MTP (Media Transfer Protocol) ou o PTP (Picture Transfer Protocol), como uma câmera digital, são redirecionados de um dispositivo Windows local para uma sessão remota.
drivestoredirect:s:*	Determina quais unidades fixas, removíveis e de rede no dispositivo local serão redirecionadas e estarão disponíveis em uma sessão remota.
enablecredsspsupport:i:1	Determina se o cliente usará o CredSSP (Credential Security Support Provider) para autenticação, se estiver disponível.
redirectclipboard:i:1	Determina se a área de transferência deve ser redirecionada.
redirectcomports:i:1	Determina se as portas serial ou COM no dispositivo local são redirecionadas para uma sessão remota.
redirectprinters:i:1	Determina se as impressoras disponíveis no dispositivo local são redirecionadas para uma sessão remota.
redirectsmartcards:i:1	Determina se os dispositivos de cartão inteligente no dispositivo local serão redirecionados e estarão disponíveis em uma sessão remota.
redirectwebauthn:i:1	Determina se as solicitações WebAuthn de uma sessão remota são redirecionadas para o dispositivo local, permitindo o uso de autenticadores locais (como o Windows Hello for Business e chaves de segurança).
usbdevicestoredirect:s:*	Determina quais dispositivos USB suportados no computador cliente são redirecionados usando o redirecionamento opaco de baixo nível para uma sessão remota.
use multimon:i:1	Determina se a sessão remota usará um ou vários monitores do dispositivo local.
videoplaybackmode:i:1	Determina se a conexão usará streaming multimídia eficiente em RDP para reprodução de vídeo.

Para obter uma lista completa de propriedades e valores suportados, consulte Propriedades RDP suportadas com o Ambiente de Trabalho Virtual do Azure

Gorjeta

Para saber mais sobre como redirecionar periféricos e recursos, consulte Redirecionamento de periféricos e recursos pelo Protocolo de Área de Trabalho Remota. Talvez seja necessário configurar mais do que apenas uma propriedade RDP.

Pré-requisitos

Antes de definir propriedades RDP personalizadas em um pool de hosts, você precisa:

• Um pool de hosts existente.

• Uma conta do Azure atribuída à função de Colaborador do Pool de Hosts da Virtualização de Área de Trabalho ou equivalente.

• Se você quiser usar a CLI do Azure ou o Azure PowerShell localmente, consulte 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 de virtualização de área de trabalho ou o módulo do PowerShell Az.DesktopVirtualization instalado. Como alternativa, use o Azure Cloud Shell.

Configurar propriedades RDP personalizadas

Selecione a guia relevante para o seu cenário.

Portal do Azure

Veja como configurar as propriedades RDP usando o portal do Azure. Para obter uma lista completa de propriedades e valores suportados, consulte Propriedades RDP suportadas com o Ambiente de Trabalho Virtual do Azure.

1. Inicie sessão 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 hosts e, em seguida, selecione o nome do pool de hosts que você deseja atualizar.

4. Selecione Propriedades do RDP e, em seguida, selecione a guia Avançado.

   

5. Adicione propriedades RDP extras ou faça alterações nas propriedades RDP existentes em um formato separado por ponto-e-vírgula, como os valores padrão já mostrados.

6. Quando terminar, selecione Salvar para salvar as alterações. Os usuários precisam atualizar seus recursos para receber as alterações.

Azure PowerShell

Para configurar as propriedades RDP usando o Azure PowerShell, use os exemplos a seguir. Certifique-se de alterar os valores para o <placeholder> seu próprio. Para obter uma lista completa de propriedades e valores suportados, consulte Propriedades RDP suportadas com o Ambiente de Trabalho Virtual do Azure.

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 o Cloud Shell, certifique-se de que o seu contexto do Azure está definido para a subscrição que pretende utilizar.

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

2. Use um dos seguintes exemplos com base em suas necessidades:

   • Para adicionar propriedades RDP personalizadas a um pool de hosts e manter todas as propriedades personalizadas existentes já definidas, execute os seguintes comandos. As propriedades RDP precisam ser escritas em um formato separado por ponto-e-vírgula. Este exemplo adiciona a desativação da área de transferência e do redirecionamento da impressora:

     $hostPool = "<HostPoolName>"
     $resourceGroup = "<ResourceGroupName>"
     $addCustomProperties = "redirectclipboard:i:0;redirectprinters:i:0"
     
     $currentCustomProperties = (Get-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup).CustomRdpProperty
     $customProperties = $currentCustomProperties + $addCustomProperties
     
     Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
     

   • Para substituir todas as propriedades personalizadas existentes por um novo conjunto de propriedades RDP personalizadas, execute o seguinte comando. Este exemplo define apenas a desativação da área de transferência e o redirecionamento da impressora:

     $hostPool = "<HostPoolName>"
     $resourceGroup = "<ResourceGroupName>"
     $customProperties = "redirectclipboard:i:0;redirectprinters:i:0"
     
     Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
     

   • Para remover todas as propriedades RDP personalizadas de um pool de hosts, execute o seguinte comando. Este exemplo passa uma cadeia de caracteres vazia para o CustomRdpProperty parâmetro:

     $hostPool = "<HostPoolName>"
     $resourceGroup = "<ResourceGroupName>"
     $customProperties = ""
     
     Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
     

3. Verifique as propriedades RDP personalizadas definidas no mesmo pool de hosts executando o seguinte comando:

   Get-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup | FT Name, CustomRdpProperty
   

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

    Name              : contoso-hp01
    CustomRdpProperty : use multimon:i:1;redirectclipboard:i:0;redirectprinters:i:0;
   

4. Os usuários precisam atualizar seus recursos para receber as alterações.

CLI do Azure

Para configurar as propriedades RDP usando a CLI do Azure, use os exemplos a seguir. Certifique-se de alterar os valores para o <placeholder> seu próprio. Para obter uma lista completa de propriedades e valores suportados, consulte Propriedades RDP suportadas com o Ambiente de Trabalho Virtual do Azure.

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

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

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

2. Use um dos seguintes exemplos com base em suas necessidades:

   • Para adicionar propriedades RDP personalizadas a um pool de hosts e manter todas as propriedades personalizadas existentes já definidas, execute os seguintes comandos. As propriedades RDP precisam ser escritas em um formato separado por ponto-e-vírgula. Este exemplo adiciona a desativação da área de transferência e o redirecionamento da impressora às propriedades personalizadas existentes:

     hostPool="<HostPoolName>"
     resourceGroup="<ResourceGroupName>"
     addCustomProperties="redirectclipboard:i:0;redirectprinters:i:0"
     
     currentCustomProperties=$(az desktopvirtualization hostpool show \
          --name $hostPool \
          --resource-group $resourceGroup \
          --query [customRdpProperty] \
          --output tsv)
     
     customProperties="$currentCustomProperties$addCustomProperties"
     
     az desktopvirtualization hostpool update \
          --name $hostPool \
          --resource-group $resourceGroup \
          --custom-rdp-property "$customProperties"
     

   • Para substituir todas as propriedades personalizadas existentes por um novo conjunto de propriedades RDP personalizadas, execute o seguinte comando. Este exemplo define apenas a desativação da área de transferência e o redirecionamento da impressora:

     hostPool="<HostPoolName>"
     resourceGroup="<ResourceGroupName>"
     
     az desktopvirtualization hostpool update \
          --name $hostPool \
          --resource-group $resourceGroup \
          --custom-rdp-property "redirectclipboard:i:0;redirectprinters:i:0"
     

   • Para remover todas as propriedades RDP personalizadas de um pool de hosts, execute o seguinte comando. Este exemplo passa uma cadeia de caracteres vazia para o --custom-rdp-property parâmetro:

     hostPool="<HostPoolName>"
     resourceGroup="<ResourceGroupName>"
     
     az desktopvirtualization hostpool update \
          --name $hostPool \
          --resource-group $resourceGroup \
          --custom-rdp-property ""
     

3. Verifique as propriedades RDP personalizadas definidas no mesmo pool de hosts executando o seguinte comando:

   az desktopvirtualization hostpool show \
       --name $hostPool \
       --resource-group $resourceGroup \
       --query "{name:name, customRdpProperty:customRdpProperty}" \
       --output table
   

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

   Name          CustomRdpProperty
   --------      ------------------------------------------------------------
   contoso-hp01  use multimon:i:0;redirectclipboard:i:0;redirectprinters:i:0;
   

4. Os usuários precisam atualizar seus recursos para receber as alterações.

Conteúdos relacionados

• Propriedades RDP suportadas com o Ambiente de Trabalho Virtual do Azure
• Redirecionamento de periféricos e recursos através do Protocolo de Área de Trabalho Remota