Partilhar via


Test-AzManagementGroupDeploymentStack

Valida uma pilha de implantação com escopo de grupo de gerenciamento.

Sintaxe

Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ManagementGroupId <String>
    [-DeploymentSubscriptionId <String>]
    [-Description <String>]
    -Location <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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ManagementGroupId <String>
    [-DeploymentSubscriptionId <String>]
    [-Description <String>]
    -Location <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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ManagementGroupId <String>
    [-DeploymentSubscriptionId <String>]
    [-Description <String>]
    -Location <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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ManagementGroupId <String>
    [-DeploymentSubscriptionId <String>]
    [-Description <String>]
    -Location <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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ManagementGroupId <String>
    [-DeploymentSubscriptionId <String>]
    [-Description <String>]
    -Location <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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ManagementGroupId <String>
    [-DeploymentSubscriptionId <String>]
    [-Description <String>]
    -Location <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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ManagementGroupId <String>
    [-DeploymentSubscriptionId <String>]
    [-Description <String>]
    -Location <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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ManagementGroupId <String>
    [-DeploymentSubscriptionId <String>]
    [-Description <String>]
    -Location <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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ManagementGroupId <String>
    [-DeploymentSubscriptionId <String>]
    [-Description <String>]
    -Location <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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ManagementGroupId <String>
    [-DeploymentSubscriptionId <String>]
    [-Description <String>]
    -Location <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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ManagementGroupId <String>
    [-DeploymentSubscriptionId <String>]
    [-Description <String>]
    -Location <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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ManagementGroupId <String>
    [-DeploymentSubscriptionId <String>]
    [-Description <String>]
    -Location <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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ManagementGroupId <String>
    [-DeploymentSubscriptionId <String>]
    [-Description <String>]
    -Location <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

Valida uma pilha de implantação com escopo de grupo de gerenciamento.

Exemplos

Exemplo 1: Cria uma nova pilha MyMGStack no grupo de gerenciamento MyManagementGroup e a implanta na assinatura filho MySubId

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

Crie uma nova pilha de implantação com escopo de grupo de gerenciamento chamada 'MyMGStack' no grupo de gerenciamento 'MyManagementGroup', com o escopo da implantação subjacente sendo MySubId, as configurações de negação sendo DenyDelete e ActionOnUnmanage sendo DetachAll.

Parâmetros

-ActionOnUnmanage

Ação para assumir recursos que não são gerenciados na exclusão ou atualização da pilha de implantação. Os valores possíveis incluem: 'detachAll' (não exclua nenhum recurso não gerenciado), 'deleteResources' (exclua todos os recursos não gerenciados que não sejam RGs ou MGs) e 'deleteAll' (exclua todos os recursos não gerenciados).

Tipo:PSActionOnUnmanage
Valores aceites:DetachAll, DeleteResources, DeleteAll
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AsJob

Execute o cmdlet em segundo plano.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-BypassStackOutOfSyncError

Erros de desvio para a pilha estar fora de sincronia ao executar a operação. Se a pilha estiver fora de sincronia e esse parâmetro não estiver definido, a operação falhará. Inclua esse parâmetro somente se for instruído a fazê-lo em uma operação de pilha com falha.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DenySettingsApplyToChildScopes

Aplicar a escopos filho.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DenySettingsExcludedAction

Lista de operações de gerenciamento baseadas em função que são excluídas do denySettings. São permitidas até 200 ações.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DenySettingsExcludedPrincipal

Lista de IDs principais do AAD excluídos do bloqueio. São permitidos até 5 princípios.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DenySettingsMode

Modo para DenySettings. Os valores possíveis incluem: 'denyDelete', 'denyWriteAndDelete' e 'none'.

Tipo:PSDenySettingsMode
Valores aceites:None, DenyDelete, DenyWriteAndDelete
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DeploymentSubscriptionId

A ID da assinatura na qual a implantação deve ser criada.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Description

Descrição para a pilha

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Force

Não peça confirmação ao substituir uma pilha existente.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Location

Localização da pilha

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ManagementGroupId

A id do grupo de gerenciamento no qual o deploymentStack será implantado.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

O nome do deploymentStack a ser criado.

Tipo:String
Aliases:StackName
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PassThru

Se definido, um booleano será retornado com valor dependente do sucesso do cmdlet.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Pre

Quando definido, indica que o cmdlet deve usar versões de API de pré-lançamento ao determinar automaticamente qual versão usar.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-QueryString

A cadeia de caracteres de consulta (por exemplo, um token SAS) a ser usada com o parâmetro TemplateUri. Seria usado no caso de modelos vinculados

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SkipTemplateParameterPrompt

Ignora o processamento de parâmetros dinâmicos do PowerShell que verifica se o parâmetro de modelo fornecido contém todos os parâmetros necessários usados pelo modelo. Essa verificação solicitaria que o usuário fornecesse um valor para os parâmetros ausentes, mas fornecer o -SkipTemplateParameterPrompt ignorará esse prompt e enviará um erro imediatamente se um parâmetro não estiver vinculado no modelo. Para scripts não interativos, -SkipTemplateParameterPrompt podem ser fornecidos para fornecer uma mensagem de erro melhor no caso de nem todos os parâmetros necessários serem satisfeitos.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Tag

As tags a serem colocadas na implantação.

Tipo:Hashtable
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TemplateFile

TemplateFile a ser usado para criar a pilha.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TemplateParameterFile

Arquivo de parâmetro a ser usado para o modelo.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TemplateParameterObject

Uma tabela de hash que representa os parâmetros.

Tipo:Hashtable
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TemplateParameterUri

Local do arquivo de parâmetro a ser usado para o modelo.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TemplateSpecId

ResourceId do TemplateSpec a ser usado para criar a pilha.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TemplateUri

Localização do modelo a ser usado para criar a pilha.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Hashtable

Saídas

Boolean