Festlegen von benutzerdefinierten RDP-Eigenschaften (Remote Desktop Protocol) für einen Hostpool in Azure Virtual Desktop

Wenn Benutzer sich bei der Windows-App oder der Remotedesktop-App anmelden, werden Desktops und Anwendungen angezeigt, auf die sie Zugriff haben. Für jeden Desktop und jede Anwendung gibt es eine entsprechende .rdp-Datei, die alle Verbindungseigenschaften enthält, die beim Herstellen einer Verbindung mit einer Remotesitzung über das Remotedesktopprotokoll (RDP) verwendet werden sollen. Diese RDP-Eigenschaften werden je Hostpool festgelegt.

Jeder Hostpool verfügt über eine Reihe von Standard-RDP-Eigenschaften und -Werten. Sie können dem Standardsatz weitere Eigenschaften hinzufügen oder die Standardwerte überschreiben, indem Sie benutzerdefinierte RDP-Eigenschaften festlegen. In diesem Artikel wird erläutert, wie Sie benutzerdefinierte RDP-Eigenschaften in einem Hostpool mithilfe des Azure-Portals, Azure PowerShell und der Azure CLI festlegen.

RDP-Standardeigenschaften des Hostpools

Hostpools weisen standardmäßig die folgenden RDP-Eigenschaften und -Werte auf:

RDP-Eigenschaft	Details
audiomode:i:0	Bestimmt, ob der lokale oder Remotecomputer Audiodateien wiedergibt.
devicestoredirect:s:*	Bestimmt, welche Peripheriegeräte das Media Transfer Protocol (MTP) oder Picture Transfer Protocol (PTP) verwenden, z. B. eine Digitalkamera, von einem lokalen Windows-Gerät zu einer Remotesitzung umgeleitet werden.
drivestoredirect:s:*	Bestimmt, welche festen, wechselbaren und Netzwerklaufwerke auf dem lokalen Gerät umgeleitet werden und in einer Remotesitzung verfügbar sind.
enablecredsspsupport:i:1	Legt fest, ob der Client den Credential Security Support Provider (CredSSP) für die Authentifizierung verwendet, sofern verfügbar.
redirectclipboard:i:1	Bestimmt, ob die Zwischenablage umgeleitet werden soll.
redirectcomports:i:1	Bestimmt, ob serielle oder COM-Ports auf dem lokalen Gerät an eine Remotesitzung umgeleitet werden.
redirectprinters:i:1	Bestimmt, ob auf dem lokalen Gerät verfügbare Drucker an eine Remotesitzung umgeleitet werden.
redirectsmartcards:i:1	Bestimmt, ob Smartcardgeräte auf dem lokalen Gerät umgeleitet und in einer Remotesitzung verfügbar sind.
redirectwebauthn:i:1	Bestimmt, ob WebAuthn-Anforderungen aus einer Remotesitzung an das lokale Gerät umgeleitet werden, sodass lokale Authentifikatoren verwendet werden können (z. B. Windows Hello for Business und Sicherheitsschlüssel).
usbdevicestoredirect:s:*	Bestimmt, welche unterstützten USB-Geräte auf dem Clientcomputer mithilfe einer undurchsichtigen Umleitung auf niedriger Ebene zu einer Remotesitzung umgeleitet werden.
use multimon:i:1	Bestimmt, ob die Remotesitzung eine oder mehrere Displays vom lokalen Gerät verwendet.
videoplaybackmode:i:1	Legt fest, ob die Verbindung für die Videowiedergabe effizientes RDP-Multimediastreaming verwendet.

Eine vollständige Liste der unterstützten Eigenschaften und deren Standardwerte finden Sie unter Unterstützte RDP-Eigenschaften mit Azure Virtual Desktop

Tipp

Weitere Informationen zum Umleiten von Peripheriegeräten und Ressourcen finden Sie unter Peripheriegeräte und Ressourcenumleitung über das Remotedesktopprotokoll. Möglicherweise müssen Sie mehr als nur eine RDP-Eigenschaft konfigurieren.

