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

az connectedmachine

注意

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

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

命令

名称 说明 类型 状态
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

用于创建或更新扩展的操作。

扩展 GA
az connectedmachine extension update

更新操作以更新扩展。

扩展 GA
az connectedmachine extension wait

将 CLI 置于等待状态,直到满足条件。

扩展 GA
az connectedmachine install-patches

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

扩展 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 列表。 获取订阅中所有 Azure Arc PrivateLinkScopes 的列表。

扩展 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(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 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(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 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(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 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]

示例

列表的示例命令

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

必需参数

--resource-group -g

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

可选参数

--expand

展开引用的资源。

全局参数
--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(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 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-resource-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(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 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-resource-id --scope-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(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 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 获取完整的调试日志。