az networkfabric controller
Note
This reference is part of the managednetworkfabric extension for the Azure CLI (version 2.49.0 or higher). The extension will automatically install the first time you run an az networkfabric controller command. Learn more about extensions.
Manage Network Fabric Controller Resource.
Commands
Name | Description | Type | Status |
---|---|---|---|
az networkfabric controller create |
Create a Network Fabric Controller resource. |
Extension | GA |
az networkfabric controller delete |
Delete the Network Fabric Controller resource. |
Extension | GA |
az networkfabric controller list |
List all Network Fabric Controllers in the provided resource group or subscription. |
Extension | GA |
az networkfabric controller show |
Show details of the provided Network Fabric Controller resource. |
Extension | GA |
az networkfabric controller update |
Update the Network Fabric Controller resource. |
Extension | GA |
az networkfabric controller wait |
Place the CLI in a waiting state until a condition is met. |
Extension | GA |
az networkfabric controller create
Create a Network Fabric Controller resource.
az networkfabric controller create --resource-group
--resource-name
[--annotation]
[--infra-er-connections]
[--ipv4-address-space]
[--ipv6-address-space]
[--is-workload-management-network-enabled {False, True}]
[--location]
[--managed-resource-group-configuration]
[--nfc-sku {Basic, HighPerformance, Standard}]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--tags]
[--workload-er-connections]
Examples
Create a Network Fabric Controller. For RE-PUT with 'mrg' parameter, both name and location properties are required.
az networkfabric controller create --resource-group "example-rg" --location "westus3" --resource-name "example-nfc" --ipv4-address-space "10.0.0.0/19" --is-workload-management-network-enabled "True" --nfc-sku "Basic" --infra-er-connections "[{expressRouteCircuitId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.Network/expressRouteCircuits/example-expressRouteCircuit',expressRouteAuthorizationKey:'auth-key'},{expressRouteCircuitId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.Network/expressRouteCircuits/example-expressRouteCircuit',expressRouteAuthorizationKey:'auth-key'}]" --workload-er-connections "[{expressRouteCircuitId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.Network/expressRouteCircuits/example-expressRouteCircuit',expressRouteAuthorizationKey:'auth-key'},{expressRouteCircuitId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.Network/expressRouteCircuits/example-expressRouteCircuit',expressRouteAuthorizationKey:'auth-key'}]" --mrg name=example-mrgName location=eastus
Help text for sub parameters under the specific parent can be viewed by using the shorthand syntax '??'. See https://github.com/Azure/azure-cli/tree/dev/doc/shorthand_syntax.md for more about shorthand syntax.
az networkfabric controller create --infra-er-connections "??"
Required Parameters
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name of the Network Fabric Controller.
Optional Parameters
Description for underlying resource.
Infra ER connections to manage infra resources. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.
IPv4 Network Fabric Controller Address Space.
IPv6 Network Fabric Controller Address Space.
A workload management network is required for all the tenant (workload) traffic. This traffic is only dedicated for Tenant workloads which are required to access internet or any other MSFT/Public endpoints. Default value is True.
Location of Azure region When not specified, the location of the resource group will be used.
Managed Resource Group configuration properties. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.
Network Fabric Controller SKU.
Do not wait for the long-running operation to finish.
Resource tags. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.
Workload management Network for hosting Proxy, NTP and DNS for workloads. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az networkfabric controller delete
Delete the Network Fabric Controller resource.
az networkfabric controller delete [--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--resource-name]
[--subscription]
Examples
Delete the Network Fabric Controller
az networkfabric controller delete --resource-group "example-rg" --resource-name "example-nfc"
Optional Parameters
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.
Do not wait for the long-running operation to finish.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name of the Network Fabric Controller.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az networkfabric controller list
List all Network Fabric Controllers in the provided resource group or subscription.
az networkfabric controller list [--resource-group]
Examples
List the Network Fabric Controllers for Resource group
az networkfabric controller list --resource-group "example-rg"
List the Network Fabric Controllers for Subscription
az networkfabric controller list --subscription "<subscriptionId>"
Optional Parameters
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az networkfabric controller show
Show details of the provided Network Fabric Controller resource.
az networkfabric controller show [--ids]
[--resource-group]
[--resource-name]
[--subscription]
Examples
Show the Network Fabric Controller
az networkfabric controller show --resource-group "example-rg" --resource-name "example-nfc"
Optional Parameters
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 of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name of the Network Fabric Controller.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az networkfabric controller update
Update the Network Fabric Controller resource.
az networkfabric controller update [--ids]
[--infra-er-connections]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--resource-name]
[--subscription]
[--tags]
[--workload-er-connections]
Examples
Update the Network Fabric Controller
az networkfabric controller update --resource-group "example-rg" --resource-name "example-nfc" --infra-er-connections "[{expressRouteCircuitId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.Network/expressRouteCircuits/example-expressRouteCircuit',expressRouteAuthorizationKey:'auth-key'}]" --workload-er-connections "[{expressRouteCircuitId:'/subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxx/resourceGroups/example-rg/providers/Microsoft.Network/expressRouteCircuits/example-expressRouteCircuit',expressRouteAuthorizationKey:'auth-key'}]"
Help text for sub parameters under the specific parent can be viewed by using the shorthand syntax '??'. See https://github.com/Azure/azure-cli/tree/dev/doc/shorthand_syntax.md for more about shorthand syntax.
az networkfabric controller update --infra-er-connections "??"
Optional Parameters
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.
Infra ER connections to manage infra resources. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.
Do not wait for the long-running operation to finish.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name of the Network Fabric Controller.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Resource tags Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.
As part of an update, the workload ExpressRoute CircuitID should be provided to create and Provision a NFC. This Express route is dedicated for Workload services. (This is a Mandatory attribute). Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az networkfabric controller wait
Place the CLI in a waiting state until a condition is met.
az networkfabric controller wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--resource-group]
[--resource-name]
[--subscription]
[--timeout]
[--updated]
Optional Parameters
Wait until created with 'provisioningState' at 'Succeeded'.
Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Wait until deleted.
Wait until the resource exists.
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.
Polling interval in seconds.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Name of the Network Fabric Controller.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Maximum wait in seconds.
Wait until updated with provisioningState at 'Succeeded'.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.