Definir propriedades personalizadas do protocolo RDP em um pool de hosts na Área de Trabalho Virtual do Azure

Quando os usuários entram no Windows App ou no aplicativo de Área de Trabalho Remota, são mostrados os desktops e aplicativos aos quais eles 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. Essas propriedades RDP são definidas por pool de host.

Cada pool de host 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 host usando o portal do Azure, o Azure PowerShell e a CLI do Azure.

Pool de hosts padrão Propriedades RDP

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

Propriedade RDP	Detalhes
`audiomode:i:0`	Determina se o computador local ou remoto reproduz áudio.
`devicestoredirect:s:*`	Determina quais periféricos que usam o Protocolo de Transferência de Mídia (MTP) ou o Protocolo de Transferência de Imagem (PTP), 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 disponibilizadas em uma sessão remota.
`enablecredsspsupport:i:1`	Determina se o cliente usará o CredSSP (Provedor de Suporte de Segurança de Credenciais) para 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 seriais 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 card inteligente no dispositivo local serão redirecionados e disponibilizados em uma sessão remota.
`redirectwebauthn:i:1`	Determina se as solicitações do 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 suportados no computador cliente são redirecionados usando 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á streaming de multimídia eficiente de RDP para reprodução de vídeo.

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

Dica

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, é necessário:

Um pool de hosts existente.
Uma conta do Azure à qual tenha sido atribuída a função de Colaborador do Pool de Host de 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 verificar se você tem 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 RDP personalizadas

Selecione a guia relevante para seu cenário.

Veja como configurar propriedades RDP usando o portal do Azure. Para obter uma lista completa de propriedades e valores com suporte, consulte Propriedades RDP com suporte 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, selecione a guia Avançado .
Adicione mais propriedades RDP 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.
Quando você terminar, selecione Salvar para salvar suas 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 <placeholder> seus próprios valores. Para obter uma lista completa de propriedades e valores com suporte, consulte Propriedades RDP com suporte com a Área de Trabalho Virtual do Azure.

Abra 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 você estiver usando o PowerShell localmente, primeiro entre no Azure PowerShell e, em seguida, verifique se o 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 RDP personalizadas a um pool de hosts e manter todas as propriedades personalizadas existentes já definidas, execute os comandos a seguir. As propriedades RDP precisam ser gravadas 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 comando a seguir. Este exemplo define apenas a desabilitação da área de transferência e do redirecionamento de 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 host, execute o comando a seguir. 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

Verifique as propriedades RDP personalizadas definidas no mesmo pool de host 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;

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 <placeholder> seus próprios valores. Para obter uma lista completa de propriedades e valores com suporte, consulte Propriedades RDP com suporte com a Área de Trabalho Virtual do Azure.

Abra Azure Cloud Shell no portal do Azure com o tipo de terminal Bash ou execute a CLI do Azure 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 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.

Use um dos seguintes exemplos com base em seus requisitos:

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

Verifique as propriedades RDP personalizadas definidas no mesmo pool de host 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;

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

Comentários

Esta página foi útil?

Last updated on 2026-08-22