• AWS Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。 # 将 `StartSession` 与 CLI 配合使用 以下代码示例演示如何使用 `StartSession`。 ------ #### [ CLI ] **AWS CLI** **示例 1：启动会话管理器会话** 此 `start-session` 示例为会话管理器会话建立与实例的连接。请注意，此交互式命令要求在进行调用的客户端计算机上安装会话管理器插件。 ``` aws ssm start-session \ --target "i-1234567890abcdef0" ``` 输出： ``` Starting session with SessionId: Jane-Roe-07a16060613c408b5 ``` **示例 2：使用 SSH 启动会话管理器会话** 此 `start-session` 示例为使用 SSH 的会话管理器会话建立与实例的连接。请注意，此交互式命令要求在进行调用的客户端计算机上安装会话管理器插件，并且该命令在实例上使用默认用户，例如为 Linux 的 EC2 实例使用 `ec2-user`。 ``` ssh -i /path/my-key-pair.pem ec2-user@i-02573cafcfEXAMPLE ``` 输出： ``` Starting session with SessionId: ec2-user-07a16060613c408b5 ``` 有关更多信息，请参阅*《AWS Systems Manager 用户指南》*中的[启动会话](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-sessions-start.html)和[为 AWS CLI 安装会话管理器插件](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html)。 + 有关 API 详细信息，请参阅《*AWS CLI 命令参考*》中的 [StartSession](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm/start-session.html)。 ------ #### [ PowerShell ] **适用于 PowerShell V4 的工具** **示例 1：此示例为会话管理器会话启动与目标的连接，从而启用端口转发。** ``` Start-SSMSession -Target 'i-064578e5e7454488f' -DocumentName 'AWS-StartPortForwardingSession' -Parameter @{ localPortNumber = '8080'; portNumber = '80' } ``` **输出**： ``` SessionId StreamUrl ---------- ---------- random-id0 wss://ssmmessages.amazonaws.com/v1/data-channel/random-id ``` + 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet Reference（V4）》中的 [StartSession](https://docs.aws.amazon.com/powershell/v4/reference)**。 **适用于 PowerShell V5 的工具** **示例 1：此示例为会话管理器会话启动与目标的连接，从而启用端口转发。注意：如果尚未使用 AWSCredentials 进行设置，则需要添加 Region 参数。** ``` Start-SSMSession -Target 'i-064578e5e7454488f' -DocumentName 'AWS-StartPortForwardingSession' -Parameter @{ localPortNumber = '8080'; portNumber = '80' } -Region 'us-west-1' ``` **输出**： ``` Starting session with SessionId: testUser-xi4glew849asyeryde34u4dfsdfy Port 8080 opened for sessionId testUser-xi4glew849asyeryde34u4dfsdfy. Waiting for connections... ``` **示例 2：此示例为会话管理器会话创建与指定实例的交互式会话。** ``` Start-SSMSession -Target 'i-1234567890abcdef0' -Region 'us-west-1' ``` **输出**： ``` Starting session with SessionId : testUser-xi4glew849asyeryde34u4dfsdfy Windows PowerShell Copyright (C) Microsoft Corporation. All rights reserved. Install the latest PowerShell for new features and improvements! PS C:\Windows\system32> whoami ec2amaz-fnsdrwv\ec2-test-user PS C:\Windows\system32> ``` **示例 3：此示例创建一个会话但不连接到它，并返回连接到该会话所需的 SessionId、StreamUrl 和 TokenValue 属性。** ``` Start-SSMSession -Target 'i-1234567890abcdef0' -Region 'us-west-1' -DisablePluginInvocation ``` **输出**： ``` SessionId : testUser-xi4glew849asyeryde34u4dfsdfy StreamUrl : {StreamUrl value redacted} TokenValue : {Token value redacted} ContentLength : 1207 HttpStatusCode : OK ``` + 有关 API 详细信息，请参阅《*AWS Tools for PowerShell Cmdlet 参考 (V5)*》中的 [StartSession](https://docs.aws.amazon.com/powershell/v5/reference)。 ------ 有关 AWS SDK 开发人员指南和代码示例的完整列表，请参阅 [将此服务与 AWS SDK 结合使用](sdk-general-information-section.md) 本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。