az network vnet subnet

管理 Azure 虛擬網絡 中的子網。

若要深入瞭解子網，請造訪 https://docs.microsoft.com/azure/virtual-network/virtual-network-manage-subnet。

命令

名稱	Description	類型	狀態
az network vnet subnet create	建立子網，並建立現有 NSG 和路由表的關聯。	核心	GA
az network vnet subnet delete	刪除子網。	核心	GA
az network vnet subnet list	列出虛擬網路中的子網。	核心	GA
az network vnet subnet list-available-delegations	列出子網委派可用的服務。	核心	GA
az network vnet subnet list-available-ips	列出子網中的一些可用IP。	核心	預覽​​
az network vnet subnet show	顯示子網的詳細數據。	核心	GA
az network vnet subnet update	更新子網。	核心	GA
az network vnet subnet wait	將 CLI 置於等候狀態，直到符合條件為止。	核心	GA

az network vnet subnet create

建立子網，並建立現有 NSG 和路由表的關聯。

az network vnet subnet create --name
                              --resource-group
                              --vnet-name
                              [--address-prefixes]
                              [--default-outbound {0, 1, f, false, n, no, t, true, y, yes}]
                              [--delegations]
                              [--disable-private-endpoint-network-policies {0, 1, f, false, n, no, t, true, y, yes}]
                              [--disable-private-link-service-network-policies {0, 1, f, false, n, no, t, true, y, yes}]
                              [--endpoints]
                              [--nat-gateway]
                              [--network-security-group]
                              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                              [--ple-network-policies {Disabled, Enabled, NetworkSecurityGroupEnabled, RouteTableEnabled}]
                              [--pls-network-policies {Disabled, Enabled}]
                              [--route-table]
                              [--service-endpoint-policy]
                              [--service-endpoints]
                              [--sharing-scope {DelegatedServices, Tenant}]

範例

使用自定義路由表建立連結至 NSG 的新子網。

az network vnet subnet create -g MyResourceGroup --vnet-name MyVnet -n MySubnet --address-prefixes 10.0.0.0/24 --network-security-group MyNsg --route-table MyRouteTable

建立連結至 NAT 閘道的新子網。

az network vnet subnet create -n MySubnet --vnet-name MyVnet -g MyResourceGroup --nat-gateway MyNatGateway --address-prefixes "10.0.0.0/21"

必要參數

--name -n

子網名稱。

--resource-group -g

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

--vnet-name

虛擬網路 （VNet） 名稱。

選擇性參數

--address-prefixes

以 CIDR 格式分隔位址前綴的空間分隔清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--default-outbound --default-outbound-access

將此屬性設定為 false，以停用子網中所有 VM 的預設輸出連線。 此屬性只能在建立子網時設定，而且無法更新現有子網。

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

--delegations

子網應該委派給其空間分隔的服務清單，例如Microsoft.Sql/servers。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--disable-private-endpoint-network-policies

停用子網上的私人端點網路原則。 請注意，它很快就會被 --private-endpoint-network-policies 取代。

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

--disable-private-link-service-network-policies

停用子網上的私人連結服務網路原則。 請注意，它很快就會被 --private-link-service-network-policies 取代。

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

--endpoints

服務端點的陣列。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--nat-gateway

要連接的 NAT 閘道名稱或識別碼。

--network-security-group --nsg

網路安全組的名稱或標識碼（NSG）。

--no-wait

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

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

--ple-network-policies --private-endpoint-network-policies

管理私人端點的網路原則。

接受的值: Disabled, Enabled, NetworkSecurityGroupEnabled, RouteTableEnabled

預設值: Disabled

--pls-network-policies --private-link-service-network-policies

管理私人鏈接服務的網路原則。

接受的值: Disabled, Enabled

預設值: Enabled

--route-table

要與子網建立關聯的路由表名稱或標識碼。

--service-endpoint-policy

要套用的服務端點原則名稱或標識碼以空格分隔的清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--service-endpoints

以空格分隔的服務列表允許私人存取此子網。 來自：az network vnet list-endpoint-services 的值。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--sharing-scope

將此屬性設定為 Tenant，以允許與 AAD 租使用者中的其他訂用帳戶共用子網。 只有當 defaultOutboundAccess 設定為 false 時，才能設定此屬性，只有在子網是空的時，才能設定這兩個屬性。

接受的值: DelegatedServices, Tenant

全域參數

--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 vnet subnet delete

刪除子網。

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

範例

刪除子網。

az network vnet subnet delete --name MySubnet --resource-group MyResourceGroup --vnet-name MyVnet

選擇性參數

--ids

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

--name -n

子網名稱。

--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 設定預設訂用帳戶。

--vnet-name

虛擬網路 （VNet） 名稱。

全域參數

--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 vnet subnet list

列出虛擬網路中的子網。

az network vnet subnet list --resource-group
                            --vnet-name
                            [--max-items]
                            [--next-token]

範例

列出虛擬網路中的子網。

az network vnet subnet list -g MyResourceGroup --vnet-name MyVNet

必要參數

--resource-group -g

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

--vnet-name

虛擬網路 （VNet） 名稱。

選擇性參數

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

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

--verbose

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

az network vnet subnet list-available-delegations

列出子網委派可用的服務。

az network vnet subnet list-available-delegations [--location]
                                                  [--max-items]
                                                  [--next-token]
                                                  [--resource-group]

範例

擷取美國西部區域中可用委派的服務名稱。

az network vnet subnet list-available-delegations -l westus --query [].serviceName

列出子網委派可用的服務。 （ 自動產生 ）

az network vnet subnet list-available-delegations --resource-group MyResourceGroup

選擇性參數

