az network nic

  • 參考

注意

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。 安裝每個擴充功能以受益于其擴充功能。 深入了解擴充功能。

管理網路介面。

若要深入瞭解 Azure 中的網路介面，請流覽 https://learn.microsoft.com/en-us/azure/virtual-network/virtual-network-network-interface?tabs=network-interface-portal 。

命令

名稱 Description 類型 狀態
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 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

現有子網的名稱或識別碼。 如果指定名稱，請同時指定 --vnet-name ;如果您想要在其他資源群組中使用現有的子網，請提供識別碼，而不是子網的名稱。

選擇性參數

--accelerated-networking

是否要啟用加速網路。

接受的值: 0, 1, f, false, n, no, t, true, y, yes
--ag-address-pools --app-gateway-address-pools

應用程式閘道後端位址集區名稱或識別碼的空間分隔清單，以與 NIC 產生關聯。 如果使用名稱， --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 產生關聯。 如果使用名稱， --lb-name 則必須指定 。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--lb-inbound-nat-rules

負載平衡器輸入 NAT 規則的名稱或識別碼以空格分隔的清單，以與 NIC 產生關聯。 如果使用名稱， --lb-name 則必須指定 。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--lb-name

負載平衡器的名稱。

--location -l

位置。​​ 來自的值： az account list-locations 。 您可以使用 來設定預設位置 az configure --defaults location=<location> 。

--network-security-group

現有網路安全性群組的名稱或識別碼。

--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 位址的名稱或識別碼。

--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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

網路介面的名稱（NIC）。

--no-wait

請勿等候長時間執行的作業完成。

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

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

網路介面的名稱（NIC）。

--no-wait

請勿等候長時間執行的作業完成。

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

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

網路介面的名稱（NIC）。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

網路介面的名稱（NIC）。

--no-wait

請勿等候長時間執行的作業完成。

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

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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 或 JSON 字串 > 。

--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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--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

現有網路安全性群組的名稱或識別碼。

--no-wait

請勿等候長時間執行的作業完成。

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

從清單中移除屬性或專案。 範例：--remove property.list OR --remove 屬性ToRemove。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--set

指定要設定的屬性路徑和值，以更新物件。 範例：--set property1.property2=。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--interval

輪詢間隔以秒為單位。

預設值: 30
--name -n

網路介面的名稱（NIC）。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。