Condividi tramite


Test-AzManagementGroupDeploymentStack

Convalida uno stack di distribuzione con ambito gruppo di gestione.

Sintassi

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

Descrizione

Convalida uno stack di distribuzione con ambito gruppo di gestione.

Esempio

Esempio 1: crea un nuovo stack MyMGStack nel gruppo di gestione MyManagementGroup e lo distribuisce nella sottoscrizione figlio MySubId

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

Creare un nuovo stack di distribuzione con ambito gruppo di gestione denominato 'MyMGStack' nel gruppo di gestione 'MyManagementGroup', con l'ambito della distribuzione sottostante mySubId, negare le impostazioni deny DenyDelete e ActionOnUnmanage essere DetachAll.

Parametri

-ActionOnUnmanage

Azione da eseguire sulle risorse che non vengono gestite durante l'eliminazione o l'aggiornamento dello stack di distribuzione. I valori possibili includono: 'detachAll' (non eliminare alcuna risorsa non gestita), 'deleteResources' (eliminare tutte le risorse non gestite che non sono gruppi di disponibilità o gruppi di disponibilità) e 'deleteAll' (eliminare ogni risorsa non gestita).

Tipo:PSActionOnUnmanage
Valori accettati:DetachAll, DeleteResources, DeleteAll
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AsJob

Eseguire il cmdlet in background.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BypassStackOutOfSyncError

Ignorare gli errori per lo stack non sincronizzato durante l'esecuzione dell'operazione. Se lo stack non è sincronizzato e questo parametro non è impostato, l'operazione avrà esito negativo. Includere questo parametro solo se richiesto di eseguire questa operazione su un'operazione stack non riuscita.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DenySettingsApplyToChildScopes

Applicare agli ambiti figlio.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DenySettingsExcludedAction

Elenco delle operazioni di gestione basate sui ruoli escluse da denySettings. Sono consentite fino a 200 azioni.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DenySettingsExcludedPrincipal

Elenco degli ID entità di AAD esclusi dal blocco. Sono consentite fino a 5 entità.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DenySettingsMode

Modalità per DenySettings. I valori possibili includono: 'denyDelete', 'denyWriteAndDelete' e 'none'.

Tipo:PSDenySettingsMode
Valori accettati:None, DenyDelete, DenyWriteAndDelete
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeploymentSubscriptionId

ID sottoscrizione in corrispondenza del quale deve essere creata la distribuzione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Description

Descrizione per lo stack

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Force

Non chiedere conferma quando si sovrascrive uno stack esistente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Location

Posizione dello stack

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ManagementGroupId

ID del gruppo di gestione in cui verrà distribuito deploymentStack.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Nome dell'oggetto deploymentStack da creare.

Tipo:String
Alias:StackName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Se impostato, verrà restituito un valore booleano che dipende dall'esito positivo del cmdlet.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Pre

Se impostato, indica che il cmdlet deve usare versioni API non definitive quando si determina automaticamente quale versione usare.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-QueryString

Stringa di query (ad esempio, un token di firma di accesso condiviso) da usare con il parametro TemplateUri. Verrebbe usato in caso di modelli collegati

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SkipTemplateParameterPrompt

Ignora l'elaborazione dei parametri dinamici di PowerShell che controlla se il parametro del modello fornito contiene tutti i parametri necessari usati dal modello. Questo controllo richiede all'utente di specificare un valore per i parametri mancanti, ma specificando il -SkipTemplateParameterPrompt ignorerà questa richiesta e genererà l'errore immediatamente se non è stato trovato un parametro da associare nel modello. Per gli script non interattivi, è possibile fornire -SkipTemplateParameterPrompt per fornire un messaggio di errore migliore nel caso in cui non siano soddisfatti tutti i parametri obbligatori.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Tag

Tag da inserire nella distribuzione.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TemplateFile

TemplateFile da usare per creare lo stack.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TemplateParameterFile

File di parametri da usare per il modello.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TemplateParameterObject

Tabella hash che rappresenta i parametri.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TemplateParameterUri

Percorso del file di parametri da usare per il modello.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TemplateSpecId

ResourceId dell'oggetto TemplateSpec da usare per creare lo stack.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TemplateUri

Posizione del modello da usare per creare lo stack.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

Hashtable

Output

Boolean