Definir propriedades personalizadas do Protocolo RDP (Remote Desktop Protocol) num conjunto de anfitriões no Azure Virtual Desktop

Quando os utilizadores iniciam sessão no Windows App 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 ambiente de trabalho e aplicação, existe um ficheiro correspondente .rdp que contém todas as propriedades de ligação a utilizar ao ligar a uma sessão remota através do Protocolo RDP (Remote Desktop Protocol). Estas propriedades RDP são definidas por conjunto de anfitriões.

Cada conjunto de anfitriões tem um conjunto de propriedades e valores RDP predefinidos. Pode adicionar outras propriedades ao conjunto predefinido ou substituir os valores predefinidos ao definir propriedades RDP personalizadas. Este artigo mostra-lhe como definir propriedades RDP personalizadas num conjunto de anfitriões com o portal do Azure, Azure PowerShell e a CLI do Azure.

Propriedades RDP do conjunto de anfitriões predefinidas

Os conjuntos de anfitriões têm as seguintes propriedades e valores RDP por predefinição:

Propriedade RDP	Detalhes
`audiomode:i:0`	Determina se o computador local ou remoto reproduz áudio.
`devicestoredirect:s:*`	Determina que periféricos que utilizam o Protocolo MTP (Media Transfer Protocol) ou o Protocolo PTP (Picture Transfer Protocol), como uma câmara digital, são redirecionados de um dispositivo Windows local para uma sessão remota.
`drivestoredirect:s:*`	Determina que unidades fixas, amovíveis e de rede no dispositivo local serão redirecionadas e disponíveis numa sessão remota.
`enablecredsspsupport:i:1`	Determina se o cliente irá utilizar o Fornecedor de Suporte de Segurança de Credenciais (CredSSP) para autenticação, se estiver disponível.
`redirectclipboard:i:1`	Determina se pretende redirecionar a área de transferência.
`redirectcomports:i:1`	Determina se as portas série 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 card inteligentes no dispositivo local serão redirecionados e disponíveis numa sessão remota.
`redirectwebauthn:i:1`	Determina se os pedidos WebAuthn de uma sessão remota são redirecionados para o dispositivo local, permitindo a utilização de autenticadores locais (como chaves de segurança e Windows Hello para Empresas).
`usbdevicestoredirect:s:*`	Determina que dispositivos USB suportados no computador cliente são redirecionados através do redirecionamento opaco de baixo nível para uma sessão remota.
`use multimon:i:1`	Determina se a sessão remota irá utilizar um ou vários ecrãs do dispositivo local.
`videoplaybackmode:i:1`	Determina se a ligação irá utilizar a transmissão em fluxo de multimédia eficiente em RDP para a reprodução de vídeo.

Para obter uma lista completa das propriedades e valores suportados, veja Propriedades de RDP suportadas com o Azure Virtual Desktop

Dica

Para saber mais sobre como redirecionar periféricos e recursos, veja Periférico e redirecionamento de recursos através do Protocolo de Ambiente de Trabalho Remoto. Poderá ter de configurar mais do que apenas uma propriedade RDP.

Pré-requisitos

Antes de poder definir propriedades RDP personalizadas num conjunto de anfitriões, precisa de:

Um conjunto de anfitriões existente.
Uma conta do Azure atribuiu a função Contribuidor do Conjunto de Anfitriões de Virtualização de Ambiente de Trabalho ou equivalente.
Se quiser utilizar a CLI do Azure ou Azure PowerShell localmente, veja Utilizar a CLI do Azure e Azure PowerShell com o Azure Virtual Desktop para se certificar de que tem a extensão da CLI do Azure de ambiente de trabalho ou o módulo Az.DesktopVirtualization do PowerShell instalado. Em alternativa, utilize a Cloud Shell do Azure.

Configurar propriedades RDP personalizadas

Selecione o separador relevante para o seu cenário.

