az deployment mg
Administre la implementación de plantillas de Azure Resource Manager en el grupo de administración.
Comandos
Nombre | Description | Tipo | Estado |
---|---|---|---|
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 mg cancel
Cancelar una implementación en el grupo de administración.
az deployment mg cancel --management-group-id
--name
Ejemplos
Cancelar una implementación en el grupo de administración.
az deployment mg cancel -m testmg -n deployment01
Parámetros requeridos
Identificador del grupo de administración.
El nombre de la implementación.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az deployment mg create
Inicie una implementación en el grupo de administración.
Especifique solo uno de los archivos --template-file | --template-uri URI | --template-spec para introducir la plantilla de ARM.
az deployment mg create --location
--management-group-id
[--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]
[--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 administración a partir de un archivo de plantilla remota mediante parámetros de un archivo JSON local.
az deployment mg create --management-group-id testrg --name rollout01 --location WestUS \
--template-uri https://myresource/azuredeploy.json --parameters @myparameters.json
Cree una implementación en el grupo de administración a partir de un archivo de plantilla local mediante parámetros de una cadena JSON.
az deployment mg create --management-group-id testmg --name rollout01 --location WestUS \
--template-file azuredeploy.json \
--parameters '{ \"policyName\": { \"value\": \"policy2\" } }'
Cree una implementación en el grupo de administración 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 mg create --management-group-id testmg --name rollout01 --location WestUS \
--template-file azuredeploy.json --parameters @params.json \
--parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json
Parámetros requeridos
Ubicación para almacenar los metadatos de implementación.
Identificador del grupo de administración en el que se va a crear la implementación.
Parámetros opcionales
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.
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.
Modo que se usa para implementar recursos. Este valor puede ser Incremental o Completado. En modo incremental, los recursos se implementan sin eliminar los recursos existentes que no se incluyen en la plantilla. En modo completo, los recursos se implementan y se eliminan los recursos existentes del grupo de recursos que no se incluyen en la plantilla. Tenga cuidado al usar el modo Completo, ya que puede eliminar accidentalmente los recursos.
El nombre de la implementación.
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.
No espere hasta que finalice la operación de ejecución prolongada.
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.
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.
Cadena de consulta (un token de SAS) que se va a usar con el URI de plantilla en el caso de las plantillas vinculadas.
Ruta de acceso al archivo de plantilla o al archivo de Bicep.
Identificador de recurso de especificación de plantilla.
Identificador URI del archivo de plantilla.
Indique al comando que ejecute what-if de implementación.
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.
Formato de los resultados what-if. Aplicable cuando --confirm-with-what-if
se establece.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az deployment mg delete
Elimine una implementación en el grupo de administración.
az deployment mg delete --management-group-id
--name
[--no-wait]
Ejemplos
Elimine una implementación en el grupo de administración.
az deployment mg delete -m testmg -n deployment01
Parámetros requeridos
Identificador del grupo de administración.
El nombre de la implementación.
Parámetros opcionales
No espere hasta que finalice la operación de ejecución prolongada.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az deployment mg export
Exporte la plantilla que se usó para una implementación.
az deployment mg export --management-group-id
--name
Ejemplos
Exporte la plantilla usada para una implementación en el grupo de administración.
az deployment mg export --management-group-id testmg --name MyDeployment
Parámetros requeridos
Identificador del grupo de administración.
El nombre de la implementación.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az deployment mg list
Enumerar las implementaciones en el grupo de administración.
az deployment mg list --management-group-id
[--filter]
Ejemplos
Enumerar las implementaciones en el grupo de administración.
az deployment mg list -m testmg
Parámetros requeridos
Identificador del grupo de administración.
Parámetros opcionales
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
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az deployment mg show
Mostrar una implementación en el grupo de administración.
az deployment mg show --management-group-id
--name
Ejemplos
Mostrar una implementación en el grupo de administración.
az deployment mg show -m testmg -n deployment01
Parámetros requeridos
Identificador del grupo de administración.
El nombre de la implementación.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az deployment mg validate
Valide si una plantilla es válida en el grupo de administración.
Especifique solo uno de los archivos --template-file | --template-uri URI | --template-spec para introducir la plantilla de ARM.
az deployment mg validate --location
--management-group-id
[--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 grupo de administración.
az deployment mg validate --management-group-id testmg --location WestUS --template-file {template-file}
Valide si una plantilla es válida en el grupo de administración. (generado automáticamente)
az deployment mg validate --location WestUS --management-group-id testmg --name mydeployment --parameters @myparameters.json --template-file azuredeploy.json
Parámetros requeridos
Ubicación para almacenar los metadatos de implementación.
Identificador del grupo de administración en el que se va a crear la implementación.
Parámetros opcionales
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.
El nombre de la implementación.
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.
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.
Cadena de consulta (un token de SAS) que se va a usar con el URI de plantilla en el caso de las plantillas vinculadas.
Ruta de acceso al archivo de plantilla o al archivo de Bicep.
Identificador de recurso de especificación de plantilla.
Identificador URI del archivo de plantilla.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az deployment mg wait
Coloque la CLI en un estado de espera hasta que se cumpla una condición de implementación.
az deployment mg wait --management-group-id
--name
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
Parámetros requeridos
Identificador del grupo de administración.
El nombre de la implementación.
Parámetros opcionales
Espere hasta que se cree con "provisioningState" en "Succeeded".
Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Espere hasta que se elimine.
Espere hasta que exista el recurso.
Intervalo de sondeo en segundos.
Espera máxima en segundos.
Espere hasta que se actualice con provisioningState en "Succeeded".
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
az deployment mg what-if
Ejecute una operación what-if de implementación en el ámbito del grupo de administración.
Especifique solo uno de los archivos --template-file | --template-uri URI | --template-spec para introducir la plantilla de ARM.
az deployment mg what-if --location
--management-group-id
[--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
[--name]
[--no-pretty-print]
[--no-prompt {false, true}]
[--parameters]
[--query-string]
[--result-format {FullResourcePayloads, ResourceIdOnly}]
[--template-file]
[--template-spec]
[--template-uri]
Ejemplos
Ejecute una operación what-if de implementación en un grupo de administración.
az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json
Ejecute una operación what-if de implementación en un grupo de administración con formato ResourceIdOnly.
az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly
Ejecute una operación what-if de implementación en un grupo de administración sin imprimir el resultado.
az deployment mg what-if --management-group-id testmg --location westus --name rollout01 --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print
Parámetros requeridos
Ubicación para almacenar los metadatos de implementación.
Identificador del grupo de administración en el que se va a crear la implementación.
Parámetros opcionales
Lista separada por espacios de tipos de cambio de recursos que se excluirán de los resultados what-if.
El nombre de la implementación.
Deshabilite la impresión bonita para los resultados de What-If. Cuando se establece, se usará el tipo de formato de salida.
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.
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.
Cadena de consulta (un token de SAS) que se va a usar con el URI de plantilla en el caso de las plantillas vinculadas.
Formato de los resultados what-if.
Ruta de acceso al archivo de plantilla o al archivo de Bicep.
Identificador de recurso de especificación de plantilla.
Identificador URI del archivo de plantilla.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.