Export-AzResourceGroup

모듈:

Az.Resources

리소스 그룹을 템플릿으로 캡처하고 파일에 저장합니다.

구문

Export-AzResourceGroup
      -ResourceGroupName <String>
      [-Path <String>]
      [-IncludeParameterDefaultValue]
      [-IncludeComments]
      [-SkipResourceNameParameterization]
      [-SkipAllParameterization]
      [-Resource <String[]>]
      [-Force]
      [-ApiVersion <String>]
      [-Pre]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Export-AzResourceGroup cmdlet은 지정된 리소스 그룹을 템플릿으로 캡처하고 JSON 파일에 저장합니다. 이는 리소스 그룹에서 일부 리소스를 이미 만든 다음 템플릿 지원 배포를 사용하는 이점을 활용하려는 시나리오에서 유용할 수 있습니다. 이 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 파일에 저장합니다. 생성된 템플릿에는 생성된 매개 변수가 포함되지 않습니다.

매개 변수

-ApiVersion

사용할 리소스 공급자 API의 버전을 지정합니다. 지정하지 않으면 최신 API 버전이 사용됩니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-DefaultProfile

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

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

-Force

사용자 확인을 요청하지 않고 명령을 강제 실행합니다.

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

-IncludeComments

이 작업이 주석을 사용하여 템플릿을 내보낸다는 것을 나타냅니다.

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

-IncludeParameterDefaultValue

이 작업은 기본값을 사용하여 템플릿 매개 변수를 내보냅니다.

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

-Path

템플릿 파일의 출력 경로를 지정합니다.

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

-Pre

이 cmdlet은 사용할 API 버전을 자동으로 결정할 때 시험판 API 버전을 사용한다는 것을 나타냅니다.

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

-Resource

결과를 필터링할 resourceIds 목록입니다.

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

-ResourceGroupName

내보낼 리소스 그룹의 이름을 지정합니다.

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

-SkipAllParameterization

모든 매개 변수화를 건너뜁니다.

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

-SkipResourceNameParameterization

리소스 이름 매개 변수화를 건너뜁니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

String

출력

PSObject

관련 링크

• Get-AzResourceGroup