az network vhub

Note

This reference is part of the virtual-wan extension for the Azure CLI (version 2.55.0 or higher). The extension will automatically install the first time you run an az network vhub command. Learn more about extensions.

Manage virtual hubs.

Commands

Name	Description	Type	Status
az network vhub bgpconnection	Manage virtual hub bgpconnections.	Extension	GA
az network vhub bgpconnection create	Create a virtual hub bgpconnection.	Extension	GA
az network vhub bgpconnection delete	Delete a virtual hub bgpconnection.	Extension	GA
az network vhub bgpconnection list	List virtual hub bgpconnections.	Extension	GA
az network vhub bgpconnection show	Get the details of a virtual hub bgpconnection.	Extension	GA
az network vhub bgpconnection update	Update settings of a virtual hub bgpconnection.	Extension	GA
az network vhub bgpconnection wait	Place the CLI in a waiting state until a condition of virtual hub bgpconnection is met.	Extension	GA
az network vhub connection	Manage virtual hub VNet connections.	Extension	GA
az network vhub connection create	Create a virtual hub VNet connection.	Extension	GA
az network vhub connection delete	Delete a virtual hub VNet connection.	Extension	GA
az network vhub connection list	List virtual hub VNet connections.	Extension	GA
az network vhub connection show	Get the details of a virtual hub VNet connection.	Extension	GA
az network vhub connection update	Update settings of a virtual hub connection.	Extension	GA
az network vhub connection wait	Place the CLI in a waiting state until a condition is met.	Extension	GA
az network vhub create	Create a virtual hub.	Extension	GA
az network vhub delete	Delete a virtual hub.	Extension	GA
az network vhub get-effective-routes	Get the effective routes configured for the Virtual Hub resource or the specified resource.	Extension	GA
az network vhub list	List virtual hubs.	Extension	GA
az network vhub route	Manage entries in the virtual hub route table.	Extension	Deprecated
az network vhub route-map	Manage route map.	Extension	GA
az network vhub route-map create	Create a route map.	Extension	GA
az network vhub route-map delete	Delete a route map.	Extension	GA
az network vhub route-map get-inbound-routes	Get the inbound routes configured for the Virtual Hub on a particular connection.	Extension	GA
az network vhub route-map get-outbound-routes	Get the outbound routes configured for the Virtual Hub on a particular connection.	Extension	GA
az network vhub route-map list	List routem maps by resource group.	Extension	GA
az network vhub route-map rule	Manage route map rule.	Extension	GA
az network vhub route-map rule add	Add route map rule.	Extension	GA
az network vhub route-map rule delete	Delete route map rule.	Extension	GA
az network vhub route-map rule list	List route map rules.	Extension	GA
az network vhub route-map rule show	Show route map rule.	Extension	GA
az network vhub route-map rule wait	Place the CLI in a waiting state until a condition is met.	Extension	GA
az network vhub route-map show	Show the details of a route map.	Extension	GA
az network vhub route-map update	Update a route map.	Extension	GA
az network vhub route-map wait	Place the CLI in a waiting state until a condition is met.	Extension	GA
az network vhub route-table	Manage route table in the virtual hub.	Extension	GA
az network vhub route-table create	Create a route table in the virtual hub.	Extension	GA
az network vhub route-table delete	Delete a route table in the virtual hub.	Extension	GA
az network vhub route-table list	List all route tables in the virtual hub.	Extension	GA
az network vhub route-table route	Manage routes of route table in the virtual hub.	Extension	GA
az network vhub route-table route add	Add a route into route table of the virtual hub.	Extension	GA
az network vhub route-table route list	List routes in the virtual hub route table.	Extension	GA
az network vhub route-table route remove	Remove a route from route table of the virtual hub.	Extension	GA
az network vhub route-table show	Show a route table in the virtual hub.	Extension	GA
az network vhub route-table update	Update a route table in the virtual hub.	Extension	GA
az network vhub route-table wait	Place the CLI in a waiting state until a condition of the vhub route-table is met.	Extension	GA
az network vhub route add	Add a route to the virtual hub route table.	Extension	Deprecated
az network vhub route list	List routes in the virtual hub route table.	Extension	Deprecated
az network vhub route remove	Remove a route from the virtual hub route table.	Extension	Deprecated
az network vhub route reset	Reset virtual hub route when the route state is failed.	Extension	Deprecated
az network vhub routing-intent	Manage routing intent in the virtual hub.	Extension	Preview
az network vhub routing-intent create	Create a routing intent in the virtual hub.	Extension	Preview
az network vhub routing-intent delete	Delete a routing intent in the virtual hub.	Extension	Preview
az network vhub routing-intent list	Retrieve the details of all routing intent resources of the virtual hub.	Extension	Preview
az network vhub routing-intent show	Retrieve the details of a routing intent.	Extension	Preview
az network vhub routing-intent update	Update a routing intent in the virtual hub.	Extension	Preview
az network vhub routing-intent wait	Place the CLI in a waiting state until a condition is met.	Extension	Preview
az network vhub show	Get the details of a virtual hub.	Extension	GA
az network vhub update	Update settings of a virtual hub.	Extension	GA
az network vhub wait	Place the CLI in a waiting state until a condition is met.	Extension	GA

az network vhub create

Create a virtual hub.

az network vhub create --name
                       --resource-group
                       [--address-prefix]
                       [--allow-b2b-traffic {0, 1, f, false, n, no, t, true, y, yes}]
                       [--asn]
                       [--auto-scale-config]
                       [--hub-routing-preference {ASPath, ExpressRoute, VpnGateway}]
                       [--location]
                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                       [--sku]
                       [--tags]
                       [--vwan]

