az deployment

Referencia

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

Comandos

Nombre	Description	Tipo	Estado
az deployment cancel	Cancelar una implementación en el ámbito de la suscripción.	Principal	Obsoleto
az deployment create	Inicie una implementación en el ámbito de la suscripción.	Principal	Obsoleto
az deployment delete	Elimine una implementación en el ámbito de la suscripción.	Principal	Obsoleto
az deployment export	Exporte la plantilla que se usó para una implementación.	Principal	Obsoleto
az deployment group	Administración de la implementación de plantillas de Azure Resource Manager en el grupo de recursos.	Principal	GA
az deployment group cancel	Cancelar una implementación en el grupo de recursos.	Principal	GA
az deployment group create	Inicie una implementación en el grupo de recursos.	Principal	GA
az deployment group delete	Elimine una implementación en el grupo de recursos.	Principal	GA
az deployment group export	Exporte la plantilla que se usó para una implementación.	Principal	GA
az deployment group list	Enumera las implementaciones en el grupo de recursos.	Principal	GA
az deployment group show	Mostrar una implementación en el grupo de recursos.	Principal	GA
az deployment group validate	Compruebe si una plantilla es válida en el grupo de recursos.	Principal	GA
az deployment group wait	Coloque la CLI en un estado de espera hasta que se cumpla una condición de implementación.	Principal	GA
az deployment group what-if	Ejecute una operación what-if de implementación en el ámbito del grupo de recursos.	Principal	GA
az deployment list	Enumera las implementaciones en el ámbito de la suscripción.	Principal	Obsoleto
az deployment mg	Administre la implementación de plantillas de Azure Resource Manager en el grupo de administración.	Principal	GA
az deployment mg cancel	Cancelar una implementación en el grupo de administración.	Principal	GA
az deployment mg create	Inicie una implementación en el grupo de administración.	Principal	GA
az deployment mg delete	Elimine una implementación en el grupo de administración.	Principal	GA
az deployment mg export	Exporte la plantilla que se usó para una implementación.	Principal	GA
az deployment mg list	Enumerar las implementaciones en el grupo de administración.	Principal	GA
az deployment mg show	Mostrar una implementación en el grupo de administración.	Principal	GA
az deployment mg validate	Valide si una plantilla es válida en el grupo de administración.	Principal	GA
az deployment mg wait	Coloque la CLI en un estado de espera hasta que se cumpla una condición de implementación.	Principal	GA
az deployment mg what-if	Ejecute una operación what-if de implementación en el ámbito del grupo de administración.	Principal	GA
az deployment operation	Administrar las operaciones de implementación en el ámbito de la suscripción.	Principal	GA
az deployment operation group	Administrar las operaciones de implementación en el grupo de recursos.	Principal	GA
az deployment operation group list	Enumerar las operaciones de implementación en el grupo de recursos.	Principal	GA
az deployment operation group show	Mostrar una operación de implementación en el grupo de recursos.	Principal	GA
az deployment operation list	Enumerar las operaciones de implementación en el ámbito de la suscripción.	Principal	Obsoleto
az deployment operation mg	Administrar las operaciones de implementación en el grupo de administración.	Principal	GA
az deployment operation mg list	Enumerar las operaciones de implementación en el grupo de administración.	Principal	GA
az deployment operation mg show	Mostrar una operación de implementación en el grupo de administración.	Principal	GA
az deployment operation show	Mostrar una operación de implementación en el ámbito de la suscripción.	Principal	Obsoleto
az deployment operation sub	Administrar las operaciones de implementación en el ámbito de la suscripción.	Principal	GA
az deployment operation sub list	Enumerar las operaciones de implementación en el ámbito de la suscripción.	Principal	GA
az deployment operation sub show	Mostrar una operación de implementación en el ámbito de la suscripción.	Principal	GA
az deployment operation tenant	Administrar las operaciones de implementación en el ámbito del inquilino.	Principal	GA
az deployment operation tenant list	Enumerar las operaciones de implementación en el ámbito del inquilino.	Principal	GA
az deployment operation tenant show	Mostrar una operación de implementación en el ámbito del inquilino.	Principal	GA
az deployment show	Mostrar una implementación en el ámbito de la suscripción.	Principal	Obsoleto
az deployment sub	Administrar la implementación de plantillas de Azure Resource Manager en el ámbito de la suscripción.	Principal	GA
az deployment sub cancel	Cancelar una implementación en el ámbito de la suscripción.	Principal	GA
az deployment sub create	Inicie una implementación en el ámbito de la suscripción.	Principal	GA
az deployment sub delete	Elimine una implementación en el ámbito de la suscripción.	Principal	GA
az deployment sub export	Exporte la plantilla que se usó para una implementación.	Principal	GA
az deployment sub list	Enumera las implementaciones en el ámbito de la suscripción.	Principal	GA
az deployment sub show	Mostrar una implementación en el ámbito de la suscripción.	Principal	GA
az deployment sub validate	Valide si una plantilla es válida en el ámbito de la suscripción.	Principal	GA
az deployment sub wait	Coloque la CLI en un estado de espera hasta que se cumpla una condición de implementación.	Principal	GA
az deployment sub what-if	Ejecute una operación what-if de implementación en el ámbito de la suscripción.	Principal	GA
az deployment tenant	Administre la implementación de plantillas de Azure Resource Manager en el ámbito del inquilino.	Principal	GA
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 validate	Valide si una plantilla es válida en el ámbito de la suscripción.	Principal	Obsoleto
az deployment wait	Coloque la CLI en un estado de espera hasta que se cumpla una condición de implementación.	Principal	Obsoleto

