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 |