Examples

Create a virtual hub.

az network vhub create -g MyRG -n MyVHub --vwan MyVWan --address-prefix 10.0.0.0/24 -l SouthCentralUS --sku Standard

Required Parameters

--name -n

Name of the virtual hub.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--address-prefix

CIDR address prefix for the virtual hub.

--allow-b2b-traffic

Flag to control branch-to-branch traffic for VirtualRouter hub.

accepted values: 0, 1, f, false, n, no, t, true, y, yes

--asn

VirtualRouter ASN.

--auto-scale-config

The VirtualHub Router autoscale configuration. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--hub-routing-preference

The hub routing preference gateway types.

accepted values: ASPath, ExpressRoute, VpnGateway

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>. When not specified, the location of the resource group will be used.

--no-wait

Do not wait for the long-running operation to finish.

accepted values: 0, 1, f, false, n, no, t, true, y, yes

--sku

The sku of the VirtualHub. Allowed values: Basic, Standard.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--vwan

Name or ID of the virtual WAN.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network vhub delete

Delete a virtual hub.

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

Examples

Delete a virtual hub.

az network vhub delete -n MyVHub -g MyRG

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name -n

Name of the virtual hub.

--no-wait

Do not wait for the long-running operation to finish.

accepted values: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--yes -y

Do not prompt for confirmation.

default value: False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network vhub get-effective-routes

Get the effective routes configured for the Virtual Hub resource or the specified resource.

az network vhub get-effective-routes [--ids]
                                     [--name]
                                     [--no-wait]
                                     [--resource-group]
                                     [--resource-id]
                                     [--resource-type]
                                     [--subscription]

Examples

Get the effective routes configured for route table in the virtual hub.

az network vhub get-effective-routes --resource-type RouteTable --resource-id /subscriptions/MySub/resourceGroups/MyRG/providers/Microsoft.Network/virtualHubs/MyHub/hubRouteTables/MyRouteTable -g MyRG -n MyHub

Get the effective routes configured for P2S connection in the virtual hub.

az network vhub get-effective-routes --resource-type P2SConnection --resource-id /subscriptions/MySub/resourceGroups/MyRG/providers/Microsoft.Network/p2sVpnGateways/MyGateway/p2sConnectionConfigurations/MyConnection -g MyRG -n MyHub

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name -n

Name of the virtual hub.

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--resource-id

The resource whose effective routes are being requested.

--resource-type

The type of the specified resource like RouteTable, ExpressRouteConnection, HubVirtualNetworkConnection, VpnConnection and P2SConnection.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network vhub list

List virtual hubs.

az network vhub list [--resource-group]

Examples

List virtual hubs.

az network vhub list -g MyRG

Optional Parameters

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network vhub show

Get the details of a virtual hub.

az network vhub show [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

Examples

Get the details of a virtual hub.

az network vhub show -n MyVHub -g MyRG

Optional Parameters

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name -n

Name of the virtual hub.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network vhub update

Update settings of a virtual hub.

az network vhub update [--add]
                       [--address-prefix]
                       [--allow-b2b-traffic {0, 1, f, false, n, no, t, true, y, yes}]
                       [--asn]
                       [--auto-scale-config]
                       [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                       [--hub-routing-preference {ASPath, ExpressRoute, VpnGateway}]
                       [--ids]
                       [--name]
                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                       [--remove]
                       [--resource-group]
                       [--set]
                       [--sku]
                       [--subscription]
                       [--tags]
                       [--vwan]

Examples

Update settings of a virtual hub.

az network vhub update -g MyRG -n MyVHub --sku Basic --hub-routing-preference VpnGateway

Optional Parameters

--add

Add an object to a list of objects by specifying a path and key value pairs. Example: --add property.listProperty <key=value, string or JSON string>.

--address-prefix

CIDR address prefix for the virtual hub.

--allow-b2b-traffic

Flag to control branch-to-branch traffic for VirtualRouter hub.

accepted values: 0, 1, f, false, n, no, t, true, y, yes

--asn

VirtualRouter ASN.

--auto-scale-config

The VirtualHub Router autoscale configuration. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--force-string

When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.

accepted values: 0, 1, f, false, n, no, t, true, y, yes

--hub-routing-preference

The hub routing preference gateway types.

accepted values: ASPath, ExpressRoute, VpnGateway

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--name -n

Name of the virtual hub.

--no-wait

Do not wait for the long-running operation to finish.

accepted values: 0, 1, f, false, n, no, t, true, y, yes

--remove

Remove a property or an element from a list. Example: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--set

Update an object by specifying a property path and value to set. Example: --set property1.property2=.

--sku

The sku of the VirtualHub.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--tags

Space-separated tags: key[=value] [key[=value] ...]. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.

--vwan

Name or ID of the virtual WAN.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az network vhub wait

Place the CLI in a waiting state until a condition is met.

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

Optional Parameters

--created

Wait until created with 'provisioningState' at 'Succeeded'.

default value: False

--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wait until deleted.

default value: False

--exists

Wait until the resource exists.

default value: False

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

--interval

Polling interval in seconds.

default value: 30

--name -n

Name of the virtual hub.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--timeout

Maximum wait in seconds.

default value: 3600

--updated

Wait until updated with provisioningState at 'Succeeded'.

default value: False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc

default value: json

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.