Dela via


New-AzManagementGroupDeploymentStack

Skapar en ny distributionsstack för hanteringsgruppsomfång.

Syntax

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

Description

Skapa en distributionsstack för hanteringsgruppsomfång.

Exempel

Exempel 1: Skapar en ny stack MyMGStack i hanteringsgruppen MyManagementGroup och distribuerar den till den underordnade prenumerationen MySubId

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

Skapa en ny distributionsstack med omfång för hanteringsgruppen med namnet "MyMGStack" i hanteringsgruppen "MyManagementGroup", där omfånget för den underliggande distributionen är MySubId och nekar att inställningarna är DenyDelete.

Exempel 2: Använd en .bicepparam-fil för att skapa en stack

New-AzManagementGroupDeploymentStack -Name MyMGStack -ManagementGroupId MyMangementGroup -DeploymentSubscriptionId MySubId -Location westus -DenySettingsMode DenyDelete -TemplateParameterFile "./parameters.bicepparam"

Det här kommandot skapar en ny stack i hanteringsgruppens omfång med hjälp av en .bicepparam-fil på disken.

Parametrar

-ActionOnUnmanage

Åtgärder för att vidta åtgärder mot resurser som inte hanteras vid borttagning eller uppdatering av distributionsstacken. Möjliga värden är: "detachAll" (ta inte bort några ohanterade resurser), "deleteResources" (ta bort alla ohanterade resurser som inte är RG:er eller MG:er) och "deleteAll" (ta bort alla ohanterade resurser).

Typ:PSActionOnUnmanage
accepterade värden:DetachAll, DeleteResources, DeleteResourcesAndResourceGroups, DeleteAll
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-AsJob

Kör cmdleten i bakgrunden.

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-BypassStackOutOfSyncError

Kringgå fel för att stacken inte är synkroniserad när åtgärden körs. Om stacken inte är synkroniserad och den här parametern inte har angetts misslyckas åtgärden. Inkludera endast den här parametern om du uppmanas att göra det vid en misslyckad stackåtgärd.

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Aliases:cf
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-DenySettingsApplyToChildScopes

Gäller för underordnade omfång.

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-DenySettingsExcludedAction

Lista över rollbaserade hanteringsåtgärder som undantas från neka Inställningar. Upp till 200 åtgärder är tillåtna.

Typ:String[]
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-DenySettingsExcludedPrincipal

Lista över AAD-huvudnamns-ID:t som undantas från låset. Upp till 5 huvudkonton är tillåtna.

Typ:String[]
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-DenySettingsMode

Läge för Neka Inställningar. Möjliga värden är: "denyDelete", "denyWriteAndDelete" och "none".

Typ:PSDenySettingsMode
accepterade värden:None, DenyDelete, DenyWriteAndDelete
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentSubscriptionId

Prenumerations-ID:t där distributionen ska skapas.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Description

Beskrivning för stacken

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

Be inte om bekräftelse när du skriver över en befintlig stack.

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Stackens plats

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementGroupId

ID:t för hanteringsgruppen som distributionStack ska distribueras till.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Namnet på den distributionStack som ska skapas.

Typ:String
Aliases:StackName
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-Pre

När den anges anger att cmdleten ska använda förhandsversioner av API-versioner när du automatiskt avgör vilken version som ska användas.

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-QueryString

Frågesträngen (till exempel en SAS-token) som ska användas med parametern TemplateUri. Skulle användas vid länkade mallar

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipTemplateParameterPrompt

Hoppar över bearbetningen av dynamiska PowerShell-parametrar som kontrollerar om den angivna mallparametern innehåller alla nödvändiga parametrar som används av mallen. Den här kontrollen uppmanar användaren att ange ett värde för de parametrar som saknas, men om du anger -SkipTemplateParameterPrompt ignoreras den här uppmaningen och felet ut omedelbart om en parameter inte är bunden i mallen. För icke-interaktiva skript kan -SkipTemplateParameterPrompt tillhandahållas för att ge ett bättre felmeddelande om inte alla obligatoriska parametrar är uppfyllda.

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Taggarna som ska sättas på distributionen.

Typ:Hashtable
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-TemplateFile

TemplateFile som ska användas för att skapa stacken.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-TemplateParameterFile

Parameterfil som ska användas för mallen.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-TemplateParameterObject

En hash-tabell som representerar parametrarna.

Typ:Hashtable
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-TemplateParameterUri

Platsen för parameterfilen som ska användas för mallen.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-TemplateSpecId

ResourceId för TemplateSpec som ska användas för att skapa stacken.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-TemplateUri

Plats för mallen som ska användas för att skapa stacken.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Aliases:wi
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

String

Hashtable

Utdata

PSDeploymentStack