Get-AzManagementGroupDeploymentWhatIfResult

Başvuru

Modül:: Az.Resources

Yönetim grubu kapsamındaki bir dağıtım için bir şablon What-If sonucu alır.

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>]

Description

Get-AzManagementGroupDeploymentWhatIfResult cmdlet'i, belirtilen yönetim grubu kapsamındaki bir şablon dağıtımı için ARM şablonu What-If sonucunu alır. Dağıtım gerçek kaynaklarda değişiklik yapmadan uygulanırsa hangi kaynakların güncelleştirileceğini gösteren değişikliklerin listesini döndürür. Dönen sonucun biçimini belirtmek için ResultFormat parametresini kullanın.

Örnekler

Örnek 1: Yönetim grubu kapsamında Durum sonucu alma

Get-AzManagementGroupDeploymentWhatIfResult `
    -DeploymentName "deploy-01" `
    -Location "West US" `
    -ManagementGroupId "myManagementGroup" `
    -TemplateFile "D:\Azure\Templates\ServiceTemplate.json" `
    -TemplateParameterFile "D:\Azure\Templates\ServiceParameters.json" `
    -ResultFormat "FullResourcePayloads"

Bu komut, özel bir şablon dosyası ve diskte parametre dosyası kullanarak yönetim grubu kapsamında What-If sonucunu alır. komutu, dağıtım verilerinin depolandığı yeri belirtmek için Location parametresini kullanır. komutu, şablonun dağıtılacağı yönetim grubunu belirtmek için ManagementGroupId parametresini kullanır. Komut, şablon dosyası belirtmek için TemplateFile parametresini kullanır. Komut, şablon parametre dosyasını belirtmek için TemplateParameterFile parametresini kullanır. Komut, What-If sonucunu tam kaynak yüklerini içerecek şekilde ayarlamak için ResultFormat parametresini kullanır.

Örnek 2: ResourceIdOnly ile yönetim grubu kapsamında Durum sonucu alma

Get-AzManagementGroupDeploymentWhatIfResult `
    -DeploymentName "deploy-01" `
    -Location "West US" `
    -ManagementGroupId "myManagementGroup" `
    -TemplateFile "D:\Azure\Templates\ServiceTemplate.json" `
    -TemplateParameterFile "D:\Azure\Templates\ServiceParameters.json" `
    -ResultFormat "ResourceIdOnly"

Bu komut, özel bir şablon dosyası ve diskte parametre dosyası kullanarak yönetim grubu kapsamında What-If sonucunu alır. komutu, dağıtım verilerinin depolandığı yeri belirtmek için Location parametresini kullanır. komutu, şablonun dağıtılacağı yönetim grubunu belirtmek için ManagementGroupId parametresini kullanır. Komut, şablon dosyası belirtmek için TemplateFile parametresini kullanır. Komut, şablon parametre dosyasını belirtmek için TemplateParameterFile parametresini kullanır. Komut, What-If sonucunu yalnızca kaynak kimliklerini içerecek şekilde ayarlamak için ResultFormat parametresini kullanır.

Örnek 3: What-If değerini hesaplamak için .bicepparam dosyası kullanma

Get-AzManagementGroupDeploymentWhatIfResult -ManagementGroupId "myManagementGroup" -Location "West US" -TemplateParameterFile "./parameters.bicepparam"

Bu komut, diskte bir .bicepparam dosyası kullanarak yönetim grubu kapsamında What-If sonucunu alır. Komut, bir .bicepparam dosyası belirtmek için TemplateParameterFile parametresini kullanır.

Parametreler

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExcludeChangeType

Durum sonuçlarından dışlanacak kaynak değişikliği türlerinin virgülle ayrılmış listesi.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Dağıtım verilerini depolama konumu.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagementGroupId

Yönetim grubu kimliği.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Oluşturacağı dağıtımın adı. Belirtilmezse, bir şablon dosyası sağlandığında varsayılan olarak şablon dosyası adını kullanır; varsayılan olarak bir şablon nesnesi sağlandığında geçerli saati kullanır; örneğin, "20131223140835".

Type:	String
Aliases:	DeploymentName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Pre

Ayarlandığında, cmdlet'in hangi sürümün kullanılacağını otomatik olarak belirlerken yayın öncesi API sürümlerini kullanması gerektiğini belirtir.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResultFormat

What-If sonuç biçimi.

Type:	WhatIfResultFormat
Accepted values:	ResourceIdOnly, FullResourcePayloads
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipTemplateParameterPrompt

Sağlanan şablon parametresinin şablon tarafından kullanılan tüm gerekli parametreleri içerip içermediğini denetleyerek PowerShell dinamik parametre işlemesini atlar. Bu denetim kullanıcıdan eksik parametreler için bir değer sağlamasını ister, ancak -SkipTemplateParameterPrompt değerinin sağlanması bu istemi yoksayar ve şablonda bir parametrenin bağlı olmadığı tespit edilirse hemen hata verir. Etkileşimli olmayan betikler için, tüm gerekli parametrelerin karşılanmaması durumunda daha iyi bir hata iletisi sağlamak için -SkipTemplateParameterPrompt sağlanabilir.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TemplateFile

Şablon dosyasının yerel yolu. Desteklenen şablon dosya türü: json ve bicep.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TemplateObject

Şablonu temsil eden karma tablo.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TemplateParameterFile

Şablon için kullanılacak parametre dosyası.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TemplateParameterObject

Parametreleri temsil eden karma tablo.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TemplateParameterUri

Şablon parametre dosyasına Uri.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TemplateSpecId

Dağıtılacak templateSpec öğesinin kaynak kimliği.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TemplateUri

Şablon dosyasının Uri'sini seçin.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Girişler

String

Hashtable

Çıkışlar

PSWhatIfOperationResult