- 최신
- 2026-04-01-미리보기
- 2026-03-01-미리보기
- 2026-01-01-미리보기
- 2025-11-01-미리보기
- 2025-10-10
- 2025-09-01-미리보기
- 2025-08-01-preview
- 2025-04-01-미리보기
- 2025-03-01-미리보기
- 2024-11-01-미리 보기
- 2024-08-08-미리보기
- 2024-04-08-미리 보기
- 2024-04-03
- 2024-03-06-미리 보기
- 2024-01-16-미리보기
- 2023-11-01-미리보기
- 2023-10-04-미리보기
- 2023-09-05
- 2022-10-14-미리보기
- 2022-09-09
- 2022-04-01-미리 보기
- 2022-02-10-미리보기
- 2021-09-03-미리보기
- 2021-07-12
- 2021-04-01-미리 보기
- 2021-03-09-미리보기
- 2021-02-01-미리보기
- 2021-01-14-미리 보기
- 2020-11-10-미리보기
- 2020-11-02-미리 보기
- 2020-10-19-미리보기
- 2020-09-21-미리보기
- 2019-12-10-미리보기
- 2019-09-24-미리 보기
- 2019-01-23-미리보기
Bicep 리소스 정의
applicationGroups 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
사용 예제
Bicep 샘플
Virtual Desktop Application Group을 배포하는 기본 예입니다.
param resourceName string = 'acctest0001'
param location string = 'westus'
resource applicationGroup 'Microsoft.DesktopVirtualization/applicationGroups@2024-04-03' = {
name: '${resourceName}-ag'
location: location
properties: {
applicationGroupType: 'Desktop'
description: ''
friendlyName: ''
hostPoolArmPath: hostPool.id
}
}
resource hostPool 'Microsoft.DesktopVirtualization/hostPools@2024-04-03' = {
name: '${resourceName}-hp'
location: location
properties: {
customRdpProperty: ''
description: ''
friendlyName: ''
hostPoolType: 'Pooled'
loadBalancerType: 'BreadthFirst'
maxSessionLimit: 999999
personalDesktopAssignmentType: ''
preferredAppGroupType: 'Desktop'
publicNetworkAccess: 'Enabled'
startVMOnConnect: false
validationEnvironment: false
vmTemplate: ''
}
}
Azure 확인된 모듈
다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.
Azure 빠른 시작 샘플
다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.
| Bicep 파일 | 묘사 |
|---|---|
| Microsoft Entra ID 조인 사용하여 AVD를 만듭니다. | 이 템플릿을 사용하면 호스트 풀, 애플리케이션 그룹, 작업 영역, 테스트 세션 호스트 및 Microsoft Entra ID 조인을 사용하여 확장과 같은 Azure Virtual Desktop 리소스를 만들 수 있습니다. |
리소스 형식
Microsoft.DesktopVirtualization/applicationGroups 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.DesktopVirtualization/applicationGroups@2026-04-01-preview' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
kind: 'string'
location: 'string'
managedBy: 'string'
name: 'string'
plan: {
name: 'string'
product: 'string'
promotionCode: 'string'
publisher: 'string'
version: 'string'
}
properties: {
applicationGroupType: 'string'
description: 'string'
friendlyName: 'string'
hostPoolArmPath: 'string'
oboTenantId: 'string'
showInFeed: bool
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
속성 값
Microsoft.DesktopVirtualization/애플리케이션그룹
| 이름 | 묘사 | 값 |
|---|---|---|
| 신원 | 이 리소스에 할당된 관리 서비스 ID입니다. | ManagedServiceIdentity |
| 종류 | 포털/도구/등에서 동일한 형식의 리소스에 대해 다른 UX 환경을 렌더링하는 데 사용하는 메타데이터 예를 들어 ApiApps는 일종의 Microsoft.Web/sites 유형입니다. 지원되는 경우 리소스 공급자는 이 값의 유효성을 검사하고 유지해야 합니다. | 문자열 제약 조건: 패턴 = ^[-\w\._,\(\)]+$ |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| 에 의해 관리됨 | 이 리소스를 관리하는 리소스의 정규화된 리소스 ID입니다. 이 리소스가 다른 Azure 리소스에서 관리되는지를 나타냅니다. 이 경우 전체 모드 배포는 다른 리소스에서 관리되므로 템플릿에서 제거된 경우 리소스를 삭제하지 않습니다. | 문자열 |
| 이름 | 리소스 이름 | 문자열 제약 조건: 최소 길이 = 3 최대 길이 = 64 패턴 = ^[A-Za-z0-9@.\-_ ]*$(필수) |
| 계획 | 리소스 계획의 세부 정보입니다. | 계획 |
| 속성 | ApplicationGroup에 대한 자세한 속성 | ApplicationGroupProperties |
| SKU (재고 관리 코드) | 이 리소스에 할당된 SKU(스톡 키핑 단위)입니다. | 스쿠 |
| 태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
ApplicationGroupProperties
| 이름 | 묘사 | 값 |
|---|---|---|
| applicationGroupType | ApplicationGroup의 리소스 종류입니다. | '데스크톱' 'RemoteApp'(필수) |
| 묘사 | ApplicationGroup에 대한 설명입니다. | 문자열 |
| 친근한 이름 | ApplicationGroup의 이름입니다. | 문자열 |
| hostPoolArmPath | ApplicationGroup의 HostPool arm 경로입니다. | string(필수) |
| oboTenantId | 리소스를 대신하여 요청되는 테넌트입니다. | 문자열 |
| 쇼인피드 | applicationGroup이 피드에 표시되는지 여부를 나타내는 부울입니다. | 부울 |
ManagedServiceIdentity (관리형 서비스 ID)
| 이름 | 묘사 | 값 |
|---|---|---|
| 형 | 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). | '없음' '시스템 할당됨' '시스템 할당, 사용자 할당' 'UserAssigned'(필수) |
| userAssignedIdentities | 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| 이름 | 묘사 | 값 |
|---|
계획
| 이름 | 묘사 | 값 |
|---|---|---|
| 이름 | 조달 중인 타사 아티팩트 사용자 정의 이름입니다. | string(필수) |
| 제품 | 조달 중인 타사 아티팩트입니다. 예: NewRelic. 제품은 데이터 시장 온보딩 시 아티팩트용으로 지정된 OfferID에 매핑됩니다. | string(필수) |
| 프로모션 코드 | 게시자는 데이터 마켓에서 프로비전된 제품/아티팩트를 위한 프로모션 코드를 제공했습니다. | 문자열 |
| 게시자 | 구입 중인 타사 아티팩트 게시자입니다. 예: NewRelic | string(필수) |
| 버전 | 원하는 제품/아티팩트 버전입니다. | 문자열 |
SKU (재고 관리 코드)
| 이름 | 묘사 | 값 |
|---|---|---|
| 용량 | SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. | 정수 (int) |
| 가족 | 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. | 문자열 |
| 이름 | SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. | string(필수) |
| 크기 | SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. | 문자열 |
| 계층 | 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. | '기본' '무료' '프리미엄' '표준' |
TrackedResource태그
| 이름 | 묘사 | 값 |
|---|
사용자 할당 ID
| 이름 | 묘사 | 값 |
|---|
ARM 템플릿 리소스 정의
applicationGroups 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 어를 참조하세요. 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
사용 예제
Azure 빠른 시작 템플릿
다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.
| 템플렛 | 묘사 |
|---|---|
|
Microsoft Entra ID 조인 사용하여 AVD를 만듭니다. Azure 배포 |
이 템플릿을 사용하면 호스트 풀, 애플리케이션 그룹, 작업 영역, 테스트 세션 호스트 및 Microsoft Entra ID 조인을 사용하여 확장과 같은 Azure Virtual Desktop 리소스를 만들 수 있습니다. |
리소스 형식
Microsoft.DesktopVirtualization/applicationGroups 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.DesktopVirtualization/applicationGroups",
"apiVersion": "2026-04-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"kind": "string",
"location": "string",
"managedBy": "string",
"plan": {
"name": "string",
"product": "string",
"promotionCode": "string",
"publisher": "string",
"version": "string"
},
"properties": {
"applicationGroupType": "string",
"description": "string",
"friendlyName": "string",
"hostPoolArmPath": "string",
"oboTenantId": "string",
"showInFeed": "bool"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
속성 값
Microsoft.DesktopVirtualization/애플리케이션그룹
| 이름 | 묘사 | 값 |
|---|---|---|
| API버전 | api 버전 | '2026-04-01-미리보기 |
| 신원 | 이 리소스에 할당된 관리 서비스 ID입니다. | ManagedServiceIdentity |
| 종류 | 포털/도구/등에서 동일한 형식의 리소스에 대해 다른 UX 환경을 렌더링하는 데 사용하는 메타데이터 예를 들어 ApiApps는 일종의 Microsoft.Web/sites 유형입니다. 지원되는 경우 리소스 공급자는 이 값의 유효성을 검사하고 유지해야 합니다. | 문자열 제약 조건: 패턴 = ^[-\w\._,\(\)]+$ |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| 에 의해 관리됨 | 이 리소스를 관리하는 리소스의 정규화된 리소스 ID입니다. 이 리소스가 다른 Azure 리소스에서 관리되는지를 나타냅니다. 이 경우 전체 모드 배포는 다른 리소스에서 관리되므로 템플릿에서 제거된 경우 리소스를 삭제하지 않습니다. | 문자열 |
| 이름 | 리소스 이름 | 문자열 제약 조건: 최소 길이 = 3 최대 길이 = 64 패턴 = ^[A-Za-z0-9@.\-_ ]*$(필수) |
| 계획 | 리소스 계획의 세부 정보입니다. | 계획 |
| 속성 | ApplicationGroup에 대한 자세한 속성 | ApplicationGroupProperties |
| SKU (재고 관리 코드) | 이 리소스에 할당된 SKU(스톡 키핑 단위)입니다. | 스쿠 |
| 태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
| 형 | 리소스 종류 | 'Microsoft.DesktopVirtualization/애플리케이션 그룹' |
ApplicationGroupProperties
| 이름 | 묘사 | 값 |
|---|---|---|
| applicationGroupType | ApplicationGroup의 리소스 종류입니다. | '데스크톱' 'RemoteApp'(필수) |
| 묘사 | ApplicationGroup에 대한 설명입니다. | 문자열 |
| 친근한 이름 | ApplicationGroup의 이름입니다. | 문자열 |
| hostPoolArmPath | ApplicationGroup의 HostPool arm 경로입니다. | string(필수) |
| oboTenantId | 리소스를 대신하여 요청되는 테넌트입니다. | 문자열 |
| 쇼인피드 | applicationGroup이 피드에 표시되는지 여부를 나타내는 부울입니다. | 부울 |
ManagedServiceIdentity (관리형 서비스 ID)
| 이름 | 묘사 | 값 |
|---|---|---|
| 형 | 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). | '없음' '시스템 할당됨' '시스템 할당, 사용자 할당' 'UserAssigned'(필수) |
| userAssignedIdentities | 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| 이름 | 묘사 | 값 |
|---|
계획
| 이름 | 묘사 | 값 |
|---|---|---|
| 이름 | 조달 중인 타사 아티팩트 사용자 정의 이름입니다. | string(필수) |
| 제품 | 조달 중인 타사 아티팩트입니다. 예: NewRelic. 제품은 데이터 시장 온보딩 시 아티팩트용으로 지정된 OfferID에 매핑됩니다. | string(필수) |
| 프로모션 코드 | 게시자는 데이터 마켓에서 프로비전된 제품/아티팩트를 위한 프로모션 코드를 제공했습니다. | 문자열 |
| 게시자 | 구입 중인 타사 아티팩트 게시자입니다. 예: NewRelic | string(필수) |
| 버전 | 원하는 제품/아티팩트 버전입니다. | 문자열 |
SKU (재고 관리 코드)
| 이름 | 묘사 | 값 |
|---|---|---|
| 용량 | SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. | 정수 (int) |
| 가족 | 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. | 문자열 |
| 이름 | SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. | string(필수) |
| 크기 | SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. | 문자열 |
| 계층 | 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. | '기본' '무료' '프리미엄' '표준' |
TrackedResource태그
| 이름 | 묘사 | 값 |
|---|
사용자 할당 ID
| 이름 | 묘사 | 값 |
|---|
Terraform(AzAPI 공급자) 리소스 정의
applicationGroups 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 자원 그룹 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
사용 예제
Terraform 샘플
Virtual Desktop Application Group을 배포하는 기본 예입니다.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westus"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "hostPool" {
type = "Microsoft.DesktopVirtualization/hostPools@2024-04-03"
parent_id = azapi_resource.resourceGroup.id
name = "${var.resource_name}-hp"
location = var.location
body = {
properties = {
customRdpProperty = ""
description = ""
friendlyName = ""
hostPoolType = "Pooled"
loadBalancerType = "BreadthFirst"
maxSessionLimit = 999999
personalDesktopAssignmentType = ""
preferredAppGroupType = "Desktop"
publicNetworkAccess = "Enabled"
startVMOnConnect = false
validationEnvironment = false
vmTemplate = ""
}
}
}
resource "azapi_resource" "applicationGroup" {
type = "Microsoft.DesktopVirtualization/applicationGroups@2024-04-03"
parent_id = azapi_resource.resourceGroup.id
name = "${var.resource_name}-ag"
location = var.location
body = {
properties = {
applicationGroupType = "Desktop"
description = ""
friendlyName = ""
hostPoolArmPath = azapi_resource.hostPool.id
}
}
}
Azure 확인된 모듈
다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.
리소스 형식
Microsoft.DesktopVirtualization/applicationGroups 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DesktopVirtualization/applicationGroups@2026-04-01-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
kind = "string"
managedBy = "string"
plan = {
name = "string"
product = "string"
promotionCode = "string"
publisher = "string"
version = "string"
}
properties = {
applicationGroupType = "string"
description = "string"
friendlyName = "string"
hostPoolArmPath = "string"
oboTenantId = "string"
showInFeed = bool
}
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
}
}
속성 값
Microsoft.DesktopVirtualization/애플리케이션그룹
| 이름 | 묘사 | 값 |
|---|---|---|
| 신원 | 이 리소스에 할당된 관리 서비스 ID입니다. | ManagedServiceIdentity |
| 종류 | 포털/도구/등에서 동일한 형식의 리소스에 대해 다른 UX 환경을 렌더링하는 데 사용하는 메타데이터 예를 들어 ApiApps는 일종의 Microsoft.Web/sites 유형입니다. 지원되는 경우 리소스 공급자는 이 값의 유효성을 검사하고 유지해야 합니다. | 문자열 제약 조건: 패턴 = ^[-\w\._,\(\)]+$ |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| 에 의해 관리됨 | 이 리소스를 관리하는 리소스의 정규화된 리소스 ID입니다. 이 리소스가 다른 Azure 리소스에서 관리되는지를 나타냅니다. 이 경우 전체 모드 배포는 다른 리소스에서 관리되므로 템플릿에서 제거된 경우 리소스를 삭제하지 않습니다. | 문자열 |
| 이름 | 리소스 이름 | 문자열 제약 조건: 최소 길이 = 3 최대 길이 = 64 패턴 = ^[A-Za-z0-9@.\-_ ]*$(필수) |
| 계획 | 리소스 계획의 세부 정보입니다. | 계획 |
| 속성 | ApplicationGroup에 대한 자세한 속성 | ApplicationGroupProperties |
| SKU (재고 관리 코드) | 이 리소스에 할당된 SKU(스톡 키핑 단위)입니다. | 스쿠 |
| 태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. |
| 형 | 리소스 종류 | "Microsoft. DesktopVirtualization/applicationGroups@2026-04-01-preview" |
ApplicationGroupProperties
| 이름 | 묘사 | 값 |
|---|---|---|
| applicationGroupType | ApplicationGroup의 리소스 종류입니다. | '데스크톱' 'RemoteApp'(필수) |
| 묘사 | ApplicationGroup에 대한 설명입니다. | 문자열 |
| 친근한 이름 | ApplicationGroup의 이름입니다. | 문자열 |
| hostPoolArmPath | ApplicationGroup의 HostPool arm 경로입니다. | string(필수) |
| oboTenantId | 리소스를 대신하여 요청되는 테넌트입니다. | 문자열 |
| 쇼인피드 | applicationGroup이 피드에 표시되는지 여부를 나타내는 부울입니다. | 부울 |
ManagedServiceIdentity (관리형 서비스 ID)
| 이름 | 묘사 | 값 |
|---|---|---|
| 형 | 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). | '없음' '시스템 할당됨' '시스템 할당, 사용자 할당' 'UserAssigned'(필수) |
| userAssignedIdentities | 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| 이름 | 묘사 | 값 |
|---|
계획
| 이름 | 묘사 | 값 |
|---|---|---|
| 이름 | 조달 중인 타사 아티팩트 사용자 정의 이름입니다. | string(필수) |
| 제품 | 조달 중인 타사 아티팩트입니다. 예: NewRelic. 제품은 데이터 시장 온보딩 시 아티팩트용으로 지정된 OfferID에 매핑됩니다. | string(필수) |
| 프로모션 코드 | 게시자는 데이터 마켓에서 프로비전된 제품/아티팩트를 위한 프로모션 코드를 제공했습니다. | 문자열 |
| 게시자 | 구입 중인 타사 아티팩트 게시자입니다. 예: NewRelic | string(필수) |
| 버전 | 원하는 제품/아티팩트 버전입니다. | 문자열 |
SKU (재고 관리 코드)
| 이름 | 묘사 | 값 |
|---|---|---|
| 용량 | SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. | 정수 (int) |
| 가족 | 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. | 문자열 |
| 이름 | SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. | string(필수) |
| 크기 | SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. | 문자열 |
| 계층 | 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. | '기본' '무료' '프리미엄' '표준' |
TrackedResource태그
| 이름 | 묘사 | 값 |
|---|
사용자 할당 ID
| 이름 | 묘사 | 값 |
|---|