Compartir a través de


az deployment tenant

Administre la implementación de plantillas de Azure Resource Manager en el ámbito del inquilino.

Comandos

Nombre Description Tipo Estado
az deployment tenant cancel

Cancelar una implementación en el ámbito del inquilino.

Principal GA
az deployment tenant create

Inicie una implementación en el ámbito del inquilino.

Principal GA
az deployment tenant delete

Elimine una implementación en el ámbito del inquilino.

Principal GA
az deployment tenant export

Exporte la plantilla que se usó para una implementación.

Principal GA
az deployment tenant list

Enumera las implementaciones en el ámbito del inquilino.

Principal GA
az deployment tenant show

Mostrar una implementación en el ámbito del inquilino.

Principal GA
az deployment tenant validate

Valide si una plantilla es válida en el ámbito del inquilino.

Principal GA
az deployment tenant wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición de implementación.

Principal GA
az deployment tenant what-if

Ejecute una operación what-if de implementación en el ámbito del inquilino.

Principal GA

az deployment tenant cancel

Cancelar una implementación en el ámbito del inquilino.

az deployment tenant cancel --name

Ejemplos

Cancelar una implementación en el ámbito del inquilino.

az deployment tenant cancel -n deployment01

Parámetros requeridos

--name -n

El nombre de la implementación.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az deployment tenant create

Inicie una implementación en el ámbito del inquilino.

Especifique solo uno de los archivos --template-file | --template-uri URI | --template-spec para introducir la plantilla de ARM.

