Get-AzManagementGroupDeploymentWhatIfResult
Ruft ein Vorlagen-What-If-Ergebnis für eine Bereitstellung im Verwaltungsgruppenbereich ab.
Syntax
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>]
Beschreibung
Das Cmdlet Get-AzManagementGroupDeploymentWhatIfResult ruft das ARM-Vorlagenergebnis "What-If" für eine Vorlagenbereitstellung im angegebenen Verwaltungsgruppenbereich ab. Es wird eine Liste der Änderungen zurückgegeben, die angeben, welche Ressourcen aktualisiert werden, wenn die Bereitstellung angewendet wird, ohne Änderungen an realen Ressourcen vorzunehmen. Um das Format für das zurückgegebene Ergebnis anzugeben, verwenden Sie den ResultFormat-Parameter .
Beispiele
Beispiel 1: Abrufen eines What-If-Ergebnisses im Verwaltungsgruppenbereich
Get-AzManagementGroupDeploymentWhatIfResult `
-DeploymentName "deploy-01" `
-Location "West US" `
-ManagementGroupId "myManagementGroup" `
-TemplateFile "D:\Azure\Templates\ServiceTemplate.json" `
-TemplateParameterFile "D:\Azure\Templates\ServiceParameters.json" `
-ResultFormat "FullResourcePayloads"
Dieser Befehl ruft ein What-If-Ergebnis im Verwaltungsgruppenbereich mithilfe einer benutzerdefinierten Vorlagendatei und einer Parameterdatei auf dem Datenträger ab. Der Befehl verwendet den Parameter "Location ", um anzugeben, wo die Bereitstellungsdaten gespeichert werden sollen. Der Befehl verwendet den Parameter "ManagementGroupId ", um die Verwaltungsgruppe anzugeben, in der die Vorlage bereitgestellt wird. Der Befehl verwendet den Parameter TemplateFile , um eine Vorlagendatei anzugeben. Der Befehl verwendet den Parameter TemplateParameterFile , um eine Vorlagenparameterdatei anzugeben. Der Befehl verwendet den Parameter ResultFormat , um das What-If-Ergebnis festzulegen, um vollständige Ressourcennutzlasten einzuschließen.
Beispiel 2: Abrufen eines What-If-Ergebnisses im Verwaltungsgruppenbereich mit 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"
Dieser Befehl ruft ein What-If-Ergebnis im Verwaltungsgruppenbereich mithilfe einer benutzerdefinierten Vorlagendatei und einer Parameterdatei auf dem Datenträger ab. Der Befehl verwendet den Parameter "Location ", um anzugeben, wo die Bereitstellungsdaten gespeichert werden sollen. Der Befehl verwendet den Parameter "ManagementGroupId ", um die Verwaltungsgruppe anzugeben, in der die Vorlage bereitgestellt wird. Der Befehl verwendet den Parameter TemplateFile , um eine Vorlagendatei anzugeben. Der Befehl verwendet den Parameter TemplateParameterFile , um eine Vorlagenparameterdatei anzugeben. Der Befehl verwendet den Parameter "ResultFormat ", um das Ergebnis "What-If" so festzulegen, dass nur Ressourcen-IDs enthalten sind.
Beispiel 3: Verwenden einer Bicepparam-Datei zum Berechnen von What-If
Get-AzManagementGroupDeploymentWhatIfResult -ManagementGroupId "myManagementGroup" -Location "West US" -TemplateParameterFile "./parameters.bicepparam"
Dieser Befehl ruft ein What-If-Ergebnis im Verwaltungsgruppenbereich mithilfe einer Bicepparam-Datei auf dem Datenträger ab. Der Befehl verwendet den Parameter TemplateParameterFile , um eine Bicepparam-Datei anzugeben.
Parameter
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeChangeType
Durch Trennzeichen getrennte Liste der Ressourcenänderungstypen, die von Den-Wäre-Ergebnissen ausgeschlossen werden sollen.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Der Speicherort zum Speichern von Bereitstellungsdaten.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ManagementGroupId
Die Verwaltungsgruppen-ID.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Der Name der Bereitstellung, die erstellt werden soll. Wenn nicht angegeben, wird standardmäßig der Vorlagendateiname verwendet, wenn eine Vorlagendatei bereitgestellt wird. wird standardmäßig auf den aktuellen Zeitpunkt festgelegt, zu dem ein Vorlagenobjekt bereitgestellt wird, z. B. "20131223140835".
Type: | String |
Aliases: | DeploymentName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Pre
Wenn festgelegt, gibt an, dass das Cmdlet Vorabversionen von API-Versionen verwenden soll, wenn automatisch bestimmt wird, welche Version verwendet werden soll.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResultFormat
Das Ergebnisformat "Was-Wenn".
Type: | WhatIfResultFormat |
Accepted values: | ResourceIdOnly, FullResourcePayloads |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipTemplateParameterPrompt
Überspringt die dynamische PowerShell-Parameterverarbeitung, die überprüft, ob der bereitgestellte Vorlagenparameter alle erforderlichen Parameter enthält, die von der Vorlage verwendet werden. Diese Überprüfung fordert den Benutzer auf, einen Wert für die fehlenden Parameter bereitzustellen, aber durch Bereitstellen des "-SkipTemplateParameterPrompt" wird diese Eingabeaufforderung ignoriert und sofort ein Fehler ausgegeben, wenn ein Parameter nicht in der Vorlage gebunden wurde. Für nicht interaktive Skripts kann -SkipTemplateParameterPrompt bereitgestellt werden, um eine bessere Fehlermeldung bereitzustellen, wenn nicht alle erforderlichen Parameter erfüllt sind.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplateFile
Lokaler Pfad zur Vorlagendatei. Unterstützter Vorlagendateityp: json und bicep.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateObject
Eine Hashtabelle, die die Vorlage darstellt.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterFile
Parameterdatei, die für die Vorlage verwendet werden soll.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterObject
Eine Hashtabelle, die die Parameter darstellt.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterUri
URI für die Vorlagenparameterdatei.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateSpecId
Ressourcen-ID der zu bereitstellenden TemplateSpec.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateUri
URI für die Vorlagendatei.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Eingaben
Ausgaben
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für