使用 PowerShell 啟用 Azure 雲端服務 (傳統) 中角色的遠端桌面連線
重要
截至 2024 年 9 月 1 日，所有客戶的雲端服務 (傳統) 均已淘汰。 自 2024 年 10 月起，Microsoft 將停止並關閉任何執行中的現有部署，且資料將永久遺失。 新部署應該使用 Azure Resource Manager 型的新部署模型 Azure 雲端服務 (延伸支援)。
遠端桌面可讓您存取 Azure 內執行中角色的桌面。 您可以使用遠端桌面連線，來疑難排解和診斷執行中應用程式的問題。
這篇文章描述如何使用 PowerShell 在雲端服務角色上啟用遠端桌面。 如需這篇文章所需要的必要條件，請參閱 如何安裝和設定 Azure PowerShell 。 PowerShell 會利用遠端桌面延伸模組，因此在應用程式部署之後，您也可以啟用遠端桌面。
從 PowerShell 設定遠端桌面
Set-AzureServiceRemoteDesktopExtension Cmdlet 可讓您在雲端服務部署的指定角色或所有角色上啟用遠端桌面。 此 Cmdlet 可讓您透過可接受 PSCredential 物件的 Credential 參數，指定遠端桌面使用者的使用者名稱和密碼。
如果以互動方式使用 PowerShell，您可以呼叫 Get-Credentials Cmdlet，輕鬆地設定 PSCredential 物件。
$remoteusercredentials = Get-Credential
此命令會顯示對話方塊，可讓您以安全的方式輸入遠端使用者的使用者名稱和密碼。
由於 PowerShell 在自動化案例中非常實用，您也可以透過不需要使用者互動的方式設定 PSCredential 物件。 您必須先設定安全的密碼。 首先，指定純文字密碼，然後使用 ConvertTo-SecureString轉換成安全字串。 接下來，您需要使用 ConvertFrom-SecureString，將這個安全字串轉換成加密的標準字串。 現在，您可以使用 Set-Content，將此加密的標準字串儲存到檔案。
您也可以建立安全的密碼檔案，這樣就不需要每次都要輸入密碼。 此外，安全的密碼檔案也比純文字檔案安全。 使用下列 PowerShell 來建立安全的密碼檔案：
ConvertTo-SecureString -String "Password123" -AsPlainText -Force | ConvertFrom-SecureString | Set-Content "password.txt"
重要
設定密碼時，請確定您符合 複雜性需求。
若要從安全的密碼檔案建立認證物件，您必須讀取檔案內容，並使用 ConvertTo-SecureString將它們轉換回安全字串。
Set-AzureServiceRemoteDesktopExtension Cmdlet 也接受 Expiration 參數，它可指定使用者帳戶到期的 日期時間 。 例如，您可以設定帳戶在目前日期和時間的幾天後到期。
這個 PowerShell 範例示範如何在雲端服務上設定遠端桌面延伸模組：
$servicename = "cloudservice"
$username = "RemoteDesktopUser"
$securepassword = Get-Content -Path "password.txt" | ConvertTo-SecureString
$expiry = $(Get-Date).AddDays(1)
$credential = New-Object System.Management.Automation.PSCredential $username,$securepassword
Set-AzureServiceRemoteDesktopExtension -ServiceName $servicename -Credential $credential -Expiration $expiry
您可以選擇性地指定部署位置和您想要啟用遠端桌面的角色。 如果未指定這些參數，此 Cmdlet 會在「生產」部署位置中的所有角色上啟用遠端桌面。
遠端桌面延伸模組與部署相關聯。 如果您為服務建立新的部署，您必須啟用該部署上的遠端桌面。 如果您想一律啟用遠端桌面，則您應該考慮將 PowerShell 指令碼整合到您的部署工作流程中。
從遠端桌面連接到角色執行個體
Get-AzureRemoteDesktopFile Cmdlet 用於從遠端桌面連接到雲端服務的特定角色執行個體。 您可以使用 LocalPath 參數，在本機下載遠端桌面通訊協定 (RDP) 檔案。 或您可以使用 Launch 參數，直接啟動 [遠端桌面連線] 對話方塊來存取雲端服務角色執行個體。
Get-AzureRemoteDesktopFile -ServiceName $servicename -Name "WorkerRole1_IN_0" -Launch
檢查服務上是否已啟用遠端桌面延伸模組
Get-AzureServiceRemoteDesktopExtension Cmdlet 會顯示服務部署上的遠端桌面為啟用或停用。 此 Cmdlet 會傳回遠端桌面使用者的使用者名稱，以及已啟用遠端桌面延伸模組的角色。 根據預設會使用部署位置，但您可以選擇改用預備位置。
Get-AzureServiceRemoteDesktopExtension -ServiceName $servicename
從服務移除遠端桌面延伸模組
如果您已在部署上啟用遠端桌面延伸模組，且需要更新遠端桌面設定，則必須先移除該延伸模組。 然後使用新的設定將其再次啟用。 例如，如果您想為遠端使用者帳戶或是已到期的帳戶設定新密碼。 必須在已啟用遠端桌面延伸模組的現有部署上執行此步驟。 對於新部署，您可以直接套用此延伸模組。
若要從部署移除遠端桌面延伸模組，您可以使用 Remove-AzureServiceRemoteDesktopExtension Cmdlet。 您也可以選擇性地指定您想要移除遠端桌面延伸模組的部署位置和角色。
Remove-AzureServiceRemoteDesktopExtension -ServiceName $servicename -UninstallConfiguration
注意
若要完全移除延伸模組組態，您應該在呼叫 remove Cmdlet 時指定 UninstallConfiguration 參數。
UninstallConfiguration 參數會將任何已套用到服務的延伸模組組態解除安裝。 每個延伸模組組態都與服務組態相關連。 呼叫 remove Cmdlet 時未指定 UninstallConfiguration 會取消部署與擴充組態的關聯，因此實際上會移除延伸模組。 不過，延伸模組組態仍然與服務相關聯。