搭配使用 StartSession 與 CLI - AWS SDK 程式碼範例

文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 AWS SDK 範例

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

搭配使用 StartSession 與 CLI

下列程式碼範例示範如何使用 StartSession

CLI
AWS CLI

範例 1:啟動 Session Manager 工作階段

start-session 範例示範建立與 Session Manager 工作階段執行個體之間的連線。請注意,若要使用此互動式命令,則需要在進行呼叫的用戶端機器上安裝 Session Manager 外掛程式。

aws ssm start-session \ --target "i-1234567890abcdef0"

輸出:

Starting session with SessionId: Jane-Roe-07a16060613c408b5

範例 2:使用 SSH 啟動 Session Manager 工作階段

start-session 範例示範使用 SSH 建立與 Session Manager 工作階段執行個體之間的連線。請注意,若要使用此互動式命令,則需要在進行呼叫的用戶端機器上安裝 Session Manager 外掛程式;而且該命令會使用執行個體上的預設使用者,例如 Linux EC2 執行個體的 ec2-user

ssh -i /path/my-key-pair.pem ec2-user@i-02573cafcfEXAMPLE

輸出:

Starting session with SessionId: ec2-user-07a16060613c408b5

如需詳細資訊,請參閱 Systems Manager 使用者指南中的啟動工作階段和安裝 CLI 的 Session Manager 外掛程式。 AWS AWS

  • 如需 API 詳細資訊,請參閱《AWS CLI 命令參考》中的 StartSession

PowerShell
PowerShell V4 的工具

範例 1:此範例示範啟動與 Session Manager 工作階段目標的連線,以啟用連接埠轉送。

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

PowerShell V5 的工具

範例 1:此範例示範啟動與 Session Manager 工作階段目標的連線,以啟用連接埠轉送。注意:如果尚未使用 AWSCredentials 設定 ,則需要新增區域參數。

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:此範例會建立具有 Session Manager 工作階段指定執行個體的互動式工作階段。

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 Reference (V5) 中的 StartSession