Partager via


az networkfabric controller

Note

Cette référence fait partie de l’extension managednetworkfabric pour Azure CLI (version 2.75.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez un contrôleur networkfabric commande. Apprenez-en davantage sur les extensions.

Gérer la ressource du contrôleur Network Fabric.

Commandes

Nom Description Type État
az networkfabric controller create

Créez une ressource Network Fabric Controller.

Extension GA
az networkfabric controller delete

Supprimez la ressource Network Fabric Controller.

Extension GA
az networkfabric controller list

Répertoriez tous les contrôleurs Network Fabric dans le groupe de ressources ou l’abonnement fourni.

Extension GA
az networkfabric controller show

Affichez les détails de la ressource Network Fabric Controller fournie.

Extension GA
az networkfabric controller update

Mettez à jour la ressource Network Fabric Controller.

Extension GA
az networkfabric controller wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.

Extension GA

az networkfabric controller create

Créez une ressource Network Fabric Controller.

az networkfabric controller create --resource-group
                                   --resource-name
                                   [--annotation]
                                   [--infra-er-connections --infrastructure-express-route-connections]
                                   [--ipv4-address-space]
                                   [--ipv6-address-space]
                                   [--is-workload-management-network-enabled --wl-mgt-net-enabled {False, True}]
                                   [--location]
                                   [--managed-resource-group-configuration --mrg]
                                   [--mi-system-assigned --system-assigned]
                                   [--mi-user-assigned --user-assigned]
                                   [--nfc-sku {Basic, HighPerformance, Standard}]
                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--tags]
                                   [--wl-er-connections --workload-er-connections --workload-express-route-connections]

Exemples

Créez un contrôleur Network Fabric. Pour RE-PUT avec le paramètre « mrg », les propriétés nom et emplacement sont requises.

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

Le texte d’aide pour les sous-paramètres sous le parent spécifique peut être affiché à l’aide de la syntaxe abrégée « ? ? ». Pour plus d’informations sur la syntaxe abrégée, consultez https://github.com/Azure/azure-cli/tree/dev/doc/shorthand_syntax.md.

az networkfabric controller create --infra-er-connections "??"

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--resource-name

Nom du contrôleur Network Fabric.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--annotation

Description de la configuration du commutateur.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--infra-er-connections --infrastructure-express-route-connections

Dans le cadre d’une mise à jour, l’INFRASTRUCTURE ExpressRoute CircuitID doit être fourni pour créer et provisionner un NFC. Cet itinéraire Express est dédié aux services d’infrastructure. (Il s’agit d’un attribut obligatoire) Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--ipv4-address-space

Espace d’adressage du contrôleur de structure réseau IPv4.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeur par défaut: 10.0.0.0/19
--ipv6-address-space

Espace d’adressage du contrôleur de structure réseau IPv6.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeur par défaut: FC00::/59
--is-workload-management-network-enabled --wl-mgt-net-enabled

Un réseau de gestion des charges de travail est requis pour tout le trafic client (charge de travail). Ce trafic est dédié uniquement aux charges de travail de locataire qui sont requises pour accéder à Internet ou à tout autre point de terminaison MSFT/public.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeur par défaut: True
Valeurs acceptées: False, True
--location -l

Emplacement géographique où la ressource se trouve quand elle n’est pas spécifiée, l’emplacement du groupe de ressources sera utilisé.

Propriété Valeur
Groupe de paramètres: Resource Arguments
--managed-resource-group-configuration --mrg

Propriétés de configuration du groupe de ressources managées. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--mi-system-assigned --system-assigned

Définissez l’identité managée du système.

Propriété Valeur
Groupe de paramètres: Identity Arguments
--mi-user-assigned --user-assigned

Définissez les identités managées par l’utilisateur. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Identity Arguments
--nfc-sku

Référence SKU du contrôleur Network Fabric.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeur par défaut: Standard
Valeurs acceptées: Basic, HighPerformance, Standard
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--tags

Balises de ressource. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Resource Arguments
--wl-er-connections --workload-er-connections --workload-express-route-connections

