将 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 用户指南》中的启动会话和为 AWS CLI 安装会话管理器插件。

• 有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 StartSession。

PowerShell

Tools for 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 参考（V4）》中的 StartSession。

Tools for 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。

有关 AWS SDK 开发人员指南和代码示例的完整列表，请参阅 将此服务与 AWS SDK 结合使用。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。