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

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.

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.

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.