Compartir a través de


az dns-resolver forwarding-rule

Note

Esta referencia forma parte de la extensión dns-resolver para la CLI de Azure (versión 2.75.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az dns-resolver forwarding-rule. Obtenga más información sobre las extensiones.

Administrar la regla de reenvío con la resolución dns.

Comandos

Nombre Description Tipo Estado
az dns-resolver forwarding-rule create

Cree una regla de reenvío en un conjunto de reglas de reenvío DNS.

Extension GA
az dns-resolver forwarding-rule delete

Elimina una regla de reenvío en un conjunto de reglas de reenvío DNS. ADVERTENCIA: Esta operación no se puede deshacer.

Extension GA
az dns-resolver forwarding-rule list

Enumera las reglas de reenvío en un conjunto de reglas de reenvío DNS.

Extension GA
az dns-resolver forwarding-rule show

Obtiene las propiedades de una regla de reenvío en un conjunto de reglas de reenvío DNS.

Extension GA
az dns-resolver forwarding-rule update

Actualice una regla de reenvío en un conjunto de reglas de reenvío DNS.

Extension GA

az dns-resolver forwarding-rule create

Cree una regla de reenvío en un conjunto de reglas de reenvío DNS.

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

Ejemplos

Regla de reenvío upsert en un conjunto de reglas de reenvío 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 requeridos

--domain-name

Nombre de dominio de la regla de reenvío.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--forwarding-rule-name --name -n

Nombre de la regla de reenvío.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--ruleset-name

Nombre del conjunto de reglas de reenvío DNS.

--target-dns-servers

Servidores DNS a los que reenviar la consulta DNS. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--forwarding-rule-state

Estado de la regla de reenvío.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: Disabled, Enabled
--if-match

ETag del recurso. Omita este valor para sobrescribir siempre el recurso actual. Especifique el valor de ETag visto por última vez para evitar que se sobrescriba accidentalmente cualquier cambio simultáneo.

--if-none-match

Establézcalo en "*" para permitir la creación de un nuevo recurso, pero evitar la actualización de un recurso existente. Se omitirán otros valores.

--metadata

Metadatos adjuntos a la regla de reenvío. Valor esperado: KEY1=VALUE1 KEY2=VALUE2 ... Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az dns-resolver forwarding-rule delete

Elimina una regla de reenvío en un conjunto de reglas de reenvío DNS. ADVERTENCIA: Esta operación no se puede deshacer.

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

Ejemplos

Eliminar regla de reenvío en un conjunto de reglas de reenvío DNS

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Nombre de la regla de reenvío.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--if-match

ETag del recurso. Omita este valor para sobrescribir siempre el recurso actual. Especifique el valor de ETag visto por última vez para evitar que se sobrescriba accidentalmente cualquier cambio simultáneo.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ruleset-name

Nombre del conjunto de reglas de reenvío DNS.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az dns-resolver forwarding-rule list

Enumera las reglas de reenvío en un conjunto de reglas de reenvío DNS.

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

Ejemplos

Enumerar reglas de reenvío en un conjunto de reglas de reenvío DNS

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

Parámetros requeridos

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--ruleset-name

Nombre del conjunto de reglas de reenvío DNS.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token argumento de un comando posterior.

Propiedad Valor
Grupo de parámetros: Pagination Arguments
--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

Propiedad Valor
Grupo de parámetros: Pagination Arguments
--top

Número máximo de resultados que se van a devolver. Si no se especifica, devuelve hasta 100 resultados.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az dns-resolver forwarding-rule show

Obtiene las propiedades de una regla de reenvío en un conjunto de reglas de reenvío DNS.

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

Ejemplos

Recuperación de la regla de reenvío en un conjunto de reglas de reenvío DNS

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Nombre de la regla de reenvío.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ruleset-name

Nombre del conjunto de reglas de reenvío DNS.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az dns-resolver forwarding-rule update

Actualice una regla de reenvío en un conjunto de reglas de reenvío DNS.

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

Ejemplos

Actualización de la regla de reenvío en un conjunto de reglas de reenvío DNS

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--forwarding-rule-name --name -n

Nombre de la regla de reenvío.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--forwarding-rule-state

Estado de la regla de reenvío.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: Disabled, Enabled
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--if-match

ETag del recurso. Omita este valor para sobrescribir siempre el recurso actual. Especifique el valor de ETag visto por última vez para evitar que se sobrescriba accidentalmente cualquier cambio simultáneo.

--if-none-match

Establézcalo en "*" para permitir la creación de un nuevo recurso, pero evitar la actualización de un recurso existente. Se omitirán otros valores.

--metadata

Metadatos adjuntos a la regla de reenvío. Valor esperado: KEY1=VALUE1 KEY2=VALUE2 ... Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ruleset-name

Nombre del conjunto de reglas de reenvío DNS.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--target-dns-servers

Servidores DNS a los que reenviar la consulta DNS. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False