Get-AzResourceGroupDeploymentWhatIfResult
Ruft ein Vorlagen-What-If-Ergebnis für eine Bereitstellung im Ressourcengruppenbereich ab.
Syntax
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterObject <Hashtable>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateParameterUri <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzResourceGroupDeploymentWhatIfResult
[-Name <String>]
-ResourceGroupName <String>
[-Mode <DeploymentMode>]
[-ResultFormat <WhatIfResultFormat>]
[-ExcludeChangeType <String[]>]
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Beschreibung
Das Cmdlet "Get-AzResourceGroupDeploymentWhatIfResult " ruft das ARM-Vorlagenergebnis "What-If" für eine Vorlagenbereitstellung im angegebenen Ressourcengruppenbereich 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 Ressourcengruppenbereich
Get-AzResourceGroupDeploymentWhatIfResult `
-DeploymentName "deploy-01" `
-ResourceGroupName "myRG1" `
-TemplateFile "D:\Azure\Templates\ServiceTemplate.json" `
-TemplateParameterFile "D:\Azure\Templates\ServiceParameters.json" `
-ResultFormat "FullResourcePayloads"
Dieser Befehl ruft ein What-If-Ergebnis im angegebenen Ressourcengruppenbereich mithilfe einer benutzerdefinierten Vorlagendatei und einer Parameterdatei auf dem Datenträger ab. Der Befehl verwendet den Parameter ResourceGroupName , um eine Ressourcengruppe 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 Ressourcengruppenbereich mit ResourceIdOnly
Get-AzResourceGroupDeploymentWhatIfResult `
-DeploymentName "deploy-01" `
-ResourceGroupName "myRG1" `
-TemplateFile "D:\Azure\Templates\ServiceTemplate.json" `
-TemplateParameterFile "D:\Azure\Templates\ServiceParameters.json" `
-ResultFormat "ResourceIdOnly"
Dieser Befehl ruft ein What-If-Ergebnis im angegebenen Ressourcengruppenbereich mithilfe einer benutzerdefinierten Vorlagendatei und einer Parameterdatei auf dem Datenträger ab. Der Befehl verwendet den Parameter ResourceGroupName , um eine Ressourcengruppe 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-AzResourceGroupDeploymentWhatIfResult -ResourceGroupName "myRG1" -TemplateParameterFile "./parameters.bicepparam"
Dieser Befehl ruft ein What-If-Ergebnis im Ressourcengruppenbereich 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
Typ: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeChangeType
Durch Trennzeichen getrennte Ressourcenänderungstypen, die aus den Was-Wenn-Ergebnissen ausgeschlossen werden sollen.
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Mode
Der Bereitstellungsmodus.
Typ: | DeploymentMode |
Zulässige Werte: | Incremental, Complete |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
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".
Typ: | String |
Aliases: | DeploymentName |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
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.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Der Name der Ressourcengruppe.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResultFormat
Das Ergebnisformat "Was-Wenn".
Typ: | WhatIfResultFormat |
Zulässige Werte: | ResourceIdOnly, FullResourcePayloads |
Position: | Named |
Standardwert: | None |
Erforderlich: | 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.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplateFile
Lokaler Pfad zur Vorlagendatei. Unterstützter Vorlagendateityp: json und bicep.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateObject
Eine Hashtabelle, die die Vorlage darstellt.
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterFile
Parameterdatei, die für die Vorlage verwendet werden soll.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterObject
Eine Hashtabelle, die die Parameter darstellt.
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterUri
URI für die Vorlagenparameterdatei.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateSpecId
Ressourcen-ID der zu bereitstellenden TemplateSpec.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateUri
URI für die Vorlagendatei.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | 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