az network cross-connection

Manage customers' ExpressRoute circuits.

To learn more about ExpressRoute circuits visit https://docs.microsoft.com/en-us/azure/expressroute/howto-circuit-cli.

Commands

az network cross-connection list

List all ExpressRoute cross-connections for the current subscription.

az network cross-connection list-arp-tables

Show the current Address Resolution Protocol (ARP) table of an ExpressRoute cross-connection peering.

az network cross-connection list-route-tables

Show the current routing table of an ExpressRoute cross-connection peering.

az network cross-connection peering

Manage ExpressRoute peering of an ExpressRoute cross-connection.

az network cross-connection peering create

Create peering settings for an ExpressRoute cross-connection.

az network cross-connection peering delete

Delete peering settings.

az network cross-connection peering list

List peering settings of an ExpressRoute cross-connection.

az network cross-connection peering show

Get the details of an express route peering.

az network cross-connection peering update

Update peering settings for an ExpressRoute cross-connection.

az network cross-connection show

Get the details of an ExpressRoute cross-connection.

az network cross-connection summarize-route-table

Gets the route table summary associated with the express route cross connection in a resource group.

az network cross-connection update

Update settings of an ExpressRoute cross-connection.

az network cross-connection wait

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

az network cross-connection list

List all ExpressRoute cross-connections for the current subscription.

az network cross-connection list [--resource-group]

Examples

List all ExpressRoute cross-connections for the current subscription.

az network cross-connection list -g MyResourceGroup

Optional Parameters

--resource-group -g

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

az network cross-connection list-arp-tables

Show the current Address Resolution Protocol (ARP) table of an ExpressRoute cross-connection peering.

az network cross-connection list-arp-tables --name
                                            --path {primary, secondary}
                                            --peering-name
                                            --resource-group

Examples

Show the current Address Resolution Protocol (ARP) table of an ExpressRoute cross-connection.

az network cross-connection list-arp-tables -g MyResourceGroup -n MyCircuit \
    --path primary --peering-name AzurePrivatePeering

Required Parameters

--name -n

ExpressRoute cross-connection name.

--path

The path of the device.

accepted values: primary, secondary
--peering-name

The name of the peering.

--resource-group -g

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

az network cross-connection list-route-tables

Show the current routing table of an ExpressRoute cross-connection peering.

az network cross-connection list-route-tables --name
                                              --path {primary, secondary}
                                              --peering-name
                                              --resource-group

Examples

Show the current routing table of an ExpressRoute cross-connection peering.

az network cross-connection list-route-tables -g MyResourceGroup -n MyCircuit \
    --path primary --peering-name AzurePrivatePeering

Required Parameters

--name -n

ExpressRoute cross-connection name.

--path

The path of the device.

accepted values: primary, secondary
--peering-name

The name of the peering.

--resource-group -g

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

az network cross-connection show

Get the details of an ExpressRoute cross-connection.

az network cross-connection show --name
                                 --resource-group

Examples

Get the details of an ExpressRoute cross-connection.

az network cross-connection show -n MyCircuit -g MyResourceGroup

Required Parameters

--name -n

ExpressRoute cross-connection name.

--resource-group -g

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

az network cross-connection summarize-route-table

Gets the route table summary associated with the express route cross connection in a resource group.

az network cross-connection summarize-route-table --name
                                                  --path {primary, secondary}
                                                  --peering-name
                                                  --resource-group

Required Parameters

--name -n

ExpressRoute cross-connection name.

--path

The path of the device.

accepted values: primary, secondary
--peering-name

The name of the peering.

--resource-group -g

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

az network cross-connection update

Update settings of an ExpressRoute cross-connection.

az network cross-connection update --name
                                   --resource-group
                                   [--add]
                                   [--force-string]
                                   [--no-wait]
                                   [--notes]
                                   [--provisioning-state {NotProvisioned, Provisioned, Provisioning}]
                                   [--remove]
                                   [--set]

Required Parameters

--name -n

ExpressRoute cross-connection name.

--resource-group -g

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

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

--force-string

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

--no-wait

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

--notes

Service provider notes.

--provisioning-state

Provisioning state of the customer ExpressRoute circuit.

accepted values: NotProvisioned, Provisioned, Provisioning
--remove

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

--set

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

az network cross-connection wait

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

az network cross-connection wait --name
                                 --resource-group
                                 [--created]
                                 [--custom]
                                 [--deleted]
                                 [--exists]
                                 [--interval]
                                 [--timeout]
                                 [--updated]

Examples

Pause executing next line of CLI script until the ExpressRoute cross-connection is successfully provisioned.

az network cross-connection wait -n MyCircuit -g MyResourceGroup --created

Required Parameters

--name -n

ExpressRoute cross-connection name.

--resource-group -g

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

Optional Parameters

--created

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

--custom

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

--deleted

Wait until deleted.

--exists

Wait until the resource exists.

--interval

Polling interval in seconds.

default value: 30
--timeout

Maximum wait in seconds.

default value: 3600
--updated

Wait until updated with provisioningState at 'Succeeded'.