Auf Englisch lesen

Freigeben über

Test-AzResourceGroupDeploymentStack

  • Referenz
Modul:
Az.Resources

Überprüft einen Ressourcengruppenbereichsbereitstellungsstapel.

Syntax

PowerShell 
Test-AzResourceGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ResourceGroupName <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>]
PowerShell 
Test-AzResourceGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ResourceGroupName <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>]
PowerShell 
Test-AzResourceGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ResourceGroupName <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>]
PowerShell 
Test-AzResourceGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ResourceGroupName <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>]
PowerShell 
Test-AzResourceGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ResourceGroupName <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>]
PowerShell 
Test-AzResourceGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ResourceGroupName <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>]
PowerShell 
Test-AzResourceGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ResourceGroupName <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>]
PowerShell 
Test-AzResourceGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ResourceGroupName <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>]
PowerShell 
Test-AzResourceGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ResourceGroupName <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>]
PowerShell 
Test-AzResourceGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ResourceGroupName <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>]
PowerShell 
Test-AzResourceGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ResourceGroupName <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>]
PowerShell 
Test-AzResourceGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ResourceGroupName <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>]
PowerShell 
Test-AzResourceGroupDeploymentStack
    [-PassThru]
    -Name <String>
    -ResourceGroupName <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>]

Beschreibung

Überprüft einen Ressourcengruppenbereichsbereitstellungsstapel.

Beispiele

Beispiel 1: Überprüft den Stapel "MyRGStack" in der Ressourcengruppe "MyResourceGroup"

PowerShell 
Test-AzResourceGroupDeploymentStack -Name MyRGStack -ResourceGroupName MyResourceGroup -TemplateFile myTemplate.json -DenySettingsMode DenyDelete -ActionOnUnmanage DetachAll

Überprüft einen ressourcengruppenbezogenen Bereitstellungsstapel mit dem Namen "MyRGStack" in der Ressourcengruppe "MyResourceGroup", wobei die Einstellungen "DenyDelete" und "ActionOnUnmanage DetachAll" verweigert werden.

Parameter

-ActionOnUnmanage

Aktion für Ressourcen, die beim Löschen oder Aktualisieren des Bereitstellungsstapels nicht verwaltet werden. Mögliche Werte sind: "detachAll" (keine nicht verwalteten Ressourcen löschen), "deleteResources" (alle nicht verwalteten Ressourcen löschen, die keine RGs oder MGs sind) und "deleteAll" (alle nicht verwalteten Ressourcen löschen).

Typ:PSActionOnUnmanage
Zulässige Werte:DetachAll, DeleteResources, DeleteAll
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AsJob

Führen Sie das Cmdlet im Hintergrund aus.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BypassStackOutOfSyncError

Umgehen von Fehlern für den Stapel, der beim Ausführen des Vorgangs nicht synchronisiert wird. Wenn der Stapel nicht synchronisiert ist und dieser Parameter nicht festgelegt ist, schlägt der Vorgang fehl. Fügen Sie diesen Parameter nur ein, wenn dies bei einem fehlgeschlagenen Stapelvorgang erforderlich ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DenySettingsApplyToChildScopes

Gilt für untergeordnete Bereiche.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DenySettingsExcludedAction

Liste der rollenbasierten Verwaltungsvorgänge, die von den denySettings ausgeschlossen sind. Bis zu 200 Aktionen sind zulässig.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DenySettingsExcludedPrincipal

Liste der von der Sperre ausgeschlossenen AAD-Prinzipal-IDs. Bis zu 5 Prinzipale sind zulässig.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DenySettingsMode

Modus für DenySettings. Mögliche Werte sind: 'denyDelete', 'denyWriteAndDelete' und 'none'.

Typ:PSDenySettingsMode
Zulässige Werte:None, DenyDelete, DenyWriteAndDelete
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Beschreibung für den Stapel.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Force

Fordern Sie beim Überschreiben eines vorhandenen Stapels keine Bestätigung an.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Der Name des zu erstellenden DeploymentStack.The name of the DeploymentStack to create.

Typ:String
Aliase:StackName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Wenn dieser Wert festgelegt ist, wird ein boolescher Wert zurückgegeben, der vom Erfolg des Cmdlets abhängig ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Pre

Wenn festgelegt, gibt an, dass das Cmdlet Vorabversionen von API-Versionen verwenden soll, wenn automatisch bestimmt wird, welche Version verwendet werden soll.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-QueryString

Die Abfragezeichenfolge (z. B. ein SAS-Token), die mit dem TemplateUri-Parameter verwendet werden soll. Würde bei verknüpften Vorlagen verwendet werden

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Der Name der zu verwendenden ResourceGroup.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SkipTemplateParameterPrompt

Überspringt die dynamische PowerShell-Parameterverarbeitung, die überprüft, ob der bereitgestellte Vorlagenparameter alle erforderlichen Parameter enthält, die von der Vorlage verwendet werden. Diese Überprüfung fordert den Benutzer auf, einen Wert für die fehlenden Parameter bereitzustellen, aber wenn der -SkipTemplateParameterPrompt diese Eingabeaufforderung bereitstellt, wird diese Eingabeaufforderung ignoriert und sofort ausgegeben, wenn ein Parameter gefunden wurde, der nicht in der Vorlage gebunden werden soll. Bei nicht interaktiven Skripts kann -SkipTemplateParameterPrompt bereitgestellt werden, um eine bessere Fehlermeldung bereitzustellen, wenn nicht alle erforderlichen Parameter erfüllt sind.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Tag

Die Tags, die für die Bereitstellung platziert werden sollen.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TemplateFile

TemplateFile, das zum Erstellen des Stapels verwendet werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TemplateParameterFile

Parameterdatei, die für die Vorlage verwendet werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TemplateParameterObject

Eine Hashtabelle, die die Parameter darstellt.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TemplateParameterUri

Speicherort der Parameterdatei, die für die Vorlage verwendet werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TemplateSpecId

ResourceId der TemplateSpec, die zum Erstellen des Stapels verwendet werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TemplateUri

Speicherort der Vorlage, die zum Erstellen des Stapels verwendet werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Ausgaben