Dela via


Test-AzManagementGroupDeploymentStack

Verifierar en distributionsstack för hanteringsgruppsomfång.

Syntax

Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -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>]
Test-AzManagementGroupDeploymentStack
    [-PassThru]
    -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

Verifierar 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

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

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, neka inställningar som DenyDelete och ActionOnUnmanage som DetachAll.

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
Godkända värden:DetachAll, DeleteResources, DeleteAll
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AsJob

Kör cmdleten i bakgrunden.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

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

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DenySettingsApplyToChildScopes

Gäller för underordnade omfång.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DenySettingsExcludedAction

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

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DenySettingsMode

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

Typ:PSDenySettingsMode
Godkända värden:None, DenyDelete, DenyWriteAndDelete
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DeploymentSubscriptionId

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Description

Beskrivning för stacken

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Force

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Location

Stackens plats

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ManagementGroupId

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Namnet på den distributionStack som ska skapas.

Typ:String
Alias:StackName
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Om värdet anges returneras ett booleskt värde som är beroende av att cmdleten lyckas.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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
Godkänn pipeline-indata:False
Godkänn jokertecken: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
Godkänn pipeline-indata:False
Godkänn jokertecken: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 omedelbart om en parameter inte har bundits 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
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Tag

Taggarna som ska sättas på distributionen.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TemplateFile

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-TemplateParameterFile

Parameterfil som ska användas för mallen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-TemplateParameterObject

En hash-tabell som representerar parametrarna.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-TemplateParameterUri

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-TemplateSpecId

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-TemplateUri

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Hashtable

Utdata

Boolean