az deployment tenant create --location
                            [--confirm-with-what-if]
                            [--handle-extended-json-format]
                            [--name]
                            [--no-prompt {false, true}]
                            [--no-wait]
                            [--parameters]
                            [--proceed-if-no-change]
                            [--query-string]
                            [--template-file]
                            [--template-spec]
                            [--template-uri]
                            [--what-if]
                            [--what-if-exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                            [--what-if-result-format {FullResourcePayloads, ResourceIdOnly}]

Ejemplos

Cree una implementación en el ámbito de inquilino a partir de un archivo de plantilla remota mediante parámetros de un archivo JSON local.

az deployment tenant create --name rollout01 --location WestUS \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Cree una implementación en el ámbito de inquilino desde un archivo de plantilla local mediante parámetros de una cadena JSON.

az deployment tenant create --name rollout01 --location WestUS \
    --template-file azuredeploy.json \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Cree una implementación en el ámbito de inquilino a partir de una plantilla local, mediante un archivo de parámetros, un archivo de parámetros remotos y invalide de forma selectiva pares clave-valor.

az deployment tenant create --name rollout01 --location WestUS \
    --template-file azuredeploy.json  --parameters @params.json \
    --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Parámetros requeridos

--location -l

Ubicación para almacenar los metadatos de implementación.

Parámetros opcionales

--confirm-with-what-if -c

Indique al comando que ejecute what-If de implementación antes de ejecutar la implementación. A continuación, se le pide que confirme los cambios en los recursos antes de continuar.

--handle-extended-json-format -j
Obsoleto

La opción "--handle-extended-json-format/-j" está en desuso y se quitará en una versión futura.

Compatibilidad para controlar el contenido extendido de la plantilla, incluidos los comentarios y varias líneas en la implementación.

--name -n

El nombre de la implementación.

--no-prompt

La opción para deshabilitar la solicitud de los parámetros que faltan para la plantilla de ARM. Cuando el valor es true, se omitirá la solicitud que requiere a los usuarios que proporcionen el parámetro que falta. El valor predeterminado es falso.

Valores aceptados: false, true
Valor predeterminado: False
--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
--parameters -p

Proporcione valores de parámetros de implementación.

Los parámetros se pueden proporcionar desde un archivo mediante la @{path} sintaxis, una cadena JSON o como <pares KEY=VALUE> . Los parámetros se evalúan en orden, por lo que cuando se asigna un valor dos veces, se usará el último valor. Se recomienda proporcionar primero el archivo de parámetros y, a continuación, invalidar selectivamente mediante la sintaxis KEY=VALUE.

--proceed-if-no-change

Indique al comando que ejecute la implementación si el resultado What-If no contiene ningún cambio de recurso. Aplicable cuando se establece --confirm-with-what-if.

--query-string -q

Cadena de consulta (un token de SAS) que se va a usar con el URI de plantilla en el caso de las plantillas vinculadas.

--template-file -f

Ruta de acceso al archivo de plantilla o al archivo de Bicep.

--template-spec -s

Identificador de recurso de especificación de plantilla.

--template-uri -u

Identificador URI del archivo de plantilla.

--what-if -w

Indique al comando que ejecute what-if de implementación.

--what-if-exclude-change-types -x

Lista separada por espacios de tipos de cambio de recursos que se excluirán de los resultados what-if. Aplicable cuando se establece --confirm-with-what-if.

Valores aceptados: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--what-if-result-format -r

Formato de los resultados what-if. Aplicable cuando --confirm-with-what-if se establece.

Valores aceptados: FullResourcePayloads, ResourceIdOnly
Valor predeterminado: FullResourcePayloads
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az deployment tenant delete

Elimine una implementación en el ámbito del inquilino.

az deployment tenant delete --name
                            [--no-wait]

Ejemplos

Elimine una implementación en el ámbito del inquilino.

az deployment tenant delete -n deployment01

Parámetros requeridos

--name -n

El nombre de la implementación.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az deployment tenant export

Exporte la plantilla que se usó para una implementación.

az deployment tenant export --name

Ejemplos

Exporte la plantilla usada para una implementación en el ámbito del inquilino.

az deployment tenant export --name MyDeployment

Parámetros requeridos

--name -n

El nombre de la implementación.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az deployment tenant list

Enumera las implementaciones en el ámbito del inquilino.

az deployment tenant list [--filter]

Ejemplos

Enumera las implementaciones en el ámbito del inquilino.

az deployment tenant list

Parámetros opcionales

--filter
Vista previa

Filtrar expresión mediante notación OData. Puede usar --filter "provisioningState eq '{state}'" para filtrar provisioningState. Para obtener más información, visite https://docs.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az deployment tenant show

Mostrar una implementación en el ámbito del inquilino.

az deployment tenant show --name

Ejemplos

Mostrar una implementación en el ámbito del inquilino.

az deployment tenant show -n deployment01

Parámetros requeridos

--name -n

El nombre de la implementación.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az deployment tenant validate

Valide si una plantilla es válida en el ámbito del inquilino.

Especifique solo uno de los archivos --template-file | --template-uri URI | --template-spec para introducir la plantilla de ARM.

az deployment tenant validate --location
                              [--handle-extended-json-format]
                              [--name]
                              [--no-prompt {false, true}]
                              [--parameters]
                              [--query-string]
                              [--template-file]
                              [--template-spec]
                              [--template-uri]

Ejemplos

Valide si una plantilla es válida en el ámbito del inquilino.

az deployment tenant validate --location WestUS --template-file {template-file}

Valide si una plantilla es válida en el ámbito del inquilino. (generado automáticamente)

az deployment tenant validate --location WestUS --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json

Parámetros requeridos

--location -l

Ubicación para almacenar los metadatos de implementación.

Parámetros opcionales

--handle-extended-json-format -j
Obsoleto

La opción "--handle-extended-json-format/-j" está en desuso y se quitará en una versión futura.

Compatibilidad para controlar el contenido extendido de la plantilla, incluidos los comentarios y varias líneas en la implementación.

--name -n

El nombre de la implementación.

--no-prompt

La opción para deshabilitar la solicitud de los parámetros que faltan para la plantilla de ARM. Cuando el valor es true, se omitirá la solicitud que requiere a los usuarios que proporcionen el parámetro que falta. El valor predeterminado es falso.

Valores aceptados: false, true
Valor predeterminado: False
--parameters -p

Proporcione valores de parámetros de implementación.

Los parámetros se pueden proporcionar desde un archivo mediante la @{path} sintaxis, una cadena JSON o como <pares KEY=VALUE> . Los parámetros se evalúan en orden, por lo que cuando se asigna un valor dos veces, se usará el último valor. Se recomienda proporcionar primero el archivo de parámetros y, a continuación, invalidar selectivamente mediante la sintaxis KEY=VALUE.

--query-string -q

Cadena de consulta (un token de SAS) que se va a usar con el URI de plantilla en el caso de las plantillas vinculadas.

--template-file -f

Ruta de acceso al archivo de plantilla o al archivo de Bicep.

--template-spec -s

Identificador de recurso de especificación de plantilla.

--template-uri -u

Identificador URI del archivo de plantilla.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az deployment tenant wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición de implementación.

az deployment tenant wait --name
                          [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--interval]
                          [--timeout]
                          [--updated]

Ejemplos

Coloque la CLI en un estado de espera hasta que se cumpla una condición de implementación. (generado automáticamente)

az deployment tenant wait --deleted --name MyDeployment

Parámetros requeridos

--name -n

El nombre de la implementación.

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az deployment tenant what-if

Ejecute una operación what-if de implementación en el ámbito del inquilino.

Especifique solo uno de los archivos --template-file | --template-uri URI | --template-spec para introducir la plantilla de ARM.

az deployment tenant what-if --location
                             [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                             [--name]
                             [--no-pretty-print]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--query-string]
                             [--result-format {FullResourcePayloads, ResourceIdOnly}]
                             [--template-file]
                             [--template-spec]
                             [--template-uri]

Ejemplos

Ejecute una operación what-if de implementación en el ámbito del inquilino.

az deployment tenant what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Ejecute una operación what-if de implementación en el ámbito del inquilino con el formato ResourceIdOnly.

az deployment tenant what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

Ejecute una operación What-If de implementación en el ámbito del inquilino sin imprimir el resultado.

az deployment tenant what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Parámetros requeridos

--location -l

Ubicación para almacenar los metadatos de la operación What-If de implementación.

Parámetros opcionales

--exclude-change-types -x

Lista separada por espacios de tipos de cambio de recursos que se excluirán de los resultados what-if.

Valores aceptados: Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported
--name -n

El nombre de la implementación.

--no-pretty-print

Deshabilite la impresión bonita para los resultados de What-If. Cuando se establece, se usará el tipo de formato de salida.

--no-prompt

La opción para deshabilitar la solicitud de los parámetros que faltan para la plantilla de ARM. Cuando el valor es true, se omitirá la solicitud que requiere a los usuarios que proporcionen el parámetro que falta. El valor predeterminado es falso.

Valores aceptados: false, true
Valor predeterminado: False
--parameters -p

Proporcione valores de parámetros de implementación.

Los parámetros se pueden proporcionar desde un archivo mediante la @{path} sintaxis, una cadena JSON o como <pares KEY=VALUE> . Los parámetros se evalúan en orden, por lo que cuando se asigna un valor dos veces, se usará el último valor. Se recomienda proporcionar primero el archivo de parámetros y, a continuación, invalidar selectivamente mediante la sintaxis KEY=VALUE.

--query-string -q

Cadena de consulta (un token de SAS) que se va a usar con el URI de plantilla en el caso de las plantillas vinculadas.

--result-format -r

Formato de los resultados what-if.

Valores aceptados: FullResourcePayloads, ResourceIdOnly
Valor predeterminado: FullResourcePayloads
--template-file -f

Ruta de acceso al archivo de plantilla o al archivo de Bicep.

--template-spec -s

Identificador de recurso de especificación de plantilla.

--template-uri -u

Identificador URI del archivo de plantilla.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.