你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az connectedmachine

注意

此参考是 Azure CLI（版本 2.57.0 或更高版本）的 connectedmachine 扩展的一部分。 该扩展将在首次运行 az connectedmachine 命令时自动安装。 详细了解扩展。

管理已启用 Azure Arc 的服务器。

命令

名称	说明	类型	Status
az connectedmachine assess-patches	评估已启用 Azure Arc 的服务器上的修补程序。	扩展	GA
az connectedmachine delete	删除已启用 Azure Arc 的服务器。	扩展	GA
az connectedmachine extension	在已启用 Azure Arc 的服务器上管理 VM 扩展。	扩展	GA
az connectedmachine extension create	创建扩展。	扩展	GA
az connectedmachine extension delete	删除扩展。	扩展	GA
az connectedmachine extension image	管理可用于已启用 Azure Arc 的服务器的 VM 扩展元数据。	扩展	GA
az connectedmachine extension image list	根据位置、发布者、extensionType 列出所有扩展版本。	扩展	GA
az connectedmachine extension image show	基于位置、发布者、extensionType 和版本获取扩展元数据。	扩展	GA
az connectedmachine extension list	获取非 Azure 计算机的所有扩展。	扩展	GA
az connectedmachine extension show	显示非 Azure 计算机的扩展。	扩展	GA
az connectedmachine extension update	更新扩展。	扩展	GA
az connectedmachine extension wait	将 CLI 置于等待状态，直到满足条件。	扩展	GA
az connectedmachine install-patches	在已启用 Azure Arc 的服务器上安装修补程序。	扩展	GA
az connectedmachine license	在已启用 Azure Arc 的服务器上管理 ESU 许可证。	扩展	GA
az connectedmachine license create	创建许可证。	扩展	GA
az connectedmachine license delete	删除许可证。	扩展	GA
az connectedmachine license list	获取非 Azure 计算机的所有许可证。	扩展	GA
az connectedmachine license show	获取有关许可证视图的信息。	扩展	GA
az connectedmachine license update	更新操作以更新许可证。	扩展	GA
az connectedmachine license wait	将 CLI 置于等待状态，直到满足条件。	扩展	GA
az connectedmachine list	列出指定资源组中的所有已启用 Azure Arc 的服务器。	扩展	GA
az connectedmachine private-endpoint-connection	使用已启用 Azure Arc 的服务器管理专用终结点连接。	扩展	GA
az connectedmachine private-endpoint-connection delete	删除具有给定名称的专用终结点连接。	扩展	GA
az connectedmachine private-endpoint-connection list	列出专用链接范围上的所有专用终结点连接。	扩展	GA
az connectedmachine private-endpoint-connection show	获取专用终结点连接。	扩展	GA
az connectedmachine private-endpoint-connection update	使用给定名称更新专用终结点连接。	扩展	GA
az connectedmachine private-endpoint-connection wait	将 CLI 置于等待状态，直到满足条件。	扩展	GA
az connectedmachine private-link-resource	管理已启用 Azure Arc 的服务器的专用链接资源。	扩展	GA
az connectedmachine private-link-resource list	列出需要为 Azure Monitor PrivateLinkScope 创建的专用链接资源。	扩展	GA
az connectedmachine private-link-resource show	获取需要为 Azure Monitor PrivateLinkScope 创建的专用链接资源。	扩展	GA
az connectedmachine private-link-scope	管理已启用 Azure Arc 的服务器的专用链接范围。	扩展	GA
az connectedmachine private-link-scope create	创建 Azure Arc PrivateLinkScope。 注意：不能在 Put 操作中为 InstrumentationKey 和 AppId 指定其他值。	扩展	GA
az connectedmachine private-link-scope delete	删除 Azure Arc PrivateLinkScope。	扩展	GA
az connectedmachine private-link-scope list	获取资源组或订阅的 Azure Arc PrivateLinkScopes 列表。	扩展	GA
az connectedmachine private-link-scope network-security-perimeter-configuration	在已启用 Azure Arc 的服务器上管理网络安全外围配置。	扩展	GA
az connectedmachine private-link-scope network-security-perimeter-configuration list	列出专用链接范围的网络安全外围配置。	扩展	GA
az connectedmachine private-link-scope network-security-perimeter-configuration show	获取专用链接范围的网络安全外围配置。	扩展	GA
az connectedmachine private-link-scope show	获取 Azure Arc PrivateLinkScope。	扩展	GA
az connectedmachine private-link-scope update	更新 Azure Arc PrivateLinkScope。 注意：不能在 Put 操作中为 InstrumentationKey 和 AppId 指定其他值。	扩展	GA
az connectedmachine private-link-scope update-tag	更新现有的 PrivateLinkScope 标记。 若要更新其他字段，请使用 CreateOrUpdate 方法。	扩展	GA
az connectedmachine private-link-scope wait	将 CLI 置于等待状态，直到满足条件。	扩展	GA
az connectedmachine run-command	管理已启用 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 show	获取有关已启用 Azure Arc 的服务器模型视图或实例视图的信息。	扩展	GA
az connectedmachine update	更新已启用 Azure Arc 的服务器。 请注意，某些属性只能在计算机创建过程中设置。	扩展	GA
az connectedmachine upgrade-extension	升级计算机扩展。	扩展	GA

