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