다음을 통해 공유

Test-AzManagementGroupDeployment

모듈:
Az.Resources

관리 그룹에서 배포의 유효성을 검사합니다.

구문

Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateFile <String>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateParameterObject <Hashtable>
    -TemplateObject <Hashtable>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateParameterObject <Hashtable>
    -TemplateFile <String>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateParameterObject <Hashtable>
    -TemplateUri <String>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateParameterObject <Hashtable>
    -TemplateSpecId <String>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateParameterFile <String>
    -TemplateObject <Hashtable>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateParameterFile <String>
    -TemplateFile <String>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateParameterFile <String>
    -TemplateUri <String>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateParameterFile <String>
    -TemplateSpecId <String>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateParameterFile <String>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateParameterUri <String>
    -TemplateObject <Hashtable>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateParameterUri <String>
    -TemplateFile <String>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateParameterUri <String>
    -TemplateUri <String>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateParameterUri <String>
    -TemplateSpecId <String>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateObject <Hashtable>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateUri <String>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzManagementGroupDeployment
    [-Name <String>]
    -ManagementGroupId <String>
    -Location <String>
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SuppressDiagnostics]
    -TemplateSpecId <String>
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

Test-AzManagementGroupDeployment cmdlet은 배포 템플릿과 해당 매개 변수 값이 관리 그룹에서 유효한지 여부를 결정합니다.

예제

예제 1: 사용자 지정 템플릿 및 매개 변수 파일을 사용하여 배포 테스트

Test-AzManagementGroupDeployment -ManagementGroupId "myMG" -Location "West US" -TemplateFile "D:\Azure\Templates\OrgSetup.json" -TemplateParameterFile "D:\Azure\Templates\OrgParms.json"

이 명령은 지정된 템플릿 파일 및 매개 변수 파일을 사용하여 관리 그룹 "myMG"에서 배포를 테스트합니다.

예제 2: 사용자 지정 템플릿 개체 및 매개 변수 파일을 사용하여 배포 테스트

$TemplateFileText = [System.IO.File]::ReadAllText("D:\Azure\Templates\OrgSetup.json")
$TemplateObject = ConvertFrom-Json $TemplateFileText -AsHashtable
Test-AzManagementGroupDeployment -ManagementGroupId "myMG" -Location "West US" -TemplateObject $TemplateObject -TemplateParameterFile "D:\Azure\Templates\EngSiteParams.json"

이 명령은 지정된 템플릿 파일 및 매개 변수 파일에서 만든 메모리 내 해시 테이블을 사용하여 관리 그룹 "myMG"에서 배포를 테스트합니다.

예제 3: .bicepparam 파일을 사용하여 배포 유효성 검사

Test-AzManagementGroupDeployment -ManagementGroupId "myManagementGroup" -Location "West US" -TemplateParameterFile "./parameters.bicepparam"

이 명령은 디스크의 .bicepparam 파일을 사용하여 관리 그룹 범위에서 배포의 유효성을 검사합니다. 이 명령은 TemplateParameterFile 매개 변수를 사용하여 .bicepparam 파일을 지정합니다.

매개 변수

-DefaultProfile

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

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Location

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ManagementGroupId

관리 그룹 ID입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

테스트할 배포의 이름입니다. 지정하지 않으면 템플릿 파일이 제공되면 기본적으로 템플릿 파일 이름이 지정됩니다.

형식:String
별칭:DeploymentName
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Pre

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-QueryString

TemplateUri 매개 변수와 함께 사용할 쿼리 문자열(예: SAS 토큰)입니다. 연결된 템플릿의 경우 사용됩니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SkipTemplateParameterPrompt

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SuppressDiagnostics

설정하면 유효한 배포에 대한 유효성 검사 진단이 표시되지 않습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-TemplateFile

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TemplateObject

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

형식:Hashtable
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TemplateParameterFile

템플릿에 사용할 매개 변수 파일입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TemplateParameterObject

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

형식:Hashtable
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TemplateParameterUri

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TemplateSpecId

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TemplateUri

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ValidationLevel

validate/what-if에 대한 유효성 검사 수준을 설정합니다. ValidationLevel은 템플릿(공급자 유효성 검사 건너뛰기), 공급자(전체 유효성 검사 수행) 또는 ProviderNoRbac(공급자 유효성 검사를 위한 RBAC 쓰기 검사 대신 RBAC 읽기 검사를 사용하여 전체 유효성 검사 수행)일 수 있습니다.

형식:String
Position:Named
Default value:None(Provider)
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Hashtable

String

출력

PSResourceManagerError