Dans le cadre d’une mise à jour, expressRoute CircuitID de la charge de travail doit être fourni pour créer et approvisionner un NFC. Cet itinéraire Express est dédié aux services de charge de travail. (Il s’agit d’un attribut obligatoire). Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az networkfabric controller delete

Supprimez la ressource Network Fabric Controller.

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

Exemples

Supprimer le contrôleur Network Fabric

az networkfabric controller delete --resource-group "example-rg" --resource-name "example-nfc"

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-name

Nom du contrôleur Network Fabric.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az networkfabric controller list

Répertoriez tous les contrôleurs Network Fabric dans le groupe de ressources ou l’abonnement fourni.

az networkfabric controller list [--max-items]
                                 [--next-token]
                                 [--resource-group]

Exemples

Répertorier les contrôleurs Network Fabric pour le groupe de ressources

az networkfabric controller list --resource-group "example-rg"

Répertorier les contrôleurs Network Fabric pour l’abonnement

az networkfabric controller list --subscription "<subscriptionId>"

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--max-items

Nombre total d’éléments à retourner dans la sortie de la commande. Si le nombre total d’éléments disponibles est supérieur à la valeur spécifiée, un jeton est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur du jeton dans --next-token argument d’une commande suivante.

Propriété Valeur
Groupe de paramètres: Pagination Arguments
--next-token

Jeton pour spécifier où commencer la pagination. Il s’agit de la valeur du jeton d’une réponse tronquée précédemment.

Propriété Valeur
Groupe de paramètres: Pagination Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az networkfabric controller show

Affichez les détails de la ressource Network Fabric Controller fournie.

az networkfabric controller show [--ids]
                                 [--resource-group]
                                 [--resource-name]
                                 [--subscription]

Exemples

Afficher le contrôleur Network Fabric

az networkfabric controller show --resource-group "example-rg" --resource-name "example-nfc"

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-name

Nom du contrôleur Network Fabric.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az networkfabric controller update

Mettez à jour la ressource Network Fabric Controller.

az networkfabric controller update [--ids]
                                   [--infra-er-connections --infrastructure-express-route-connections]
                                   [--mi-system-assigned --system-assigned]
                                   [--mi-user-assigned --user-assigned]
                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--resource-group]
                                   [--resource-name]
                                   [--subscription]
                                   [--tags]
                                   [--wl-er-connections --workload-er-connections --workload-express-route-connections]

Exemples

Mettre à jour le contrôleur Network Fabric

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'}]"

Le texte d’aide pour les sous-paramètres sous le parent spécifique peut être affiché à l’aide de la syntaxe abrégée « ? ? ». Pour plus d’informations sur la syntaxe abrégée, consultez https://github.com/Azure/azure-cli/tree/dev/doc/shorthand_syntax.md.

az networkfabric controller update --infra-er-connections "??"

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--infra-er-connections --infrastructure-express-route-connections

Dans le cadre d’une mise à jour, l’INFRASTRUCTURE ExpressRoute CircuitID doit être fourni pour créer et provisionner un NFC. Cet itinéraire Express est dédié aux services d’infrastructure. (Il s’agit d’un attribut obligatoire) Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--mi-system-assigned --system-assigned

Définissez l’identité managée du système.

Propriété Valeur
Groupe de paramètres: Identity Arguments
--mi-user-assigned --user-assigned

Définissez les identités managées par l’utilisateur. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Identity Arguments
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-name

Nom du contrôleur Network Fabric.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--tags

Balises de ressource. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--wl-er-connections --workload-er-connections --workload-express-route-connections

Dans le cadre d’une mise à jour, expressRoute CircuitID de la charge de travail doit être fourni pour créer et approvisionner un NFC. Cet itinéraire Express est dédié aux services de charge de travail. (Il s’agit d’un attribut obligatoire). Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az networkfabric controller wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
--deleted

Attendez la suppression.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--exists

Attendez que la ressource existe.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--interval

Intervalle d’interrogation en secondes.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: 30
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-name

Nom du contrôleur Network Fabric.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--timeout

Délai maximal d’attente en secondes.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False