Personalizar as propriedades de Protocolo RDP para um pool de host

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.

É possível personalizar as propriedades do protocolo RDP de um pool de host, como a experiência de vários monitores e o redirecionamento de áudio, para proporcionar uma experiência ideal aos usuários, considerando as respectivas necessidades. Se você quiser alterar as propriedades padrão do arquivo RFP, personalize as propriedades RDP na Área de Trabalho Virtual do Azure usando o portal do Azure ou o parâmetro -CustomRdpProperty no cmdlet Update-AzWvdHostPool.

Confira Propriedades do RDP compatíveis com a Área de Trabalho Virtual do Azure para obter uma lista completa das propriedades com suporte e os valores padrão.

Propriedades padrão do arquivo RDP

Por padrão, os arquivos RDP têm as seguintes propriedades:

Propriedade RDP Para Desktop e RemoteApp
Modo de vários monitores habilitado
Redirecionamentos habilitados Unidades, área de transferência, impressoras, portas COM, cartões inteligentes, dispositivos, usbdevicestore e WebAuthn
Modo de áudio remoto Reproduzir localmente
VideoPlayback habilitado
EnableCredssp habilitado

Importante

  • O modo de vários monitores é habilitado apenas para grupos de aplicativos da área de trabalho e é ignorado para grupos de aplicativos do RemoteApp.

  • Todas as propriedades do arquivo RDP padrão são expostas no portal do Azure.

  • Um campo CustomRdpProperty nulo aplicará todas as propriedades RDP padrão ao pool de host. Um campo CustomRdpProperty vazio não aplicará nenhuma propriedade RDP padrão ao pool de host.

  • Se você também definir as configurações do redirecionamento de dispositivos usando objetos da Política de Grupo (GPOs), as configurações nas GPOs substituirão as propriedades RDP especificadas no pool de hosts.

Pré-requisitos

Antes de começar, siga as instruções descritas em Configurar o módulo do PowerShell da Área de Trabalho Virtual do Azure para configurar o módulo do PowerShell e entrar no Azure.

Configurar propriedades RDP no portal do Azure

Para configurar propriedades RDP 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 Área de Trabalho Virtual do Azure, selecione pools de hosts no menu no lado esquerdo da tela.
  5. Selecione o nome do pool de host que deseja atualizar.
  6. Selecione Propriedades RDP no menu no lado esquerdo da tela.
  7. Defina a propriedade que desejar.
    • Como alternativa, você pode abrir a guia Avançado e adicionar suas propriedades RDP em um formato separado por ponto e vírgula, como os exemplos do PowerShell nas seções a seguir.
  8. Quando você concluir, selecione Salvar para salvar as alterações.

As próximas seções informarão como editar as propriedades RDP personalizadas manualmente no PowerShell.

Adicionar ou editar uma única propriedade RDP personalizada

Para adicionar ou editar uma única propriedade RDP personalizada, execute o seguinte cmdlet do PowerShell:

Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty <property>

Observação

O serviço de Área de Trabalho Virtual do Azure não aceita caracteres de escape, como ponto e vírgula ou dois-pontos, como nomes de propriedades RDP personalizadas válidas.

Para verificar se o cmdlet que você acabou de executar atualizou a propriedade, execute este cmdlet:

Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty

Name              : <hostpoolname>
CustomRdpProperty : <customRDPpropertystring>

Por exemplo, se você estava verificando a propriedade "audiocapturemode" em um pool de host chamado 0301HP, insira este cmdlet:

Get-AzWvdHostPool -ResourceGroupName 0301rg -Name 0301hp | format-list Name, CustomRdpProperty

Name              : 0301HP
CustomRdpProperty : audiocapturemode:i:1;

Adicionar ou editar várias propriedades personalizadas de RDP

Para adicionar ou editar várias propriedades de RDP personalizadas, execute os seguintes cmdlets do PowerShell fornecendo as propriedades de RDP personalizadas como uma cadeia de caracteres separada por ponto-e-vírgula:

$properties="<property1>;<property2>;<property3>"
Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty $properties

Observação

O serviço de Área de Trabalho Virtual do Azure não aceita caracteres de escape, como ponto e vírgula ou dois-pontos, como nomes de propriedades RDP personalizadas válidas.

Você pode verificar se a propriedade RDP foi adicionada executando o seguinte cmdlet:

Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty

Name              : <hostpoolname>
CustomRdpProperty : <customRDPpropertystring>

Com base em nosso exemplo de cmdlet anterior, se você configurar várias propriedades RDP no pool de host 0301HP, o cmdlet terá esta aparência:

Get-AzWvdHostPool -ResourceGroupName 0301rg -Name 0301hp | format-list Name, CustomRdpProperty

Name              : 0301HP
CustomRdpProperty : audiocapturemode:i:1;audiomode:i:0;

Redefinir todas as propriedades de RDP personalizadas

Você pode redefinir propriedades RDP personalizadas individuais para os valores padrão seguindo as instruções em Adicionar ou editar uma só propriedade RDP personalizada. Você também pode redefinir todas as propriedades RDP personalizadas de um pool de host executando o seguinte cmdlet do PowerShell:

Update-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> -CustomRdpProperty ""

Para garantir que você removeu a configuração com êxito, insira este cmdlet:

Get-AzWvdHostPool -ResourceGroupName <resourcegroupname> -Name <hostpoolname> | format-list Name, CustomRdpProperty

Name              : <hostpoolname>
CustomRdpProperty : <CustomRDPpropertystring>

Próximas etapas

Agora que as propriedades RDP de um determinado pool de host foram personalizadas, é possível entrar em um cliente da Área de Trabalho Virtual do Azure para testá-las em uma sessão de usuário. Os guias de instruções a seguir mostrarão como se conectar a uma sessão usando o cliente de sua escolha: