다음을 통해 공유


New-AzResourceGroup

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

구문

Default (기본값)

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
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

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Location

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:1
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Name

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:ResourceGroupName

매개 변수 집합

(All)
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Pre

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Tag

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

매개 변수 속성

형식:Hashtable
Default value:None
와일드카드 지원:False
DontShow:False
별칭:태그들

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값: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를 참조하세요.

입력

String

Hashtable

출력

PSResourceGroup