Get-AzManagementGroupDeploymentWhatIfResult
Získá šablonu What-If výsledek nasazení v oboru skupiny pro správu.
Syntax
ByTemplateFileWithNoParameters (Výchozí)
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateFile <String>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateObjectAndParameterObject
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateParameterObject <Hashtable>
-TemplateObject <Hashtable>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateFileAndParameterObject
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateUriAndParameterObject
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateSpecResourceIdAndParamsObject
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateParameterObject <Hashtable>
-TemplateSpecId <String>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateObjectAndParameterFile
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateParameterFile <String>
-TemplateObject <Hashtable>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateFileAndParameterFile
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateParameterFile <String>
-TemplateFile <String>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateUriAndParameterFile
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateParameterFile <String>
-TemplateUri <String>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateSpecResourceIdAndParams
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateParameterFile <String>
-TemplateSpecId <String>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByParameterFileWithNoTemplate
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateParameterFile <String>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateObjectAndParameterUri
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateParameterUri <String>
-TemplateObject <Hashtable>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateFileAndParameterUri
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateParameterUri <String>
-TemplateFile <String>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateUriAndParameterUri
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateParameterUri <String>
-TemplateUri <String>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateSpecResourceIdAndParamsUri
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateParameterUri <String>
-TemplateSpecId <String>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateObjectWithNoParameters
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateObject <Hashtable>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateUriWithNoParameters
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateUri <String>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ByTemplateSpecResourceId
Get-AzManagementGroupDeploymentWhatIfResult
-ManagementGroupId <String>
-Location <String>
-TemplateSpecId <String>
[-Name <String>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
[-ValidationLevel <String>]
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Rutina Get-AzManagementGroupDeploymentWhatIfResult získá šablonu ARM What-If výsledek nasazení šablony v zadaném oboru skupiny pro správu. Vrátí seznam změn, které udávají, které prostředky budou aktualizovány, pokud se nasazení použije bez provedení jakýchkoli změn skutečných prostředků. Chcete-li zadat formát pro vrácený výsledek, použijte parametr ResultFormat .
Příklady
Příklad 1: Získání výsledku What-If v oboru skupiny pro správu
Get-AzManagementGroupDeploymentWhatIfResult `
-DeploymentName "deploy-01" `
-Location "West US" `
-ManagementGroupId "myManagementGroup" `
-TemplateFile "D:\Azure\Templates\ServiceTemplate.json" `
-TemplateParameterFile "D:\Azure\Templates\ServiceParameters.json" `
-ResultFormat "FullResourcePayloads"
Tento příkaz získá What-If výsledek v oboru skupiny pro správu pomocí vlastního souboru šablony a souboru parametrů na disku.
Příkaz pomocí parametru Location určuje, kam se mají ukládat data nasazení.
Příkaz pomocí parametru ManagementGroupId určí skupinu pro správu, do které se šablona nasadí.
Příkaz používá k zadání souboru šablony parametr TemplateFile .
Příkaz používá parametr TemplateParameterFile k určení souboru parametrů šablony.
Příkaz pomocí parametru ResultFormat nastaví výsledek What-If tak, aby zahrnoval úplné datové části prostředků.
Příklad 2: Získání výsledku What-If v oboru skupiny pro správu pomocí ResourceIdOnly
Get-AzManagementGroupDeploymentWhatIfResult `
-DeploymentName "deploy-01" `
-Location "West US" `
-ManagementGroupId "myManagementGroup" `
-TemplateFile "D:\Azure\Templates\ServiceTemplate.json" `
-TemplateParameterFile "D:\Azure\Templates\ServiceParameters.json" `
-ResultFormat "ResourceIdOnly"
Tento příkaz získá What-If výsledek v oboru skupiny pro správu pomocí vlastního souboru šablony a souboru parametrů na disku.
Příkaz pomocí parametru Location určuje, kam se mají ukládat data nasazení.
Příkaz pomocí parametru ManagementGroupId určí skupinu pro správu, do které se šablona nasadí.
Příkaz používá k zadání souboru šablony parametr TemplateFile .
Příkaz používá parametr TemplateParameterFile k určení souboru parametrů šablony.
Příkaz pomocí parametru ResultFormat nastaví výsledek What-If tak, aby obsahoval pouze ID prostředků.
Příklad 3: Výpočet What-If pomocí souboru .bicepparam
Get-AzManagementGroupDeploymentWhatIfResult -ManagementGroupId "myManagementGroup" -Location "West US" -TemplateParameterFile "./parameters.bicepparam"
Tento příkaz získá What-If výsledek v oboru skupiny pro správu pomocí souboru .bicepparam na disku.
Příkaz používá parametr TemplateParameterFile k určení souboru .bicepparam.
Parametry
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Vlastnosti parametru
Typ: IAzureContextContainer
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Aliasy: AzContext, AzureRmContext, AzureCredential
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-ExcludeChangeType
Čárkami oddělený seznam typů změn prostředků, které mají být vyloučeny z What-If výsledků.
Vlastnosti parametru
Typ: String [ ]
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-Location
Umístění pro ukládání dat nasazení.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-ManagementGroupId
ID skupiny pro správu.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-Name
Název nasazení, které se má vytvořit.
Pokud není zadáno, použije se při zadání souboru šablony výchozí název souboru šablony; výchozí hodnota aktuálního času, kdy je zadaný objekt šablony, například "20131223140835".
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Aliasy: název nasazení
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-Pre
Při nastavení označuje, že rutina by měla při automatickém určování verze, kterou verzi použít, používat předběžné verze rozhraní API.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
Formát výsledku What-If.
Typ: WhatIfResultFormat
Default value: None
Přípustné hodnoty: ResourceIdOnly, FullResourcePayloads
Podporuje zástupné znaky: False
DontShow: False
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-SkipTemplateParameterPrompt
Přeskočí zpracování dynamického parametru PowerShellu, které kontroluje, jestli zadaný parametr šablony obsahuje všechny nezbytné parametry, které šablona používá.
Tato kontrola by uživateli zobrazila výzvu k zadání hodnoty chybějících parametrů, ale za předpokladu, že -SkipTemplateParameterPrompt bude tuto výzvu ignorovat a okamžitě se zobrazí chyba, pokud nebyl v šabloně nalezen parametr vázán.
Pro neinteraktivní skripty je možné poskytnout -SkipTemplateParameterPrompt, aby se v případě, že nejsou splněny všechny požadované parametry, zobrazily lepší chybovou zprávu.
Vlastnosti parametru
Typ: SwitchParameter
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
-TemplateFile
Místní cesta k souboru šablony. Podporovaný typ souboru šablony: json a bicep.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateFileWithNoParameters
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateFileAndParameterObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateFileAndParameterFile
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateFileAndParameterUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-TemplateObject
Tabulka hash, která představuje šablonu.
Vlastnosti parametru
Typ: Hashtable
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateObjectAndParameterObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateObjectAndParameterFile
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateObjectAndParameterUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateObjectWithNoParameters
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-TemplateParameterFile
Soubor parametrů, který se má použít pro šablonu.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateObjectAndParameterFile
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateFileAndParameterFile
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateUriAndParameterFile
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateSpecResourceIdAndParams
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByParameterFileWithNoTemplate
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-TemplateParameterObject
Tabulka hash, která představuje parametry.
Vlastnosti parametru
Typ: Hashtable
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateObjectAndParameterObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateFileAndParameterObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateUriAndParameterObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateSpecResourceIdAndParamsObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-TemplateParameterUri
Identifikátor URI souboru parametrů šablony.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateObjectAndParameterUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateFileAndParameterUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateUriAndParameterUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateSpecResourceIdAndParamsUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-TemplateSpecId
ID prostředku šablonySpec, který se má nasadit.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateSpecResourceIdAndParamsObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateSpecResourceIdAndParams
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateSpecResourceIdAndParamsUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateSpecResourceId
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-TemplateUri
Identifikátor URI souboru šablony.
Vlastnosti parametru
Typ: String
Default value: None
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
ByTemplateUriAndParameterObject
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateUriAndParameterFile
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateUriAndParameterUri
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
ByTemplateUriWithNoParameters
Position: Named
Povinné: True
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: True
Hodnota ze zbývajících argumentů: False
-ValidationLevel
Nastaví úroveň ověřování pro ověření a citlivostní ověření. ValidationLevel může být Template(Skips provider validation), Provider(Provádí úplné ověření) nebo ProviderNoRbac(Provádí úplné ověření pomocí kontrol čtení RBAC místo kontrol zápisu RBAC pro ověření zprostředkovatele).
Vlastnosti parametru
Typ: String
Default value: None(Provider)
Podporuje zástupné znaky: False
DontShow: False
Sady parametrů
(All)
Position: Named
Povinné: False
Hodnota z kanálu: False
Hodnota z kanálu podle názvu vlastnosti: False
Hodnota ze zbývajících argumentů: False
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters .
Výstupy