Partager via

az dns-resolver forwarding-ruleset

Note

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

Gérer l’ensemble de règles de transfert avec le programme de résolution dns.

Commandes

Nom Description Type État
az dns-resolver forwarding-ruleset create

Créez un ensemble de règles de transfert DNS.

 Extension GA
az dns-resolver forwarding-ruleset delete

Supprime un ensemble de règles de transfert DNS. AVERTISSEMENT : cette opération ne peut pas être annulée. Toutes les règles de transfert au sein de l’ensemble de règles seront supprimées.

 Extension GA
az dns-resolver forwarding-ruleset list

Répertorie les ID de ressource de jeu de règles de transfert DNS attachés à un réseau virtuel. Et répertorie les ensembles de règles de transfert DNS au sein d’un groupe de ressources. Et répertorie les ensembles de règles de transfert DNS dans tous les groupes de ressources d’un abonnement.

 Extension GA
az dns-resolver forwarding-ruleset list-by-virtual-network

Répertorie les ID de ressource de jeu de règles de transfert DNS attachés à un réseau virtuel.

 Extension GA
az dns-resolver forwarding-ruleset show

Obtient les propriétés d’un ensemble de règles de transfert DNS.

 Extension GA
az dns-resolver forwarding-ruleset update

Mettez à jour un ensemble de règles de transfert DNS.

 Extension GA
az dns-resolver forwarding-ruleset wait

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

 Extension GA

az dns-resolver forwarding-ruleset create

Créez un ensemble de règles de transfert DNS.

