云助手命令可以在ECS实例中快速完成运行自动化运维脚本、轮询进程、重置用户密码、安装或者卸载软件、更新应用以及安装补丁等一些日常任务。命令类型可以是Windows PowerShell脚本、Bat批处理命令和Linux Shell脚本，命令中支持自定义参数，方便设置变量值。

背景信息

• 在一个阿里云地域下，您可以保有100条云助手命令，配额随您的云服务器使用情况可能会增加。

  说明 您也可以调用API DescribeAccountAttributes，将参数AttributeName.N设置为max-axt-command-count，查询一个地域中云助手命令配额。

• 创建的脚本在Base64编码后大小不能超过16 KB。

• 一份云助手命令中的自定义参数不能超过20个。

• 创建命令时，您需要自行测试命令的语法、逻辑或算法是否正确。

  例如，假设您已在实例中创建了一个/backup目录(mkdir /backup)，以下Shell命令将在该目录中归档一份文件。

  #!/bin/bash
  OF=/backup/my-backup-$(date +%Y%m%d).tgz
  tar -cf $OF {{file}}

  说明 以上示例命令中，{{file}}是一个自定义参数，您可以在执行命令时设置为需要归档的目标文件，如/app/usrcredential。自定义参数能满足动态取值以及一值多用的场景。对于具有安全敏感性的数据以及随环境变化的数据，建议您设置自定义参数，例如AccessKey、实例ID、授权码、时间参数、关键系统文件等。

控制台操作

1. 登录ECS管理控制台云助手页面。

2. 在顶部状态栏左上角处，选择地域。

3. 单击创建 / 新建命令，完成配置。

   

• Shell命令：默认在root用户的/home目录。

• Bat或者Power Shell命令：默认在云助手客户端进程目录，例如，C:\ProgramData\aliyun\assist\$(version)。

• Linux系统ECS实例：选择Shell。

• Windows系统ECS实例：选择Bat或者Power Shell。

1. 选择命令类型。

2. 在命令内容框中，编辑或者粘贴您的命令。

   有关Shell命令的示例，可以参见查看实例系统配置。

3. 单击开关按钮，确定是否使用参数。

   如果您开启了使用参数功能，在命令内容中以{{key}}格式设置自定义参数。

4. 输入命令名称。

5. 输入命令描述。

6. 输入命令的执行路径。

7. 设置命令在实例中的最大的超时时间，单位为秒，默认为60秒。

8. 单击确定。

CLI示例

• 请求示例：

  调用CreateCommand接口创建一份名为test的云助手命令，假设命令内容为echo 123，并使用Base64编码明文命令。如果目标实例为Windows实例，将Type修改为RunBatScript或者RunPowershellScript。

  < style="box-sizing: border-box;transition: color 0.2s ease 0s;color: rgb(255, 255, 255);background: url("https://mmbiz.qpic.cn/mmbiz_png/tMJtfgIIibWJSmYr6lYNdCxJx7ia15s0WTXlKlh50BYtj04QPku40DNtDXjWlvB5GUia81Z9GqiaemshDlX4jzf61Q/640?wx_fmt=png") 15px 8px / 10px no-repeat;outline: none;display: inline-block;width: 65.9926px;height: 30px;font-size: 12px;text-align: center;line-height: 30px;text-indent: 18px; top: 0px;left: 0px;" target="_blank">试用

  aliyun ecs CreateCommand --RegionId TheRegionId--CommandContent ZWNobyAxMjM=--Type RunShellScript--Name test--Description test--output cols=CommandId

• 返回示例：

  CommandId
  ---------
  c-hz0b8osxk8a***

后续步骤

执行命令

说明 如果您创建的命令使用了参数，执行命令时，您需要在命令参数栏中填写参数取值。