- 최신
- 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 리소스 정의
hostPools 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
사용 예제
Azure 확인된 모듈
다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.
Azure 빠른 시작 샘플
다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.
| Bicep 파일 | 묘사 |
|---|---|
| Microsoft Entra ID 조인 사용하여 AVD를 만듭니다. | 이 템플릿을 사용하면 호스트 풀, 애플리케이션 그룹, 작업 영역, 테스트 세션 호스트 및 Microsoft Entra ID 조인을 사용하여 확장과 같은 Azure Virtual Desktop 리소스를 만들 수 있습니다. |
리소스 형식
Microsoft.DesktopVirtualization/hostPools 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.DesktopVirtualization/hostPools@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: {
agentUpdate: {
maintenanceWindows: [
{
dayOfWeek: 'string'
hour: int
}
]
maintenanceWindowTimeZone: 'string'
type: 'string'
useSessionHostLocalTime: bool
}
allowRDPShortPathWithPrivateLink: 'string'
conditionalRdpProperty: 'string'
customRdpProperty: 'string'
deploymentScope: 'string'
description: 'string'
directUDP: 'string'
friendlyName: 'string'
hostPoolType: 'string'
loadBalancerType: 'string'
managedPrivateUDP: 'string'
managementType: 'string'
maxSessionLimit: int
oboTenantId: 'string'
personalDesktopAssignmentType: 'string'
preferredAppGroupType: 'string'
publicNetworkAccess: 'string'
publicUDP: 'string'
registrationInfo: {
expirationTime: 'string'
registrationTokenOperation: 'string'
token: 'string'
}
relayUDP: 'string'
ring: int
ssoadfsAuthority: 'string'
ssoClientId: 'string'
ssoClientSecretKeyVaultPath: 'string'
ssoSecretType: 'string'
startVMOnConnect: bool
validationEnvironment: bool
vmTemplate: 'string'
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
속성 값
Microsoft.DesktopVirtualization/hostPools
| 이름 | 묘사 | 값 |
|---|---|---|
| 신원 | 이 리소스에 할당된 관리 서비스 ID입니다. | ManagedServiceIdentity |
| 종류 | 포털/도구/등에서 동일한 형식의 리소스에 대해 다른 UX 환경을 렌더링하는 데 사용하는 메타데이터 예를 들어 ApiApps는 일종의 Microsoft.Web/sites 유형입니다. 지원되는 경우 리소스 공급자는 이 값의 유효성을 검사하고 유지해야 합니다. | 문자열 제약 조건: 패턴 = ^[-\w\._,\(\)]+$ |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| 에 의해 관리됨 | 이 리소스를 관리하는 리소스의 정규화된 리소스 ID입니다. 이 리소스가 다른 Azure 리소스에서 관리되는지를 나타냅니다. 이 경우 전체 모드 배포는 다른 리소스에서 관리되므로 템플릿에서 제거된 경우 리소스를 삭제하지 않습니다. | 문자열 |
| 이름 | 리소스 이름 | 문자열 제약 조건: 최소 길이 = 3 최대 길이 = 64 패턴 = ^[A-Za-z0-9@.\-_ ]*$(필수) |
| 계획 | 리소스 계획의 세부 정보입니다. | 계획 |
| 속성 | HostPool에 대한 자세한 속성 | HostPoolProperties(필수) |
| SKU (재고 관리 코드) | 이 리소스에 할당된 SKU(스톡 키핑 단위)입니다. | 스쿠 |
| 태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
에이전트업데이트프로퍼티
| 이름 | 묘사 | 값 |
|---|---|---|
| 유지 관리Windows | 유지 관리 기간 목록입니다. 유지 관리 기간은 2시간입니다. | 유지 보수 창 속성[] |
| 유지 관리WindowTimeZone | /dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0에 정의된 유지 관리를 위한 표준 시간대입니다. useLocalTime이 true이면 설정해야 합니다. | 문자열 |
| 형 | 세션 호스트 구성 요소에 대한 유지 관리 유형입니다. | '기본값' '예정됨' |
| useSessionHostLocalTime | 가상 머신의 localTime을 사용할지 여부입니다. | 부울 |
HostPoolProperties
| 이름 | 묘사 | 값 |
|---|---|---|
| 에이전트업데이트 | 에이전트, 모니터링 에이전트 및 스택 구성 요소를 업데이트하기 위한 세션 호스트 구성입니다. | 에이전트업데이트프로퍼티 |
| allowRDPShortPathWithPrivateLink | RDPShortPath 전송의 사용이 허용되는지 여부를 제어하여 Private Link 경로를 우회할 수 있습니다. | '사용 안 함' '사용' |
| 조건형 RdpProperty | 호스트 풀의 조건부 RDP 속성은 .의 형식으로 <rdpPropertyName>:<type>:<value>:<conditionType>:<conditionValue>문자열로 직렬화되었습니다. |
문자열 |
| customRdpProperty를 참조하십시오. | HostPool의 사용자 지정 rdp 속성입니다. | 문자열 |
| 배포 범위 | DeploymentScope 형식입니다. | '지리적' '지역' |
| 묘사 | HostPool에 대한 설명입니다. | 문자열 |
| 다이렉트UDP | 기본값: AVD 전체 설정은 연결 가용성을 확인하는 데 사용됩니다. 사용: UDP는 연결을 만들 때 이 연결 유형을 시도합니다. 즉, 이 연결 형식을 방지할 수 있는 다른 요소가 있으므로 이 연결이 가능하지만 보장되지는 않습니다. 사용 안 함: UDP는 연결을 만들 때 이 연결 형식을 시도하지 않습니다. | '기본값' '사용 안 함' '사용' |
| 친근한 이름 | HostPool의 이름입니다. | 문자열 |
| hostPoolType입니다 | 데스크톱용 HostPool 유형입니다. | 'BYODesktop' '개인' 'Pooled'(필수) |
| 로드 밸런서 유형 | 부하 분산 장치의 유형입니다. | '너비 우선' '뎁스퍼스트' '다중 퍼시스턴트' '영구적'(필수) |
| 관리비공개UDP | 기본값: AVD 전체 설정은 연결 가용성을 확인하는 데 사용됩니다. 사용: UDP는 연결을 만들 때 이 연결 유형을 시도합니다. 즉, 이 연결 형식을 방지할 수 있는 다른 요소가 있으므로 이 연결이 가능하지만 보장되지는 않습니다. 사용 안 함: UDP는 연결을 만들 때 이 연결 형식을 시도하지 않습니다. | '기본값' '사용 안 함' '사용' |
| 관리 유형 | 이 hostpool, Automated 또는 Standard에 대한 관리 유형입니다. 기본값은 Automated입니다. | '자동화됨' '표준' |
| maxSessionLimit | HostPool의 최대 세션 제한입니다. | 정수 (int) |
| oboTenantId | 리소스를 대신하여 요청되는 테넌트입니다. | 문자열 |
| personalDesktopAssignmentType | HostPool의 PersonalDesktopAssignment 유형입니다. | '자동' '직접' |
| preferredAppGroupType | 기본 설정 애플리케이션 그룹 유형으로, 기본값은 데스크톱 애플리케이션 그룹입니다. | '데스크톱' '없음' 'RailApplications'(필수) |
| 공공 네트워크 접근 | 사용하도록 설정하면 공용 네트워크와 프라이빗 네트워크 모두에서 이 리소스에 액세스할 수 있습니다. 사용 안 함에서는 이 리소스를 프라이빗 엔드포인트를 통해서만 액세스할 수 있습니다. | '사용 안 함' '사용' 'EnabledForClientsOnly' 'EnabledForSessionHostsOnly' |
| 퍼블릭UDP | 기본값: AVD 전체 설정은 연결 가용성을 확인하는 데 사용됩니다. 사용: UDP는 연결을 만들 때 이 연결 유형을 시도합니다. 즉, 이 연결 형식을 방지할 수 있는 다른 요소가 있으므로 이 연결이 가능하지만 보장되지는 않습니다. 사용 안 함: UDP는 연결을 만들 때 이 연결 형식을 시도하지 않습니다. | '기본값' '사용 안 함' '사용' |
| 등록 정보 | HostPool의 등록 정보입니다. | 등록 정보 |
| 릴레이UDP | 기본값: AVD 전체 설정은 연결 가용성을 확인하는 데 사용됩니다. 사용: UDP는 연결을 만들 때 이 연결 유형을 시도합니다. 즉, 이 연결 형식을 방지할 수 있는 다른 요소가 있으므로 이 연결이 가능하지만 보장되지는 않습니다. 사용 안 함: UDP는 연결을 만들 때 이 연결 형식을 시도하지 않습니다. | '기본값' '사용 안 함' '사용' |
| 반지 | HostPool의 링 번호입니다. | 정수 (int) |
| ssoadfs권한 | WVD SSO 인증서에 서명하기 위한 고객 ADFS 서버에 대한 URL입니다. | 문자열 |
| ssoClientId | WVD SSO 인증서를 발급하는 데 사용되는 등록된 신뢰 당사자에 대한 ClientId입니다. | 문자열 |
| ssoClientSecretKeyVaultPath | ADFS에 대한 통신에 사용되는 비밀을 저장하는 Azure KeyVault 경로입니다. | 문자열 |
| ssoSecretType | Single Sign-On 비밀 형식의 형식입니다. | '인증서' 'CertificateInKeyVault' '공유 키' 'SharedKeyInKeyVault' |
| startVMOnConnect | StartVMOnConnect 기능을 설정/해제할 플래그입니다. | 부울 |
| 유효성 검사 환경 | 유효성 검사 환경입니다. | 부울 |
| vm템플릿 | hostpool 내에서 sessionhosts 구성을 위한 VM 템플릿입니다. | 문자열 |
유지 보수 창 속성
| 이름 | 묘사 | 값 |
|---|---|---|
| 요일의주 | 요일입니다. | '금요일' '월요일' '토요일' '일요일' '목요일' '화요일' '수요일' |
| 시 | 하루의 업데이트 시작 시간입니다. (0 - 23) | 정수 (int) |
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(필수) |
| 버전 | 원하는 제품/아티팩트 버전입니다. | 문자열 |
등록 정보
| 이름 | 묘사 | 값 |
|---|---|---|
| 만료 시간 | 등록 토큰의 만료 시간입니다. | 문자열 |
| registrationTokenOperation | 토큰을 다시 설정하는 형식입니다. | '삭제' '없음' '업데이트' |
| 토큰 | 등록 토큰 base64로 인코딩된 문자열입니다. | 문자열 |
SKU (재고 관리 코드)
| 이름 | 묘사 | 값 |
|---|---|---|
| 용량 | SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. | 정수 (int) |
| 가족 | 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. | 문자열 |
| 이름 | SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. | string(필수) |
| 크기 | SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. | 문자열 |
| 계층 | 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. | '기본' '무료' '프리미엄' '표준' |
TrackedResource태그
| 이름 | 묘사 | 값 |
|---|
사용자 할당 ID
| 이름 | 묘사 | 값 |
|---|
ARM 템플릿 리소스 정의
hostPools 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 어를 참조하세요. 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
사용 예제
Azure 빠른 시작 템플릿
다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.
| 템플렛 | 묘사 |
|---|---|
|
Microsoft Entra ID 조인 사용하여 AVD를 만듭니다. Azure 배포 |
이 템플릿을 사용하면 호스트 풀, 애플리케이션 그룹, 작업 영역, 테스트 세션 호스트 및 Microsoft Entra ID 조인을 사용하여 확장과 같은 Azure Virtual Desktop 리소스를 만들 수 있습니다. |
리소스 형식
Microsoft.DesktopVirtualization/hostPools 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.DesktopVirtualization/hostPools",
"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": {
"agentUpdate": {
"maintenanceWindows": [
{
"dayOfWeek": "string",
"hour": "int"
}
],
"maintenanceWindowTimeZone": "string",
"type": "string",
"useSessionHostLocalTime": "bool"
},
"allowRDPShortPathWithPrivateLink": "string",
"conditionalRdpProperty": "string",
"customRdpProperty": "string",
"deploymentScope": "string",
"description": "string",
"directUDP": "string",
"friendlyName": "string",
"hostPoolType": "string",
"loadBalancerType": "string",
"managedPrivateUDP": "string",
"managementType": "string",
"maxSessionLimit": "int",
"oboTenantId": "string",
"personalDesktopAssignmentType": "string",
"preferredAppGroupType": "string",
"publicNetworkAccess": "string",
"publicUDP": "string",
"registrationInfo": {
"expirationTime": "string",
"registrationTokenOperation": "string",
"token": "string"
},
"relayUDP": "string",
"ring": "int",
"ssoadfsAuthority": "string",
"ssoClientId": "string",
"ssoClientSecretKeyVaultPath": "string",
"ssoSecretType": "string",
"startVMOnConnect": "bool",
"validationEnvironment": "bool",
"vmTemplate": "string"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
속성 값
Microsoft.DesktopVirtualization/hostPools
| 이름 | 묘사 | 값 |
|---|---|---|
| API버전 | api 버전 | '2026-04-01-미리보기 |
| 신원 | 이 리소스에 할당된 관리 서비스 ID입니다. | ManagedServiceIdentity |
| 종류 | 포털/도구/등에서 동일한 형식의 리소스에 대해 다른 UX 환경을 렌더링하는 데 사용하는 메타데이터 예를 들어 ApiApps는 일종의 Microsoft.Web/sites 유형입니다. 지원되는 경우 리소스 공급자는 이 값의 유효성을 검사하고 유지해야 합니다. | 문자열 제약 조건: 패턴 = ^[-\w\._,\(\)]+$ |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| 에 의해 관리됨 | 이 리소스를 관리하는 리소스의 정규화된 리소스 ID입니다. 이 리소스가 다른 Azure 리소스에서 관리되는지를 나타냅니다. 이 경우 전체 모드 배포는 다른 리소스에서 관리되므로 템플릿에서 제거된 경우 리소스를 삭제하지 않습니다. | 문자열 |
| 이름 | 리소스 이름 | 문자열 제약 조건: 최소 길이 = 3 최대 길이 = 64 패턴 = ^[A-Za-z0-9@.\-_ ]*$(필수) |
| 계획 | 리소스 계획의 세부 정보입니다. | 계획 |
| 속성 | HostPool에 대한 자세한 속성 | HostPoolProperties(필수) |
| SKU (재고 관리 코드) | 이 리소스에 할당된 SKU(스톡 키핑 단위)입니다. | 스쿠 |
| 태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
| 형 | 리소스 종류 | 'Microsoft.DesktopVirtualization/hostPools' |
에이전트업데이트프로퍼티
| 이름 | 묘사 | 값 |
|---|---|---|
| 유지 관리Windows | 유지 관리 기간 목록입니다. 유지 관리 기간은 2시간입니다. | 유지 보수 창 속성[] |
| 유지 관리WindowTimeZone | /dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0에 정의된 유지 관리를 위한 표준 시간대입니다. useLocalTime이 true이면 설정해야 합니다. | 문자열 |
| 형 | 세션 호스트 구성 요소에 대한 유지 관리 유형입니다. | '기본값' '예정됨' |
| useSessionHostLocalTime | 가상 머신의 localTime을 사용할지 여부입니다. | 부울 |
HostPoolProperties
| 이름 | 묘사 | 값 |
|---|---|---|
| 에이전트업데이트 | 에이전트, 모니터링 에이전트 및 스택 구성 요소를 업데이트하기 위한 세션 호스트 구성입니다. | 에이전트업데이트프로퍼티 |
| allowRDPShortPathWithPrivateLink | RDPShortPath 전송의 사용이 허용되는지 여부를 제어하여 Private Link 경로를 우회할 수 있습니다. | '사용 안 함' '사용' |
| 조건형 RdpProperty | 호스트 풀의 조건부 RDP 속성은 .의 형식으로 <rdpPropertyName>:<type>:<value>:<conditionType>:<conditionValue>문자열로 직렬화되었습니다. |
문자열 |
| customRdpProperty를 참조하십시오. | HostPool의 사용자 지정 rdp 속성입니다. | 문자열 |
| 배포 범위 | DeploymentScope 형식입니다. | '지리적' '지역' |
| 묘사 | HostPool에 대한 설명입니다. | 문자열 |
| 다이렉트UDP | 기본값: AVD 전체 설정은 연결 가용성을 확인하는 데 사용됩니다. 사용: UDP는 연결을 만들 때 이 연결 유형을 시도합니다. 즉, 이 연결 형식을 방지할 수 있는 다른 요소가 있으므로 이 연결이 가능하지만 보장되지는 않습니다. 사용 안 함: UDP는 연결을 만들 때 이 연결 형식을 시도하지 않습니다. | '기본값' '사용 안 함' '사용' |
| 친근한 이름 | HostPool의 이름입니다. | 문자열 |
| hostPoolType입니다 | 데스크톱용 HostPool 유형입니다. | 'BYODesktop' '개인' 'Pooled'(필수) |
| 로드 밸런서 유형 | 부하 분산 장치의 유형입니다. | '너비 우선' '뎁스퍼스트' '다중 퍼시스턴트' '영구적'(필수) |
| 관리비공개UDP | 기본값: AVD 전체 설정은 연결 가용성을 확인하는 데 사용됩니다. 사용: UDP는 연결을 만들 때 이 연결 유형을 시도합니다. 즉, 이 연결 형식을 방지할 수 있는 다른 요소가 있으므로 이 연결이 가능하지만 보장되지는 않습니다. 사용 안 함: UDP는 연결을 만들 때 이 연결 형식을 시도하지 않습니다. | '기본값' '사용 안 함' '사용' |
| 관리 유형 | 이 hostpool, Automated 또는 Standard에 대한 관리 유형입니다. 기본값은 Automated입니다. | '자동화됨' '표준' |
| maxSessionLimit | HostPool의 최대 세션 제한입니다. | 정수 (int) |
| oboTenantId | 리소스를 대신하여 요청되는 테넌트입니다. | 문자열 |
| personalDesktopAssignmentType | HostPool의 PersonalDesktopAssignment 유형입니다. | '자동' '직접' |
| preferredAppGroupType | 기본 설정 애플리케이션 그룹 유형으로, 기본값은 데스크톱 애플리케이션 그룹입니다. | '데스크톱' '없음' 'RailApplications'(필수) |
| 공공 네트워크 접근 | 사용하도록 설정하면 공용 네트워크와 프라이빗 네트워크 모두에서 이 리소스에 액세스할 수 있습니다. 사용 안 함에서는 이 리소스를 프라이빗 엔드포인트를 통해서만 액세스할 수 있습니다. | '사용 안 함' '사용' 'EnabledForClientsOnly' 'EnabledForSessionHostsOnly' |
| 퍼블릭UDP | 기본값: AVD 전체 설정은 연결 가용성을 확인하는 데 사용됩니다. 사용: UDP는 연결을 만들 때 이 연결 유형을 시도합니다. 즉, 이 연결 형식을 방지할 수 있는 다른 요소가 있으므로 이 연결이 가능하지만 보장되지는 않습니다. 사용 안 함: UDP는 연결을 만들 때 이 연결 형식을 시도하지 않습니다. | '기본값' '사용 안 함' '사용' |
| 등록 정보 | HostPool의 등록 정보입니다. | 등록 정보 |
| 릴레이UDP | 기본값: AVD 전체 설정은 연결 가용성을 확인하는 데 사용됩니다. 사용: UDP는 연결을 만들 때 이 연결 유형을 시도합니다. 즉, 이 연결 형식을 방지할 수 있는 다른 요소가 있으므로 이 연결이 가능하지만 보장되지는 않습니다. 사용 안 함: UDP는 연결을 만들 때 이 연결 형식을 시도하지 않습니다. | '기본값' '사용 안 함' '사용' |
| 반지 | HostPool의 링 번호입니다. | 정수 (int) |
| ssoadfs권한 | WVD SSO 인증서에 서명하기 위한 고객 ADFS 서버에 대한 URL입니다. | 문자열 |
| ssoClientId | WVD SSO 인증서를 발급하는 데 사용되는 등록된 신뢰 당사자에 대한 ClientId입니다. | 문자열 |
| ssoClientSecretKeyVaultPath | ADFS에 대한 통신에 사용되는 비밀을 저장하는 Azure KeyVault 경로입니다. | 문자열 |
| ssoSecretType | Single Sign-On 비밀 형식의 형식입니다. | '인증서' 'CertificateInKeyVault' '공유 키' 'SharedKeyInKeyVault' |
| startVMOnConnect | StartVMOnConnect 기능을 설정/해제할 플래그입니다. | 부울 |
| 유효성 검사 환경 | 유효성 검사 환경입니다. | 부울 |
| vm템플릿 | hostpool 내에서 sessionhosts 구성을 위한 VM 템플릿입니다. | 문자열 |
유지 보수 창 속성
| 이름 | 묘사 | 값 |
|---|---|---|
| 요일의주 | 요일입니다. | '금요일' '월요일' '토요일' '일요일' '목요일' '화요일' '수요일' |
| 시 | 하루의 업데이트 시작 시간입니다. (0 - 23) | 정수 (int) |
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(필수) |
| 버전 | 원하는 제품/아티팩트 버전입니다. | 문자열 |
등록 정보
| 이름 | 묘사 | 값 |
|---|---|---|
| 만료 시간 | 등록 토큰의 만료 시간입니다. | 문자열 |
| registrationTokenOperation | 토큰을 다시 설정하는 형식입니다. | '삭제' '없음' '업데이트' |
| 토큰 | 등록 토큰 base64로 인코딩된 문자열입니다. | 문자열 |
SKU (재고 관리 코드)
| 이름 | 묘사 | 값 |
|---|---|---|
| 용량 | SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. | 정수 (int) |
| 가족 | 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. | 문자열 |
| 이름 | SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. | string(필수) |
| 크기 | SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. | 문자열 |
| 계층 | 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. | '기본' '무료' '프리미엄' '표준' |
TrackedResource태그
| 이름 | 묘사 | 값 |
|---|
사용자 할당 ID
| 이름 | 묘사 | 값 |
|---|
Terraform(AzAPI 공급자) 리소스 정의
hostPools 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 자원 그룹 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
사용 예제
Azure 확인된 모듈
다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.
리소스 형식
Microsoft.DesktopVirtualization/hostPools 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DesktopVirtualization/hostPools@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 = {
agentUpdate = {
maintenanceWindows = [
{
dayOfWeek = "string"
hour = int
}
]
maintenanceWindowTimeZone = "string"
type = "string"
useSessionHostLocalTime = bool
}
allowRDPShortPathWithPrivateLink = "string"
conditionalRdpProperty = "string"
customRdpProperty = "string"
deploymentScope = "string"
description = "string"
directUDP = "string"
friendlyName = "string"
hostPoolType = "string"
loadBalancerType = "string"
managedPrivateUDP = "string"
managementType = "string"
maxSessionLimit = int
oboTenantId = "string"
personalDesktopAssignmentType = "string"
preferredAppGroupType = "string"
publicNetworkAccess = "string"
publicUDP = "string"
registrationInfo = {
expirationTime = "string"
registrationTokenOperation = "string"
token = "string"
}
relayUDP = "string"
ring = int
ssoadfsAuthority = "string"
ssoClientId = "string"
ssoClientSecretKeyVaultPath = "string"
ssoSecretType = "string"
startVMOnConnect = bool
validationEnvironment = bool
vmTemplate = "string"
}
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
}
}
속성 값
Microsoft.DesktopVirtualization/hostPools
| 이름 | 묘사 | 값 |
|---|---|---|
| 신원 | 이 리소스에 할당된 관리 서비스 ID입니다. | ManagedServiceIdentity |
| 종류 | 포털/도구/등에서 동일한 형식의 리소스에 대해 다른 UX 환경을 렌더링하는 데 사용하는 메타데이터 예를 들어 ApiApps는 일종의 Microsoft.Web/sites 유형입니다. 지원되는 경우 리소스 공급자는 이 값의 유효성을 검사하고 유지해야 합니다. | 문자열 제약 조건: 패턴 = ^[-\w\._,\(\)]+$ |
| 위치 | 리소스가 있는 지리적 위치 | string(필수) |
| 에 의해 관리됨 | 이 리소스를 관리하는 리소스의 정규화된 리소스 ID입니다. 이 리소스가 다른 Azure 리소스에서 관리되는지를 나타냅니다. 이 경우 전체 모드 배포는 다른 리소스에서 관리되므로 템플릿에서 제거된 경우 리소스를 삭제하지 않습니다. | 문자열 |
| 이름 | 리소스 이름 | 문자열 제약 조건: 최소 길이 = 3 최대 길이 = 64 패턴 = ^[A-Za-z0-9@.\-_ ]*$(필수) |
| 계획 | 리소스 계획의 세부 정보입니다. | 계획 |
| 속성 | HostPool에 대한 자세한 속성 | HostPoolProperties(필수) |
| SKU (재고 관리 코드) | 이 리소스에 할당된 SKU(스톡 키핑 단위)입니다. | 스쿠 |
| 태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. |
| 형 | 리소스 종류 | "Microsoft. DesktopVirtualization/hostPools@2026-04-01-preview" |
에이전트업데이트프로퍼티
| 이름 | 묘사 | 값 |
|---|---|---|
| 유지 관리Windows | 유지 관리 기간 목록입니다. 유지 관리 기간은 2시간입니다. | 유지 보수 창 속성[] |
| 유지 관리WindowTimeZone | /dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0에 정의된 유지 관리를 위한 표준 시간대입니다. useLocalTime이 true이면 설정해야 합니다. | 문자열 |
| 형 | 세션 호스트 구성 요소에 대한 유지 관리 유형입니다. | '기본값' '예정됨' |
| useSessionHostLocalTime | 가상 머신의 localTime을 사용할지 여부입니다. | 부울 |
HostPoolProperties
| 이름 | 묘사 | 값 |
|---|---|---|
| 에이전트업데이트 | 에이전트, 모니터링 에이전트 및 스택 구성 요소를 업데이트하기 위한 세션 호스트 구성입니다. | 에이전트업데이트프로퍼티 |
| allowRDPShortPathWithPrivateLink | RDPShortPath 전송의 사용이 허용되는지 여부를 제어하여 Private Link 경로를 우회할 수 있습니다. | '사용 안 함' '사용' |
| 조건형 RdpProperty | 호스트 풀의 조건부 RDP 속성은 .의 형식으로 <rdpPropertyName>:<type>:<value>:<conditionType>:<conditionValue>문자열로 직렬화되었습니다. |
문자열 |
| customRdpProperty를 참조하십시오. | HostPool의 사용자 지정 rdp 속성입니다. | 문자열 |
| 배포 범위 | DeploymentScope 형식입니다. | '지리적' '지역' |
| 묘사 | HostPool에 대한 설명입니다. | 문자열 |
| 다이렉트UDP | 기본값: AVD 전체 설정은 연결 가용성을 확인하는 데 사용됩니다. 사용: UDP는 연결을 만들 때 이 연결 유형을 시도합니다. 즉, 이 연결 형식을 방지할 수 있는 다른 요소가 있으므로 이 연결이 가능하지만 보장되지는 않습니다. 사용 안 함: UDP는 연결을 만들 때 이 연결 형식을 시도하지 않습니다. | '기본값' '사용 안 함' '사용' |
| 친근한 이름 | HostPool의 이름입니다. | 문자열 |
| hostPoolType입니다 | 데스크톱용 HostPool 유형입니다. | 'BYODesktop' '개인' 'Pooled'(필수) |
| 로드 밸런서 유형 | 부하 분산 장치의 유형입니다. | '너비 우선' '뎁스퍼스트' '다중 퍼시스턴트' '영구적'(필수) |
| 관리비공개UDP | 기본값: AVD 전체 설정은 연결 가용성을 확인하는 데 사용됩니다. 사용: UDP는 연결을 만들 때 이 연결 유형을 시도합니다. 즉, 이 연결 형식을 방지할 수 있는 다른 요소가 있으므로 이 연결이 가능하지만 보장되지는 않습니다. 사용 안 함: UDP는 연결을 만들 때 이 연결 형식을 시도하지 않습니다. | '기본값' '사용 안 함' '사용' |
| 관리 유형 | 이 hostpool, Automated 또는 Standard에 대한 관리 유형입니다. 기본값은 Automated입니다. | '자동화됨' '표준' |
| maxSessionLimit | HostPool의 최대 세션 제한입니다. | 정수 (int) |
| oboTenantId | 리소스를 대신하여 요청되는 테넌트입니다. | 문자열 |
| personalDesktopAssignmentType | HostPool의 PersonalDesktopAssignment 유형입니다. | '자동' '직접' |
| preferredAppGroupType | 기본 설정 애플리케이션 그룹 유형으로, 기본값은 데스크톱 애플리케이션 그룹입니다. | '데스크톱' '없음' 'RailApplications'(필수) |
| 공공 네트워크 접근 | 사용하도록 설정하면 공용 네트워크와 프라이빗 네트워크 모두에서 이 리소스에 액세스할 수 있습니다. 사용 안 함에서는 이 리소스를 프라이빗 엔드포인트를 통해서만 액세스할 수 있습니다. | '사용 안 함' '사용' 'EnabledForClientsOnly' 'EnabledForSessionHostsOnly' |
| 퍼블릭UDP | 기본값: AVD 전체 설정은 연결 가용성을 확인하는 데 사용됩니다. 사용: UDP는 연결을 만들 때 이 연결 유형을 시도합니다. 즉, 이 연결 형식을 방지할 수 있는 다른 요소가 있으므로 이 연결이 가능하지만 보장되지는 않습니다. 사용 안 함: UDP는 연결을 만들 때 이 연결 형식을 시도하지 않습니다. | '기본값' '사용 안 함' '사용' |
| 등록 정보 | HostPool의 등록 정보입니다. | 등록 정보 |
| 릴레이UDP | 기본값: AVD 전체 설정은 연결 가용성을 확인하는 데 사용됩니다. 사용: UDP는 연결을 만들 때 이 연결 유형을 시도합니다. 즉, 이 연결 형식을 방지할 수 있는 다른 요소가 있으므로 이 연결이 가능하지만 보장되지는 않습니다. 사용 안 함: UDP는 연결을 만들 때 이 연결 형식을 시도하지 않습니다. | '기본값' '사용 안 함' '사용' |
| 반지 | HostPool의 링 번호입니다. | 정수 (int) |
| ssoadfs권한 | WVD SSO 인증서에 서명하기 위한 고객 ADFS 서버에 대한 URL입니다. | 문자열 |
| ssoClientId | WVD SSO 인증서를 발급하는 데 사용되는 등록된 신뢰 당사자에 대한 ClientId입니다. | 문자열 |
| ssoClientSecretKeyVaultPath | ADFS에 대한 통신에 사용되는 비밀을 저장하는 Azure KeyVault 경로입니다. | 문자열 |
| ssoSecretType | Single Sign-On 비밀 형식의 형식입니다. | '인증서' 'CertificateInKeyVault' '공유 키' 'SharedKeyInKeyVault' |
| startVMOnConnect | StartVMOnConnect 기능을 설정/해제할 플래그입니다. | 부울 |
| 유효성 검사 환경 | 유효성 검사 환경입니다. | 부울 |
| vm템플릿 | hostpool 내에서 sessionhosts 구성을 위한 VM 템플릿입니다. | 문자열 |
유지 보수 창 속성
| 이름 | 묘사 | 값 |
|---|---|---|
| 요일의주 | 요일입니다. | '금요일' '월요일' '토요일' '일요일' '목요일' '화요일' '수요일' |
| 시 | 하루의 업데이트 시작 시간입니다. (0 - 23) | 정수 (int) |
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(필수) |
| 버전 | 원하는 제품/아티팩트 버전입니다. | 문자열 |
등록 정보
| 이름 | 묘사 | 값 |
|---|---|---|
| 만료 시간 | 등록 토큰의 만료 시간입니다. | 문자열 |
| registrationTokenOperation | 토큰을 다시 설정하는 형식입니다. | '삭제' '없음' '업데이트' |
| 토큰 | 등록 토큰 base64로 인코딩된 문자열입니다. | 문자열 |
SKU (재고 관리 코드)
| 이름 | 묘사 | 값 |
|---|---|---|
| 용량 | SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. | 정수 (int) |
| 가족 | 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. | 문자열 |
| 이름 | SKU의 이름입니다. 예: P3. 일반적으로 letter+number 코드입니다. | string(필수) |
| 크기 | SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. | 문자열 |
| 계층 | 이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. | '기본' '무료' '프리미엄' '표준' |
TrackedResource태그
| 이름 | 묘사 | 값 |
|---|
사용자 할당 ID
| 이름 | 묘사 | 값 |
|---|