Compartir vía

az stack mg

  • Referencia

Administrar pilas de implementación en el grupo de administración.

Comandos

Nombre Description Tipo Estado
az stack mg create

Cree o actualice una pila de implementación en el ámbito del grupo de administración.

 Core GA
az stack mg delete

Elimine la pila de implementación especificada del ámbito del grupo de administración.

 Core GA
az stack mg export

Exporte la plantilla usada para crear la pila de implementación.

 Core GA
az stack mg list

Enumere todas las pilas de implementación en el grupo de administración.

 Core GA
az stack mg show

Obtiene la pila de implementación especificada del ámbito del grupo de administración.

 Core GA
az stack mg validate

Valide una pila de implementación en el ámbito del grupo de administración.

 Core GA

az stack mg create

Cree o actualice una pila de implementación en el ámbito del grupo de administración.

az stack mg create --action-on-unmanage {deleteAll, deleteResources, detachAll}
                   --deny-settings-mode {denyDelete, denyWriteAndDelete, none}
                   --location
                   --management-group-id
                   --name
                   [--bse {false, true}]
                   [--cs]
                   [--deny-settings-excluded-actions]
                   [--deny-settings-excluded-principals]
                   [--deployment-subscription]
                   [--description]
                   [--no-wait]
                   [--parameters]
                   [--query-string]
                   [--tags]
                   [--template-file]
                   [--template-spec]
                   [--template-uri]
                   [--yes]

Ejemplos

Cree una pila de implementación mediante el archivo de plantilla y desasocie todos los recursos en unmanage.

az stack mg create --name StackName --management-group-id myMg --template-file simpleTemplate.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll

Cree una pila de implementación con el archivo de parámetros y elimine recursos en unmanage.

az stack mg create --name StackName --management-group-id myMg --action-on-unmanage deleteResources --template-file simpleTemplate.json --parameters simpleTemplateParams.json --location westus2 --description description --deny-settings-mode None

Cree una pila de implementación con la especificación de plantilla.

az stack mg create --name StackName --management-group-id myMg --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources

Cree una pila de implementación mediante el archivo bicep y elimine todos los recursos de unmanage.

az stack mg create --name StackName --management-group-id myMg --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

Cree una pila de implementación mediante parámetros de pares clave-valor.

az stack mg create --name StackName --management-group-id myMg --template-file simpleTemplate.json --location westus --description description --parameters simpleTemplateParams.json value1=foo value2=bar --deny-settings-mode None --action-on-unmanage deleteResources

Cree una pila de implementació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 stack mg create --name StackName --management-group-id myMg --template-file azuredeploy.json --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json --location westus --deny-settings-mode None --action-on-unmanage deleteResources

Cree una pila de implementación a partir de una plantilla local mediante la configuración de denegación.

az stack mg create --name StackName --management-group-id myMg --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-excluded-principals "test1 test2" --location westus --action-on-unmanage deleteResources

Cree una pila de implementación a partir de una plantilla local y aplique la configuración de denegación al ámbito secundario.

az stack mg create --name StackName --management-group-id myMg --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-apply-to-child-scopes --location westus --action-on-unmanage deleteResources

Parámetros requeridos

--action-on-unmanage --aou

Define lo que sucede con los recursos que ya no se administran después de actualizar o eliminar la pila.

Valores aceptados: deleteAll, deleteResources, detachAll
--deny-settings-mode --dm

Defina qué operaciones se deniegan en los recursos administrados por la pila.

Valores aceptados: denyDelete, denyWriteAndDelete, none
--location -l

Ubicación para almacenar la pila de implementación.

--management-group-id -m

Identificador del grupo de administración en el que se va a crear la pila.

--name -n

Nombre de la pila de implementación.

Parámetros opcionales

--bse --bypass-stack-out-of-sync-error

Marca para omitir errores de servicio que indican que la lista de recursos de pila no está sincronizada correctamente.

Valores aceptados: false, true
Valor predeterminado: False
--cs --deny-settings-apply-to-child-scopes

Deny Configuración se aplicarán a los ámbitos secundarios.

