本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `AWSSupport-ManageRDPSettings`
<a name="automation-awssupport-managerdpsettings"></a>

 **Description** 

`AWSSupport-ManageRDPSettings` Runbook 允許使用者管理常見的遠端桌面通訊協定 (RDP) 設定，例如 RDP 連接埠和網路層身分驗證 (NLA)。根據預設，執行手冊會讀取和輸出設定的值。

**重要**  
執行此 Runbook 之前，應仔細檢閱 RDP 設定的變更。

[執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-ManageRDPSettings)

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（選用） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 的使用者許可。
+ InstanceId

  類型：字串

  描述：(必要) 管理 RDP 設定的受管執行個體之 ID。
+ NLASettingAction

  類型：字串

  有效值：檢查 \$1 啟用 \$1 停用

  預設：Check

  描述：(必要) 在 NLA 設定上執行的動作：Check，Enable，Disable。
+ RDPPort

  類型：字串

  預設：3389

  描述：(選用) 指定新的 RDP 連接埠。僅在動作設為 Modify 時使用。連接埠號碼必須為介於 1025 到 65535 的數字。備註：連接埠變更之後，RDP 服務會重新啟動。
+ RDPPortAction

  類型：字串

  有效值：檢查 \$1 修改

  預設：Check

  描述：（必要） 要套用至 RDP 連接埠的動作。
+ RemoteConnections

  類型：字串

  有效值：檢查 \$1 啟用 \$1 停用

  預設：Check

  描述：（必要） 在 fDenyTSConnections 設定上執行的動作。

**必要的 IAM 許可**

`AutomationAssumeRole` 參數需要下列動作才能成功使用 Runbook。

接收命令的 EC2 執行個體必須具備已連接 **AmazonSSMManagedInstanceCore** Amazon 受管政策的 IAM 角色。使用者必須至少具備 **ssm:SendCommand** 以傳送命令給執行個體，也要有 **ssm:GetCommandInvocation** 才能夠讀取命令輸出。

 **文件步驟** 

`aws:runCommand` - 執行 PowerShell 指令碼以變更或檢查目標執行個體上的 RDP 設定。

 **輸出** 

manageRDPSettings.Output