Get-AzDeploymentWhatIfResult

구독 범위에서 배포에 대한 템플릿 What-If 결과를 가져옵니다.

Syntax

Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateParameterObject <Hashtable>
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateParameterObject <Hashtable>
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateParameterObject <Hashtable>
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateParameterObject <Hashtable>
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateParameterFile <String>
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateParameterFile <String>
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateParameterFile <String>
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateParameterFile <String>
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateParameterUri <String>
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateParameterUri <String>
   -TemplateFile <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateParameterUri <String>
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateParameterUri <String>
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateObject <Hashtable>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateUri <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzDeploymentWhatIfResult
   [-Name <String>]
   -Location <String>
   [-ResultFormat <WhatIfResultFormat>]
   [-ExcludeChangeType <String[]>]
   -TemplateSpecId <String>
   [-SkipTemplateParameterPrompt]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Get-AzDeploymentWhatIfResult cmdlet은 현재 구독 범위에서 템플릿 배포에 대한 ARM 템플릿 What-If 결과를 가져옵니다. 실제 리소스를 변경하지 않고 배포가 적용되는 경우 업데이트할 리소스를 나타내는 변경 내용 목록을 반환합니다. 반환 결과에 대한 형식을 지정하려면 ResultFormat 매개 변수를 사용합니다.

예제

예제 1: 구독 범위에서 What-If 결과 가져오기

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

이 명령은 사용자 지정 템플릿 파일 및 디스크의 매개 변수 파일을 사용하여 현재 구독 범위에서 What-If 결과를 가져옵니다. 이 명령은 Location 매개 변수를 사용하여 배포 데이터를 저장할 위치를 지정합니다. 이 명령은 TemplateFile 매개 변수를 사용하여 템플릿 파일을 지정합니다. 이 명령은 TemplateParameterFile 매개 변수를 사용하여 템플릿 매개 변수 파일을 지정합니다. 이 명령은 ResultFormat 매개 변수를 사용하여 전체 리소스 페이로드를 포함하도록 What-If 결과를 설정합니다.

예제 2: ResourceIdOnly를 사용하여 구독 범위에서 What-If 결과 가져오기

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

이 명령은 사용자 지정 템플릿 파일 및 디스크의 매개 변수 파일을 사용하여 현재 구독 범위에서 What-If 결과를 가져옵니다. 이 명령은 Location 매개 변수를 사용하여 배포 데이터를 저장할 위치를 지정합니다. 이 명령은 TemplateFile 매개 변수를 사용하여 템플릿 파일을 지정합니다. 이 명령은 TemplateParameterFile 매개 변수를 사용하여 템플릿 매개 변수 파일을 지정합니다. 이 명령은 ResultFormat 매개 변수를 사용하여 리소스 ID만 포함하도록 What-If 결과를 설정합니다.

매개 변수

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

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

What-If 결과에서 제외할 리소스 변경 형식의 쉼표로 구분된 목록입니다.

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

배포 데이터를 저장할 위치입니다.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

만들 배포의 이름입니다. 지정하지 않으면 템플릿 파일이 제공되면 기본적으로 템플릿 파일 이름이 지정됩니다. 는 템플릿 개체가 제공되는 현재 시간(예: "20131223140835")으로 설정됩니다.

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

설정되면 cmdlet이 사용할 버전을 자동으로 결정할 때 시험판 API 버전을 사용해야 임을 나타냅니다.

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

What-If 결과 형식입니다.

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

제공된 템플릿 매개 변수에 템플릿에서 사용하는 모든 필요한 매개 변수가 포함되어 있는지 확인하는 PowerShell 동적 매개 변수 처리를 건너뜁니다. 이 검사는 사용자에게 누락된 매개 변수에 대한 값을 제공하라는 메시지를 표시하지만 -SkipTemplateParameterPrompt를 제공하면 이 프롬프트를 무시하고 매개 변수가 템플릿에 바인딩되지 않은 경우 즉시 오류가 발생합니다. 비대화형 스크립트의 경우 모든 필수 매개 변수가 충족되지 않는 경우 더 나은 오류 메시지를 제공하기 위해 -SkipTemplateParameterPrompt를 제공할 수 있습니다.

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

템플릿 파일의 로컬 경로입니다. 지원되는 템플릿 파일 형식: json 및 bicep.

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

템플릿을 나타내는 해시 테이블입니다.

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

템플릿 매개 변수가 있는 파일입니다.

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

매개 변수를 나타내는 해시 테이블입니다.

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

템플릿 매개 변수 파일에 대한 URI입니다.

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

배포할 templateSpec의 리소스 ID입니다.

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

템플릿 파일에 대한 URI입니다.

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

입력

Hashtable

String

출력

PSWhatIfOperationResult