Compartir a través de


az deployment sub

Administrar la implementación de plantillas de Azure Resource Manager en el ámbito de la suscripción.

Comandos

Nombre Description Tipo Estado
az deployment sub cancel

Cancelar una implementación en el ámbito de la suscripción.

Core GA
az deployment sub create

Inicie una implementación en el ámbito de la suscripción.

Core GA
az deployment sub delete

Elimine una implementación en el ámbito de la suscripción.

Core GA
az deployment sub export

Exporte la plantilla usada para una implementación.

Core GA
az deployment sub list

Enumera las implementaciones en el ámbito de la suscripción.

Core GA
az deployment sub show

Mostrar una implementación en el ámbito de la suscripción.

Core GA
az deployment sub validate

Valide si una plantilla es válida en el ámbito de la suscripción.

Core GA
az deployment sub wait

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

Core GA
az deployment sub what-if

Ejecute una operación de implementación What-If en el ámbito de la suscripción.

Core GA

az deployment sub cancel

Cancelar una implementación en el ámbito de la suscripción.

az deployment sub cancel --name

Ejemplos

Cancelar una implementación en el ámbito de la suscripción.

az deployment sub cancel -n deployment01

Parámetros requeridos

--name -n

Nombre de la implementación.

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 deployment sub create

Inicie una implementación en el ámbito de la suscripción.

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

az deployment sub 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]
                         [--validation-level {Provider, ProviderNoRbac, Template}]
                         [--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 la suscripción desde un archivo de plantilla remota mediante parámetros de un archivo JSON local.

az deployment sub create --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

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

Cree una implementación en el ámbito de la suscripción desde 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 sub create --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

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.

--confirm-with-what-if -c

Indique al comando que ejecute la implementación What-If 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

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

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

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

Propiedad Valor
Valor predeterminado: False
--parameters -p

Proporcione valores de parámetros de implementación.

Los parámetros se pueden proporcionar desde un archivo mediante la sintaxis de @{path}, 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 del What-If no contiene cambios en los recursos. 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.

--validation-level

Nivel de validación de implementación. Puede establecerse en "Provider" (valor predeterminado), "Template" o "ProviderNoRbac". Con un nivel de validación de "proveedor", ARM realizará una validación completa y comprobará que tiene permiso suficiente para implementar todos los recursos de la plantilla. Con un nivel de validación de "providerNoRbac", ARM realizará una validación completa, pero solo comprobará si hay permisos de lectura en cada recurso. Con un nivel de validación de "plantilla", solo se realizará la validación estática: se omitirán las comprobaciones previas y permisos.

Propiedad Valor
Valores aceptados: Provider, ProviderNoRbac, Template
--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 de What-If. Aplicable cuando se establece --confirm-with-what-if.

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

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

Propiedad Valor
Valor predeterminado: FullResourcePayloads
Valores aceptados: FullResourcePayloads, ResourceIdOnly
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 deployment sub delete

Elimine una implementación en el ámbito de la suscripción.

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

Ejemplos

Elimine una implementación en el ámbito de la suscripción.

az deployment sub delete -n deployment01

Parámetros requeridos

--name -n

Nombre de la implementación.

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.

--no-wait

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

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.

--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 deployment sub export

Exporte la plantilla usada para una implementación.

az deployment sub export --name

Ejemplos

Exporte la plantilla usada para una implementación en el ámbito de la suscripción.

az deployment sub export --name MyDeployment

Parámetros requeridos

--name -n

Nombre de la implementación.

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 deployment sub list

Enumera las implementaciones en el ámbito de la suscripción.

az deployment sub list [--filter]

Ejemplos

Enumera las implementaciones en el ámbito de la suscripción.

az deployment sub list

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.

--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://learn.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.

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 deployment sub show

Mostrar una implementación en el ámbito de la suscripción.

az deployment sub show --name

Ejemplos

Mostrar una implementación en el ámbito de la suscripción.

az deployment sub show -n deployment01

Parámetros requeridos

--name -n

Nombre de la implementación.

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 deployment sub validate

Valide si una plantilla es válida en el ámbito de la suscripción.

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

az deployment sub validate --location
                           [--handle-extended-json-format]
                           [--name]
                           [--no-prompt {false, true}]
                           [--parameters]
                           [--query-string]
                           [--template-file]
                           [--template-spec]
                           [--template-uri]
                           [--validation-level {Provider, ProviderNoRbac, Template}]

Ejemplos

Valide si una plantilla es válida en el ámbito de la suscripción.

az deployment sub validate --location westus2 --template-file {template-file}

Valide si una plantilla es válida en el ámbito de la suscripción. (autogenerated)

az deployment sub validate --location westus2 --parameters MyValue=This MyArray=@array.json --template-file azuredeploy.json

Parámetros requeridos

--location -l

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

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.

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

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

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

Proporcione valores de parámetros de implementación.

Los parámetros se pueden proporcionar desde un archivo mediante la sintaxis de @{path}, 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.

--validation-level

Nivel de validación de implementación. Puede establecerse en "Provider" (valor predeterminado), "Template" o "ProviderNoRbac". Con un nivel de validación de "proveedor", ARM realizará una validación completa y comprobará que tiene permiso suficiente para implementar todos los recursos de la plantilla. Con un nivel de validación de "providerNoRbac", ARM realizará una validación completa, pero solo comprobará si hay permisos de lectura en cada recurso. Con un nivel de validación de "plantilla", solo se realizará la validación estática: se omitirán las comprobaciones previas y permisos.

Propiedad Valor
Valores aceptados: Provider, ProviderNoRbac, Template
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 deployment sub wait

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

az deployment sub 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. (autogenerated)

az deployment sub wait --created --name MyDeployment

Parámetros requeridos

--name -n

Nombre de la implementación.

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.

--created

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--custom

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
--deleted

Espere hasta que se elimine.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--interval

Intervalo de sondeo en segundos.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: 30
--timeout

Espera máxima en segundos.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: 3600
--updated

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
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.

--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 deployment sub what-if

Ejecute una operación de implementación What-If en el ámbito de la suscripción.

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

az deployment sub 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]
                          [--validation-level {Provider, ProviderNoRbac, Template}]

Ejemplos

Ejecute una operación de implementación What-If en una suscripción.

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

Ejecute una operación de implementación What-If en una suscripción con formato ResourceIdOnly.

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

Ejecute una operación de implementación What-If en una suscripción sin imprimir el resultado.

az deployment sub 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 de implementación What-If.

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.

--exclude-change-types -x

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

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

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

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

Proporcione valores de parámetros de implementación.

Los parámetros se pueden proporcionar desde un archivo mediante la sintaxis de @{path}, 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 What-If resultados.

Propiedad Valor
Valor predeterminado: FullResourcePayloads
Valores aceptados: FullResourcePayloads, ResourceIdOnly
--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.

--validation-level

Nivel de validación de implementación. Puede establecerse en "Provider" (valor predeterminado), "Template" o "ProviderNoRbac". Con un nivel de validación de "proveedor", ARM realizará una validación completa y comprobará que tiene permiso suficiente para implementar todos los recursos de la plantilla. Con un nivel de validación de "providerNoRbac", ARM realizará una validación completa, pero solo comprobará si hay permisos de lectura en cada recurso. Con un nivel de validación de "plantilla", solo se realizará la validación estática: se omitirán las comprobaciones previas y permisos.

Propiedad Valor
Valores aceptados: Provider, ProviderNoRbac, Template
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