Compartir a través de


Set-AzManagementGroupDeploymentStack

Establece una nueva pila de implementación con ámbito de grupo de administración.

Sintaxis

Set-AzManagementGroupDeploymentStack
   -Name <String>
   -ManagementGroupId <String>
   [-DeploymentSubscriptionId <String>]
   -Location <String>
   [-Description <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzManagementGroupDeploymentStack
   -Name <String>
   -ManagementGroupId <String>
   [-DeploymentSubscriptionId <String>]
   -Location <String>
   [-Description <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateFile <String>
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzManagementGroupDeploymentStack
   -Name <String>
   -ManagementGroupId <String>
   [-DeploymentSubscriptionId <String>]
   -Location <String>
   [-Description <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateFile <String>
   -TemplateParameterUri <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzManagementGroupDeploymentStack
   -Name <String>
   -ManagementGroupId <String>
   [-DeploymentSubscriptionId <String>]
   -Location <String>
   [-Description <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateFile <String>
   -TemplateParameterObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzManagementGroupDeploymentStack
   -Name <String>
   -ManagementGroupId <String>
   [-DeploymentSubscriptionId <String>]
   -Location <String>
   [-Description <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateUri <String>
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzManagementGroupDeploymentStack
   -Name <String>
   -ManagementGroupId <String>
   [-DeploymentSubscriptionId <String>]
   -Location <String>
   [-Description <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateUri <String>
   -TemplateParameterUri <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzManagementGroupDeploymentStack
   -Name <String>
   -ManagementGroupId <String>
   [-DeploymentSubscriptionId <String>]
   -Location <String>
   [-Description <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateUri <String>
   -TemplateParameterObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzManagementGroupDeploymentStack
   -Name <String>
   -ManagementGroupId <String>
   [-DeploymentSubscriptionId <String>]
   -Location <String>
   [-Description <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzManagementGroupDeploymentStack
   -Name <String>
   -ManagementGroupId <String>
   [-DeploymentSubscriptionId <String>]
   -Location <String>
   [-Description <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateSpecId <String>
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzManagementGroupDeploymentStack
   -Name <String>
   -ManagementGroupId <String>
   [-DeploymentSubscriptionId <String>]
   -Location <String>
   [-Description <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateSpecId <String>
   -TemplateParameterUri <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzManagementGroupDeploymentStack
   -Name <String>
   -ManagementGroupId <String>
   [-DeploymentSubscriptionId <String>]
   -Location <String>
   [-Description <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateSpecId <String>
   -TemplateParameterObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzManagementGroupDeploymentStack
   -Name <String>
   -ManagementGroupId <String>
   [-DeploymentSubscriptionId <String>]
   -Location <String>
   [-Description <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzManagementGroupDeploymentStack
   -Name <String>
   -ManagementGroupId <String>
   [-DeploymentSubscriptionId <String>]
   -Location <String>
   [-Description <String>]
   -ActionOnUnmanage <PSActionOnUnmanage>
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-BypassStackOutOfSyncError]
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Actualice una pila de implementación con ámbito de grupo de administración.

Ejemplos

Ejemplo 1: actualiza la pila de ámbito del grupo de administración MyMGStack en MyManagementGroup implementada en la suscripción secundaria MySubId

Set-AzManagementGroupDeploymentStack -Name MyMGStack -ManagementGroupId MyMangementGroup -DeploymentSubscriptionId MySubId -TemplateFile myTemplate.json -Location westus -DenySettingsMode DenyDelete

Actualice una pila de implementación con ámbito de grupo de administración denominada "MyMGStack" en el grupo de administración "MyManagementGroup", con el ámbito de la implementación subyacente que es MySubId y la configuración de denegación es DenyDelete.

Ejemplo 2: Uso de un archivo .bicepparam para crear una pila

Set-AzManagementGroupDeploymentStack -Name MyMGStack -ManagementGroupId MyMangementGroup -DeploymentSubscriptionId MySubId -Location westus -DenySettingsMode DenyDelete -TemplateParameterFile "./parameters.bicepparam"

Este comando actualiza una pila en el ámbito del grupo de administración mediante un archivo .bicepparam en el disco.

Parámetros

-ActionOnUnmanage

Acción que se debe realizar en los recursos que se vuelven no administrados al eliminar o actualizar la pila de implementación. Los valores posibles incluyen: 'detachAll' (no eliminar ningún recurso no administrado), 'deleteResources' (elimine todos los recursos no administrados que no sean RG o MG) y 'deleteAll' (elimine todos los recursos no administrados).

Tipo:PSActionOnUnmanage
Valores aceptados:DetachAll, DeleteResources, DeleteAll
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AsJob

Ejecute el cmdlet en segundo plano.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BypassStackOutOfSyncError

Omisión de errores para que la pila no se sincronice al ejecutar la operación. Si la pila no está sincronizada y este parámetro no está establecido, se producirá un error en la operación. Incluya este parámetro solo si se le indica que lo haga en una operación de pila con errores.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DenySettingsApplyToChildScopes

Se aplica a los ámbitos secundarios.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DenySettingsExcludedAction

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

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DenySettingsExcludedPrincipal

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

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DenySettingsMode

Modo para DenySettings. Los valores posibles son: 'denyDelete', 'denyWriteAndDelete' y 'none'.

Tipo:PSDenySettingsMode
Valores aceptados:None, DenyDelete, DenyWriteAndDelete
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeploymentSubscriptionId

Identificador de suscripción en el que se debe crear la implementación.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Description

Descripción de la pila.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Force

No pida confirmación al sobrescribir una pila existente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Location

Ubicación de la pila.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ManagementGroupId

Identificador del grupo de administración en el que se implementará deploymentStack.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Nombre de deploymentStack que se va a crear.

Tipo:String
Alias:StackName
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Pre

Cuando se establece, indica que el cmdlet debe usar versiones de API de versión preliminar al determinar automáticamente qué versión se va a usar.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-QueryString

Cadena de consulta (por ejemplo, un token de SAS) que se va a usar con el parámetro TemplateUri. Se usaría en el caso de plantillas vinculadas

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SkipTemplateParameterPrompt

Omite el procesamiento de parámetros dinámicos de PowerShell que comprueba si el parámetro de plantilla proporcionado contiene todos los parámetros necesarios usados por la plantilla. Esta comprobación solicitaría al usuario que proporcione un valor para los parámetros que faltan, pero si se proporciona -SkipTemplateParameterPrompt, se omitirá este mensaje y se producirá un error inmediatamente si se encontró que un parámetro no está enlazado en la plantilla. En el caso de los scripts no interactivos, se puede proporcionar -SkipTemplateParameterPrompt para proporcionar un mejor mensaje de error en caso de que no se cumplan todos los parámetros necesarios.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Tag

Etiquetas que se van a colocar en la implementación.

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TemplateFile

TemplateFile que se usará para crear la pila.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TemplateParameterFile

Archivo de parámetros que se va a usar para la plantilla.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TemplateParameterObject

Tabla hash que representa los parámetros.

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TemplateParameterUri

Ubicación del archivo parameter que se va a usar para la plantilla.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TemplateSpecId

ResourceId de TemplateSpec que se va a usar para crear la pila.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TemplateUri

Ubicación de la plantilla que se va a usar para crear la pila.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Hashtable

Salidas

PSDeploymentStack