Ustawianie niestandardowych właściwości protokołu RDP (Remote Desktop Protocol) w puli hostów w usłudze Azure Virtual Desktop

Poniżej przedstawiono sposób konfigurowania właściwości protokołu RDP przy użyciu witryny Azure Portal. Aby uzyskać pełną listę obsługiwanych właściwości i wartości, zobacz Obsługiwane właściwości protokołu RDP za pomocą usługi Azure Virtual Desktop.

1. Zaloguj się w witrynie Azure Portal.

2. Na pasku wyszukiwania wprowadź ciąg Azure Virtual Desktop i wybierz pasujący wpis usługi.

3. Wybierz pozycję Pule hostów, a następnie wybierz nazwę puli hostów, którą chcesz zaktualizować.

4. Wybierz pozycję Właściwości protokołu RDP, a następnie wybierz kartę Zaawansowane .

   

5. Dodaj dodatkowe właściwości protokołu RDP lub wprowadź zmiany w istniejących właściwościach protokołu RDP w formacie rozdzielanym średnikami, tak jak pokazano już wartości domyślne.

6. Gdy wszystko będzie gotowe, wybierz pozycję Zapisz , aby zapisać zmiany. Użytkownicy muszą odświeżyć swoje zasoby, aby otrzymywać zmiany.

Aby skonfigurować właściwości protokołu RDP przy użyciu programu Azure PowerShell, skorzystaj z poniższych przykładów. Pamiętaj, aby zmienić <placeholder> własne wartości. Aby uzyskać pełną listę obsługiwanych właściwości i wartości, zobacz Obsługiwane właściwości protokołu RDP za pomocą usługi Azure Virtual Desktop.

1. Otwórz usługę Azure Cloud Shell w witrynie Azure Portal z typem terminalu programu PowerShell lub uruchom program PowerShell na urządzeniu lokalnym.

   • Jeśli używasz usługi Cloud Shell, upewnij się, że kontekst platformy Azure jest ustawiony na subskrypcję, której chcesz użyć.

   • Jeśli używasz programu PowerShell lokalnie, najpierw zaloguj się przy użyciu programu Azure PowerShell, a następnie upewnij się, że kontekst platformy Azure jest ustawiony na subskrypcję, której chcesz użyć.

2. Użyj jednego z następujących przykładów na podstawie wymagań:

   • Aby dodać niestandardowe właściwości protokołu RDP do puli hostów i zachować wszystkie istniejące właściwości niestandardowe już ustawione, uruchom następujące polecenia. Właściwości protokołu RDP muszą być zapisywane w formacie rozdzielanym średnikami. W tym przykładzie dodano wyłączenie schowka i przekierowania drukarki:

     $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
     

   • Aby zastąpić wszystkie istniejące właściwości niestandardowe nowym zestawem niestandardowych właściwości protokołu RDP, uruchom następujące polecenie. W tym przykładzie ustawia się tylko wyłączenie schowka i przekierowania drukarki:

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

   • Aby usunąć wszystkie niestandardowe właściwości protokołu RDP z puli hostów, uruchom następujące polecenie. W tym przykładzie do parametru CustomRdpProperty przekazuje pusty ciąg:

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

3. Sprawdź niestandardowe właściwości protokołu RDP ustawione w tej samej puli hostów, uruchamiając następujące polecenie:

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

   Dane wyjściowe powinny być podobne do następującego przykładu:

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

4. Użytkownicy muszą odświeżyć swoje zasoby, aby otrzymywać zmiany.

Aby skonfigurować właściwości protokołu RDP przy użyciu interfejsu wiersza polecenia platformy Azure, skorzystaj z poniższych przykładów. Pamiętaj, aby zmienić <placeholder> własne wartości. Aby uzyskać pełną listę obsługiwanych właściwości i wartości, zobacz Obsługiwane właściwości protokołu RDP za pomocą usługi Azure Virtual Desktop.

1. Otwórz usługę Azure Cloud Shell w witrynie Azure Portal z typem terminalu powłoki Bash lub uruchom interfejs wiersza polecenia platformy Azure na urządzeniu lokalnym.

   • Jeśli używasz usługi Cloud Shell, upewnij się, że kontekst platformy Azure jest ustawiony na subskrypcję, której chcesz użyć.

   • Jeśli używasz interfejsu wiersza polecenia platformy Azure lokalnie, najpierw zaloguj się przy użyciu interfejsu wiersza polecenia platformy Azure, a następnie upewnij się, że kontekst platformy Azure jest ustawiony na subskrypcję, której chcesz użyć.

2. Użyj jednego z następujących przykładów na podstawie wymagań:

   • Aby dodać niestandardowe właściwości protokołu RDP do puli hostów i zachować wszystkie istniejące właściwości niestandardowe już ustawione, uruchom następujące polecenia. Właściwości protokołu RDP muszą być zapisywane w formacie rozdzielanym średnikami. W tym przykładzie dodano wyłączenie schowka i przekierowania drukarki do istniejących właściwości niestandardowych:

     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"
     

   • Aby zastąpić wszystkie istniejące właściwości niestandardowe nowym zestawem niestandardowych właściwości protokołu RDP, uruchom następujące polecenie. W tym przykładzie ustawia się tylko wyłączenie schowka i przekierowania drukarki:

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

   • Aby usunąć wszystkie niestandardowe właściwości protokołu RDP z puli hostów, uruchom następujące polecenie. W tym przykładzie do parametru --custom-rdp-property przekazuje pusty ciąg:

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

3. Sprawdź niestandardowe właściwości protokołu RDP ustawione w tej samej puli hostów, uruchamiając następujące polecenie:

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

   Dane wyjściowe powinny być podobne do następującego przykładu:

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

4. Użytkownicy muszą odświeżyć swoje zasoby, aby otrzymywać zmiany.