Valor predeterminado: False
--deny-settings-excluded-actions --ea

Lista de operaciones de administración basadas en roles que se excluyen de la denegación Configuración. Se permiten hasta 200 acciones.

--deny-settings-excluded-principals --ep

Lista de identificadores de entidad de seguridad de AAD excluidos del bloqueo. Se permiten hasta 5 entidades de seguridad.

--deployment-subscription --ds

Ámbito en el que se debe crear la implementación inicial. Si no se especifica un ámbito, el valor predeterminado será el ámbito de la pila de implementación.

--description

Descripción de la pila de implementación.

--no-wait

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

Valor predeterminado: False
--parameters -p

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.

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

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--template-file -f

Ruta de acceso a un archivo de plantilla o archivo de Bicep en el sistema de archivos.

--template-spec -s

Identificador de recurso de especificación de plantilla.

--template-uri -u

Identificador URI de un archivo de plantilla remoto.

--yes

No solicita confirmación.

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 stack mg delete

Elimine la pila de implementación especificada del ámbito del grupo de administración.

az stack mg delete --action-on-unmanage {deleteAll, deleteResources, detachAll}
                   --management-group-id
                   [--bse {false, true}]
                   [--id]
                   [--name]
                   [--yes]

Ejemplos

Elimine la pila por nombre.

az stack mg delete --name StackName --management-group-id myMg --action-on-unmanage detachAll

Elimine la pila por identificador de recurso de pila.

az stack mg delete --id /providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks/StackName --management-group-id myMg --action-on-unmanage deleteAll

Parámetros requeridos

--action-on-unmanage --aou

Define lo que sucede con los recursos que ya no se administran después de actualizar o eliminar la pila.

Valores aceptados: deleteAll, deleteResources, detachAll
--management-group-id -m

Identificador del grupo de administración en el que se va a crear la pila.

Parámetros opcionales

--bse --bypass-stack-out-of-sync-error

Marca para omitir errores de servicio que indican que la lista de recursos de pila no está sincronizada correctamente.

Valores aceptados: false, true
Valor predeterminado: False
--id

Identificador de recurso de la pila de implementación.

--name -n

Nombre de la pila de implementación.

--yes

No solicita confirmación.

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 stack mg export

Exporte la plantilla usada para crear la pila de implementación.

az stack mg export --management-group-id
                   [--id]
                   [--name]

Ejemplos

Exporte la plantilla por nombre.

az stack mg export --name StackName --management-group-id myMg

Exporte la plantilla por identificador de recurso de pila.

az stack mg export --id /providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks/StackName --management-group-id myMg

Parámetros requeridos

--management-group-id -m

Identificador del grupo de administración en el que se va a crear la pila.

Parámetros opcionales

--id

Identificador de recurso de la pila de implementación.

--name -n

Nombre de la pila de 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 stack mg list

Enumere todas las pilas de implementación en el grupo de administración.

az stack mg list --management-group-id

Ejemplos

Enumerar todas las pilas

az stack mg list --management-group-id myMg

Parámetros requeridos

--management-group-id -m

Identificador del grupo de administración en el que se va a crear la pila.

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 stack mg show

Obtiene la pila de implementación especificada del ámbito del grupo de administración.

az stack mg show --management-group-id
                 [--id]
                 [--name]

Ejemplos

Obtiene la pila por nombre.

az stack mg show --name StackName --management-group-id myMg

Obtenga la pila por identificador de recurso de pila.

az stack mg show --id /providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks/StackName --management-group-id myMg

Parámetros requeridos

--management-group-id -m

Identificador del grupo de administración en el que se va a crear la pila.

Parámetros opcionales

--id

Identificador de recurso de la pila de implementación.

--name -n

Nombre de la pila de 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 stack mg validate

Valide una pila de implementación en el ámbito del grupo de administración.

