Microsoft.DesktopVirtualization 호스트 풀

Bicep 리소스 정의

hostPools 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

사용 예제

Azure 확인된 모듈

다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.

모듈 묘사
AVD(Azure Virtual Desktop) 호스트 풀 AVD(Azure Virtual Desktop) 호스트 풀용 AVM 리소스 모듈

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 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

사용 예제

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 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.

모듈 묘사
AVD(Azure Virtual Desktop) 호스트 풀 AVD(Azure Virtual Desktop) 호스트 풀용 AVM 리소스 모듈

리소스 형식

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

이름 묘사 값