Eis como configurar propriedades RDP com o portal do Azure. Para obter uma lista completa das propriedades e valores suportados, veja Propriedades de RDP suportadas com o Azure Virtual Desktop.

Entre no portal do Azure.
Na barra de pesquisa, introduza Azure Virtual Desktop e selecione a entrada de serviço correspondente.
Selecione Conjuntos de anfitriões e, em seguida, selecione o nome do conjunto de anfitriões que pretende atualizar.
Selecione Propriedades do RDP e, em seguida, selecione o separador Avançadas .
Adicione propriedades RDP adicionais ou faça alterações às propriedades RDP existentes num formato separado por ponto e vírgula, como os valores predefinidos já apresentados.
Quando você terminar, selecione Salvar para salvar suas alterações. Os utilizadores têm de atualizar os recursos para receber as alterações.

Para configurar propriedades RDP com Azure PowerShell, utilize os seguintes exemplos. Certifique-se de que altera os <placeholder> valores dos seus próprios valores. Para obter uma lista completa das propriedades e valores suportados, veja Propriedades de RDP suportadas com o Azure Virtual Desktop.

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 Cloud Shell, certifique-se de que o contexto do Azure está definido para a subscrição que pretende utilizar.
- Se estiver a utilizar o PowerShell localmente, primeiro inicie sessão com Azure PowerShell e, em seguida, certifique-se de que o contexto do Azure está definido para a subscrição que pretende utilizar.

Utilize um dos seguintes exemplos com base nos seus requisitos:

Para adicionar propriedades RDP personalizadas a um conjunto de anfitriões e manter as propriedades personalizadas já definidas, execute os seguintes comandos. As propriedades RDP têm de ser escritas num 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 do 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 conjunto de anfitriões, execute o seguinte comando. Este exemplo transmite uma cadeia vazia ao CustomRdpProperty parâmetro :

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

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

Verifique as propriedades de RDP personalizadas definidas no mesmo conjunto de anfitriões ao executar o seguinte comando:

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

O resultado deve ser semelhante ao seguinte exemplo:

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

Os utilizadores têm de atualizar os recursos para receber as alterações.

Para configurar propriedades RDP com a CLI do Azure, utilize os seguintes exemplos. Certifique-se de que altera os <placeholder> valores dos seus próprios valores. Para obter uma lista completa das propriedades e valores suportados, veja Propriedades de RDP suportadas com o Azure Virtual Desktop.

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 Cloud Shell, certifique-se de que o contexto do Azure está definido para a subscrição que pretende utilizar.
- Se estiver a utilizar a CLI do Azure localmente, primeiro inicie sessão com a CLI do Azure e, em seguida, certifique-se de que o contexto do Azure está definido para a subscrição que pretende utilizar.

Utilize um dos seguintes exemplos com base nos seus requisitos:

Para adicionar propriedades RDP personalizadas a um conjunto de anfitriões e manter as propriedades personalizadas já definidas, execute os seguintes comandos. As propriedades RDP têm de ser escritas num formato separado por ponto e vírgula. Este exemplo adiciona a desativação do redirecionamento da área de transferência e da impressora para as 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 do 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 conjunto de anfitriões, execute o seguinte comando. Este exemplo transmite uma cadeia vazia ao --custom-rdp-property parâmetro :

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

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

Verifique as propriedades de RDP personalizadas definidas no mesmo conjunto de anfitriões ao executar o seguinte comando:

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

O resultado deve ser semelhante ao seguinte exemplo:

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

Os utilizadores têm de atualizar os recursos para receber as alterações.

Comentários

Esta página foi útil?

Last updated on 2025-06-20

Compartilhar via

Definir propriedades personalizadas do Protocolo RDP (Remote Desktop Protocol) num conjunto de anfitriões no Azure Virtual Desktop

Propriedades RDP do conjunto de anfitriões predefinidas

Pré-requisitos

Configurar propriedades RDP personalizadas

Conteúdo relacionado

Comentários

Recursos adicionais