你当前正在访问 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。
命令
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
必需参数
网络接口的名称(NIC)。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
现有子网的名称或 ID。 如果指定了名称,请同时指定 --vnet-name
;如果要在其他资源组中使用现有子网,请提供 ID 而不是子网的名称。
可选参数
是否启用加速网络。
要与 NIC 关联的应用程序网关后端地址池的名称或 ID 的空格分隔列表。 如果使用名称, --gateway-name
则必须指定。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
应用程序安全组的空间分隔列表。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
网络接口资源的辅助模式。
网络接口资源的辅助 SKU。
DNS 服务器 IP 地址的空间分隔列表。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
边缘区域的名称。
应用程序网关的名称。
内部 DNS 标签的名称。
是否启用 IP 转发。
要与 NIC 关联的负载均衡器地址池的名称或 ID 的空格分隔列表。 如果使用名称, --lb-name
则必须指定。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
要与 NIC 关联的负载均衡器入站 NAT 规则的名称或 ID 的空格分隔列表。 如果使用名称, --lb-name
则必须指定。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
负载均衡器的名称。
Location。 az account list-locations
中的值。 可以使用 az configure --defaults location=<location>
配置默认位置。
现有网络安全组的名称或 ID。
不等待长时间运行的操作完成。
要使用的静态专用 IP 地址。
要使用的专用 IP 地址的版本。
现有公共 IP 地址的名称或 ID。
空格分隔标记:key[=value] [key[=value] ...]。支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
虚拟网络的名称。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
可选参数
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
网络接口的名称(NIC)。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 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 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}`]"
可选参数
命令输出中要返回的项总数。 如果可用的项总数大于指定的值,则会在命令的输出中提供令牌。 若要恢复分页,请在后续命令的参数中 --next-token
提供令牌值。
用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
可选参数
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
网络接口的名称(NIC)。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 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 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"
可选参数
展开引用的资源。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
网络接口的名称(NIC)。
资源组的名称。 可以使用 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 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
可选参数
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
网络接口的名称(NIC)。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 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 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
可选参数
是否启用加速网络。
通过指定路径和键值对将对象添加到对象列表。 示例:--add property.listProperty <key=value、string 或 JSON 字符串>。
网络接口资源的辅助模式。
网络接口资源的辅助 SKU。
DNS 服务器 IP 地址的空间分隔列表。 使用 null 还原默认 Azure 服务器。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
使用“set”或“add”时,保留字符串文本,而不是尝试转换为 JSON。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
内部 DNS 标签的名称。
网络接口的 IP 配置列表。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
是否启用 IP 转发。
网络接口的名称(NIC)。
现有网络安全组的名称或 ID。
不等待长时间运行的操作完成。
从列表中删除属性或元素。 示例:--remove property.list OR --remove propertyToRemove。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
通过指定要设置的属性路径和值来更新对象。 示例:--set property1.property2=。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az network nic wait
将 CLI 置于等待状态,直到满足条件。
az network nic wait [--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
可选参数
等待在“Succeeded”中使用“provisioningState”创建。
等待条件满足自定义 JMESPath 查询。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
等到删除为止。
等待资源存在。
展开引用的资源。
一个或多个资源 ID(空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
轮询间隔(以秒为单位)。
网络接口的名称(NIC)。
资源组的名称。 可以使用 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 获取完整的调试日志。