Compartir a través de

az stack sub

  • Referencia

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 {deleteAll, deleteResources, detachAll}
                    --deny-settings-mode {denyDelete, denyWriteAndDelete, none}
                    --location
                    --name
                    [--bse {false, true}]
                    [--cs]
                    [--deny-settings-excluded-actions]
                    [--deny-settings-excluded-principals]
                    [--deployment-resource-group]
                    [--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.

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.

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

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

az stack sub delete --action-on-unmanage {deleteAll, deleteResources, detachAll}
                    [--bse {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.

Valores aceptados: deleteAll, deleteResources, detachAll

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

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

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

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

az stack sub validate --action-on-unmanage {deleteAll, deleteResources, detachAll}
                      --deny-settings-mode {denyDelete, denyWriteAndDelete, none}
                      --location
                      --name
                      [--bse {false, true}]
                      [--cs]
                      [--deny-settings-excluded-actions]
                      [--deny-settings-excluded-principals]
                      [--deployment-resource-group]
                      [--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.

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.

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