本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# `AWSSupport-TroubleshootRDP`
<a name="automation-awssupport-troubleshootrdp"></a>

 **描述** 

`AWSSupport-TroubleshootRDP` 运行手册允许用户检查或修改目标实例上可能影响远程桌面协议 (RDP) 连接的常规设置，如 RDP 端口、网络层身份验证 (NLA) 和 Windows 防火墙配置文件。（可选）如果用户明确允许进行离线修复，则可以通过停止和启动实例来离线应用更改。默认情况下，此运行手册读取和输出这些设置的值。

**重要**  
在使用此运行手册之前，应仔细检查对 RDP 设置、RDP 服务和 Windows 防火墙配置文件的更改。

[运行此自动化（控制台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootRDP)

**文档类型**

自动化

**所有者**

Amazon

**平台**

Windows

**参数**
+ 操作

  类型：字符串

  有效值： CheckAll \$1 FixAll \$1 自定义

  默认值：Custom

  描述：（可选）[自定义] 使用 “防火墙”、“操作” RDPService StartupType、“ RDPService操作”、“ RDPPort操作” 和 “ NLASetting操作” 中的值RemoteConnections 来管理设置。[CheckAll] 读取设置的值而不进行更改。[FixAll] 恢复 RDP 默认设置，然后禁用 Windows 防火墙。
+ AllowOffline

  类型：字符串

  有效值：true \$1 false

  默认：false

  说明：（可选）仅修复 - 如果当在线故障排除失败或提供的实例不是托管实例时允许进行离线 RDP 修复，请将其设置为 true。注意：对于离线修复，SSM Automation 会停止实例，并在尝试任何操作前创建一个 AMI。
+ AutomationAssumeRole

  类型：字符串

  描述：（可选）允许 Systems Manager Automation 代表您执行操作 AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称（ARN）。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。
+ 防火墙

  类型：字符串

  有效值：Check \$1 禁用

  默认值：Check

  说明：（可选）检查或禁用 Windows 防火墙（所有配置文件）。
+ InstanceId

  类型：字符串

  说明：（必需）要对其 RDP 设置进行故障排除的实例的 ID。
+ NLASetting 操作

  类型：字符串

  有效值：Check \$1 禁用

  默认值：Check

  说明：（可选）检查或禁用网络层身份验证 (NLA)。
+ RDPPort 操作

  类型：字符串

  有效值：Check \$1 修改

  默认值：Check

  说明：（可选）检查用于 RDP 连接的当前端口，或将 RDP 端口修改回 3389 并重启服务。
+ RDPService 操作

  类型：字符串

  有效值：Check \$1 启动 \$1 重启 \$1 强制重启

  默认值：Check

  描述：（可选）检查、启动、重新启动或强制重启 RDP 服务（）。TermService
+ RDPServiceStartupType

  类型：字符串

  有效值：Check \$1 自动

  默认值：Check

  说明：（可选）检查或设置 RDP 服务在 Windows 启动时自动启动。
+ RemoteConnections

  类型：字符串

  有效值：Check \$1 启用

  默认值：Check

  描述：（可选）要对 fDeny TSConnections 设置执行的操作：选中，启用。
+ S3 BucketName

  类型：字符串

  说明：（可选）仅离线 - 您账户中用于上传故障排除日志的 S3 存储桶的名称。请确保存储桶策略不会向不需要访问收集的日志的各方授予不必要的读/写权限。
+ SubnetId

  类型：字符串

  默认： SelectedInstanceSubnet

  描述：（可选）仅限脱机-用于执行离线故障排除的 EC2 Rescue 实例的子网 ID。如果未指定子网 ID，A AWS Systems Manager utomation 将创建一个新的 VPC。重要：子网必须与位于同一个可用区中 InstanceId，并且必须允许访问 SSM 端点。

**所需的 IAM 权限**

`AutomationAssumeRole` 参数需要执行以下操作才能成功使用运行手册。

建议接收命令的 EC2 实例具有 IAM 角色并附有 Amazon A **SSMManagedInstanceCorema** zon 托管策略。要进行在线修复，用户必须至少有 **ssm: DescribeInstanceInformation**、**ssm: StartAutomationExecution** 和 **ssm: SendCommand** 才能运行自动化并将命令发送到实例，还必须有 **ssm: GetAutomationExecution** 才能读取自动化输出。要进行离线修复，用户必须至少具有 **ssm: DescribeInstanceInformation**、**ssm: StartAutomationExecution**、**ec2: 和** **ssm: DescribeInstances**，GetAutomationExecution才能读取自动化输出。 `AWSSupport-TroubleshootRDP`调用`AWSSupport-ExecuteEC2Rescue`以执行离线修复-请查看的权限`AWSSupport-ExecuteEC2Rescue`以确保您可以成功运行自动化。

 **文档步骤** 

1. `aws:assertAwsResourceProperty`-检查实例是否是 Windows Server 实例

1. `aws:assertAwsResourceProperty` - 检查实例是否为托管实例

1. （在线故障排除）如果实例为托管实例，则：

   1. `aws:assertAwsResourceProperty` - 检查提供的操作值

   1. （在线检查）如果**动作 = CheckAll**，那么：

      `aws:runPowerShellScript`-运行 PowerShell 脚本以获取 Windows 防火墙配置文件状态。

      `aws:executeAutomation` - 调用 `AWSSupport-ManageWindowsService` 以获取 RDP 服务状态。

      `aws:executeAutomation` - 调用 `AWSSupport-ManageRDPSettings` 以获取 RDP 设置。

   1. （在线修复）如果动**作 = FixAll**，那么：

      `aws:runPowerShellScript`-运行 PowerShell 脚本以禁用所有 Windows 防火墙配置文件。

      `aws:executeAutomation` - 调用 `AWSSupport-ManageWindowsService` 以启动 RDP 服务。

      `aws:executeAutomation` - 调用 `AWSSupport-ManageRDPSettings` 以启用远程连接并禁用 NLA。

   1. （在线管理）如果 **Action = Custom**，则：

      `aws:runPowerShellScript`-运行 PowerShell 脚本以管理 Windows 防火墙配置文件。

      `aws:executeAutomation` - 调用 `AWSSupport-ManageWindowsService` 以管理 RDP 服务。

      `aws:executeAutomation` - 调用 `AWSSupport-ManageRDPSettings` 以管理 RDP 设置。

1. （离线修复）如果实例并非托管实例，则：

   1. `aws:assertAwsResourceProperty`-断言 **AllowOffline = 真**

   1. `aws:assertAwsResourceProperty`-断言**操作 = FixAll**

   1. `aws:assertAwsResourceProperty`-断言的价值 SubnetId

      （使用提供的实例的子网）如果 SubnetId 为 SELECTED\$1INSTANCE\$1SUBNET

      `aws:executeAwsApi` - 检索当前实例的子网。

      `aws:executeAutomation` - 使用提供的实例的子网运行 `AWSSupport-ExecuteEC2Rescue`。

   1. （使用提供的自定义子网）如果未选中 SELECTED\$1IN SubnetId STANCE\$1SUBNET

      `aws:executeAutomation`-`AWSSupport-ExecuteEC2Rescue` 使用提供的 SubnetId值运行。

 **输出** 

manageFirewallProfiles。输出

管理RDPService设置。输出

管理 RDPSettings .Output

checkFirewallProfiles。输出

检查RDPService设置。输出

检查 RDPSettings .Output

disableFirewallProfiles。输出

恢复默认设置RDPService。输出

恢复默认. RDPSettings Output

疑难解答RDPOffline。输出

疑难解答RDPOfflineWithSubnetId。输出