az stack mg validate --action-on-unmanage {deleteAll, deleteResources, detachAll}
                     --deny-settings-mode {denyDelete, denyWriteAndDelete, none}
                     --location
                     --management-group-id
                     --name
                     [--bse {false, true}]
                     [--cs]
                     [--deny-settings-excluded-actions]
                     [--deny-settings-excluded-principals]
                     [--deployment-subscription]
                     [--description]
                     [--parameters]
                     [--query-string]
                     [--tags]
                     [--template-file]
                     [--template-spec]
                     [--template-uri]

Ejemplos

Valide una pila de implementación mediante el archivo de plantilla y desasocie todos los recursos de unmanage.

az stack mg validate --name StackName --management-group-id myMg --template-file simpleTemplate.json --location westus2 --description description --deny-settings-mode None --action-on-unmanage detachAll

Valide una pila de implementación con el archivo de parámetros y elimine recursos en unmanage.

az stack mg validate --name StackName --management-group-id myMg --action-on-unmanage deleteResources --template-file simpleTemplate.json --parameters simpleTemplateParams.json --location westus2 --description description --deny-settings-mode None

Valide una pila de implementación con la especificación de plantilla.

az stack mg validate --name StackName --management-group-id myMg --template-spec TemplateSpecResourceIDWithVersion --location westus2 --description description --deny-settings-mode None --action-on-unmanage deleteResources

Valide una pila de implementación mediante el archivo bicep y elimine todos los recursos de unmanage.

az stack mg validate --name StackName --management-group-id myMg --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

Valide una pila de implementación mediante parámetros de pares clave-valor.

az stack mg validate --name StackName --management-group-id myMg --template-file simpleTemplate.json --location westus --description description --parameters simpleTemplateParams.json value1=foo value2=bar --deny-settings-mode None --action-on-unmanage deleteResources

Valide una pila de implementació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 stack mg validate --name StackName --management-group-id myMg --template-file azuredeploy.json --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json --location westus --deny-settings-mode None --action-on-unmanage deleteResources

Valide una pila de implementación desde una plantilla local mediante la configuración de denegación.

az stack mg validate --name StackName --management-group-id myMg --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-excluded-principals "test1 test2" --location westus --action-on-unmanage deleteResources

Valide una pila de implementación desde una plantilla local y aplique la configuración de denegación al ámbito secundario.

az stack mg validate --name StackName --management-group-id myMg --template-file azuredeploy.json --deny-settings-mode denyDelete --deny-settings-excluded-actions Microsoft.Compute/virtualMachines/write --deny-settings-apply-to-child-scopes --location westus --action-on-unmanage deleteResources

Parámetros requeridos

--action-on-unmanage --aou

Define lo que sucede con los recursos que ya no se administran después de actualizar o eliminar la pila.

Valores aceptados: deleteAll, deleteResources, detachAll
--deny-settings-mode --dm

Defina qué operaciones se deniegan en los recursos administrados por la pila.

Valores aceptados: denyDelete, denyWriteAndDelete, none
--location -l

Ubicación para almacenar la pila de implementación.

--management-group-id -m

Identificador del grupo de administración en el que se va a crear la pila.

--name -n

Nombre de la pila de implementación.

Parámetros opcionales

--bse --bypass-stack-out-of-sync-error

Marca para omitir errores de servicio que indican que la lista de recursos de pila no está sincronizada correctamente.

Valores aceptados: false, true
Valor predeterminado: False
--cs --deny-settings-apply-to-child-scopes

Deny Configuración se aplicarán a los ámbitos secundarios.

Valor predeterminado: False
--deny-settings-excluded-actions --ea

Lista de operaciones de administración basadas en roles que se excluyen de la denegación Configuración. Se permiten hasta 200 acciones.

--deny-settings-excluded-principals --ep

Lista de identificadores de entidad de seguridad de AAD excluidos del bloqueo. Se permiten hasta 5 entidades de seguridad.

--deployment-subscription --ds

Ámbito en el que se debe crear la implementación inicial. Si no se especifica un ámbito, el valor predeterminado será el ámbito de la pila de implementación.

--description

Descripción de la pila de implementación.

--parameters -p

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.

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

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--template-file -f

Ruta de acceso a un archivo de plantilla o archivo de Bicep en el sistema de archivos.

--template-spec -s

Identificador de recurso de especificación de plantilla.

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