New-AzSubscriptionDeploymentStack

Referenz

Modul:: Az.Resources

Erstellt einen neuen Bereitstellungsstapel mit Abonnementbereich.

Syntax

New-AzSubscriptionDeploymentStack
   [-Name] <String>
   [-Description <String>]
   -Location <String>
   [-DeleteAll]
   [-DeleteResources]
   [-DeleteResourceGroups]
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-DeploymentResourceGroupName <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSubscriptionDeploymentStack
   [-Name] <String>
   [-Description <String>]
   -Location <String>
   [-DeleteAll]
   [-DeleteResources]
   [-DeleteResourceGroups]
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-DeploymentResourceGroupName <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   -TemplateFile <String>
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSubscriptionDeploymentStack
   [-Name] <String>
   [-Description <String>]
   -Location <String>
   [-DeleteAll]
   [-DeleteResources]
   [-DeleteResourceGroups]
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-DeploymentResourceGroupName <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   -TemplateFile <String>
   -TemplateParameterUri <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSubscriptionDeploymentStack
   [-Name] <String>
   [-Description <String>]
   -Location <String>
   [-DeleteAll]
   [-DeleteResources]
   [-DeleteResourceGroups]
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-DeploymentResourceGroupName <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   -TemplateFile <String>
   -TemplateParameterObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSubscriptionDeploymentStack
   [-Name] <String>
   [-Description <String>]
   -Location <String>
   [-DeleteAll]
   [-DeleteResources]
   [-DeleteResourceGroups]
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-DeploymentResourceGroupName <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   -TemplateUri <String>
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSubscriptionDeploymentStack
   [-Name] <String>
   [-Description <String>]
   -Location <String>
   [-DeleteAll]
   [-DeleteResources]
   [-DeleteResourceGroups]
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-DeploymentResourceGroupName <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   -TemplateUri <String>
   -TemplateParameterUri <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSubscriptionDeploymentStack
   [-Name] <String>
   [-Description <String>]
   -Location <String>
   [-DeleteAll]
   [-DeleteResources]
   [-DeleteResourceGroups]
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-DeploymentResourceGroupName <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   -TemplateUri <String>
   -TemplateParameterObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSubscriptionDeploymentStack
   [-Name] <String>
   [-Description <String>]
   -Location <String>
   [-DeleteAll]
   [-DeleteResources]
   [-DeleteResourceGroups]
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-DeploymentResourceGroupName <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSubscriptionDeploymentStack
   [-Name] <String>
   [-Description <String>]
   -Location <String>
   [-DeleteAll]
   [-DeleteResources]
   [-DeleteResourceGroups]
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-DeploymentResourceGroupName <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   -TemplateSpecId <String>
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSubscriptionDeploymentStack
   [-Name] <String>
   [-Description <String>]
   -Location <String>
   [-DeleteAll]
   [-DeleteResources]
   [-DeleteResourceGroups]
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-DeploymentResourceGroupName <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   -TemplateSpecId <String>
   -TemplateParameterUri <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSubscriptionDeploymentStack
   [-Name] <String>
   [-Description <String>]
   -Location <String>
   [-DeleteAll]
   [-DeleteResources]
   [-DeleteResourceGroups]
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-DeploymentResourceGroupName <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   -TemplateSpecId <String>
   -TemplateParameterObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSubscriptionDeploymentStack
   [-Name] <String>
   [-Description <String>]
   -Location <String>
   [-DeleteAll]
   [-DeleteResources]
   [-DeleteResourceGroups]
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-DeploymentResourceGroupName <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSubscriptionDeploymentStack
   [-Name] <String>
   [-Description <String>]
   -Location <String>
   [-DeleteAll]
   [-DeleteResources]
   [-DeleteResourceGroups]
   -DenySettingsMode <PSDenySettingsMode>
   [-DenySettingsExcludedPrincipal <String[]>]
   [-DenySettingsExcludedAction <String[]>]
   [-DenySettingsApplyToChildScopes]
   [-DeploymentResourceGroupName <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   -TemplateParameterFile <String>
   [-SkipTemplateParameterPrompt]
   [-QueryString <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Erstellen Sie einen abonnementbezogenen Bereitstellungsstapel.

Beispiele

Beispiel 1: Erstellen eines abonnementbezogenen Bereitstellungsstapels MySubStack am Westus-Standort

New-AzSubscriptionDeploymentStack -Name MySubStack -TemplateFile myTemplate.json -Location westus -DenySettingsMode DenyDelete

Erstellen Sie einen neuen Abonnementbereichsbereitstellungsstapel namens "MySubStack" im Standardabonnement, wobei die Einstellungen "DenyDelete" verweigert werden.

Beispiel 2: Verwenden einer Bicepparam-Datei zum Erstellen eines Stapels

New-AzSubscriptionDeploymentStack -Name MySubStack -Location westus -DenySettingsMode DenyDelete -TemplateParameterFile "./parameters.bicepparam"

Mit diesem Befehl wird ein neuer Stapel im Abonnementbereich mithilfe einer Bicepparam-Datei auf dem Datenträger erstellt.

Parameter

-AsJob

Führen Sie das Cmdlet im Hintergrund aus.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-DeleteAll

Signal zum Löschen von Ressourcen und Ressourcengruppen nach dem Aktualisieren des Stapels.

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

-DeleteResourceGroups

Signal zum Löschen nicht verwalteter Stapelressourcengruppen nach dem Aktualisieren des Stapels.

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

-DeleteResources

Signal zum Löschen nicht verwalteter Stapelressourcen nach dem Aufwärtsup des Stapels.

Typ:	SwitchParameter
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

-DeploymentResourceGroupName

Die ResourceGroup, auf der die Bereitstellung erstellt wird. Wenn keine angegeben ist, wird standardmäßig der Umfang des Bereitstellungsstapels auf Abonnementebene verwendet.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
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

-Location

Position des Stapels.

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

-Name

Der Name des zu erstellenden deploymentStack

Typ:	String
Aliase:	StackName
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
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

-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 durch Bereitstellen des "-SkipTemplateParameterPrompt" wird diese Eingabeaufforderung ignoriert und sofort ein Fehler ausgegeben, wenn ein Parameter nicht in der Vorlage gebunden wurde. Für nicht interaktive 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 geschieht, 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

String

Hashtable

Ausgaben

PSDeploymentStack

Freigeben über