Set-AzSubscriptionDeploymentStack
Legt einen neuen abonnementbezogenen Bereitstellungsstapel fest.
Syntax
Set-AzSubscriptionDeploymentStack
-Name <String>
[-Description <String>]
-Location <String>
[-DeploymentResourceGroupName <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-AzSubscriptionDeploymentStack
-Name <String>
[-Description <String>]
-Location <String>
[-DeploymentResourceGroupName <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-AzSubscriptionDeploymentStack
-Name <String>
[-Description <String>]
-Location <String>
[-DeploymentResourceGroupName <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-AzSubscriptionDeploymentStack
-Name <String>
[-Description <String>]
-Location <String>
[-DeploymentResourceGroupName <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-AzSubscriptionDeploymentStack
-Name <String>
[-Description <String>]
-Location <String>
[-DeploymentResourceGroupName <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-AzSubscriptionDeploymentStack
-Name <String>
[-Description <String>]
-Location <String>
[-DeploymentResourceGroupName <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-AzSubscriptionDeploymentStack
-Name <String>
[-Description <String>]
-Location <String>
[-DeploymentResourceGroupName <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-AzSubscriptionDeploymentStack
-Name <String>
[-Description <String>]
-Location <String>
[-DeploymentResourceGroupName <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-AzSubscriptionDeploymentStack
-Name <String>
[-Description <String>]
-Location <String>
[-DeploymentResourceGroupName <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-AzSubscriptionDeploymentStack
-Name <String>
[-Description <String>]
-Location <String>
[-DeploymentResourceGroupName <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-AzSubscriptionDeploymentStack
-Name <String>
[-Description <String>]
-Location <String>
[-DeploymentResourceGroupName <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-AzSubscriptionDeploymentStack
-Name <String>
[-Description <String>]
-Location <String>
[-DeploymentResourceGroupName <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-AzSubscriptionDeploymentStack
-Name <String>
[-Description <String>]
-Location <String>
[-DeploymentResourceGroupName <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
Aktualisieren sie einen Abonnementbereichsbereitstellungsstapel.
Beispiele
Beispiel 1: Aktualisiert den abonnementbezogenen Bereitstellungsstapel MySubStack im aktuellen Abonnement.
Set-AzSubscriptionDeploymentStack -Name MySubStack -TemplateFile myTemplate.json -Location westus -DenySettingsMode DenyDelete
Aktualisieren Sie einen abonnementbezogenen Bereitstellungsstapel mit dem Namen "MySubStack" im Standardabonnement, wobei die Einstellungen "DenyDelete" verweigert werden.
Beispiel 2: Verwenden einer Bicepparam-Datei zum Aktualisieren eines Stapels
Set-AzSubscriptionDeploymentStack -Name MySubStack -Location westus -DenySettingsMode DenyDelete -TemplateParameterFile "./parameters.bicepparam"
Mit diesem Befehl wird ein Stapel auf dem Abonnementbereich mithilfe einer Bicepparam-Datei auf dem Datenträger aktualisiert.
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 |
-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.The name of the deploymentStack to create.
Typ: | String |
Aliase: | StackName |
Position: | Named |
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 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
Azure PowerShell