--location -l

位置。​​ 值的來源：az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。 未指定時，將會使用資源群組的位置。

--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 vnet subnet list-available-ips

預覽

此命令處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

列出子網中的一些可用IP。

az network vnet subnet list-available-ips [--ids]
                                          [--name]
                                          [--resource-group]
                                          [--subscription]
                                          [--vnet-name]

範例

列出子網中的一些可用IP。

az network vnet subnet list-available-ips --resource-group MyResourceGroup --vnet-name MyVNet -n MySubnet

選擇性參數

--ids

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

--name -n

子網名稱。

--resource-group -g

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

--subscription

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

--vnet-name

虛擬網路 （VNet） 名稱。

全域參數

--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 vnet subnet show

顯示子網的詳細數據。

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

範例

顯示與虛擬網路相關聯的子網詳細數據。

az network vnet subnet show -g MyResourceGroup -n MySubnet --vnet-name MyVNet

選擇性參數

--expand

展開參考的資源。 預設值為 None。

--ids

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

--name -n

子網名稱。

--resource-group -g

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

--subscription

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

--vnet-name

虛擬網路 （VNet） 名稱。

全域參數

--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 vnet subnet update

更新子網。

az network vnet subnet update [--add]
                              [--address-prefixes]
                              [--default-outbound {0, 1, f, false, n, no, t, true, y, yes}]
                              [--delegations]
                              [--disable-private-endpoint-network-policies {0, 1, f, false, n, no, t, true, y, yes}]
                              [--disable-private-link-service-network-policies {0, 1, f, false, n, no, t, true, y, yes}]
                              [--endpoints]
                              [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                              [--ids]
                              [--name]
                              [--nat-gateway]
                              [--network-security-group]
                              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                              [--ple-network-policies {Disabled, Enabled, NetworkSecurityGroupEnabled, RouteTableEnabled}]
                              [--pls-network-policies {Disabled, Enabled}]
                              [--remove]
                              [--resource-group]
                              [--route-table]
                              [--service-endpoint-policy]
                              [--service-endpoints]
                              [--set]
                              [--sharing-scope {DelegatedServices, Tenant}]
                              [--subscription]
                              [--vnet-name]

範例

將網路安全組關聯至子網。

az network vnet subnet update -g MyResourceGroup -n MySubnet --vnet-name MyVNet --network-security-group MyNsg

使用 NAT 閘道更新子網。

az network vnet subnet update -n MySubnet --vnet-name MyVnet -g MyResourceGroup --nat-gateway MyNatGateway --address-prefixes "10.0.0.0/21"

停用私人端點網路原則。

az network vnet subnet update -n MySubnet --vnet-name MyVnet -g MyResourceGroup --private-endpoint-network-policies Disabled

中斷連結子網中的網路安全組。

az network vnet subnet update -g MyResourceGroup --vnet-name MyVNet -n MySubnet --nsg null

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例：--add property.listProperty <key=value、string 或 JSON 字串>。

--address-prefixes

以 CIDR 格式分隔位址前綴的空間分隔清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--default-outbound --default-outbound-access

將此屬性設定為 false，以停用子網中所有 VM 的預設輸出連線。 此屬性只能在建立子網時設定，而且無法更新現有子網。

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

--delegations

子網應該委派給其空間分隔的服務清單，例如Microsoft.Sql/servers。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--disable-private-endpoint-network-policies

停用子網上的私人端點網路原則。 請注意，它很快就會被 --private-endpoint-network-policies 取代。

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

--disable-private-link-service-network-policies

停用子網上的私人連結服務網路原則。 請注意，它很快就會被 --private-link-service-network-policies 取代。

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

--endpoints

服務端點的陣列。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

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

--ids

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

--name -n

子網名稱。

--nat-gateway

要連接的 NAT 閘道名稱或識別碼。 使用 null 將它中斷連結。

--network-security-group --nsg

網路安全組的名稱或標識碼（NSG）。 使用 null 將它中斷連結。

--no-wait

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

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

--ple-network-policies --private-endpoint-network-policies

管理私人端點的網路原則。

接受的值: Disabled, Enabled, NetworkSecurityGroupEnabled, RouteTableEnabled

--pls-network-policies --private-link-service-network-policies

管理私人鏈接服務的網路原則。

接受的值: Disabled, Enabled

--remove

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

--resource-group -g

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

--route-table

要與子網建立關聯的路由表名稱或標識碼。 使用 null 將它中斷連結。

--service-endpoint-policy

要套用的服務端點原則名稱或標識碼以空格分隔的清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--service-endpoints

以空格分隔的服務列表允許私人存取此子網。 來自：az network vnet list-endpoint-services 的值。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--set

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

--sharing-scope

將此屬性設定為 Tenant，以允許與 AAD 租使用者中的其他訂用帳戶共用子網。 只有當 defaultOutboundAccess 設定為 false 時，才能設定此屬性，只有在子網是空的時，才能設定這兩個屬性。

接受的值: DelegatedServices, Tenant

--subscription

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

--vnet-name

虛擬網路 （VNet） 名稱。

全域參數

--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 vnet subnet wait

將 CLI 置於等候狀態，直到符合條件為止。

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

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False

--custom

等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False

--exists

等候資源存在。

預設值: False

--expand

展開參考的資源。 預設值為 None。

--ids

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

--interval

輪詢間隔以秒為單位。

預設值: 30

--name -n

子網名稱。

--resource-group -g

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

--subscription

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

--timeout

以秒為單位的等候上限。

預設值: 3600

--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: False

--vnet-name

虛擬網路 （VNet） 名稱。

全域參數

--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 來取得完整偵錯記錄。