Voraussetzungen

Bevor Sie benutzerdefinierte RDP-Eigenschaften für einen Hostpool festlegen können, benötigen Sie Folgendes:

• Einen vorhandenen Hostpool.

• Ein Azure-Konto, dem die Rolle Hostpoolmitwirkender für die Desktopvirtualisierung zugewiesen ist.

• Wenn Sie die Azure-Befehlszeilenschnittstelle oder Microsoft Azure PowerShell lokal verwenden möchten, lesen Sie Verwenden der Azure-Befehlszeilenschnittstelle und Microsoft Azure PowerShell mit Azure Virtual Desktop, um sicherzustellen, dass die Azure-Befehlszeilenschnittstellen-Erweiterung desktopvirtualization oder das PowerShell-Modul Az.DesktopVirtualization installiert ist. Stattdessen können Sie auch die Azure Cloud Shell verwenden.

Konfigurieren von benutzerdefinierten RDP-Eigenschaften

Wählen Sie die relevante Registerkarte für Ihr Szenario aus.

Azure portal

Hier erfahren Sie, wie Sie RDP-Eigenschaften mithilfe des Azure-Portals konfigurieren. Eine vollständige Liste der unterstützten Eigenschaften und deren Standardwerte finden Sie unter Unterstützte RDP-Eigenschaften mit Azure Virtual Desktop.

1. Melden Sie sich beim Azure-Portal an.

2. Geben Sie in der Suchleiste Azure Virtual Desktop ein, und wählen Sie den entsprechenden Diensteintrag aus.

3. Wählen Sie Hostpools und dann den Namen des Hostpools aus, den Sie aktualisieren möchten.

4. Wählen Sie RDP-Eigenschaften aus, und wählen Sie dann die Registerkarte Erweitert aus.

   

5. Fügen Sie zusätzliche RDP-Eigenschaften hinzu, oder nehmen Sie Änderungen an den vorhandenen RDP-Eigenschaften in einem durch Semikolons getrennten Format vor, wie die bereits gezeigten Standardwerte.

6. Wenn Sie fertig sind, wählen Sie Speichern aus, um Ihre Änderungen zu speichern. Benutzer müssen ihre Ressourcen aktualisieren, um die Änderungen zu erhalten.

Azure PowerShell

Verwenden Sie die folgenden Beispiele, um RDP-Eigenschaften mit Azure PowerShell zu konfigurieren. Legen Sie die <placeholder>-Werte auf Ihre eigenen Werte fest. Eine vollständige Liste der unterstützten Eigenschaften und deren Standardwerte finden Sie unter Unterstützte RDP-Eigenschaften mit Azure Virtual Desktop.

1. Öffnen Sie Azure Cloud Shell im Azure-Portal mit dem Terminaltyp PowerShell, oder führen Sie PowerShell auf Ihrem lokalen Gerät aus.

   • Wenn Sie Cloud Shell verwenden, stellen Sie sicher, dass Ihr Azure-Kontext auf das Abonnement festgelegt ist, das Sie verwenden möchten.

   • Wenn Sie die PowerShell lokal verwenden, müssen Sie sich zunächst mit Azure PowerShell anmelden und dann sicherstellen, dass Ihr Azure-Kontext auf das Abonnement festgelegt ist, das Sie verwenden möchten.

