Get-AzManagementGroupDeploymentWhatIfResult
Získá výsledek citlivostní analýza pro nasazení v oboru skupiny pro správu.
Syntaxe
Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzManagementGroupDeploymentWhatIfResult
[-Name <String>]
-ManagementGroupId <String>
-Location <String>
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Rutina Get-AzManagementGroupDeploymentWhatIfResult získá výsledek šablony ARM What-If pro 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 citlivostní analýza 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á výsledek citlivostní analýzy 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 citlivostní analýza 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á výsledek citlivostní analýzy 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 použije parametr ResultFormat k nastavení výsledku What-If tak, aby obsahoval pouze ID prostředků.
Příklad 3: Výpočet citlivostní analýza pomocí souboru .bicepparam
Get-AzManagementGroupDeploymentWhatIfResult -ManagementGroupId "myManagementGroup" -Location "West US" -TemplateParameterFile "./parameters.bicepparam"Tento příkaz získá výsledek citlivostní kontroly 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.
| Typ: | IAzureContextContainer |
| Aliasy: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ExcludeChangeType
Čárkami oddělený seznam typů změn prostředků, které mají být vyloučeny z výsledků citlivostní dokumentace.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Location
Umístění pro ukládání dat nasazení.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ManagementGroupId
ID skupiny pro správu.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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".
| Typ: | String |
| Aliasy: | DeploymentName |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ResultFormat
Formát výsledku citlivostní citlivosti.
| Typ: | WhatIfResultFormat |
| Přípustné hodnoty: | ResourceIdOnly, FullResourcePayloads |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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 poskytnutí parametru -SkipTemplateParameterPrompt bude tuto výzvu ignorovat a okamžitě se zobrazí chyba, pokud v šabloně nebyl nalezen parametr vázán. V případě neinteraktivních skriptů je možné zadat parametr -SkipTemplateParameterPrompt, který poskytuje lepší chybovou zprávu v případě, že nejsou splněny všechny požadované parametry.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-TemplateFile
Místní cesta k souboru šablony. Podporovaný typ souboru šablony: json a bicep.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-TemplateObject
Tabulka hash, která představuje šablonu.
| Typ: | Hashtable |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-TemplateParameterFile
Soubor parametrů, který se má použít pro šablonu.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-TemplateParameterObject
Tabulka hash, která představuje parametry.
| Typ: | Hashtable |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-TemplateParameterUri
Identifikátor URI souboru parametrů šablony.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-TemplateSpecId
ID prostředku šablonySpec, který se má nasadit.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-TemplateUri
Identifikátor URI souboru šablony.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |