全部產品
Search
文件中心

Elastic Compute Service:建立命令

更新時間:Apr 21, 2026

雲助手命令可以在ECS執行個體中快速完成運行自動化營運指令碼、輪詢進程、重設使用者密碼、安裝或卸載軟體、更新應用以及安裝補丁等日常任務。命令類型可以是Windows PowerShell指令碼、Bat批處理命令和Linux Shell指令碼,命令中支援自訂參數,方便設定變數值。

使用限制

  • 在一個阿里雲地區下,您可以儲存500~50,000條雲助手命令,配額隨您的雲端服務器使用方式可能會增加。您也可以申請提升配額,關於如何查詢及提升配額,請參見ECS配額管理建立命令會佔用雲助手命令配額。

    說明

    填寫詳細的配額提升申請理由可提高審批通過率。

  • 建立的指令碼在Base64編碼後大小不能超過18 KB。

操作步驟

通過控制台建立命令

  1. 訪問ECS控制台-雲助手

  2. 在頁面左側頂部,選擇雲助手命令所屬資源群組與所在的地區。

    說明

    設定命令所屬的資源群組後,您可以在資源群組層面對命令進行許可權管理,將所需的RAM權限原則加入指定的資源群組以實現資源群組鑒權。命令相關的RAM權限原則和資源群組鑒權說明,請參見雲助手命令自訂策略樣本資源分組和授權

    地區

  3. ECS 雲助手頁面右上方,單擊建立/執行命令

  4. 命令信息地區,完成以下配置:

    • 命令內容:可開啟使用參數

      命令內容在Base64編碼後,選擇執行並保存時不能超過18 KB,選擇執行時不能超過24 KB。
      • 自訂參數:使用{{parameter}}格式定義參數,手動賦值,能滿足動態取值以及一值多用的情境。

      • 內建參數:雲助手提供了一些內建參數,無需手動賦值,可在執行時自動替換,例如 {{ACS::RegionId}}(地區 ID)、{{ACS::InstanceId}}(執行個體 ID)等。

      #!/bin/bash
      # 樣本
      # {{name}}是自訂參數,需要在命令內容編寫完成後進行手動賦值
      echo {{name}}
      
      # {{ACS::RegionId}}是內建參數,無需手動賦值
      echo {{ACS::RegionId}}
    • 執行計劃

      • 僅預檢:只預檢此次請求,命令內容不會實際生效,檢查項包括請求參數、執行個體執行環境、雲助手Agent運行狀態等。

      • 定時執行

        • 固定時間間隔執行:基於Rate運算式,僅適用於固定的時間間隔。

          設定的時間間隔不大於7天、不小於60秒,且需大於定時任務的逾時時間。
        • 基於時鐘定時執行:基於Cron運算式,配置靈活,適用於較複雜的定時任務執行情境。

    • 執行使用者:預設為root (Linux) 或System (Windows)。建議遵循最小許可權原則,使用普通使用者執行。

    • 執行路徑:指令碼在執行個體內的執行目錄。Linux 預設在 /root 目錄下,Windows 預設在 C:\Windows\system32 目錄下。為確保指令碼在預期路徑下執行,建議在指令碼開頭使用cd命令切換目錄。

    • 逾時時間:預設為 60 秒。可設定逾時範圍為10~86400秒(24小時)。

    • 任務終止模式

      • 指令碼進程:停止任務時會終止指令碼進程。

      • 進程樹:停止任務時會終止進程樹(指令碼進程以及它建立的所有子進程的集合)。

  5. 選擇執行個體或者選擇受管理的執行個體地區,選中需要執行命令的目標執行個體。

    可選擇多台執行個體,最多支援100台。
  6. 單擊儲存

通過CLI建立命令

請求樣本

調用CreateCommand介面建立一條名為update的雲助手命令,用於更新系統。

aliyun ecs CreateCommand --RegionId 'cn-hangzhou' \
--CommandContent 'eXVtIHVwZGF0ZSAteQ==' \
--Type 'RunShellScript' \
--Name 'update' \
--Description 'update' \
--output cols=CommandId
說明

半形單引號('')內為參數的樣本取值,您需要根據實際情況修改。

主要參數說明如下表所示,更多參數說明,請參見CreateCommand

名稱

樣本

描述

RegionId

cn-hangzhou

地區ID。

Name

update

命令名稱。

Type

RunShellScript

命令類型。

  • Linux:RunShellScript

  • Windows:RunBatScript或者RunPowerShellScript

CommandContent

eXVtIHVwZGF0ZSAteQ==

通過Base64編碼後的命令內容。

Description

update

命令的描述資訊。

返回樣本

CommandId
---------
c-hz018qng4on****

後續步驟

建立命令後,您可以在我的命令頁簽中查看具體資訊。如果需要對指定執行個體執行此命令,請參見執行命令

說明

如果您建立的命令使用了參數,執行命令時,您需要在命令參數欄中填寫參數取值。