2. Verwenden Sie eines der folgenden Beispiele basierend auf Ihren Anforderungen:

   • Führen Sie die folgenden Befehle aus, um einem Hostpool benutzerdefinierte RDP-Eigenschaften hinzuzufügen und vorhandene benutzerdefinierte bereits festgelegte Eigenschaften zu behalten. RDP-Eigenschaften müssen in einem durch Semikolons getrennten Format geschrieben werden. In diesem Beispiel wird die Zwischenablage und die Druckerumleitung deaktiviert:

     $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
     

   • Führen Sie den folgenden Befehl aus, um alle vorhandenen benutzerdefinierten Eigenschaften durch einen neuen Satz benutzerdefinierter RDP-Eigenschaften zu ersetzen. In diesem Beispiel wird nur das Deaktivieren der Zwischenablage und der Druckerumleitung festgelegt:

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

   • Führen Sie den folgenden Befehl aus, um alle benutzerdefinierten RDP-Eigenschaften aus einem Hostpool zu entfernen. In diesem Beispiel wird eine leere Zeichenfolge an den CustomRdpProperty-Parameter übergeben:

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

3. Überprüfen Sie die für denselben Hostpool festgelegten benutzerdefinierten RDP-Eigenschaften, indem Sie den folgenden Befehl ausführen:

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

   Die Ausgabe sollte ungefähr wie das folgende Beispiel aussehen:

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

4. Benutzer müssen ihre Ressourcen aktualisieren, um die Änderungen zu erhalten.

Azure-Befehlszeilenschnittstelle

Verwenden Sie die folgenden Beispiele, um RDP-Eigenschaften mit Azure CLI zu konfigurieren. Legen Sie die <placeholder>-Werte auf Ihre eigenen Werte fest. Eine vollständige Liste der unterstützten Eigenschaften und deren Standardwerte finden Sie unter Unterstützte RDP-Eigenschaften mit Azure Virtual Desktop.

1. Öffnen Sie Azure Cloud Shell im Azure-Portal mit dem Terminaltyp Bash, oder führen Sie die Azure CLI auf Ihrem lokalen Gerät aus.

   • Wenn Sie Cloud Shell verwenden, stellen Sie sicher, dass Ihr Azure-Kontext auf das Abonnement festgelegt ist, das Sie verwenden möchten.

   • Wenn Sie die Azure CLI lokal verwenden, müssen Sie sich zunächst mit der Azure CLI anmelden und dann sicherstellen, dass Ihr Azure-Kontext auf das Abonnement festgelegt ist, das Sie verwenden möchten.

2. Verwenden Sie eines der folgenden Beispiele basierend auf Ihren Anforderungen:

   • Führen Sie die folgenden Befehle aus, um einem Hostpool benutzerdefinierte RDP-Eigenschaften hinzuzufügen und vorhandene benutzerdefinierte bereits festgelegte Eigenschaften zu behalten. RDP-Eigenschaften müssen in einem durch Semikolons getrennten Format geschrieben werden. In diesem Beispiel wird die Deaktivierung der Zwischenablage und der Druckerumleitung zu den vorhandenen benutzerdefinierten Eigenschaften hinzugefügt:

     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"
     

   • Führen Sie den folgenden Befehl aus, um alle vorhandenen benutzerdefinierten Eigenschaften durch einen neuen Satz benutzerdefinierter RDP-Eigenschaften zu ersetzen. In diesem Beispiel wird nur das Deaktivieren der Zwischenablage und der Druckerumleitung festgelegt:

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

   • Führen Sie den folgenden Befehl aus, um alle benutzerdefinierten RDP-Eigenschaften aus einem Hostpool zu entfernen. In diesem Beispiel wird eine leere Zeichenfolge an den --custom-rdp-property-Parameter übergeben:

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

3. Überprüfen Sie die für denselben Hostpool festgelegten benutzerdefinierten RDP-Eigenschaften, indem Sie den folgenden Befehl ausführen:

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

   Die Ausgabe sollte ungefähr wie das folgende Beispiel aussehen:

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

4. Benutzer müssen ihre Ressourcen aktualisieren, um die Änderungen zu erhalten.

Zugehöriger Inhalt

• Unterstützte RDP-Eigenschaften bei Azure Virtual Desktop
• Umleitung von Peripheriegeräten und Ressourcen über das Remotedesktopprotokoll