az dns-resolver forwarding-ruleset create --dns-forwarding-ruleset-name --name
                                          --outbound-endpoints
                                          --resource-group
                                          [--if-match]
                                          [--if-none-match]
                                          [--location]
                                          [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                          [--tags]

Exemples

Ensemble de règles de transfert DNS Upsert

az dns-resolver forwarding-ruleset create --name "samplednsForwardingRuleset" --location "westus2" --outbound-endpoints [{id:"/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resou rceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/out boundEndpoints/sampleOutboundEndpoint0"},{id:"/subscriptions/abdd4249-9f3 4-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsR esolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint1"}] --tags key1="value1" --resource-group "sampleResourceGroup"

Paramètres obligatoires

--dns-forwarding-ruleset-name --name -n

Nom de l’ensemble de règles de transfert DNS.

--outbound-endpoints

Référence aux points de terminaison sortants du programme de résolution DNS utilisés pour router les requêtes DNS correspondant aux règles de transfert du jeu de règles aux serveurs DNS cibles. 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
--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 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.

--if-match

ETag de la ressource. Omettez cette valeur pour toujours remplacer la ressource actuelle. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

--if-none-match

Définissez la valeur « * » pour permettre la création d’une nouvelle ressource, mais pour empêcher la mise à jour d’une ressource existante. D’autres valeurs seront ignorées.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>. Lorsqu’il n’est pas spécifié, l’emplacement du groupe de ressources est utilisé.

Propriété Valeur
Groupe de paramètres: Parameters 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
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. 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: Parameters 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 dns-resolver forwarding-ruleset delete

Supprime un ensemble de règles de transfert DNS. AVERTISSEMENT : cette opération ne peut pas être annulée. Toutes les règles de transfert au sein de l’ensemble de règles seront supprimées.

az dns-resolver forwarding-ruleset delete [--dns-forwarding-ruleset-name --name]
                                          [--ids]
                                          [--if-match]
                                          [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                          [--resource-group]
                                          [--subscription]
                                          [--yes]

Exemples

Supprimer l’ensemble de règles de transfert DNS

az dns-resolver forwarding-ruleset delete --name "samplednsForwardingRulesetName" --resource-group "sampleResourceGroup"

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.

--dns-forwarding-ruleset-name --name -n

Nom de l’ensemble de règles de transfert DNS.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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
--if-match

ETag de la ressource. Omettez cette valeur pour toujours remplacer la ressource actuelle. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

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

N’invitez pas à confirmer.

Propriété Valeur
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

az dns-resolver forwarding-ruleset list

Répertorie les ID de ressource de jeu de règles de transfert DNS attachés à un réseau virtuel. Et répertorie les ensembles de règles de transfert DNS au sein d’un groupe de ressources. Et répertorie les ensembles de règles de transfert DNS dans tous les groupes de ressources d’un abonnement.

az dns-resolver forwarding-ruleset list [--resource-group]
                                        [--top]
                                        [--virtual-network-name]

Exemples

Répertorier les ensembles de règles de transfert DNS par réseau virtuel

az dns-resolver forwarding-ruleset list --resource-group "sampleResourceGroup" --virtual-network-name "sampleVirtualNetwork"

Répertorier les ensembles de règles de transfert DNS par groupe de ressources

az dns-resolver forwarding-ruleset list --resource-group "sampleResourceGroup"

Répertorier les ensembles de règles de transfert DNS par abonnement

az dns-resolver forwarding-ruleset list

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.

--resource-group -g

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

--top

Nombre maximal de résultats à retourner. Si ce n’est pas spécifié, retourne jusqu’à 100 résultats.

--virtual-network-name

Nom du réseau virtuel.

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 dns-resolver forwarding-ruleset list-by-virtual-network

Répertorie les ID de ressource de jeu de règles de transfert DNS attachés à un réseau virtuel.

az dns-resolver forwarding-ruleset list-by-virtual-network --resource-group
                                                           --virtual-network-name
                                                           [--max-items]
                                                           [--next-token]
                                                           [--top]

Exemples

Répertorier les ensembles de règles de transfert DNS par réseau virtuel

az dns-resolver forwarding-ruleset list --resource-group "sampleResourceGroup" --virtual- network-name "sampleVirtualNetwork"

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

--virtual-network-name

Nom du réseau virtuel.

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

Nombre maximal de résultats à retourner. Si ce n’est pas spécifié, retourne jusqu’à 100 résultats.

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 dns-resolver forwarding-ruleset show

Obtient les propriétés d’un ensemble de règles de transfert DNS.

az dns-resolver forwarding-ruleset show [--dns-forwarding-ruleset-name --name]
                                        [--ids]
                                        [--resource-group]
                                        [--subscription]

Exemples

Récupérer l’ensemble de règles de transfert DNS

az dns-resolver forwarding-ruleset show --name "sampleDnsForwardingRuleset" --resource-group "sampleResourceGroup"

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.

--dns-forwarding-ruleset-name --name -n

Nom de l’ensemble de règles de transfert DNS.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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
--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 dns-resolver forwarding-ruleset update

Mettez à jour un ensemble de règles de transfert DNS.

az dns-resolver forwarding-ruleset update [--add]
                                          [--dns-forwarding-ruleset-name --name]
                                          [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                          [--ids]
                                          [--if-match]
                                          [--if-none-match]
                                          [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                          [--remove]
                                          [--resource-group]
                                          [--set]
                                          [--subscription]
                                          [--tags]

Exemples

Mettre à jour l’ensemble de règles de transfert DNS

az dns-resolver forwarding-ruleset update --name "sampleDnsForwardingRuleset" --tags key1="value1" --resource-group "sampleResourceGroup"

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.

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
--dns-forwarding-ruleset-name --name -n

Nom de l’ensemble de règles de transfert DNS.

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

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--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
--if-match

ETag de la ressource. Omettez cette valeur pour toujours remplacer la ressource actuelle. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

--if-none-match

Définissez la valeur « * » pour permettre la création d’une nouvelle ressource, mais pour empêcher la mise à jour d’une ressource existante. D’autres valeurs seront ignorées.

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

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriété Valeur
Groupe de paramètres: Generic Update 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
--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

Propriété Valeur
Groupe de paramètres: Generic Update 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 séparées par l’espace : key[=value] [key[=value] ...]. 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: Parameters 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 dns-resolver forwarding-ruleset wait

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

az dns-resolver forwarding-ruleset wait [--created]
                                        [--custom]
                                        [--deleted]
                                        [--dns-forwarding-ruleset-name --name]
                                        [--exists]
                                        [--ids]
                                        [--interval]
                                        [--resource-group]
                                        [--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
--dns-forwarding-ruleset-name --name -n

Nom de l’ensemble de règles de transfert DNS.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--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
--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