Compartir vía

az deployment group

  • Referencia

Administración de la implementación de plantillas de Azure Resource Manager en el grupo de recursos.

Comandos

Nombre Description Tipo Estado
az deployment group cancel

Cancelar una implementación en el grupo de recursos.

 Núcleo GA
az deployment group create

Inicie una implementación en el grupo de recursos.

 Núcleo GA
az deployment group delete

Elimine una implementación en el grupo de recursos.

 Núcleo GA
az deployment group export

Exporte la plantilla usada para una implementación.

 Núcleo GA
az deployment group list

Enumera las implementaciones en el grupo de recursos.

 Núcleo GA
az deployment group show

Mostrar una implementación en el grupo de recursos.

 Núcleo GA
az deployment group validate

Compruebe si una plantilla es válida en el grupo de recursos.

 Núcleo GA
az deployment group wait

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

 Núcleo GA
az deployment group what-if

Ejecute una operación de implementación What-If en el ámbito del grupo de recursos.

 Núcleo GA

az deployment group cancel

Editar

Cancelar una implementación en el grupo de recursos.

az deployment group cancel --name
                           --resource-group

Ejemplos

Cancelar una implementación en el grupo de recursos.

az deployment group cancel -g testrg -n deployment01

Parámetros requeridos

--name -n

Nombre de la implementación.

--resource-group -g

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

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az deployment group create

Editar

Inicie una implementación en el grupo de recursos.

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

az deployment group create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--confirm-with-what-if]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--proceed-if-no-change]
                           [--query-string]
                           [--rollback-on-error]
                           [--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 grupo de recursos a partir de un archivo de plantilla remoto mediante parámetros de un archivo JSON local.

az deployment group create --resource-group testrg --name rollout01 \
    --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  \
    --parameters '{ \"policyName\": { \"value\": \"policy2\" } }'

Cree una implementación en el grupo de recursos a partir de un archivo de plantilla local mediante parámetros de una cadena de matriz.

az deployment group create --resource-group testgroup --template-file demotemplate.json --parameters exampleString='inline string' exampleArray='("value1", "value2")'

Cree una implementación en el grupo de recursos 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 group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json  --parameters @params.json \
    --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Creación de una implementación en el ámbito del grupo de recursos a partir de una especificación de plantilla

az deployment group create --resource-group testrg --template-spec "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0"

Creación de una implementación en el ámbito del grupo de recursos desde un archivo de parámetros bicepparam

az deployment group create --resource-group testrg --parameters parameters.bicepparam

Creación de una implementación en el grupo de recursos entre inquilinos

az deployment group create --resource-group testrg --name rollout01 \
    --template-file azuredeploy.json --parameters @myparameters.json --aux-tenants auxiliary_tenant01 auxiliary_tenant02

Parámetros requeridos

--resource-group -g

Grupo de recursos en el que se va a crear la implementación.

Parámetros opcionales

--aux-subs
Obsoleto

La opción "--aux-subs" está en desuso y se quitará en una versión futura. Use "--aux-tenants" en su lugar.

Suscripciones auxiliares que se usarán durante la implementación entre inquilinos.

--aux-tenants

Inquilinos auxiliares que se usarán durante la implementación entre inquilinos.

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

--mode

Modo de implementación.

Valores aceptados: Complete, Incremental
Valor predeterminado: Incremental
--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.

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

No espere a 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 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. Tenga en cuenta también si proporciona un archivo bicepparam, puede usar este argumento solo una vez.

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

--rollback-on-error

Nombre de una implementación a la que se revertirá al error o use como marca para revertir a la última implementación correcta.

--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 de 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 What-If resultados. Aplicable cuando se establece --confirm-with-what-if.

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

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az deployment group delete

Editar

Elimine una implementación en el grupo de recursos.

az deployment group delete --name
                           --resource-group
                           [--no-wait]

Ejemplos

Elimine una implementación en el grupo de recursos.

az deployment group delete -g testrg -n deployment01

Parámetros requeridos

--name -n

Nombre de la implementación.

--resource-group -g

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

Parámetros opcionales

--no-wait

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

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az deployment group export

Editar

Exporte la plantilla usada para una implementación.

az deployment group export --name
                           --resource-group

Ejemplos

Exporte la plantilla usada para una implementación en el grupo de recursos.

az deployment group export --resource-group testrg --name MyDeployment

Parámetros requeridos

--name -n

Nombre de la implementación.

--resource-group -g

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

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az deployment group list

Editar

Enumera las implementaciones en el grupo de recursos.

az deployment group list --resource-group
                         [--filter]

Ejemplos

Enumera las implementaciones en el grupo de recursos.

az deployment group list -g testrg

Parámetros requeridos

--resource-group -g

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

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://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.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az deployment group show

Editar

Mostrar una implementación en el grupo de recursos.

az deployment group show --name
                         --resource-group

Ejemplos

Mostrar una implementación en el grupo de recursos.

az deployment group show -g testrg -n deployment01

Parámetros requeridos

--name -n

Nombre de la implementación.

--resource-group -g

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

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az deployment group validate

Editar

Compruebe si una plantilla es válida en el grupo de recursos.

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

az deployment group validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--name]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--query-string]
                             [--rollback-on-error]
                             [--template-file]
                             [--template-spec]
                             [--template-uri]

Ejemplos

Compruebe si una plantilla es válida en el grupo de recursos.

az deployment group validate --resource-group testrg --template-file {template-file}

Compruebe si una plantilla es válida en el grupo de recursos. (generado automáticamente)

az deployment group validate --parameters MyValue=This MyArray=@array.json --resource-group testrg --template-file azuredeploy.json

Parámetros requeridos

--resource-group -g

Grupo de recursos en el que se va a crear la 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.

--mode

Modo de implementación.

Valores aceptados: Complete, Incremental
Valor predeterminado: Incremental
--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.

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

--rollback-on-error

Nombre de una implementación a la que se revertirá al error o use como marca para revertir a la última implementación correcta.

--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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az deployment group wait

Editar

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

az deployment group wait --name
                         --resource-group
                         [--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 group wait --created --name MyDeployment --resource-group MyResourceGroup

Parámetros requeridos

--name -n

Nombre de la implementación.

--resource-group -g

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

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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az deployment group what-if

Editar

Ejecute una operación de implementación What-If en el ámbito del grupo de recursos.

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

az deployment group what-if --resource-group
                            [--aux-tenants]
                            [--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
                            [--mode {Complete, Incremental}]
                            [--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 de implementación What-If en un grupo de recursos.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Ejecute una operación de implementación What-If en un grupo de recursos con formato ResourceIdOnly.

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly

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

az deployment group what-if --resource-group testrg --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print

Parámetros requeridos

--resource-group -g

Grupo de recursos en el que se va a ejecutar la implementación What-If operación.

Parámetros opcionales

--aux-tenants

Inquilinos auxiliares que se usarán durante la implementación entre inquilinos.

--exclude-change-types -x

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

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

Modo de implementación.

Valores aceptados: Complete, Incremental
Valor predeterminado: Incremental
--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.

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

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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.