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

Wenn sich Benutzer bei 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 pro Hostpool festgelegt.

Jeder Hostpool verfügt über einen Satz von RDP-Standardeigenschaften und -Werten. Sie können dem Standardsatz weitere Eigenschaften hinzufügen oder die Standardwerte überschreiben, indem Sie benutzerdefinierte RDP-Eigenschaften festlegen. In diesem Artikel erfahren Sie, wie Sie benutzerdefinierte RDP-Eigenschaften für einen Hostpool mithilfe der Azure-Portal, Azure PowerShell und der Azure CLI festlegen.

RDP-Standardeigenschaften des Hostpools

Hostpools verfügen standardmäßig über die folgenden RDP-Eigenschaften und -Werte:

RDP-Eigenschaft	Details
`audiomode:i:0`	Bestimmt, ob der lokale Computer oder der Remotecomputer Audiodaten wiedergibt.
`devicestoredirect:s:*`	Bestimmt, welche Peripheriegeräte, die das Media Transfer Protocol (MTP) oder das Bildübertragungsprotokoll (PTP) verwenden, z. B. eine Digitalkamera, von einem lokalen Windows-Gerät zu einer Remotesitzung umgeleitet werden.
`drivestoredirect:s:*`	Bestimmt, welche Festplattenlaufwerke, Wechseldatenträger und Netzwerklaufwerke auf dem lokalen Gerät umgeleitet und in einer Remotesitzung verfügbar sind.
`enablecredsspsupport:i:1`	Bestimmt, 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 Intelligente Karte Geräte auf dem lokalen Gerät umgeleitet werden und in einer Remotesitzung verfügbar sind.
`redirectwebauthn:i:1`	Bestimmt, ob WebAuthn-Anforderungen von einer Remotesitzung an das lokale Gerät umgeleitet werden, sodass lokale Authentifikatoren (z. B. Windows Hello for Business und Sicherheitsschlüssel) verwendet werden können.
`usbdevicestoredirect:s:*`	Bestimmt, welche unterstützten USB-Geräte auf dem Clientcomputer mithilfe einer undurchsichtigen Umleitung auf niedriger Ebene an eine Remotesitzung umgeleitet werden.
`use multimon:i:1`	Bestimmt, ob die Remotesitzung eine oder mehrere Anzeigen des lokalen Geräts verwendet.
`videoplaybackmode:i:1`	Bestimmt, ob die Verbindung RDP-effizientes Multimediastreaming für die Videowiedergabe verwendet.

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

Tipp

Weitere Informationen zum Umleiten von Peripheriegeräten und Ressourcen finden Sie unter Umleitung von Peripheriegeräten und Ressourcen ü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:

Ein vorhandener Hostpool.
Ein Azure-Konto, dem die Rolle "Desktop Virtualization Host Pool Contributor" oder eine entsprechende Rolle zugewiesen ist.
Wenn Sie die Azure CLI oder Azure PowerShell lokal verwenden möchten, lesen Sie Verwenden der Azure CLI und Azure PowerShell mit Azure Virtual Desktop, um sicherzustellen, dass die Azure CLI-Erweiterung desktopvirtualization oder das PowerShell-Modul Az.DesktopVirtualization installiert ist. Alternativ können Sie die Azure-Cloud Shell verwenden.

Konfigurieren von benutzerdefinierten RDP-Eigenschaften

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

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

Melden Sie sich beim Azure-Portal an.
Geben Sie in der Suchleiste Azure Virtual Desktop ein, und wählen Sie den entsprechenden Diensteintrag aus.
Wählen Sie Hostpools und dann den Namen des Hostpools aus, den Sie aktualisieren möchten.
Wählen Sie RDP-Eigenschaften und dann die Registerkarte Erweitert aus.
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.
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.

Verwenden Sie die folgenden Beispiele, um RDP-Eigenschaften mithilfe von Azure PowerShell zu konfigurieren. Achten Sie darauf, die <placeholder> Werte für Ihre eigenen Werte zu ändern. Eine vollständige Liste der unterstützten Eigenschaften und Werte finden Sie unter Unterstützte RDP-Eigenschaften mit Azure Virtual Desktop.

Öffnen Sie Azure Cloud Shell im Azure-Portal mit dem PowerShell-Terminaltyp, 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 PowerShell lokal verwenden, melden Sie sich zuerst mit Azure PowerShell an, und stellen Sie dann sicher, dass Ihr Azure-Kontext auf das Abonnement festgelegt ist, das Sie verwenden möchten.

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 Eigenschaften beizubehalten, die bereits festgelegt sind. RDP-Eigenschaften müssen in einem durch Semikolons getrennten Format geschrieben werden. In diesem Beispiel wird die Deaktivierung der Zwischenablage und der Druckerumleitung hinzugefügt:
```
$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 die Deaktivierung 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
```

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

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

Die Ausgabe sollte in etwa wie im folgenden Beispiel aussehen:

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

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

Verwenden Sie die folgenden Beispiele, um RDP-Eigenschaften mithilfe der Azure CLI zu konfigurieren. Achten Sie darauf, die <placeholder> Werte für Ihre eigenen Werte zu ändern. Eine vollständige Liste der unterstützten Eigenschaften und Werte finden Sie unter Unterstützte RDP-Eigenschaften mit Azure Virtual Desktop.

Öffnen Sie Azure Cloud Shell im Azure-Portal mit dem Bash-Terminaltyp, 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, melden Sie sich zuerst mit der Azure CLI an, und stellen Sie dann sicher, dass Ihr Azure-Kontext auf das Abonnement festgelegt ist, das Sie verwenden möchten.

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 Eigenschaften beizubehalten, die bereits festgelegt sind. RDP-Eigenschaften müssen in einem durch Semikolons getrennten Format geschrieben werden. In diesem Beispiel wird die Deaktivierung der Zwischenablage und 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 die Deaktivierung 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 ""
```

Überprüfen Sie die benutzerdefinierten RDP-Eigenschaften, die für denselben Hostpool festgelegt sind, 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 in etwa wie im folgenden Beispiel aussehen:

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

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

Feedback

War diese Seite hilfreich?

Last updated on 2025-06-20

Freigeben über

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

RDP-Standardeigenschaften des Hostpools

Voraussetzungen

Konfigurieren von benutzerdefinierten RDP-Eigenschaften

Verwandte Inhalte

Feedback

Zusätzliche Ressourcen