Compartir a través de

az group deployment

  • Obsoleto
  • Referencia

Este grupo de comandos ha quedado en desuso y se quitará en una versión futura. Use "grupo de implementación" en su lugar.

Administración de implementaciones de Azure Resource Manager.

Comandos

Nombre Description Tipo Estado
az group deployment cancel

Cancela una implementación de plantilla que se está ejecutando actualmente.

 Principal Obsoleto
az group deployment create

Iniciar una implementación.

 Principal Obsoleto
az group deployment delete

Elimina una implementación del historial de implementación.

 Principal Obsoleto
az group deployment export

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

 Principal Obsoleto
az group deployment list

Se enumeran todas las implementaciones en un grupo de recursos.

 Principal Obsoleto
az group deployment operation

Administrar las operaciones de implementación.

 Principal Obsoleto
az group deployment operation list

Obtiene todas las operaciones de implementación de una implementación.

 Principal Obsoleto
az group deployment operation show

Obtenga la operación de una implementación.

 Principal Obsoleto
az group deployment show

Obtiene una implementación.

 Principal Obsoleto
az group deployment validate

Valide si una plantilla es sintácticamente correcta.

 Principal Obsoleto
az group deployment wait

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

 Principal Obsoleto

az group deployment cancel

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "implementación de grupo" está en desuso y se quitará en una versión futura. Use "grupo de implementación" en su lugar.

Cancela una implementación de plantilla que se está ejecutando actualmente.

Solo puede cancelar una implementación si se acepta o se ejecuta provisioningState. Una vez cancelada la implementación, provisioningState se establece en Cancelado. La cancelación de una implementación de plantilla detiene la implementación de plantillas que se está ejecutando actualmente y deja el grupo de recursos implementado parcialmente.

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

Parámetros requeridos

--name -n

El 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 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 group deployment create

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "implementación de grupo" está en desuso y se quitará en una versión futura. Use "grupo de implementación" en su lugar.

Iniciar una implementación.

az group deployment create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--rollback-on-error]
                           [--template-file]
                           [--template-uri]

Ejemplos

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

az group deployment create -g MyResourceGroup --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters "{ \"location\": { \"value\": \"westus\" } }"

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

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

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

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

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

Incremental (solo agregar recursos al grupo de recursos) o Completar (quitar recursos adicionales del grupo de recursos).

Valores aceptados: Complete, Incremental
Valor predeterminado: Incremental
--name -n

El nombre de la implementación. El valor predeterminado es el nombre base del archivo de plantilla.

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

--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 a un archivo de plantilla o archivo de Bicep en el sistema de archivos.

--template-uri -u

Identificador URI de un archivo de plantilla remoto.

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 group deployment delete

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "implementación de grupo" está en desuso y se quitará en una versión futura. Use "grupo de implementación" en su lugar.

Elimina una implementación del historial de implementación.

No se puede eliminar una implementación de plantilla que se está ejecutando actualmente. Al eliminar una implementación de plantilla, se quitan las operaciones de implementación asociadas. La eliminación de una implementación de plantilla no afecta al estado del grupo de recursos. Se trata de una operación asincrónica que devuelve un estado de 202 hasta que la implementación de la plantilla se elimina correctamente. El encabezado de respuesta Location contiene el URI que se usa para obtener el estado del proceso. Mientras se ejecuta el proceso, una llamada al URI del encabezado Location devuelve un estado de 202. Cuando finalice el proceso, el URI del encabezado Location devuelve un estado de 204 cuando se realiza correctamente. Si se produjo un error en la solicitud asincrónica, el URI del encabezado Location devuelve un código de estado de nivel de error.

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

Parámetros requeridos

--name -n

El 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 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 group deployment export

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "implementación de grupo" está en desuso y se quitará en una versión futura. Use "grupo de implementación" en su lugar.

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

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

Ejemplos

Exporte la plantilla que se usó para una implementación. (generado automáticamente)

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

Parámetros requeridos

--name -n

El 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 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 group deployment list

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "implementación de grupo" está en desuso y se quitará en una versión futura. Use "grupo de implementación" en su lugar.

Se enumeran todas las implementaciones en un grupo de recursos.

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

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

Filtro que se aplicará a la operación. Por ejemplo, puede usar $filter=provisioningState eq '{state}'. El valor predeterminado es None.

--top

Número de resultados que se van a obtener. Si se pasa null, devuelve todas las implementaciones. El valor predeterminado es None.

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

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "implementación de grupo" está en desuso y se quitará en una versión futura. Use "grupo de implementación" en su lugar.

Obtiene una implementación.

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

Parámetros requeridos

--name -n

El 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 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 group deployment validate

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "implementación de grupo" está en desuso y se quitará en una versión futura. Use "grupo de implementación" en su lugar.

Valide si una plantilla es sintácticamente correcta.

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

Ejemplos

Valide si una plantilla es sintácticamente correcta. (generado automáticamente)

az group deployment validate --parameters "{ \"location\": { \"value\": \"westus\" } }" \
    --resource-group MyResourceGroup --template-file storage.json

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

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

Incremental (solo agregar recursos al grupo de recursos) o Completar (quitar recursos adicionales del grupo de recursos).

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

--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 a un archivo de plantilla o archivo de Bicep en el sistema de archivos.

--template-uri -u

Identificador URI de un archivo de plantilla remoto.

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 group deployment wait

Editar
Obsoleto

Este comando está en desuso implícitamente porque el grupo de comandos "implementación de grupo" está en desuso y se quitará en una versión futura. Use "grupo de implementación" en su lugar.

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

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

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

az group deployment wait --created --name MyDeployment --resource-group MyResourceGroup

Parámetros requeridos

--name -n

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