Compartir a través de

az stack sub

Administrar pilas de implementación en la suscripción.

Comandos

Nombre Description Tipo Estado
az stack sub create

Cree o actualice una pila de implementación en el ámbito de la suscripción.

 Core GA
az stack sub delete

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

 Core GA
az stack sub export

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

 Core GA
az stack sub list

Enumere todas las pilas de implementación de la suscripción.

 Core GA
az stack sub show

Obtenga la pila de implementación especificada del ámbito de la suscripción.

 Core GA
az stack sub validate

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

 Core GA

az stack sub create

Cree o actualice una pila de implementación en el ámbito de la suscripción.

az stack sub create --action-on-unmanage --aou {deleteAll, deleteResources, detachAll}
                    --deny-settings-mode --dm {denyDelete, denyWriteAndDelete, none}
                    --location
                    --name
                    [--bse --bypass-stack-out-of-sync-error {false, true}]
                    [--cs --deny-settings-apply-to-child-scopes]
                    [--deny-settings-excluded-actions --ea]
                    [--deny-settings-excluded-principals --ep]
                    [--deployment-resource-group --dr]
                    [--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 sub create --name StackName --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 sub create --name StackName --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 sub create --name StackName --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 sub create --name StackName --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

Cree una pila de implementación en una suscripción diferente.

az stack sub create --name StackName --template-file simpleTemplate.json --location westus2 --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources

Cree una pila de implementación e implemente en el ámbito del grupo de recursos.

az stack sub create --name StackName --template-file simpleTemplate.json --location westus --deployment-resource-group ResourceGroup --description description --deny-settings-mode None --action-on-unmanage deleteResources

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

az stack sub create --name StackName --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 sub create --name StackName --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 sub create --name StackName --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 a los ámbitos secundarios.

az stack sub create --name StackName --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.

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

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

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

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

--name -n

Nombre de la pila de implementación.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

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

DenySettings se aplicará a los ámbitos secundarios.

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

Lista de operaciones de administración basadas en roles que se excluyen de denySettings. 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-resource-group --dr

Á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 a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--parameters -p

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.

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

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Propiedad Valor
Valor predeterminado: False

az stack sub delete

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

az stack sub delete --action-on-unmanage --aou {deleteAll, deleteResources, detachAll}
                    [--bse --bypass-stack-out-of-sync-error {false, true}]
                    [--id]
                    [--name]
                    [--yes]

Ejemplos

Elimine la pila por nombre.

az stack sub delete --name StackName --action-on-unmanage deleteResources

Elimine la pila por identificador de recurso de pila.

az stack sub delete --id /subscriptions/111111111111/providers/Microsoft.Resources/deploymentStacks/StackName --action-on-unmanage detachAll

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.

Propiedad Valor
Valores aceptados: deleteAll, deleteResources, detachAll

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

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

Identificador de recurso de la pila de implementación.

--name -n

Nombre de la pila de implementación.

--yes

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Propiedad Valor
Valor predeterminado: False

az stack sub export

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

az stack sub export [--id]
                    [--name]

Ejemplos

Exporte la plantilla por nombre.

az stack sub export --name StackName

Exporte la plantilla por identificador de recurso de pila.

az stack sub export --id /subscriptions/111111111111/providers/Microsoft.Resources/deploymentStacks/StackName

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Propiedad Valor
Valor predeterminado: False

az stack sub list

Enumere todas las pilas de implementación de la suscripción.

az stack sub list

Ejemplos

Enumerar todas las pilas

az stack sub list
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Propiedad Valor
Valor predeterminado: False

az stack sub show

Obtenga la pila de implementación especificada del ámbito de la suscripción.

az stack sub show [--id]
                  [--name]

Ejemplos

Obtiene la pila por nombre.

az stack sub show --name StackName

Obtenga la pila por identificador de recurso de pila.

az stack sub show --id /subscriptions/111111111111/providers/Microsoft.Resources/deploymentStacks/StackName

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Propiedad Valor
Valor predeterminado: False

az stack sub validate

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

az stack sub validate --action-on-unmanage --aou {deleteAll, deleteResources, detachAll}
                      --deny-settings-mode --dm {denyDelete, denyWriteAndDelete, none}
                      --location
                      --name
                      [--bse --bypass-stack-out-of-sync-error {false, true}]
                      [--cs --deny-settings-apply-to-child-scopes]
                      [--deny-settings-excluded-actions --ea]
                      [--deny-settings-excluded-principals --ep]
                      [--deployment-resource-group --dr]
                      [--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 sub validate --name StackName --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 sub validate --name StackName --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 sub validate --name StackName --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 sub validate --name StackName --action-on-unmanage deleteAll --template-file simple.bicep --location westus2 --description description --deny-settings-mode None

Valide una pila de implementación en una suscripción diferente.

az stack sub validate --name StackName --template-file simpleTemplate.json --location westus2 --description description --subscription subscriptionId --deny-settings-mode None --action-on-unmanage deleteResources

Valide una pila de implementación e implemente en el ámbito del grupo de recursos.

az stack sub validate --name StackName --template-file simpleTemplate.json --location westus --deployment-resource-group ResourceGroup --description description --deny-settings-mode None --action-on-unmanage deleteResources

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

az stack sub validate --name StackName --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 sub validate --name StackName --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 sub validate --name StackName --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 a los ámbitos secundarios.

az stack sub validate --name StackName --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.

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

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

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

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

--name -n

Nombre de la pila de implementación.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

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

DenySettings se aplicará a los ámbitos secundarios.

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

Lista de operaciones de administración basadas en roles que se excluyen de denySettings. 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-resource-group --dr

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

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Propiedad Valor
Valor predeterminado: False