View a markdown version of this page

AWSSupport-TroubleshootWindowsUpdate - AWS Systems Manager 自动化运行手册参考

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

AWSSupport-TroubleshootWindowsUpdate

描述

该AWSSupport-TroubleshootWindowsUpdate运行手册用于确定可能导致亚马逊弹性计算云(亚马逊 EC2)Windows 实例的 Windows 更新失败的问题。

如何工作?

该运行手册执行以下步骤:

  • 检查目标 Amazon EC2 实例是否由管理 AWS Systems Manager。

  • 检查系统管理器修补操作是否支持代 AWS Systems Manager 理(SSM 代理)和 Windows 服务器版本。

  • 检查 Windows 更新推荐的可用磁盘空间以及重启是否处于待处理状态。待重启通常表示更新处于待处理状态,需要重新启动才能执行其他更新。

  • 在操作系统级别配置代理设置,这有助于解决连接问题。

  • 执行亚马逊简单存储服务 (Amazon S3) 终端节点连接测试并调用 GetDeployablePatchSnapshotForInstance API 操作以检索托管节点使用的补丁基准的当前快照。

  • 如果连接失败,则提供运行手AWSSupport-AnalyzeAWSEndpointReachabilityFromEC2册来分析实例与 Amazon S3 终端节点的连接的选项。

  • 验证 Windows 更新配置并测试 Windows 服务器更新服务 (WSUS)(如果适用)。

重要
  • 不支持活动目录域控制器。

  • 不支持 Windows 服务器版本 2008 R2 或以前的版本。

  • 不支持 SSM 代理 1.2.371 或以前的版本。

  • 该AWSSupport-AnalyzeAWSEndpointReachabilityFromEC2运行手册VPC Reachability Analyzer用于分析源端点和服务端点之间的网络连接。每次在来源和目标之间运行分析时,您需要支付费用。有关详细信息,请参阅 Amazon VPC 定价。

  • 该AWSSupport-AnalyzeAWSEndpointReachabilityFromEC2运行手册并非在支持 Systems Manager 的所有地区都可用。

运行此自动化(控制台)

文档类型

自动化

所有者

Amazon

平台

Windows

参数

所需的 IAM 权限

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

  • ssm:StartAutomationExecution

  • ssm:GetAutomationExecution

  • ssm:DescribeInstanceInformation

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:ListCommands

注意

要运行子运行手册AWSSupport-AnalyzeAWSEndpointReachabilityFromEC2,请添加本文档中列出的权限。

说明

按照这些步骤对自动化进行配置:

  1. 导航到 AWSSupport-TroubleshootWindowsUpdate “系统管理器” 下的 “文档”。

  2. 选择 Execute automation(执行自动化)。

  3. 对于输入参数,输入以下内容:

    • AutomationAssumeRole (可选):

      (IAM) 角色的亚马逊资源名称 AWS AWS Identity and Access Management (ARN),允许系统管理员自动化代表您执行操作。如果未指定任何角色,系统管理员自动化将使用启动本运行手册的用户的权限。

    • InstanceId (必填):

      输入 Windows 更新失败的亚马逊 EC2 实例的 ID。

    • RunVpcReachabilityAnalyzer(可选):

      如果网络问题是由扩展检查确定的,或者指定的true实例 ID 不是托管实例,则指定运行AWSSupport-AnalyzeAWSEndpointReachabilityFromEC2自动化。有关此子自动化的更多信息,请参阅文档。默认值为 false。

    • RetainVpcReachabilityAnalysis(可选):

      仅在存在时RunVpcReachabilityAnalyzer才相关true。指定true保留由创建的网络洞察路径和相关分析Reachability Analyzer。默认情况下,成功分析后会删除这些资源。如果您选择保留分析,子运行手册不会删除分析,您可以在 Amazon VPC 控制台中将其可视化。控制台链接将在子自动化输出中可用。默认值false。

    显示 InstanceId、 AutomationAssumeRole RunVpcReachabilityAnalyzer、和 RetainVpcReachabilityAnalysis 字段的输入参数部分。
  4. 选择执行。

  5. 自动化启动。

  6. 文档将执行以下步骤:

    • getWindowsServerAndSSMAgentVersion:

      验证目标实例是否由管理, AWS Systems Manager 并获取有关 SSM 代理版本和 Windows 版本的详细信息。

    • assertifInstanceIsSsmManaged:

      确保 Amazon EC2 实例由 AWS Systems Manager (SSM) 管理,否则自动化将结束。

    • CheckProxy:

      检查 Windows 实例的所有代理类型。

    • CheckPrerequisites:

      获取 SSM 代理版本和 Windows 版本,并确定它是否是 Active Directory 域控制器 (DC)。如果该实例是 DC,或者不支持 SSM 代理或 Windows 版本,则运行手册将停止。

    • CheckDiskSpace:

      获取并验证 Windows 实例上的可用磁盘空间是否足以执行 Windows 更新。

    • CheckPendingReboot:

      检查是否有任何待重启的 Windows 实例。

    • CheckS3Connectivity:

      检查该实例是否可以到达的 Amazon S3 终端节点Patchbaseline。

    • branchOnRunVpcReachabilityAnalyzer:

      如果RunVpcReachabilityAnalyzer属实,则它将自动化分支为调试 Amazon S3 连接进行更深入的分析。

    • GenerateEndpoints:

      生成一个终端节点以对 Amazon S3 终端节点进行扩展连接检查。

    • analyzeAwsEndpointReachabilityFromEC2:

      调用自动化运行手册AWSSupport-AnalyzeAWSEndpointReachabilityFromEC2。以检查所选实例到所需端点的可访问性。

    • CheckWindowsUpdateServices:

      检查 Windows 更新服务状态和启动类型。

    • CheckWindowsUpdateSettings:

      检查在 Windows 实例上配置的 Windows 更新策略。

    • CheckWSUSSettings:

      检查 Windows 更新是使用 WSUS 还是微软更新目录配置的,并验证连接。

    • CheckWUGlobalSettings:

      检查在 Windows 实例上配置的 Windows 更新全局设置。

    • GenerateLogs:

      将 Windows 更新日志和 CBS 日志下载到实例桌面,并检查 Windows 事件日志中是否存在故障。

    • FinalReport:

      生成所有步骤的完整报告。

  7. 完成后,请查看 “输出” 部分,了解详细的执行结果:

    最终报告结果显示所有先决条件和配置检查均已通过,并带有绿色复选标记。

参考

Systems Manager Automation

与 AWS 服务相关的文档