Export-AzResourceGroup
리소스 그룹을 템플릿으로 캡처하고 파일에 저장합니다.
구문
Default (기본값)
Export-AzResourceGroup
-ResourceGroupName <String>
[-Path <String>]
[-IncludeParameterDefaultValue]
[-IncludeComments]
[-SkipResourceNameParameterization]
[-SkipAllParameterization]
[-Resource <String[]>]
[-Force]
[-ApiVersion <String>]
[-OutputFormat <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Export-AzResourceGroup cmdlet은 지정된 리소스 그룹을 템플릿으로 캡처하고 JSON 또는 Bicep 파일에 저장합니다. 이는 리소스 그룹에서 일부 리소스를 이미 만든 다음 템플릿 지원 배포를 사용하는 이점을 활용하려는 시나리오에서 유용할 수 있습니다.
이 cmdlet을 사용하면 리소스 그룹의 기존 리소스에 대한 템플릿을 생성하여 쉽게 시작할 수 있습니다.
이 cmdlet이 템플릿의 일부 부분을 생성하지 못하는 경우가 있을 수 있습니다.
경고 메시지는 실패한 리소스를 알려줍니다.
성공한 파트에 대해 템플릿이 계속 생성됩니다.
예제
예제 1: 리소스 그룹 내보내기
Export-AzResourceGroup -ResourceGroupName "TestGroup"
이 명령은 TestGroup이라는 리소스 그룹을 템플릿으로 캡처하고 현재 디렉터리의 JSON 파일에 저장합니다.
예제 2: 리소스 그룹에서 단일 리소스 내보내기
Export-AzResourceGroup -ResourceGroupName "TestGroup" -Resource "/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Compute/virtualMachines/TestVirtualMachine"
이 명령은 "TestGroup" 리소스 그룹에서 "TestVirtualMachine"이라는 Virtual Machine 리소스를 템플릿으로 캡처하고 현재 디렉터리의 JSON 파일에 저장합니다.
예제 3: 리소스 그룹에서 선택한 리소스 내보내기
Export-AzResourceGroup -ResourceGroupName "TestGroup" -SkipAllParameterization -Resource @(
"/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Compute/virtualMachines/TestVm",
"/subscriptions/5f43547b-1d2d-4a3e-ace4-88d4b600d568/resourceGroups/TestGroup/providers/Microsoft.Network/networkInterfaces/TestNic"
)
이 명령은 "TestGroup" 리소스 그룹의 두 리소스를 템플릿으로 캡처하고 현재 디렉터리의 JSON 파일에 저장합니다. 생성된 템플릿에는 생성된 매개 변수가 포함되지 않습니다.
예제 4: 리소스 그룹을 Bicep 파일로 내보내기
Export-AzResourceGroup -ResourceGroupName "TestGroup" -OutputFormat Bicep
이 명령은 TestGroup이라는 리소스 그룹을 템플릿으로 캡처하고 현재 디렉터리의 Bicep 파일에 저장합니다.
예제 5: 사용자 지정 경로를 사용하여 리소스 그룹을 Bicep 파일로 내보내기
Export-AzResourceGroup -ResourceGroupName "TestGroup" -OutputFormat Bicep -Path "C:\Templates\MyResourceGroup.bicep"
이 명령은 TestGroup이라는 리소스 그룹을 템플릿으로 캡처하고 지정된 경로의 Bicep 파일에 저장합니다.
매개 변수
-ApiVersion
사용할 리소스 공급자 API의 버전을 지정합니다.
지정하지 않으면 최신 API 버전이 사용됩니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
형식: SwitchParameter
Default value: False 와일드카드 지원: False DontShow: False 별칭: cf(cf)
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독
매개 변수 속성
형식: IAzureContextContainer
Default value: None 와일드카드 지원: False DontShow: False 별칭: AzContext, AzureRmContext, AzureCredential
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Force
사용자 확인을 요청하지 않고 명령을 강제로 실행합니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
이 작업이 주석을 사용하여 템플릿을 내보낸다는 것을 나타냅니다.
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-IncludeParameterDefaultValue
이 작업은 기본값을 사용하여 템플릿 매개 변수를 내보냅니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
내보낸 템플릿의 형식을 지정합니다. 지원되는 값은 "Json" 및 "Bicep"입니다.
형식: String
Default value: Json 허용되는 값: Json, Bicep 와일드카드 지원: False DontShow: False
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Path
템플릿 파일의 출력 경로를 지정합니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: True 나머지 인수의 값: False
-Pre
이 cmdlet은 사용할 API 버전을 자동으로 결정할 때 시험판 API 버전을 사용한다는 것을 나타냅니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-Resource
결과를 필터링할 resourceIds 목록입니다.
매개 변수 속성
형식: String [ ]
Default value: None 와일드카드 지원: False DontShow: False
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-ResourceGroupName
내보낼 리소스 그룹의 이름을 지정합니다.
매개 변수 속성
형식: String
Default value: None 와일드카드 지원: False DontShow: False 별칭: 리소스 그룹
매개 변수 집합
(All)
Position: Named 필수: True 파이프라인의 값: False 속성 이름별 파이프라인의 값: True 나머지 인수의 값: False
-SkipAllParameterization
모든 매개 변수화를 건너뜁니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-SkipResourceNameParameterization
리소스 이름 매개 변수화를 건너뜁니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요.
cmdlet이 실행되지 않습니다.
매개 변수 속성
형식: SwitchParameter
Default value: False 와일드카드 지원: False DontShow: False 별칭: 위스콘신
매개 변수 집합
(All)
Position: Named 필수: False 파이프라인의 값: False 속성 이름별 파이프라인의 값: False 나머지 인수의 값: False
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters 를 참조하세요.
출력
