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

az network nic

注意

此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。 安装每个扩展，使其受益于其扩展功能。 详细了解扩展。

管理网络接口。

若要详细了解 Azure 中的网络接口，请访问 https://learn.microsoft.com/en-us/azure/virtual-network/virtual-network-network-interface?tabs=network-interface-portal。

命令

名称	说明	类型	Status
az network nic create	创建网络接口。	核心	GA
az network nic delete	删除网络接口。	核心	GA
az network nic ip-config	管理网络接口的 IP 配置。	核心	GA
az network nic ip-config address-pool	管理 IP 配置中的地址池。	核心	GA
az network nic ip-config address-pool add	将地址池添加到 IP 配置。	核心	GA
az network nic ip-config address-pool remove	删除 IP 配置的地址池。	核心	GA
az network nic ip-config create	创建 IP 配置。	核心	GA
az network nic ip-config delete	删除 IP 配置。	核心	GA
az network nic ip-config inbound-nat-rule	管理 IP 配置的入站 NAT 规则。	核心	GA
az network nic ip-config inbound-nat-rule add	将入站 NAT 规则添加到 IP 配置。	核心	GA
az network nic ip-config inbound-nat-rule remove	删除 IP 配置的入站 NAT 规则。	核心	GA
az network nic ip-config inbound-nat-rule wait	将 CLI 置于等待状态，直到满足条件。	核心	GA
az network nic ip-config list	列出 NIC 的 IP 配置。	核心	GA
az network nic ip-config show	显示 IP 配置的详细信息。	核心	GA
az network nic ip-config update	更新 IP 配置。	核心	GA
az network nic ip-config wait	将 CLI 置于等待状态，直到满足条件。	核心	GA
az network nic list	列出网络接口。	核心	GA
az network nic list-effective-nsg	列出应用于网络接口的所有有效网络安全组。	核心	GA
az network nic show	获取网络接口的详细信息。	核心	GA
az network nic show-effective-route-table	显示应用于网络接口的有效路由表。	核心	GA
az network nic update	更新网络接口。	核心	GA
az network nic vtap-config	管理虚拟网络分流配置。	扩展	GA
az network nic vtap-config create	创建虚拟网络点击配置。	扩展	GA
az network nic vtap-config delete	删除虚拟网络点击配置。	扩展	GA
az network nic vtap-config list	列出虚拟网络点击配置。	扩展	GA
az network nic vtap-config show	获取虚拟网络点击配置的详细信息。	扩展	GA
az network nic vtap-config wait	将 CLI 置于等待状态，直到满足条件。	扩展	GA
az network nic wait	将 CLI 置于等待状态，直到满足条件。	核心	GA

az network nic create

创建网络接口。

az network nic create --name
                      --resource-group
                      --subnet
                      [--accelerated-networking {0, 1, f, false, n, no, t, true, y, yes}]
                      [--ag-address-pools]
                      [--application-security-groups]
                      [--auxiliary-mode {AcceleratedConnections, Floating, MaxConnections, None}]
                      [--auxiliary-sku {A1, A2, A4, A8, None}]
                      [--dns-servers]
                      [--edge-zone]
                      [--gateway-name]
                      [--internal-dns-name]
                      [--ip-forwarding {0, 1, f, false, n, no, t, true, y, yes}]
                      [--lb-address-pools]
                      [--lb-inbound-nat-rules]
                      [--lb-name]
                      [--location]
                      [--network-security-group]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--private-ip-address]
                      [--private-ip-address-version {IPv4, IPv6}]
                      [--public-ip-address]
                      [--tags]
                      [--vnet-name]

示例

为指定虚拟网络上的指定子网创建网络接口。

az network nic create -g MyResourceGroup --vnet-name MyVnet --subnet MySubnet -n MyNic

为虚拟网络上的指定子网创建网络接口，该子网允许 IP 转发受网络安全组的约束。

az network nic create -g MyResourceGroup --vnet-name MyVnet --subnet MySubnet -n MyNic --ip-forwarding --network-security-group MyNsg

使用网络安全组和应用程序安全组为虚拟网络上的指定子网创建网络接口。

az network nic create -g MyResourceGroup --vnet-name MyVnet --subnet MySubnet -n MyNic --network-security-group MyNsg --application-security-groups Web App

必需参数

--name -n

网络接口的名称（NIC）。

--resource-group -g

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

--subnet

现有子网的名称或 ID。 如果指定了名称，请同时指定 --vnet-name;如果要在其他资源组中使用现有子网，请提供 ID 而不是子网的名称。

可选参数

--accelerated-networking

是否启用加速网络。

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

--ag-address-pools --app-gateway-address-pools

要与 NIC 关联的应用程序网关后端地址池的名称或 ID 的空格分隔列表。 如果使用名称， --gateway-name 则必须指定。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--application-security-groups --asgs

应用程序安全组的空间分隔列表。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--auxiliary-mode

网络接口资源的辅助模式。

接受的值: AcceleratedConnections, Floating, MaxConnections, None

--auxiliary-sku

网络接口资源的辅助 SKU。

接受的值: A1, A2, A4, A8, None

--dns-servers

DNS 服务器 IP 地址的空间分隔列表。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--edge-zone

边缘区域的名称。

--gateway-name

应用程序网关的名称。

--internal-dns-name

内部 DNS 标签的名称。

--ip-forwarding

是否启用 IP 转发。

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

--lb-address-pools

要与 NIC 关联的负载均衡器地址池的名称或 ID 的空格分隔列表。 如果使用名称， --lb-name 则必须指定。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--lb-inbound-nat-rules

