Partilhar via

az dns-resolver forwarding-rule

  • Referência

Nota

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

Gerencie a regra de encaminhamento com o resolvedor de dns.

Comandos

Name Description Tipo Status
az dns-resolver forwarding-rule create

Crie uma regra de encaminhamento em um conjunto de regras de encaminhamento DNS.

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

Exclui uma regra de encaminhamento em um conjunto de regras de encaminhamento DNS. AVISO: Esta operação não pode ser desfeita.

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

Lista as regras de encaminhamento em um conjunto de regras de encaminhamento DNS.

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

Obtém propriedades de uma regra de encaminhamento em um conjunto de regras de encaminhamento DNS.

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

Atualize uma regra de encaminhamento em um conjunto de regras de encaminhamento DNS.

 Extensão GA

az dns-resolver forwarding-rule create

Crie uma regra de encaminhamento em um conjunto de regras de encaminhamento DNS.

az dns-resolver forwarding-rule create --domain-name
                                       --forwarding-rule-name
                                       --resource-group
                                       --ruleset-name
                                       --target-dns-servers
                                       [--forwarding-rule-state {Disabled, Enabled}]
                                       [--if-match]
                                       [--if-none-match]
                                       [--metadata]

Exemplos

Regra de encaminhamento Upsert em um conjunto de regras de encaminhamento DNS

az dns-resolver forwarding-rule create --ruleset-name "sampleDnsForwardingRuleset" --name "sampleForwardingRule" --domain-name "contoso.com." --forwarding-rule-state "Enabled" --metadata additionalProp1="value1" --target-dns-servers [{ip-address:"10.0.0.1",port:53},{ip-address:"10.0.0.2",port:53}] --resource-group "sampleResourceGroup"

Parâmetros Obrigatórios

--domain-name

O nome de domínio para a regra de encaminhamento.

--forwarding-rule-name --name -n

O nome da regra de encaminhamento.

--resource-group -g

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

--ruleset-name

O nome do conjunto de regras de encaminhamento DNS.

--target-dns-servers

Servidores DNS para os quais encaminhar a consulta DNS. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros Opcionais

--forwarding-rule-state

O estado da regra de encaminhamento.

Valores aceites: Disabled, Enabled
--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.

--metadata

Metadados anexados à regra de encaminhamento. Valor esperado: KEY1=VALUE1 KEY2=VALUE2 ... Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dns-resolver forwarding-rule delete

Exclui uma regra de encaminhamento em um conjunto de regras de encaminhamento DNS. AVISO: Esta operação não pode ser desfeita.

az dns-resolver forwarding-rule delete [--forwarding-rule-name]
                                       [--ids]
                                       [--if-match]
                                       [--resource-group]
                                       [--ruleset-name]
                                       [--subscription]
                                       [--yes]

Exemplos

Excluir regra de encaminhamento em um conjunto de regras de encaminhamento DNS

az dns-resolver forwarding-rule delete --ruleset-name "sampleDnsForwardingRuleset" --name "sampleForwardingRule" --resource-group "sampleResourceGroup"

Parâmetros Opcionais

--forwarding-rule-name --name -n

O nome da regra de encaminhamento.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. 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.

--resource-group -g

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

--ruleset-name

O nome do conjunto de regras de encaminhamento DNS.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dns-resolver forwarding-rule list

Lista as regras de encaminhamento em um conjunto de regras de encaminhamento DNS.

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

Exemplos

Listar regras de encaminhamento em um conjunto de regras de encaminhamento DNS

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

Parâmetros Obrigatórios

--resource-group -g

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

--ruleset-name

O nome do conjunto de regras de encaminhamento DNS.

Parâmetros Opcionais

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token no --next-token argumento de um comando subsequente.

--next-token

Token para especificar por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

--top

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dns-resolver forwarding-rule show

Obtém propriedades de uma regra de encaminhamento em um conjunto de regras de encaminhamento DNS.

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

Exemplos

Recuperar regra de encaminhamento em um conjunto de regras de encaminhamento DNS

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

Parâmetros Opcionais

--forwarding-rule-name --name -n

O nome da regra de encaminhamento.

--ids

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

--resource-group -g

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

--ruleset-name

O nome do conjunto de regras de encaminhamento DNS.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dns-resolver forwarding-rule update

Atualize uma regra de encaminhamento em um conjunto de regras de encaminhamento DNS.

az dns-resolver forwarding-rule update [--add]
                                       [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--forwarding-rule-name]
                                       [--forwarding-rule-state {Disabled, Enabled}]
                                       [--ids]
                                       [--if-match]
                                       [--metadata]
                                       [--remove]
                                       [--resource-group]
                                       [--ruleset-name]
                                       [--set]
                                       [--subscription]
                                       [--target-dns-servers]

Exemplos

Atualizar regra de encaminhamento em um conjunto de regras de encaminhamento DNS

az dns-resolver forwarding-rule update --ruleset-name "sampleDnsForwardingRuleset" --name "sampleForwardingRule" --forwarding-rule-state "Disabled" --metadata additionalProp2="value2" --resource-group "sampleResourceGroup"

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

--force-string

Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--forwarding-rule-name --name -n

O nome da regra de encaminhamento.

--forwarding-rule-state

O estado da regra de encaminhamento.

Valores aceites: Disabled, Enabled
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. 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.

--metadata

Metadados anexados à regra de encaminhamento. Valor esperado: KEY1=VALUE1 KEY2=VALUE2 ... Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

--resource-group -g

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

--ruleset-name

O nome do conjunto de regras de encaminhamento DNS.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--target-dns-servers

Servidores DNS para os quais encaminhar a consulta DNS. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.