Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
- Latest
- 2026-01-01-превью
- 2025-11-01-превью
- 2025-10-10
- 2025-09-01-превью
- 2025-08-01-превью
- 2025-04-01-preview
- 2025-03-01-preview
- 2024-11-01-preview
- 2024-08-08-превью
- 2024-04-08-превью
- 2024-04-03
- 2024-03-06-превью
- 2024-01-16-превью
- 2023-11-01-preview
- 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-preview
- 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 см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.DesktopVirtualization/hostPools, добавьте в шаблон следующий Bicep.
resource symbolicname 'Microsoft.DesktopVirtualization/hostPools@2025-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
}
customRdpProperty: 'string'
description: 'string'
directUDP: 'string'
friendlyName: 'string'
hostPoolType: 'string'
loadBalancerType: 'string'
managedPrivateUDP: 'string'
managementType: 'string'
maxSessionLimit: int
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
| Имя | Description | Ценность |
|---|---|---|
| identity | Удостоверения управляемой службы, назначенные этому ресурсу. | ManagedServiceIdentity |
| добрый | Метаданные, используемые порталом/инструментами/и т.д. для рендеринга различных UX-опытов для ресурсов одного типа; Например, ApiApps — это разновидность типа Microsoft.Web/sites. При поддержке поставщик ресурсов должен проверить и сохранить это значение. | string Ограничения целостности: Шаблон = ^[-\w\._,\(\)]+$ |
| location | Географическое расположение, в котором находится ресурс | строка (обязательно) |
| managedBy | Полный идентификатор ресурса ресурса, который управляет этим ресурсом. Указывает, управляется ли этот ресурс другим ресурсом Azure. В этом случае развертывание полного режима не удаляет ресурс, если он удаляется из шаблона, так как он управляется другим ресурсом. | струна |
| имя | имя ресурса. | string Ограничения целостности: Минимальная длина = 3 Максимальная длина = 64 Pattern = ^[A-Za-z0-9@.\-_ ]*$ (обязательно) |
| план | Сведения о плане ресурсов. | План |
| properties | Подробные свойства для HostPool | HostPoolProperties (обязательно) |
| sku | SKU (единица складского учета), назначенная этому ресурсу. | Sku |
| tags | Теги ресурсов | Словарь имен и значений тегов. См. теги в шаблонах |
AgentUpdateProperties
| Имя | Description | Ценность |
|---|---|---|
| maintenanceWindows | Перечень окон технического обслуживания. Окна технического обслуживания длятся 2 часа. | MaintenanceWindowProperties[] |
| maintenanceWindowTimeZone | Часовой пояс для обслуживания, определенный в /dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0. Должно быть установлено, если useLocalTime имеет значение true. | струна |
| type | Тип обслуживания компонентов узла сеансов. | По умолчанию 'Scheduled' |
| useSessionHostLocalTime | Следует ли использовать localTime виртуальной машины. | bool |
Свойства HostPool
| Имя | Description | Ценность |
|---|---|---|
| agentUpdate | Конфигурация узла сеансов для обновления агента, агента мониторинга и компонента стека. | AgentUpdateProperties |
| customRdpProperty | Пользовательское свойство rdp HostPool. | струна |
| описание | Описание HostPool. | струна |
| directUDP | По умолчанию: для определения доступности подключения используются настройки на уровне AVD, Включено: UDP будет пытаться установить этот тип соединения при выполнении подключений. Это означает, что данное соединение возможно, но не гарантируется, так как существуют другие факторы, которые могут препятствовать этому типу соединения, Отключено: UDP не будет пытаться использовать этот тип соединения при выполнении соединений | По умолчанию 'Disabled' 'Enabled' |
| friendlyName | Понятное имя HostPool. | струна |
| hostPoolType | Тип HostPool для настольных компьютеров. | «BYODesktop» «Личное» «Объединенный» (обязательно) |
| loadBalancerType | Тип подсистемы балансировки нагрузки. | «Широта первая» «Глубина прежде всего» «МножественныйПостоянный» «Постоянный» (обязательно) |
| управляемыйPrivateUDP | По умолчанию: для определения доступности подключения используются настройки на уровне AVD, Включено: UDP будет пытаться установить этот тип соединения при выполнении подключений. Это означает, что данное соединение возможно, но не гарантируется, так как существуют другие факторы, которые могут препятствовать этому типу соединения, Отключено: UDP не будет пытаться использовать этот тип соединения при выполнении соединений | По умолчанию 'Disabled' 'Enabled' |
| managementType | Тип управления для данного пула узлов: автоматизированный или стандартный. Значение по умолчанию — Автоматически. | «Автоматизированный» 'Standard' |
| maxSessionLimit | Максимальный лимит сессий HostPool. | инт |
| personalDesktopAssignmentType | PersonalDesktopAssignment для HostPool. | "Автоматически" 'Direct' |
| preferredAppGroupType | Тип предпочитаемой группы приложений, по умолчанию Группа приложений для настольных ПК | 'Desktop' "Нет" 'RailApplications' (обязательно) |
| доступ к публичной сети | Параметр «Включено» позволяет получить доступ к этому ресурсу как из общедоступных, так и из частных сетей, параметр «Отключено» позволяет доступ к этому ресурсу только через частные конечные точки | 'Disabled' 'Enabled' 'EnabledForClientsOnly' 'EnabledForSessionHostsOnly' |
| publicUDP | По умолчанию: для определения доступности подключения используются настройки на уровне AVD, Включено: UDP будет пытаться установить этот тип соединения при выполнении подключений. Это означает, что данное соединение возможно, но не гарантируется, так как существуют другие факторы, которые могут препятствовать этому типу соединения, Отключено: UDP не будет пытаться использовать этот тип соединения при выполнении соединений | По умолчанию 'Disabled' 'Enabled' |
| регистрацияИнфо | Регистрационная информация HostPool. | Информация о регистрации |
| релеUDP | По умолчанию: для определения доступности подключения используются настройки на уровне AVD, Включено: UDP будет пытаться установить этот тип соединения при выполнении подключений. Это означает, что данное соединение возможно, но не гарантируется, так как существуют другие факторы, которые могут препятствовать этому типу соединения, Отключено: UDP не будет пытаться использовать этот тип соединения при выполнении соединений | По умолчанию 'Disabled' 'Enabled' |
| кольцо | Номер кольца HostPool. | инт |
| ssoadfsAuthority | URL-адрес сервера ADFS клиента для подписи сертификатов единого входа WVD. | струна |
| ssoClientId | ClientId для зарегистрированной проверяющей стороны, используемый для выпуска сертификатов единого входа WVD. | струна |
| ssoClientSecretKeyVaultPath | Путь к Azure KeyVault, в котором хранится секрет, используемый для связи с ADFS. | струна |
| ssoSecretType | Тип единого знака на Secret Type. | 'Certificate' «СертификатInKeyVault» «Общий ключ» «SharedKeyInKeyVault» |
| startVMOnConnect | Флаг для включения/выключения функции StartVMOnConnect. | bool |
| validationEnvironment | Это среда валидации. | bool |
| Шаблон vmTemplate | Шаблон виртуальной машины для настройки sessionhosts в пуле хостов. | струна |
MaintenanceWindowProperties
| Имя | Description | Ценность |
|---|---|---|
| dayOfWeek | День недели. | 'Friday' 'Monday' 'Saturday' 'Sunday' 'Thursday' 'Tuesday' 'Wednesday' |
| час | Час начала обновления. (0 - 23) | инт |
ManagedServiceIdentity
| Имя | Description | Ценность |
|---|---|---|
| type | Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). | "Нет" 'SystemAssigned' 'SystemAssigned,UserAssigned' UserAssigned (обязательно) |
| userAssignedIdentities | Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Имя | Description | Ценность |
|---|
Plan
| Имя | Description | Ценность |
|---|---|---|
| имя | Определяемое пользователем имя 3-й партии Артефакт, который приобретается. | строка (обязательно) |
| продукт | 3-й партии артефакт, который приобретается. Например, NewRelic. Продукт сопоставляется с предложением, указанным для артефакта во время подключения рынка данных. | строка (обязательно) |
| промокод | Издатель предоставил код повышения уровня, подготовленный в Data Market для указанного продукта или артефакта. | струна |
| издатель | Издатель 3-й партии артефакт, который покупается. Например, NewRelic | строка (обязательно) |
| version | Версия требуемого продукта или артефакта. | струна |
Информация о регистрации
| Имя | Description | Ценность |
|---|---|---|
| expirationTime | Срок действия регистрационного токена. | струна |
| registrationTokenOperation | Тип сброса токена. | "Удалить" "Нет" 'Update' |
| token | Токен регистрации base64 закодирован в строке. | струна |
Sku
| Имя | Description | Ценность |
|---|---|---|
| capacity | Если номер SKU поддерживает горизонтальное масштабирование или в, то целое число емкости должно быть включено. Если горизонтальное масштабирование невозможно для ресурса, это может быть опущено. | инт |
| family | Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. | струна |
| имя | Имя номера SKU. Например, P3. Обычно это код буквы и числа | строка (обязательно) |
| size | Размер номера SKU. Если поле имени является сочетанием уровня и другого значения, это будет автономный код. | струна |
| tier | Это поле необходимо реализовать поставщиком ресурсов, если служба имеет несколько уровней, но не требуется для PUT. | "Базовый" 'Free' "Премиум" 'Standard' |
TrackedResourceTags
| Имя | Description | Ценность |
|---|
UserAssignedIdentity
| Имя | Description | Ценность |
|---|
Примеры использования
Проверенные модули Azure
Для развертывания этого типа ресурсов можно использовать следующие проверенные модули Azure .
| Модуль | Description |
|---|---|
| Пул узлов Виртуального рабочего стола Azure (AVD) | Ресурсный модуль AVM для пула узлов Виртуального рабочего стола Azure (AVD) |
Примеры быстрого запуска Azure
Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.
| Bicep-файл | Description |
|---|---|
| Создание AVD с помощью Microsoft Entra ID Join | Этот шаблон позволяет создавать ресурсы Виртуального рабочего стола Azure, такие как пул узлов, группа приложений, рабочая область, узел тестового сеанса и его расширения, с присоединением к Microsoft Entra ID |
Определение ресурса шаблона ARM
Тип ресурса hostPools может быть развернут с помощью операций, нацеленных на:
- группы ресурсов . См. команды развертывания группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.DesktopVirtualization/hostPools, добавьте в шаблон следующий код JSON.
{
"type": "Microsoft.DesktopVirtualization/hostPools",
"apiVersion": "2025-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"
},
"customRdpProperty": "string",
"description": "string",
"directUDP": "string",
"friendlyName": "string",
"hostPoolType": "string",
"loadBalancerType": "string",
"managedPrivateUDP": "string",
"managementType": "string",
"maxSessionLimit": "int",
"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
| Имя | Description | Ценность |
|---|---|---|
| apiVersion | Версия API | '2025-04-01-preview' |
| identity | Удостоверения управляемой службы, назначенные этому ресурсу. | ManagedServiceIdentity |
| добрый | Метаданные, используемые порталом/инструментами/и т.д. для рендеринга различных UX-опытов для ресурсов одного типа; Например, ApiApps — это разновидность типа Microsoft.Web/sites. При поддержке поставщик ресурсов должен проверить и сохранить это значение. | string Ограничения целостности: Шаблон = ^[-\w\._,\(\)]+$ |
| location | Географическое расположение, в котором находится ресурс | строка (обязательно) |
| managedBy | Полный идентификатор ресурса ресурса, который управляет этим ресурсом. Указывает, управляется ли этот ресурс другим ресурсом Azure. В этом случае развертывание полного режима не удаляет ресурс, если он удаляется из шаблона, так как он управляется другим ресурсом. | струна |
| имя | имя ресурса. | string Ограничения целостности: Минимальная длина = 3 Максимальная длина = 64 Pattern = ^[A-Za-z0-9@.\-_ ]*$ (обязательно) |
| план | Сведения о плане ресурсов. | План |
| properties | Подробные свойства для HostPool | HostPoolProperties (обязательно) |
| sku | SKU (единица складского учета), назначенная этому ресурсу. | Sku |
| tags | Теги ресурсов | Словарь имен и значений тегов. См. теги в шаблонах |
| type | Тип ресурса | «Microsoft.DesktopVirtualization/hostPools» |
AgentUpdateProperties
| Имя | Description | Ценность |
|---|---|---|
| maintenanceWindows | Перечень окон технического обслуживания. Окна технического обслуживания длятся 2 часа. | MaintenanceWindowProperties[] |
| maintenanceWindowTimeZone | Часовой пояс для обслуживания, определенный в /dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0. Должно быть установлено, если useLocalTime имеет значение true. | струна |
| type | Тип обслуживания компонентов узла сеансов. | По умолчанию 'Scheduled' |
| useSessionHostLocalTime | Следует ли использовать localTime виртуальной машины. | bool |
Свойства HostPool
| Имя | Description | Ценность |
|---|---|---|
| agentUpdate | Конфигурация узла сеансов для обновления агента, агента мониторинга и компонента стека. | AgentUpdateProperties |
| customRdpProperty | Пользовательское свойство rdp HostPool. | струна |
| описание | Описание HostPool. | струна |
| directUDP | По умолчанию: для определения доступности подключения используются настройки на уровне AVD, Включено: UDP будет пытаться установить этот тип соединения при выполнении подключений. Это означает, что данное соединение возможно, но не гарантируется, так как существуют другие факторы, которые могут препятствовать этому типу соединения, Отключено: UDP не будет пытаться использовать этот тип соединения при выполнении соединений | По умолчанию 'Disabled' 'Enabled' |
| friendlyName | Понятное имя HostPool. | струна |
| hostPoolType | Тип HostPool для настольных компьютеров. | «BYODesktop» «Личное» «Объединенный» (обязательно) |
| loadBalancerType | Тип подсистемы балансировки нагрузки. | «Широта первая» «Глубина прежде всего» «МножественныйПостоянный» «Постоянный» (обязательно) |
| управляемыйPrivateUDP | По умолчанию: для определения доступности подключения используются настройки на уровне AVD, Включено: UDP будет пытаться установить этот тип соединения при выполнении подключений. Это означает, что данное соединение возможно, но не гарантируется, так как существуют другие факторы, которые могут препятствовать этому типу соединения, Отключено: UDP не будет пытаться использовать этот тип соединения при выполнении соединений | По умолчанию 'Disabled' 'Enabled' |
| managementType | Тип управления для данного пула узлов: автоматизированный или стандартный. Значение по умолчанию — Автоматически. | «Автоматизированный» 'Standard' |
| maxSessionLimit | Максимальный лимит сессий HostPool. | инт |
| personalDesktopAssignmentType | PersonalDesktopAssignment для HostPool. | "Автоматически" 'Direct' |
| preferredAppGroupType | Тип предпочитаемой группы приложений, по умолчанию Группа приложений для настольных ПК | 'Desktop' "Нет" 'RailApplications' (обязательно) |
| доступ к публичной сети | Параметр «Включено» позволяет получить доступ к этому ресурсу как из общедоступных, так и из частных сетей, параметр «Отключено» позволяет доступ к этому ресурсу только через частные конечные точки | 'Disabled' 'Enabled' 'EnabledForClientsOnly' 'EnabledForSessionHostsOnly' |
| publicUDP | По умолчанию: для определения доступности подключения используются настройки на уровне AVD, Включено: UDP будет пытаться установить этот тип соединения при выполнении подключений. Это означает, что данное соединение возможно, но не гарантируется, так как существуют другие факторы, которые могут препятствовать этому типу соединения, Отключено: UDP не будет пытаться использовать этот тип соединения при выполнении соединений | По умолчанию 'Disabled' 'Enabled' |
| регистрацияИнфо | Регистрационная информация HostPool. | Информация о регистрации |
| релеUDP | По умолчанию: для определения доступности подключения используются настройки на уровне AVD, Включено: UDP будет пытаться установить этот тип соединения при выполнении подключений. Это означает, что данное соединение возможно, но не гарантируется, так как существуют другие факторы, которые могут препятствовать этому типу соединения, Отключено: UDP не будет пытаться использовать этот тип соединения при выполнении соединений | По умолчанию 'Disabled' 'Enabled' |
| кольцо | Номер кольца HostPool. | инт |
| ssoadfsAuthority | URL-адрес сервера ADFS клиента для подписи сертификатов единого входа WVD. | струна |
| ssoClientId | ClientId для зарегистрированной проверяющей стороны, используемый для выпуска сертификатов единого входа WVD. | струна |
| ssoClientSecretKeyVaultPath | Путь к Azure KeyVault, в котором хранится секрет, используемый для связи с ADFS. | струна |
| ssoSecretType | Тип единого знака на Secret Type. | 'Certificate' «СертификатInKeyVault» «Общий ключ» «SharedKeyInKeyVault» |
| startVMOnConnect | Флаг для включения/выключения функции StartVMOnConnect. | bool |
| validationEnvironment | Это среда валидации. | bool |
| Шаблон vmTemplate | Шаблон виртуальной машины для настройки sessionhosts в пуле хостов. | струна |
MaintenanceWindowProperties
| Имя | Description | Ценность |
|---|---|---|
| dayOfWeek | День недели. | 'Friday' 'Monday' 'Saturday' 'Sunday' 'Thursday' 'Tuesday' 'Wednesday' |
| час | Час начала обновления. (0 - 23) | инт |
ManagedServiceIdentity
| Имя | Description | Ценность |
|---|---|---|
| type | Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). | "Нет" 'SystemAssigned' 'SystemAssigned,UserAssigned' UserAssigned (обязательно) |
| userAssignedIdentities | Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Имя | Description | Ценность |
|---|
Plan
| Имя | Description | Ценность |
|---|---|---|
| имя | Определяемое пользователем имя 3-й партии Артефакт, который приобретается. | строка (обязательно) |
| продукт | 3-й партии артефакт, который приобретается. Например, NewRelic. Продукт сопоставляется с предложением, указанным для артефакта во время подключения рынка данных. | строка (обязательно) |
| промокод | Издатель предоставил код повышения уровня, подготовленный в Data Market для указанного продукта или артефакта. | струна |
| издатель | Издатель 3-й партии артефакт, который покупается. Например, NewRelic | строка (обязательно) |
| version | Версия требуемого продукта или артефакта. | струна |
Информация о регистрации
| Имя | Description | Ценность |
|---|---|---|
| expirationTime | Срок действия регистрационного токена. | струна |
| registrationTokenOperation | Тип сброса токена. | "Удалить" "Нет" 'Update' |
| token | Токен регистрации base64 закодирован в строке. | струна |
Sku
| Имя | Description | Ценность |
|---|---|---|
| capacity | Если номер SKU поддерживает горизонтальное масштабирование или в, то целое число емкости должно быть включено. Если горизонтальное масштабирование невозможно для ресурса, это может быть опущено. | инт |
| family | Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. | струна |
| имя | Имя номера SKU. Например, P3. Обычно это код буквы и числа | строка (обязательно) |
| size | Размер номера SKU. Если поле имени является сочетанием уровня и другого значения, это будет автономный код. | струна |
| tier | Это поле необходимо реализовать поставщиком ресурсов, если служба имеет несколько уровней, но не требуется для PUT. | "Базовый" 'Free' "Премиум" 'Standard' |
TrackedResourceTags
| Имя | Description | Ценность |
|---|
UserAssignedIdentity
| Имя | Description | Ценность |
|---|
Примеры использования
Шаблоны быстрого запуска Azure
Следующие шаблоны быстрого запуска Azure развертывают этот тип ресурса.
| Template | Description |
|---|---|
|
Создание AVD с помощью Microsoft Entra ID Join |
Этот шаблон позволяет создавать ресурсы Виртуального рабочего стола Azure, такие как пул узлов, группа приложений, рабочая область, узел тестового сеанса и его расширения, с присоединением к Microsoft Entra ID |
Определение ресурса Terraform (поставщик AzAPI)
Тип ресурса hostPools может быть развернут с помощью операций, нацеленных на:
- Группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.DesktopVirtualization/hostPools, добавьте в шаблон следующий Terraform.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DesktopVirtualization/hostPools@2025-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
}
customRdpProperty = "string"
description = "string"
directUDP = "string"
friendlyName = "string"
hostPoolType = "string"
loadBalancerType = "string"
managedPrivateUDP = "string"
managementType = "string"
maxSessionLimit = int
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
| Имя | Description | Ценность |
|---|---|---|
| identity | Удостоверения управляемой службы, назначенные этому ресурсу. | ManagedServiceIdentity |
| добрый | Метаданные, используемые порталом/инструментами/и т.д. для рендеринга различных UX-опытов для ресурсов одного типа; Например, ApiApps — это разновидность типа Microsoft.Web/sites. При поддержке поставщик ресурсов должен проверить и сохранить это значение. | string Ограничения целостности: Шаблон = ^[-\w\._,\(\)]+$ |
| location | Географическое расположение, в котором находится ресурс | строка (обязательно) |
| managedBy | Полный идентификатор ресурса ресурса, который управляет этим ресурсом. Указывает, управляется ли этот ресурс другим ресурсом Azure. В этом случае развертывание полного режима не удаляет ресурс, если он удаляется из шаблона, так как он управляется другим ресурсом. | струна |
| имя | имя ресурса. | string Ограничения целостности: Минимальная длина = 3 Максимальная длина = 64 Pattern = ^[A-Za-z0-9@.\-_ ]*$ (обязательно) |
| план | Сведения о плане ресурсов. | План |
| properties | Подробные свойства для HostPool | HostPoolProperties (обязательно) |
| sku | SKU (единица складского учета), назначенная этому ресурсу. | Sku |
| tags | Теги ресурсов | Словарь имен и значений тегов. |
| type | Тип ресурса | "Microsoft.DesktopVirtualization/hostPools@2025-04-01-preview" |
AgentUpdateProperties
| Имя | Description | Ценность |
|---|---|---|
| maintenanceWindows | Перечень окон технического обслуживания. Окна технического обслуживания длятся 2 часа. | MaintenanceWindowProperties[] |
| maintenanceWindowTimeZone | Часовой пояс для обслуживания, определенный в /dotnet/api/system.timezoneinfo.findsystemtimezonebyid?view=net-5.0. Должно быть установлено, если useLocalTime имеет значение true. | струна |
| type | Тип обслуживания компонентов узла сеансов. | По умолчанию 'Scheduled' |
| useSessionHostLocalTime | Следует ли использовать localTime виртуальной машины. | bool |
Свойства HostPool
| Имя | Description | Ценность |
|---|---|---|
| agentUpdate | Конфигурация узла сеансов для обновления агента, агента мониторинга и компонента стека. | AgentUpdateProperties |
| customRdpProperty | Пользовательское свойство rdp HostPool. | струна |
| описание | Описание HostPool. | струна |
| directUDP | По умолчанию: для определения доступности подключения используются настройки на уровне AVD, Включено: UDP будет пытаться установить этот тип соединения при выполнении подключений. Это означает, что данное соединение возможно, но не гарантируется, так как существуют другие факторы, которые могут препятствовать этому типу соединения, Отключено: UDP не будет пытаться использовать этот тип соединения при выполнении соединений | По умолчанию 'Disabled' 'Enabled' |
| friendlyName | Понятное имя HostPool. | струна |
| hostPoolType | Тип HostPool для настольных компьютеров. | «BYODesktop» «Личное» «Объединенный» (обязательно) |
| loadBalancerType | Тип подсистемы балансировки нагрузки. | «Широта первая» «Глубина прежде всего» «МножественныйПостоянный» «Постоянный» (обязательно) |
| управляемыйPrivateUDP | По умолчанию: для определения доступности подключения используются настройки на уровне AVD, Включено: UDP будет пытаться установить этот тип соединения при выполнении подключений. Это означает, что данное соединение возможно, но не гарантируется, так как существуют другие факторы, которые могут препятствовать этому типу соединения, Отключено: UDP не будет пытаться использовать этот тип соединения при выполнении соединений | По умолчанию 'Disabled' 'Enabled' |
| managementType | Тип управления для данного пула узлов: автоматизированный или стандартный. Значение по умолчанию — Автоматически. | «Автоматизированный» 'Standard' |
| maxSessionLimit | Максимальный лимит сессий HostPool. | инт |
| personalDesktopAssignmentType | PersonalDesktopAssignment для HostPool. | "Автоматически" 'Direct' |
| preferredAppGroupType | Тип предпочитаемой группы приложений, по умолчанию Группа приложений для настольных ПК | 'Desktop' "Нет" 'RailApplications' (обязательно) |
| доступ к публичной сети | Параметр «Включено» позволяет получить доступ к этому ресурсу как из общедоступных, так и из частных сетей, параметр «Отключено» позволяет доступ к этому ресурсу только через частные конечные точки | 'Disabled' 'Enabled' 'EnabledForClientsOnly' 'EnabledForSessionHostsOnly' |
| publicUDP | По умолчанию: для определения доступности подключения используются настройки на уровне AVD, Включено: UDP будет пытаться установить этот тип соединения при выполнении подключений. Это означает, что данное соединение возможно, но не гарантируется, так как существуют другие факторы, которые могут препятствовать этому типу соединения, Отключено: UDP не будет пытаться использовать этот тип соединения при выполнении соединений | По умолчанию 'Disabled' 'Enabled' |
| регистрацияИнфо | Регистрационная информация HostPool. | Информация о регистрации |
| релеUDP | По умолчанию: для определения доступности подключения используются настройки на уровне AVD, Включено: UDP будет пытаться установить этот тип соединения при выполнении подключений. Это означает, что данное соединение возможно, но не гарантируется, так как существуют другие факторы, которые могут препятствовать этому типу соединения, Отключено: UDP не будет пытаться использовать этот тип соединения при выполнении соединений | По умолчанию 'Disabled' 'Enabled' |
| кольцо | Номер кольца HostPool. | инт |
| ssoadfsAuthority | URL-адрес сервера ADFS клиента для подписи сертификатов единого входа WVD. | струна |
| ssoClientId | ClientId для зарегистрированной проверяющей стороны, используемый для выпуска сертификатов единого входа WVD. | струна |
| ssoClientSecretKeyVaultPath | Путь к Azure KeyVault, в котором хранится секрет, используемый для связи с ADFS. | струна |
| ssoSecretType | Тип единого знака на Secret Type. | 'Certificate' «СертификатInKeyVault» «Общий ключ» «SharedKeyInKeyVault» |
| startVMOnConnect | Флаг для включения/выключения функции StartVMOnConnect. | bool |
| validationEnvironment | Это среда валидации. | bool |
| Шаблон vmTemplate | Шаблон виртуальной машины для настройки sessionhosts в пуле хостов. | струна |
MaintenanceWindowProperties
| Имя | Description | Ценность |
|---|---|---|
| dayOfWeek | День недели. | 'Friday' 'Monday' 'Saturday' 'Sunday' 'Thursday' 'Tuesday' 'Wednesday' |
| час | Час начала обновления. (0 - 23) | инт |
ManagedServiceIdentity
| Имя | Description | Ценность |
|---|---|---|
| type | Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). | "Нет" 'SystemAssigned' 'SystemAssigned,UserAssigned' UserAssigned (обязательно) |
| userAssignedIdentities | Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Имя | Description | Ценность |
|---|
Plan
| Имя | Description | Ценность |
|---|---|---|
| имя | Определяемое пользователем имя 3-й партии Артефакт, который приобретается. | строка (обязательно) |
| продукт | 3-й партии артефакт, который приобретается. Например, NewRelic. Продукт сопоставляется с предложением, указанным для артефакта во время подключения рынка данных. | строка (обязательно) |
| промокод | Издатель предоставил код повышения уровня, подготовленный в Data Market для указанного продукта или артефакта. | струна |
| издатель | Издатель 3-й партии артефакт, который покупается. Например, NewRelic | строка (обязательно) |
| version | Версия требуемого продукта или артефакта. | струна |
Информация о регистрации
| Имя | Description | Ценность |
|---|---|---|
| expirationTime | Срок действия регистрационного токена. | струна |
| registrationTokenOperation | Тип сброса токена. | "Удалить" "Нет" 'Update' |
| token | Токен регистрации base64 закодирован в строке. | струна |
Sku
| Имя | Description | Ценность |
|---|---|---|
| capacity | Если номер SKU поддерживает горизонтальное масштабирование или в, то целое число емкости должно быть включено. Если горизонтальное масштабирование невозможно для ресурса, это может быть опущено. | инт |
| family | Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. | струна |
| имя | Имя номера SKU. Например, P3. Обычно это код буквы и числа | строка (обязательно) |
| size | Размер номера SKU. Если поле имени является сочетанием уровня и другого значения, это будет автономный код. | струна |
| tier | Это поле необходимо реализовать поставщиком ресурсов, если служба имеет несколько уровней, но не требуется для PUT. | "Базовый" 'Free' "Премиум" 'Standard' |
TrackedResourceTags
| Имя | Description | Ценность |
|---|
UserAssignedIdentity
| Имя | Description | Ценность |
|---|
Примеры использования
Проверенные модули Azure
Для развертывания этого типа ресурсов можно использовать следующие проверенные модули Azure .
| Модуль | Description |
|---|---|
| Пул узлов Виртуального рабочего стола Azure (AVD) | Ресурсный модуль AVM для пула узлов Виртуального рабочего стола Azure (AVD) |