다음을 통해 공유


New-AzResourceGroup

Azure 리소스 그룹을 만듭니다.

구문

New-AzResourceGroup
   [-Name] <String>
   [-Location] <String>
   [-Tag <Hashtable>]
   [-Force]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzResourceGroup cmdlet은 Azure 리소스 그룹을 만듭니다. 이름 및 위치만 사용하여 리소스 그룹을 만든 다음 New-AzResource cmdlet을 사용하여 리소스 그룹에 추가할 리소스를 만들 수 있습니다. 기존 리소스 그룹에 배포를 추가하려면 New-AzResourceGroupDeployment cmdlet을 사용합니다. 기존 리소스 그룹에 리소스를 추가하려면 New-AzResource cmdlet을 사용합니다. Azure 리소스는 데이터베이스 서버, 데이터베이스 또는 웹 사이트와 같은 사용자 관리형 Azure 엔터티입니다. Azure 리소스 그룹은 한 단위로 배포되는 Azure 리소스의 컬렉션입니다.

예제

예제 1: 빈 리소스 그룹 만들기

New-AzResourceGroup -Name RG01 -Location "South Central US"

이 명령은 리소스가 없는 리소스 그룹을 만듭니다. New-AzResource 또는 New-AzResourceGroupDeployment cmdlet을 사용하여 이 리소스 그룹에 리소스 및 배포를 추가할 수 있습니다.

예제 2: 위치 매개 변수를 사용하여 빈 리소스 그룹 만들기

New-AzResourceGroup RG01 "South Central US"

이 명령은 리소스가 없는 리소스 그룹을 만듭니다.

예제 3: 태그가 있는 리소스 그룹 만들기

New-AzResourceGroup -Name RG01 -Location "South Central US" -Tag @{Empty=$null; Department="Marketing"}

이 명령은 빈 리소스 그룹을 만듭니다. 이 명령은 리소스 그룹에 태그를 할당한다는 점을 제외하고 예제 1의 명령과 동일합니다. 비어 있는 첫 번째 태그를 사용하여 리소스가 없는 리소스 그룹을 식별할 수 있습니다. 두 번째 태그는 부서라는 이름이 지정되며 마케팅 값이 있습니다. 이 태그와 같은 태그를 사용하여 관리 또는 예산을 위한 리소스 그룹을 분류할 수 있습니다.

매개 변수

-ApiVersion

리소스 공급자가 지원하는 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

-Location

리소스 그룹의 위치를 지정합니다. 미국 서부 또는 동남 아시아 등 Azure 데이터 센터 위치를 지정합니다. 모든 위치에 리소스 그룹을 배치할 수 있습니다. 리소스 그룹은 Azure 구독과 동일한 위치 또는 해당 리소스와 동일한 위치에 있을 필요가 없습니다. 각 리소스 유형을 지원하는 위치를 확인하려면 ProviderNamespace 매개 변수와 함께 Get-AzResourceProvider cmdlet을 사용합니다.

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

-Name

리소스 그룹의 이름을 지정합니다. 리소스 이름은 구독에서 고유해야 합니다. 해당 이름을 가진 리소스 그룹이 이미 있는 경우 명령은 기존 리소스 그룹을 바꾸기 전에 확인 메시지를 표시합니다.

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

-Pre

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

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

-Tag

해시 테이블 형식의 키-값 쌍입니다. 예: @{key0="value0"; key1=$null; key2="value2"} 태그를 추가하거나 변경하려면 리소스 그룹에 대한 태그 컬렉션을 바꿔야 합니다. 리소스 및 그룹에 태그를 할당한 후 Get-AzResource 및 Get-AzResourceGroup의 Tag 매개 변수를 사용하여 태그 이름 또는 이름 및 값으로 리소스 및 그룹을 검색할 수 있습니다. 태그를 사용하여 부서 또는 비용 센터와 같은 리소스를 분류하거나 리소스에 대한 메모 또는 메모를 추적할 수 있습니다. 미리 정의된 태그를 얻으려면 Get-AzTag cmdlet을 사용합니다.

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

-WhatIf

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

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

입력

String

Hashtable

출력

PSResourceGroup