要与 NIC 关联的负载均衡器入站 NAT 规则的名称或 ID 的空格分隔列表。 如果使用名称， --lb-name 则必须指定。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--lb-name

负载均衡器的名称。

--location -l

Location。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--network-security-group

现有网络安全组的名称或 ID。

--no-wait

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

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

--private-ip-address

要使用的静态专用 IP 地址。

--private-ip-address-version

要使用的专用 IP 地址的版本。

接受的值: IPv4, IPv6

默认值: IPv4

--public-ip-address

现有公共 IP 地址的名称或 ID。

--tags

空格分隔标记：key[=value] [key[=value] ...]。支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--vnet-name

虚拟网络的名称。

全局参数

--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 network nic delete

删除网络接口。

az network nic delete [--ids]
                      [--name]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--resource-group]
                      [--subscription]

示例

删除网络接口。

az network nic delete -g MyResourceGroup -n MyNic

可选参数

--ids

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

--name -n

网络接口的名称（NIC）。

--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 network nic list

列出网络接口。

列出附加到 VM 规模集中 VM 的网络接口，请使用 az vmss nic list 或 az vmss nic list-vm-nics。

az network nic list [--max-items]
                    [--next-token]
                    [--resource-group]

示例

按内部 DNS 后缀列出所有 NIC。

az network nic list --query "[?dnsSettings.internalDomainNameSuffix=`{dnsSuffix}`]"

可选参数

--max-items

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

--next-token

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

--resource-group -g

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

全局参数

--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 network nic list-effective-nsg

列出应用于网络接口的所有有效网络安全组。

若要了解有关使用有效安全规则进行故障排除的详细信息，请访问 https://learn.microsoft.com/en-us/azure/virtual-network/diagnose-network-traffic-filter-problem。

az network nic list-effective-nsg [--ids]
                                  [--name]
                                  [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                  [--resource-group]
                                  [--subscription]

示例

列出与 NIC 关联的有效安全组。

az network nic list-effective-nsg -g MyResourceGroup -n MyNic

可选参数

--ids

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

--name -n

网络接口的名称（NIC）。

--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 network nic show

获取网络接口的详细信息。

az network nic show [--expand]
                    [--ids]
                    [--name]
                    [--resource-group]
                    [--subscription]

示例

获取 NIC 的内部域名后缀。

az network nic show -g MyResourceGroup -n MyNic --query "dnsSettings.internalDomainNameSuffix"

可选参数

--expand

展开引用的资源。

--ids

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

--name -n

网络接口的名称（NIC）。

--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 network nic show-effective-route-table

显示应用于网络接口的有效路由表。

若要了解有关使用有效路由表进行故障排除的详细信息，请访问 https://learn.microsoft.com/en-us/azure/virtual-network/diagnose-network-routing-problem#using-effective-routes-to-troubleshoot-vm-traffic-flow。

az network nic show-effective-route-table [--ids]
                                          [--name]
                                          [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                          [--resource-group]
                                          [--subscription]

示例

显示应用于网络接口的有效路由。

az network nic show-effective-route-table -g MyResourceGroup -n MyNic

可选参数

--ids

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

--name -n

网络接口的名称（NIC）。

--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 network nic update

更新网络接口。

az network nic update [--accelerated-networking {0, 1, f, false, n, no, t, true, y, yes}]
                      [--add]
                      [--auxiliary-mode {AcceleratedConnections, Floating, MaxConnections, None}]
                      [--auxiliary-sku {A1, A2, A4, A8, None}]
                      [--dns-servers]
                      [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                      [--ids]
                      [--internal-dns-name]
                      [--ip-configurations]
                      [--ip-forwarding {0, 1, f, false, n, no, t, true, y, yes}]
                      [--name]
                      [--network-security-group]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--remove]
                      [--resource-group]
                      [--set]
                      [--subscription]

示例

更新网络接口以使用不同的网络安全组。

az network nic update -g MyResourceGroup -n MyNic --network-security-group MyNewNsg

可选参数

--accelerated-networking

是否启用加速网络。

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

--add

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

--auxiliary-mode

网络接口资源的辅助模式。

接受的值: AcceleratedConnections, Floating, MaxConnections, None

--auxiliary-sku

网络接口资源的辅助 SKU。

接受的值: A1, A2, A4, A8, None

--dns-servers

DNS 服务器 IP 地址的空间分隔列表。 使用 null 还原到默认 Azure 服务器。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--force-string

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

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

--ids

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

--internal-dns-name

内部 DNS 标签的名称。

--ip-configurations

网络接口的 IP 配置列表。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--ip-forwarding

是否启用 IP 转发。

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

--name -n

网络接口的名称（NIC）。

--network-security-group

现有网络安全组的名称或 ID。

--no-wait

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

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

--remove

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

--resource-group -g

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

--set

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

--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 network nic wait

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

az network nic wait [--created]
                    [--custom]
                    [--deleted]
                    [--exists]
                    [--expand]
                    [--ids]
                    [--interval]
                    [--name]
                    [--resource-group]
                    [--subscription]
                    [--timeout]
                    [--updated]

可选参数

--created

等待在“Succeeded”中使用“provisioningState”创建。

默认值: False

--custom

等待条件满足自定义 JMESPath 查询。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到删除为止。

默认值: False

--exists

等待资源存在。

默认值: False

--expand

展开引用的资源。

--ids

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

--interval

轮询间隔（以秒为单位）。

默认值: 30

--name -n

网络接口的名称（NIC）。

--resource-group -g

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

--subscription

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

--timeout

最大等待（以秒为单位）。

默认值: 3600

--updated

等到 provisioningState 更新为“Succeeded”。

默认值: 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 获取完整的调试日志。