在 Linux 受管節點上執行 PowerShell 指令碼 - AWS Systems Manager

在 Linux 受管節點上執行 PowerShell 指令碼

使用 aws:runPowerShellScript 外掛程式或 AWS-RunPowerShellScript 命令文件以及 PowerShell Core,您可以在 Linux 受管節點上執行 PowerShell 指令碼。這對於熟悉 PowerShell 且比起其他指令碼語言較偏好使用 PowerShell 的系統管理員來說十分有用。

開始之前

連線至您的 Linux 受管節點,並遵循適當作業系統的 PowerShell Core 安裝程序。

許多 PowerShell 命令 (cmdlet) 無法在 Linux 上使用。若要查看可以使用哪些命令,請在 Linux 受管節點上使用 pwsh 命令來啟動 PowerShell 之後,使用 Get-Command Cmdlet。如需詳細資訊,請參閱 Get-Command

下列程序說明如何使用主控台在 Linux 受管節點上執行 PowerShell 指令碼。

使用主控台在 Linux 受管節點上執行 PowerShell 指令碼

  1. 開啟位於 AWS Systems Managerhttps://console.aws.amazon.com/systems-manager/ 的 主控台。https://console.aws.amazon.com/systems-manager/

  2. 在導覽窗格中,選擇 Run Command

    -或-

    如果 AWS Systems Manager 首頁先開啟,選擇選單圖示 ( ) 以開啟導覽窗格,然後選擇 Run Command

  3. 選擇 執行命令

  4. Command document (命令文件) 清單中,選擇 AWS-RunPowerShellScript 文件。

  5. Command parameters (命令參數) 區段中,指定您要使用的可用 PowerShell 命令。

  6. Targets (目標) 區段中,透過手動指定標籤、選取執行個體或邊緣裝置,或指定資源群組,選擇您要執行這項操作的受管節點。

    注意

    如果您預期看到的受管節點未列出,請參閱 疑難排解受管節點的可用性 以取得疑難排解秘訣。

  7. 對於 Other parameters (其他參數)

    • Comment (註解) 中,輸入此命令的相關資訊。

    • Timeout (seconds) (逾時 (秒)) 中,指定在命令執行全面失敗之前,系統要等候的秒數。

  8. 對於 Rate control (速率控制):

    • Concurrency (並行) 中,指定可同時執行命令的受管節點數目或百分比。

      注意

      如果透過指定套用至受管節點的標籤或指定 AWS 資源群組選取了目標,且您不確定會以多少個受管節點為目標,則透過指定百分比限制可以同時執行文件之目標的數量。

    • Error threshold (錯誤閾值) 中,指定在特定數目或百分比之節點上的命令失敗之後,停止在其他受管節點上執行命令。例如,如果您指定三個錯誤,則 Systems Manager 會在收到第四個錯誤時停止傳送命令。仍在處理命令的受管節點也可能會傳送錯誤。

  9. (選用) 針對 Output options (輸出選項),若要將命令輸出儲存至檔案,請選取 Write command output to an S3 bucket (將命令輸出寫入至 S3 儲存貯體) 方塊。在方塊中輸入儲存貯體和字首 (資料夾) 名稱。

    注意

    授予能力以將資料寫入至 S3 儲存貯體的 S3 許可,會是指派給執行個體之執行個體設定檔 (適用於 EC2 執行個體) 或 IAM 服務角色 (內部部署機器) 的許可,而不是執行此任務之 IAM 使用者的許可。如需詳細資訊,請參閱建立適用於 Systems Manager 的 IAM 執行個體設定檔或者建立適用於混合環境的 IAM 服務角色。此外,若指定的 S3 儲存貯體位於不同的 AWS 帳戶 內,請確保與受管節點相關聯的執行個體設定檔或 IAM 服務角色是否具有寫入該儲存貯體的必要許可。

  10. SNS notifications (SNS 通知) 區段中,如果您要傳送有關命令執行狀態的通知,請選取 Enable SNS notifications (啟用 SNS 通知) 核取方塊。

    如需為 Run Command 設定 Amazon SNS 通知的詳細資訊,請參閱 使用 Amazon SNS 通知監控 Systems Manager 狀態變更

  11. 選擇 Run (執行)。

若要查看使用 aws:runPowerShellScript 外掛程式的範例,請參閱aws:runPowerShellScript