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

Artigo
10/16/2024

Quando os usuários entram no Aplicativo do Windows ou no aplicativo da Área de Trabalho Remota, as áreas de trabalho e os aplicativos aos quais eles têm acesso são mostrados. Para cada área de trabalho e aplicativo, há um arquivo .rdp correspondente que contém todas as propriedades de conexão a serem usadas ao se conectar a uma sessão remota pelo PROTOCOLO RDP (Protocolo de Área de Trabalho Remota). Essas propriedades do RDP são definidas por pool de host.

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

Propriedades de RDP do pool de host padrão

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

Propriedade do RDP	Detalhes
`audiomode:i:0`	Determina se o computador local ou remoto reproduz áudio.
`devicestoredirect:s:*`	Determina quais periféricos que usam o PROTOCOLO 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 disponíveis em uma sessão remota.
`enablecredsspsupport:i:1`	Determina se o cliente usará o CredSSP (Provedor de Suporte de Segurança de Credencial) para a autenticação, se ele 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 para Empresas e chaves de segurança).
`usbdevicestoredirect:s:*`	Determina quais dispositivos USB compatíveis 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á uma ou várias exibições do dispositivo local.
`videoplaybackmode:i:1`	Determina se a conexão usará o streaming multimídia eficiente do RDP para reprodução de vídeo.

Para obter uma lista completa de propriedades e valores com suporte, consulte Propriedades RDP compatíveis com a Área de Trabalho Virtual do Azure

Dica

Para saber mais sobre como redirecionar periféricos e recursos, consulte Periférico e redirecionamento de 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 host, você precisa:

Um pool de host existente.
Uma conta do Azure com atribuída à função Colaborador do Pool de Hosts de Virtualização de Área de Trabalho ou equivalente.
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.

Configurar propriedades personalizadas de RDP

Selecione a guia relevante ao seu cenário.

Aqui está como configurar propriedades RDP usando o portal do Azure. Para obter uma lista completa de propriedades e valores com suporte, consulte Propriedades RDP compatíveis com a Área de Trabalho Virtual do Azure.

Entre no portal do Azure.
Na barra de pesquisa, insira Área de Trabalho Virtual do Azure e selecione a entrada de serviço correspondente.
Selecione Pools de host e, em seguida, selecione o nome do pool de host que você deseja atualizar.
Selecione Propriedades RDP e, em seguida, a guia Avançado.
Adicione as propriedades do RDP extras ou faça alterações nas propriedades do RDP existentes em um formato separado por ponto-e-vírgula, como os valores padrão já mostrados.
Quando você concluir, selecione Salvar para salvar as alterações. Os usuários precisam atualizar seus recursos para receber as alterações.

Para configurar propriedades RDP usando o Azure PowerShell, use os exemplos a seguir. Certifique-se de alterar os valores <placeholder> para os seus valores. Para obter uma lista completa de propriedades e valores com suporte, consulte Propriedades RDP compatíveis com a Área de Trabalho Virtual do Azure.

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.

Use um dos seguintes exemplos com base em seus requisitos:

Para adicionar propriedades do RDP personalizadas a um pool de host e manter todas as propriedades personalizadas existentes já definidas, execute os comandos a seguir. As propriedades do RDP precisam ser gravadas em um formato separado por ponto e vírgula. Este exemplo adiciona a desabilitação da área de transferência e o 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 do RDP personalizadas, execute o comando a seguir. Este exemplo define apenas a desabilitaçã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 do RDP personalizadas de um pool de host, execute o comando a seguir. Este exemplo passa uma cadeia de caracteres vazia para o parâmetro CustomRdpProperty:

$hostPool = "<HostPoolName>"
$resourceGroup = "<ResourceGroupName>"
$customProperties = ""

Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties

Verifique as propriedades do 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 seguinte exemplo:

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

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

Para configurar propriedades RDP usando a CLI do Azure, use os exemplos a seguir. Certifique-se de alterar os valores <placeholder> para os seus valores. Para obter uma lista completa de propriedades e valores com suporte, consulte Propriedades RDP compatíveis com a Área de Trabalho Virtual do Azure.

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.

Use um dos seguintes exemplos com base em seus requisitos:

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 do RDP personalizadas, execute o comando a seguir. Este exemplo define apenas a desabilitaçã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 do RDP personalizadas de um pool de host, execute o comando a seguir. Este exemplo passa uma cadeia de caracteres vazia para o parâmetro --custom-rdp-property:

hostPool="<HostPoolName>"
resourceGroup="<ResourceGroupName>"

az desktopvirtualization hostpool update \
     --name $hostPool \
     --resource-group $resourceGroup \
     --custom-rdp-property ""

Verifique as propriedades do 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 seguinte exemplo:

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

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

Compartilhar via

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

Propriedades de RDP do pool de host padrão

Pré-requisitos

Configurar propriedades personalizadas de RDP

Comentários

Recursos adicionais

Compartilhar via

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

Propriedades de RDP do pool de host padrão

Pré-requisitos

Configurar propriedades personalizadas de RDP

Conteúdo relacionado

Comentários

Recursos adicionais