az connectedmachine assess-patches

评估已启用 Azure Arc 的服务器上的修补程序。

az connectedmachine assess-patches [--ids]
                                   [--name]
                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--resource-group]
                                   [--subscription]

示例

评估修补程序的示例命令

az connectedmachine assess-patches --resource-group MyResourceGroup --name MyMachine

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

混合计算机的名称。

--no-wait

不等待长时间运行的操作完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az connectedmachine delete

删除已启用 Azure Arc 的服务器。

az connectedmachine delete [--ids]
                           [--machine-name]
                           [--resource-group]
                           [--subscription]
                           [--yes]

示例

用于删除的示例命令

az connectedmachine delete --name myMachine --resource-group myResourceGroup

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--machine-name --name -n

混合计算机的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--yes -y

不提示确认。

默认值: False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az connectedmachine install-patches

在已启用 Azure Arc 的服务器上安装修补程序。

az connectedmachine install-patches --maximum-duration
                                    --reboot-setting {Always, IfRequired, Never}
                                    [--ids]
                                    [--linux-parameters]
                                    [--name]
                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--resource-group]
                                    [--subscription]
                                    [--windows-parameters]

示例

安装修补程序的示例命令

az connectedmachine install-patches --resource-group MyResourceGroup --name MyMachine --maximum-duration PT4H --reboot-setting IfRequired --windows-parameters "{"classificationsToInclude": ["Critical", "Security"]}"

必需参数

--maximum-duration

指定操作将运行的最大时间量。 它必须是符合 ISO 8601 的持续时间字符串，例如 PT4H（4 小时）。

--reboot-setting

定义在软件更新操作期间重新启动 VM 是可以接受的。

接受的值: Always, IfRequired, Never

可选参数

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--linux-parameters

Linux VM 上的 InstallPatches 的输入，如 API 支持速记语法、json-file 和 yaml-file 直接接收的那样。 请尝试“？？” 以显示更多内容。

--name -n

混合计算机的名称。

--no-wait

不等待长时间运行的操作完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--windows-parameters

Windows VM 上的 InstallPatches 的输入，如 API 支持速记语法、json-file 和 yaml-file 直接接收的那样。 请尝试“？？” 以显示更多内容。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az connectedmachine list

列出指定资源组中的所有已启用 Azure Arc 的服务器。

az connectedmachine list --resource-group
                         [--expand]
                         [--max-items]
                         [--next-token]

示例

列表的示例命令

az connectedmachine list --resource-group myResourceGroup
az connectedmachine list

必需参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--expand

展开引用的资源。

--max-items