az deployment cancel

Editar

Obsoleto

Este comando ha quedado en desuso y se quitará en una versión futura. Use 'deployment sub cancel' en su lugar.

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

az deployment cancel --name

Ejemplos

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

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

Editar

Obsoleto

Este comando ha quedado en desuso y se quitará en una versión futura. Use "deployment sub create" en su lugar.

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 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 la suscripción desde un archivo de plantilla remota mediante parámetros de un archivo JSON local.

az deployment 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 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 create --location WestUS --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 de la suscripción a partir de una especificación de plantilla

az deployment create --location WestUS --template-spec "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Resources/templateSpecs/myTemplateSpec/versions/1.0"

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 delete

Editar

Obsoleto

Este comando ha quedado en desuso y se quitará en una versión futura. Use "deployment sub delete" en su lugar.

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

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

Ejemplos

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

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

Editar

Obsoleto

Este comando ha quedado en desuso y se quitará en una versión futura. Use "deployment sub export" en su lugar.

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

az deployment export --name

Ejemplos

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

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

Editar

Obsoleto

Este comando ha quedado en desuso y se quitará en una versión futura. Use "deployment sub list" en su lugar.

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

az deployment list [--filter]

Ejemplos

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

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

Editar

Obsoleto

Este comando ha quedado en desuso y se quitará en una versión futura. Use "deployment sub show" en su lugar.

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

az deployment show --name

Ejemplos

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

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

Editar

Obsoleto

Este comando ha quedado en desuso y se quitará en una versión futura. Use "deployment sub validate" en su lugar.

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 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 de la suscripción.

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

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

Valores aceptados: false, true

Valor predeterminado: False

--parameters -p

Proporcione valores de parámetros de implementación.

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

Editar

Obsoleto

Este comando ha quedado en desuso y se quitará en una versión futura. Use "deployment sub wait" en su lugar.

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

az deployment 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 wait --deleted --name MyDeployment --subscription MySubscription

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.

Compartir a través de

az deployment

Comandos

az deployment cancel

Ejemplos

Parámetros requeridos

az deployment create

Ejemplos

Parámetros requeridos

Parámetros opcionales

az deployment delete

Ejemplos

Parámetros requeridos

Parámetros opcionales

az deployment export

Ejemplos

Parámetros requeridos

az deployment list

Ejemplos

Parámetros opcionales

az deployment show

Ejemplos

Parámetros requeridos

az deployment validate

Ejemplos

Parámetros requeridos

Parámetros opcionales

az deployment wait

Ejemplos

Parámetros requeridos

Parámetros opcionales

Recursos adicionales