New-AzSubscriptionDeploymentStack

模組:

Az.Resources

建立新的訂用帳戶範圍部署堆疊。

語法

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

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

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

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

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

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

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

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

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

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

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

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

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

Description

建立訂用帳戶範圍部署堆疊。

範例

範例 1：在 westus 位置建立訂用帳戶範圍部署堆棧 MySubStack

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

在預設訂用帳戶中建立名為 『MySubStack』 的新訂用帳戶範圍部署堆疊，拒絕設定為 DenyDelete。

範例 2：使用 .bicepparam 檔案建立堆棧

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

此命令會使用磁碟上的 .bicepparam 檔案，在訂用帳戶範圍建立新的堆棧。

參數

-ActionOnUnmanage

針對在刪除或更新部署堆疊時變成 Unmanaged 的資源採取動作。 可能的值包括：'detachAll'（請勿刪除任何 Unmanaged 資源）、'deleteResources'（刪除所有非 RG 或 MG 的 Unmanaged 資源），以及 'deleteAll' （刪除每個 Unmanaged 資源）。

類型:	PSActionOnUnmanage
接受的值:	DetachAll, DeleteResources, DeleteAll
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-AsJob

在背景中執行 Cmdlet。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-BypassStackOutOfSyncError

執行作業時，略過堆疊不同步的錯誤。 如果堆疊未同步，且未設定此參數，作業將會失敗。 只有在指示在失敗的堆疊作業上這樣做時，才包含此參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DenySettingsApplyToChildScopes

套用至子範圍。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DenySettingsExcludedAction

從 denySettings 排除的角色型管理作業清單。 最多允許 200 個動作。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DenySettingsExcludedPrincipal

從鎖定排除的 AAD 主體標識碼清單。 最多允許5個主體。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DenySettingsMode

DenySettings 的模式。 可能的值包括：『denyDelete』、『denyWriteAndDelete』和 『none』。

類型:	PSDenySettingsMode
接受的值:	None, DenyDelete, DenyWriteAndDelete
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DeploymentResourceGroupName

要在其中建立部署的 ResourceGroup。 如果未指定任何專案，則會預設為部署堆疊的訂用帳戶層級範圍。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Description

堆疊的描述。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Force

覆寫現有堆疊時，請勿要求確認。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Location

堆疊的位置。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Name

要建立的 deploymentStack 名稱

類型:	String
別名:	StackName
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Pre

設定時，表示 Cmdlet 在自動判斷要使用的版本時，應該使用發行前版本 API 版本。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-QueryString

要與 TemplateUri 參數搭配使用的查詢字串（例如 SAS 令牌）。 會用於連結的範本

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SkipTemplateParameterPrompt

略過 PowerShell 動態參數處理，檢查提供的範本參數是否包含範本所使用的所有必要參數。 這項檢查會提示使用者提供遺漏參數的值，但提供 -SkipTemplateParameterPrompt 會忽略此提示，並在找不到參數時立即在範本中系結時發生錯誤。 針對非互動式腳本，您可以提供 -SkipTemplateParameterPrompt，以在不符合所有必要參數的情況下提供更好的錯誤訊息。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Tag

要放在部署上的標記。

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TemplateFile

用來建立堆疊的TemplateFile。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-TemplateParameterFile

要用於範本的參數檔案。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-TemplateParameterObject

表示參數的哈希表。

類型:	Hashtable
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-TemplateParameterUri

要用於範本的參數檔案位置。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-TemplateSpecId

要用來建立堆疊之 TemplateSpec 的 ResourceId。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-TemplateUri

要用來建立堆疊的範本位置。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

Hashtable

輸出

PSDeploymentStack