你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az connectedmachine run-command
注意
此参考是 Azure CLI(版本 2.49.0 或更高版本)的 connectedmachine 扩展的一部分。 该扩展将在首次运行 az connectedmachine run-command 命令 时自动安装。 详细了解扩展。
此命令组处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
管理已启用 Azure Arc 的服务器上的运行命令。
命令
名称 | 说明 | 类型 | 状态 |
---|---|---|---|
az connectedmachine run-command create |
创建操作以创建或更新运行命令。 |
扩展 | 预览版 |
az connectedmachine run-command delete |
删除操作以删除运行命令。 |
扩展 | 预览版 |
az connectedmachine run-command list |
列出操作以获取非 Azure 计算机的所有运行命令。 |
扩展 | 预览 |
az connectedmachine run-command show |
获取用于获取运行命令的操作。 |
扩展 | 预览 |
az connectedmachine run-command update |
用于创建或更新运行命令的更新操作。 |
扩展 | 预览 |
az connectedmachine run-command wait |
将 CLI 置于等待状态,直到满足条件。 |
扩展 | 预览 |
az connectedmachine run-command create
命令组“az connectedmachine run-command”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
创建操作以创建或更新运行命令。
az connectedmachine run-command create --machine-name
--name
--resource-group
[--async {0, 1, f, false, n, no, t, true, y, yes}]
[--command-id]
[--error-blob-managed-identity]
[--error-blob-uri]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--output-blob-managed-identity]
[--output-blob-uri]
[--parameters]
[--password]
[--protected-parameters]
[--run-as-user]
[--script]
[--script-uri]
[--script-uri-managed-id]
[--tags]
[--timeout]
示例
用于运行命令创建的示例命令
az connectedmachine run-command create --resource-group "myResourceGroup" --location "West US" --async false --parameters "[{"name":"param1","value":"value1"}]" --password "<runAsPassword>" --user "user1" --script "Write-Host Hello World!" --timeout 3600 --name "myRunCommand" --machine-name "myMachine" --subscription "mySubscription"
az connectedmachine run-command create --resource-group "myResourceGroup" --location "West US" --script "Write-Host Hello World!" --name "myRunCommand" --machine-name "myMachine" --output-uri "https://mystorageaccount.blob.core.windows.net/mycontainer/RuncommandOutput.txt?sp=racw&st=2022-10-17T19:02:15Z&se=2022-10-18T03:02:15Z&spr=https&sv=2021-06-08&sr=b&sig=3BxtEasfdasdfasdfdYki9yvYsqc60V0%3D" --subscription "mySubscription"
必需参数
混合计算机的名称。
run 命令的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
可选。 如果设置为 true,则脚本启动后预配将立即完成,并且不会等待脚本完成。
指定预定义内置脚本的 commandId。
用户分配的托管标识有权访问 errorBlobUri 存储 Blob。 在系统分配的标识的情况下使用空对象。 确保已向托管标识授予对具有“存储 Blob 数据参与者”角色分配的 Blob 容器的访问权限。 对于用户分配的标识,请确保将其添加到 VM 的标识下。 有关托管标识和运行命令的详细信息,请参阅 https://aka.ms/ManagedIdentity 和支持 https://aka.ms/RunCommandManaged 速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
指定将上传脚本错误流的 Azure 存储 Blob。 使用具有读取、追加、创建、写入访问权限的 SAS URI 或使用托管标识提供对 Blob 的 VM 访问权限。 引用 errorBlobManagedIdentity 参数。
未指定资源所在的地理位置,将使用资源组的位置。
不等待长时间运行的操作完成。
用户分配的托管标识有权访问 outputBlobUri 存储 Blob。 在系统分配的标识的情况下使用空对象。 确保已向托管标识授予对具有“存储 Blob 数据参与者”角色分配的 Blob 容器的访问权限。 对于用户分配的标识,请确保将其添加到 VM 的标识下。 有关托管标识和运行命令的详细信息,请参阅 https://aka.ms/ManagedIdentity 和支持 https://aka.ms/RunCommandManaged 速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
指定将上传脚本输出流的 Azure 存储 Blob。 使用具有读取、追加、创建、写入访问权限的 SAS URI 或使用托管标识提供对 Blob 的 VM 访问权限。 引用 outputBlobManagedIdentity 参数。
脚本使用的参数。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
在执行 run 命令时,指定计算机上的用户帐户密码。
脚本使用的参数。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
在执行 run 命令时,指定计算机上的用户帐户。
指定要在计算机上执行的脚本内容。
指定脚本下载位置。 它可以是具有读取访问权限或公共 URI 的 Azure 存储 Blob 的 SAS URI。
对于 Azure 存储 Blob,用户分配的托管标识有权访问 scriptUri。 在系统分配的标识的情况下使用空对象。 确保 Azure 存储 blob 存在,并且已向托管标识授予对 Blob 容器的访问权限,并具有“存储 Blob 数据读取者”角色分配。 对于用户分配的标识,请确保将其添加到 VM 的标识下。 有关托管标识和运行命令的详细信息,请参阅 https://aka.ms/ManagedIdentity 和 https://aka.ms/RunCommandManaged。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
资源标记。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
执行 run 命令的超时(以秒为单位)。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az connectedmachine run-command delete
命令组“az connectedmachine run-command”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
删除操作以删除运行命令。
az connectedmachine run-command delete [--ids]
[--machine-name]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]
示例
用于运行命令删除的示例命令
az connectedmachine run-command delete --resource-group "myResourceGroup" --name "myRunCommand" --machine-name "myMachine"
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
混合计算机的名称。
run 命令的名称。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
不提示确认。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az connectedmachine run-command list
命令组“az connectedmachine run-command”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
列出操作以获取非 Azure 计算机的所有运行命令。
az connectedmachine run-command list --machine-name
--resource-group
[--expand]
示例
Run-command 列表的示例命令
az connectedmachine run-command list --resource-group "myResourceGroup" --machine-name "myMachine"
必需参数
混合计算机的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
要应用于操作的展开表达式。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az connectedmachine run-command show
命令组“az connectedmachine run-command”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
获取用于获取运行命令的操作。
az connectedmachine run-command show [--ids]
[--machine-name]
[--name]
[--resource-group]
[--subscription]
示例
run-command show 的示例命令
az connectedmahine run-command show --resource-group "myResourceGroup" --name "myRunCommand" --machine-name "myMachine"
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
混合计算机的名称。
run 命令的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az connectedmachine run-command update
命令组“az connectedmachine run-command”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
用于创建或更新运行命令的更新操作。
az connectedmachine run-command update [--add]
[--async {0, 1, f, false, n, no, t, true, y, yes}]
[--error-blob-managed-identity]
[--error-blob-uri]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--machine-name]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--output-blob-managed-identity]
[--output-blob-uri]
[--parameters]
[--password]
[--protected-parameters]
[--remove]
[--resource-group]
[--run-as-user]
[--set]
[--source]
[--subscription]
[--tags]
[--timeout]
示例
运行命令更新的示例命令
az connetcedmachine run-command update --resource-group "myResourceGroup" --name "myRunCommand" --machine-name "myMachine" --subscription "mySubscription" --tags Tag1=Value1
可选参数
通过指定路径和键值对将对象添加到对象列表。 示例:--add property.listProperty <key=value、string 或 JSON 字符串>。
可选。 如果设置为 true,则脚本启动后预配将立即完成,并且不会等待脚本完成。
用户分配的托管标识有权访问 errorBlobUri 存储 Blob。 在系统分配的标识的情况下使用空对象。 确保已向托管标识授予对具有“存储 Blob 数据参与者”角色分配的 Blob 容器的访问权限。 对于用户分配的标识,请确保将其添加到 VM 的标识下。 有关托管标识和运行命令的详细信息,请参阅 https://aka.ms/ManagedIdentity 和支持 https://aka.ms/RunCommandManaged 速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
指定将上传脚本错误流的 Azure 存储 Blob。 使用具有读取、追加、创建、写入访问权限的 SAS URI 或使用托管标识提供对 Blob 的 VM 访问权限。 引用 errorBlobManagedIdentity 参数。
使用“set”或“add”时,保留字符串文本,而不是尝试转换为 JSON。
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
混合计算机的名称。
run 命令的名称。
不等待长时间运行的操作完成。
用户分配的托管标识有权访问 outputBlobUri 存储 Blob。 在系统分配的标识的情况下使用空对象。 确保已向托管标识授予对具有“存储 Blob 数据参与者”角色分配的 Blob 容器的访问权限。 对于用户分配的标识,请确保将其添加到 VM 的标识下。 有关托管标识和运行命令的详细信息,请参阅 https://aka.ms/ManagedIdentity 和支持 https://aka.ms/RunCommandManaged 速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
指定将上传脚本输出流的 Azure 存储 Blob。 使用具有读取、追加、创建、写入访问权限的 SAS URI 或使用托管标识提供对 Blob 的 VM 访问权限。 引用 outputBlobManagedIdentity 参数。
脚本使用的参数。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
在执行 run 命令时,指定计算机上的用户帐户密码。
脚本使用的参数。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
从列表中删除属性或元素。 示例:--remove property.list OR --remove propertyToRemove。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
在执行 run 命令时,指定计算机上的用户帐户。
通过指定要设置的属性路径和值来更新对象。 示例:--set property1.property2=。
运行命令脚本的源。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
资源标记。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
执行 run 命令的超时(以秒为单位)。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az connectedmachine run-command wait
命令组“az connectedmachine run-command”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
将 CLI 置于等待状态,直到满足条件。
az connectedmachine run-command wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--machine-name]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
可选参数
等待在“Succeeded”中使用“provisioningState”创建。
等待条件满足自定义 JMESPath 查询。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
等到删除为止。
等待资源存在。
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
轮询间隔(以秒为单位)。
混合计算机的名称。
run 命令的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
最大等待(以秒为单位)。
等到 provisioningState 更新为“Succeeded”。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