在 Azure 虛擬桌面的主機集區上設定自訂遠端桌面通訊協定 (RDP) 屬性
本文內容
當使用者登入 Windows 應用程式或遠端桌面應用程式時,會顯示他們有權存取的桌面和應用程式。 針對每個桌面和應用程式,有一個對應的 .rdp
檔案,其中包含透過遠端桌面通訊協定連線到遠端會話時要使用的所有連線屬性。 這些 RDP 屬性是為每個主機集區設定。
每個主機集區都有一組預設 RDP 屬性和值。 您可以將其他屬性新增至預設集,或藉由設定自定義 RDP 屬性來覆寫預設值。 本文說明如何使用 Azure 入口網站、Azure PowerShell 和 Azure CLI,在主機集區上設定自定義 RDP 屬性。
默認主機集區 RDP 屬性
根據預設,主機集區具有下列 RDP 屬性和值:
RDP 屬性
詳細資料
audiomode:i:0
決定本機或遠端電腦是否播放音訊。
devicestoredirect:s:*
決定使用媒體傳輸通訊協定 (MTP) 或圖片傳輸通訊協定 (PTP) 的周邊,例如數位相機,會從本機 Windows 裝置重新導向至遠端工作階段。
drivestoredirect:s:*
判斷本機裝置上的固定、卸載式和網路磁碟驅動器將會重新導向,並在遠端會話中使用。
enablecredsspsupport:i:1
決定用戶端是否會使用認證安全性支援提供者 (CredSSP) 進行驗證 (如果有的話)。
redirectclipboard:i:1
判斷是否要重新導向剪貼簿。
redirectcomports:i:1
判斷本機裝置上的序列或 COM 埠是否重新導向至遠端會話。
redirectprinters:i:1
判斷本機裝置上可用的印表機是否重新導向至遠端會話。
redirectsmartcards:i:1
判斷本機裝置上的智慧卡裝置是否會重新導向並可在遠端會話中使用。
redirectwebauthn:i:1
判斷遠端會話的 WebAuthn 要求是否重新導向至本機裝置,允許使用本機驗證器(例如 Windows Hello 企業版 和安全性密鑰)。
usbdevicestoredirect:s:*
決定客戶端電腦上支援哪些 USB 裝置會使用不透明的低階重新導向重新導向至遠端會話。
use multimon:i:1
判斷遠端會話是否會使用本機裝置中的一或多個顯示器。
videoplaybackmode:i:1
判斷連線是否會使用 RDP 有效率的多媒體串流來播放視訊。
如需支援屬性和值的完整清單,請參閱 Azure 虛擬桌面支援的 RDP 屬性
提示
若要深入瞭解如何重新導向周邊和資源,請參閱 透過遠端桌面通訊協定 的周邊和資源重新導向。 您可能需要只設定 RDP 屬性。
必要條件
在主機集區上設定自定義 RDP 屬性之前,您需要:
選取案例相關的索引標籤。
以下說明如何使用 Azure 入口網站 設定 RDP 屬性。 如需支援屬性和值的完整清單,請參閱 Azure 虛擬桌面 支援的 RDP 屬性。
登入 Azure 入口網站 。
在搜尋列中輸入「Azure 虛擬桌面」 ,並選取相符的服務項目。
選取 [ 主機集區 ],然後選取您要更新的主機集區名稱。
選取 [RDP 屬性 ],然後選取 [ 進階 ] 索引標籤。
新增額外的 RDP 屬性,或變更以分號分隔格式的現有 RDP 屬性,例如已經顯示的預設值。
當您完成時,請選取 [儲存] 以儲存您的變更。 使用者需要重新整理其資源,才能接收變更。
若要使用 Azure PowerShell 設定 RDP 屬性,請使用下列範例。 請務必將 <placeholder>
值變更為自己的值。 如需支援屬性和值的完整清單,請參閱 Azure 虛擬桌面 支援的 RDP 屬性。
在 Azure 入口網站中使用 PowerShell 終端機類型開啟 Azure Cloud Shell ,或在本機裝置上執行 PowerShell。
根據您的需求使用下列其中一個範例:
若要將自定義 RDP 屬性新增至主機集區,並保留任何已設定的現有自定義屬性,請執行下列命令。 RDP 屬性必須以分號分隔的格式撰寫。 此範例會新增停用剪貼簿和印表機重新導向:
$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
若要將所有現有的自定義屬性取代為一組新的自定義 RDP 屬性,請執行下列命令。 此範例只會設定停用剪貼簿和印表機重新導向:
$hostPool = "<HostPoolName>"
$resourceGroup = "<ResourceGroupName>"
$customProperties = "redirectclipboard:i:0;redirectprinters:i:0"
Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
若要從主機集區移除所有自定義 RDP 屬性,請執行下列命令。 這個範例會將空字串傳遞至 CustomRdpProperty
參數:
$hostPool = "<HostPoolName>"
$resourceGroup = "<ResourceGroupName>"
$customProperties = ""
Update-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup -CustomRdpProperty $customProperties
執行下列命令,檢查在相同主機集區上設定的自定義 RDP 屬性:
Get-AzWvdHostPool -Name $hostPool -ResourceGroupName $resourceGroup | FT Name, CustomRdpProperty
輸出內容應會類似於下列範例:
Name : contoso-hp01
CustomRdpProperty : use multimon:i:1;redirectclipboard:i:0;redirectprinters:i:0;
使用者需要重新整理其資源,才能接收變更。
若要使用 Azure CLI 設定 RDP 屬性,請使用下列範例。 請務必將 <placeholder>
值變更為自己的值。 如需支援屬性和值的完整清單,請參閱 Azure 虛擬桌面 支援的 RDP 屬性。
在 Azure 入口網站中使用 Bash 終端機類型開啟 Azure Cloud Shell ,或在本機裝置上執行 Azure CLI。
根據您的需求使用下列其中一個範例:
若要將自定義 RDP 屬性新增至主機集區,並保留任何已設定的現有自定義屬性,請執行下列命令。 RDP 屬性必須以分號分隔的格式撰寫。 此範例會將停用剪貼簿和印表機重新導向新增至現有的自訂屬性:
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"
若要將所有現有的自定義屬性取代為一組新的自定義 RDP 屬性,請執行下列命令。 此範例只會設定停用剪貼簿和印表機重新導向:
hostPool="<HostPoolName>"
resourceGroup="<ResourceGroupName>"
az desktopvirtualization hostpool update \
--name $hostPool \
--resource-group $resourceGroup \
--custom-rdp-property "redirectclipboard:i:0;redirectprinters:i:0"
若要從主機集區移除所有自定義 RDP 屬性,請執行下列命令。 這個範例會將空字串傳遞至 --custom-rdp-property
參數:
hostPool="<HostPoolName>"
resourceGroup="<ResourceGroupName>"
az desktopvirtualization hostpool update \
--name $hostPool \
--resource-group $resourceGroup \
--custom-rdp-property ""
執行下列命令,檢查在相同主機集區上設定的自定義 RDP 屬性:
az desktopvirtualization hostpool show \
--name $hostPool \
--resource-group $resourceGroup \
--query "{name:name, customRdpProperty:customRdpProperty}" \
--output table
輸出內容應會類似於下列範例:
Name CustomRdpProperty
-------- ------------------------------------------------------------
contoso-hp01 use multimon:i:0;redirectclipboard:i:0;redirectprinters:i:0;
使用者需要重新整理其資源,才能接收變更。
相關內容