命令输出中要返回的项总数。 如果可用的项总数大于指定的值，则会在命令的输出中提供令牌。 若要恢复分页，请在后续命令的参数中 --next-token 提供令牌值。

--next-token

用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az connectedmachine show

获取有关已启用 Azure Arc 的服务器模型视图或实例视图的信息。

az connectedmachine show [--expand {instanceView}]
                         [--ids]
                         [--machine-name]
                         [--resource-group]
                         [--subscription]

示例

显示的示例命令

az connectedmachine show --name myMachine --resource-group myResourceGroup

可选参数

--expand

要应用于操作的展开表达式。

接受的值: instanceView

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--machine-name --name -n

混合计算机的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az connectedmachine update

更新已启用 Azure Arc 的服务器。 请注意，某些属性只能在计算机创建过程中设置。

az connectedmachine update [--add]
                           [--agent-upgrade]
                           [--client-public-key]
                           [--expand {instanceView}]
                           [--extensions]
                           [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                           [--identity]
                           [--ids]
                           [--kind {AVS, AWS, EPS, GCP, HCI, SCVMM, VMware}]
                           [--license-profile]
                           [--location-data]
                           [--machine-name]
                           [--mssql-discovered]
                           [--os-profile]
                           [--os-type]
                           [--parent-cluster-id]
                           [--private-link-scope-id]
                           [--remove]
                           [--resource-group]
                           [--service-statuses]
                           [--set]
                           [--subscription]
                           [--tags]

示例

更新的示例命令

az connectedmachine update --name myMachine --resource-group myResourceGroup --location eastus2euap

可选参数

--add

通过指定路径和键值对将对象添加到对象列表。 示例：--add property.listProperty <key=value、string 或 JSON 字符串>。

--agent-upgrade

计算机 w.r.t 代理升级支持速记语法、json-file 和 yaml-file 的信息。 请尝试“？？” 以显示更多内容。

--client-public-key

客户端在初始资源载入期间提供的公钥。

--expand

要应用于操作的展开表达式。

接受的值: instanceView

--extensions

计算机扩展信息（弃用字段）支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--force-string

使用“set”或“add”时，保留字符串文本，而不是尝试转换为 JSON。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--identity

资源的标识。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--kind

指示本地放置哪个类型的 Arc 计算机，例如 HCI、SCVMM 或 VMware 等。

接受的值: AVS, AWS, EPS, GCP, HCI, SCVMM, VMware

--license-profile

指定计算机的许可证相关属性。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--location-data

与资源的地理位置相关的元数据。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--machine-name --name -n

混合计算机的名称。

--mssql-discovered

指定计算机上是否发现任何 MS SQL 实例。

--os-profile

指定混合计算机的操作系统设置。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--os-type

操作系统的类型（windows/linux）。

--parent-cluster-id --parent-cluster-resource-id

此计算机分配到的父群集 （Azure HCI） 的资源 ID（如果有）。

--private-link-scope-id --private-link-scope-resource-id

此计算机分配到的专用链接范围的资源 ID（如果有）。

--remove

从列表中删除属性或元素。 示例：--remove property.list OR --remove propertyToRemove。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--service-statuses

报告回 ARM 的依赖服务的状态。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--set

通过指定要设置的属性路径和值来更新对象。 示例：--set property1.property2=。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--tags

资源标记。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az connectedmachine upgrade-extension

升级计算机扩展。

az connectedmachine upgrade-extension [--extension-targets]
                                      [--ids]
                                      [--machine-name]
                                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                      [--resource-group]
                                      [--subscription]

示例

升级扩展的示例命令

az connectedmachine extension upgrade --machine-name "myMachineName" --resource-group "myResourceGroup" --subscription "mySubscription" --targets "{"Microsoft.Compute.CustomScriptExtension": "{"targetVersion": "1.10"}", "Microsoft.Azure.Monitoring": "{"targetVersion": "2.0"}"}"

可选参数

--extension-targets

描述扩展目标属性。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--machine-name

混合计算机的名称。

--no-wait

不等待长时间运行的操作完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。