az dns-resolver forwarding-ruleset

  • Referência

Observação

Essa referência faz parte da extensão dns-resolver para a CLI do Azure (versão 2.39.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az dns-resolver forwarding-ruleset . Saiba mais sobre extensões.

Gerencie o conjunto de regras de encaminhamento com o resolvedor de DNS.

Comandos

Nome Description Tipo Status
az dns-resolver forwarding-ruleset create

Crie um conjunto de regras de encaminhamento DNS.

 Extensão GA
az dns-resolver forwarding-ruleset delete

Exclui um conjunto de regras de encaminhamento DNS. Aviso: Esta operação não pode ser desfeita. Todas as regras de encaminhamento dentro do conjunto de regras serão excluídas.

 Extensão GA
az dns-resolver forwarding-ruleset list

Lista IDs de recursos do conjunto de regras de encaminhamento DNS anexados a uma rede virtual. E Lista conjuntos de regras de encaminhamento DNS dentro de um grupo de recursos. E Lista conjuntos de regras de encaminhamento DNS em todos os grupos de recursos de uma assinatura.

 Extensão GA
az dns-resolver forwarding-ruleset list-by-virtual-network

Lista IDs de recursos do conjunto de regras de encaminhamento DNS anexados a uma rede virtual.

 Extensão GA
az dns-resolver forwarding-ruleset show

Obtém um conjunto de regras de encaminhamento DNS propriedades.

 Extensão GA
az dns-resolver forwarding-ruleset update

Atualize um conjunto de regras de encaminhamento DNS.

 Extensão GA
az dns-resolver forwarding-ruleset wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Extensão GA

az dns-resolver forwarding-ruleset create

Crie um conjunto de regras de encaminhamento DNS.

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

Exemplos

Conjunto de regras de encaminhamento 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"

Parâmetros Exigidos

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

O nome do conjunto de regras de encaminhamento DNS.

--outbound-endpoints

A referência aos pontos de extremidade de saída do resolvedor DNS usados para rotear consultas DNS correspondentes às regras de encaminhamento no conjunto de regras para os servidores DNS de destino. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--if-match

ETag do recurso. Omita esse valor para sempre substituir o recurso atual. Especifique o valor ETag visto pela última vez para evitar a substituição acidental de quaisquer alterações simultâneas.

--if-none-match

Defina como '*' para permitir que um novo recurso seja criado, mas para impedir a atualização de um recurso existente. Outros valores serão ignorados.

--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>. Quando não especificado, o local do grupo de recursos será usado.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az dns-resolver forwarding-ruleset delete

Exclui um conjunto de regras de encaminhamento DNS. Aviso: Esta operação não pode ser desfeita. Todas as regras de encaminhamento dentro do conjunto de regras serão excluídas.

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

Exemplos

Excluir conjunto de regras de encaminhamento DNS

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

Parâmetros Opcionais

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

O nome do conjunto de regras de encaminhamento DNS.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--if-match

ETag do recurso. Omita esse valor para sempre substituir o recurso atual. Especifique o valor ETag visto pela última vez para evitar a substituição acidental de quaisquer alterações simultâneas.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--yes -y

Não solicite confirmação.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az dns-resolver forwarding-ruleset list

Lista IDs de recursos do conjunto de regras de encaminhamento DNS anexados a uma rede virtual. E Lista conjuntos de regras de encaminhamento DNS dentro de um grupo de recursos. E Lista conjuntos de regras de encaminhamento DNS em todos os grupos de recursos de uma assinatura.

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

Exemplos

Listar conjuntos de regras de encaminhamento DNS por rede virtual

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

Listar conjuntos de regras de encaminhamento DNS por grupo de recursos

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

Listar conjuntos de regras de encaminhamento DNS por assinatura

az dns-resolver forwarding-ruleset list

Parâmetros Opcionais

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--top

O número máximo de resultados a serem retornados. Se não for especificado, retorna até 100 resultados.

--virtual-network-name

O nome da rede virtual.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

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

Lista IDs de recursos do conjunto de regras de encaminhamento DNS anexados a uma rede virtual.

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

Exemplos

Listar conjuntos de regras de encaminhamento DNS por rede virtual

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

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--virtual-network-name

O nome da rede virtual.

Parâmetros Opcionais

--top

O número máximo de resultados a serem retornados. Se não for especificado, retorna até 100 resultados.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az dns-resolver forwarding-ruleset show

Obtém um conjunto de regras de encaminhamento DNS propriedades.

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

Exemplos

Recuperar conjunto de regras de encaminhamento DNS

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

Parâmetros Opcionais

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

O nome do conjunto de regras de encaminhamento DNS.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az dns-resolver forwarding-ruleset update

Atualize um conjunto de regras de encaminhamento DNS.

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

Exemplos

Atualizar conjunto de regras de encaminhamento DNS

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

Parâmetros Opcionais

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

O nome do conjunto de regras de encaminhamento DNS.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--if-match

ETag do recurso. Omita esse valor para sempre substituir o recurso atual. Especifique o valor ETag visto pela última vez para evitar a substituição acidental de quaisquer alterações simultâneas.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az dns-resolver forwarding-ruleset wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

az dns-resolver forwarding-ruleset wait [--created]
                                        [--custom]
                                        [--deleted]
                                        [--dns-forwarding-ruleset-name]
                                        [--exists]
                                        [--ids]
                                        [--interval]
                                        [--resource-group]
                                        [--subscription]
                                        [--timeout]
                                        [--updated]

Parâmetros Opcionais

--created

Aguarde até criar com 'provisioningState' em 'Succeeded'.

valor padrão: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

valor padrão: False
--dns-forwarding-ruleset-name --name -n

O nome do conjunto de regras de encaminhamento DNS.

--exists

Aguarde até que o recurso exista.

valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

valor padrão: 30
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--timeout

Espera máxima em segundos.

valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.