Тип ресурса cloudPcProvisioningPolicy

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет политику подготовки облачных компьютеров.

Методы

Метод Тип возвращаемых данных Описание
Список provisioningPolicies Коллекция cloudPcProvisioningPolicy Перечисление свойств и связей объектов cloudPcProvisioningPolicy .
Получение cloudPcProvisioningPolicy cloudPcProvisioningPolicy Чтение свойств и связей объекта cloudPcProvisioningPolicy .
Создание cloudPcProvisioningPolicy cloudPcProvisioningPolicy Создайте объект cloudPcProvisioningPolicy .
Обновление cloudPcProvisioningPolicy cloudPcProvisioningPolicy Обновите свойства объекта cloudPcProvisioningPolicy .
Удаление cloudPcProvisioningPolicy Нет Удалите объект cloudPcProvisioningPolicy .
Назначение cloudPcProvisioningPolicy Нет Назначьте cloudPcProvisioningPolicy группам пользователей.
Применение cloudPcProvisioningPolicy Нет Примените текущую конфигурацию политики подготовки ко всем устройствам облачных компьютеров в соответствии с указанной политикой. В настоящее время можно изменить только регион.
applyConfig Нет Обновите конфигурацию политики подготовки для набора устройств облачных компьютеров по их идентификаторам.

Свойства

Свойство Тип Описание
alternateResourceUrl String URL-адрес альтернативного ресурса, который ссылается на эту политику подготовки. Только для чтения.
cloudPcGroupDisplayName String Отображаемое имя группы облачных компьютеров, в которой находятся облачные компьютеры. Только для чтения.
cloudPcNamingTemplate String Шаблон, используемый для имен облачных компьютеров, подготовленных с помощью этой политики. Шаблон может содержать настраиваемый текст и маркеры замены, включая %USERNAME:x% и %RAND:x%, которые представляют имя пользователя и случайно созданное число соответственно. Например, означает, CPC-%USERNAME:4%-%RAND:5% что имя облачного компьютера начинается с CPC-, за которым следует имя пользователя из четырех символов, - символ, а затем пять случайных символов. Общая длина текста, созданного шаблоном, не может превышать 15 символов. Поддерживает $filter, $select и $orderby.
description String Описание политики подготовки. Поддерживает $filter, $select и $orderBy.
displayName String Отображаемое имя политики подготовки.
domainJoinConfigurations Коллекция cloudPcDomainJoinConfiguration Указывает список, упорядоченный по приоритету для присоединения облачных компьютеров к Microsoft Entra ID (Azure AD). Поддерживает $select.
enableSingleSignOn Логический True Значение , если к подготовленному облачному компьютеру можно получить доступ с помощью единого входа. False указывает, что подготовленный облачный компьютер не поддерживает эту функцию. Значение по умолчанию — false. Windows 365 пользователи могут использовать единый вход для проверки подлинности, чтобы Microsoft Entra ID с помощью параметров без пароля (например, ключей FIDO) для доступа к облачному компьютеру. Необязательный параметр.
gracePeriodInHours Int32 Количество часов ожидания перед повторной подготовкой или отменой подготовки. Только для чтения.
id String Уникальный идентификатор, связанный с политикой подготовки. Этот идентификатор заполняется автоматически во время создания новой политики подготовки. Только для чтения. Поддерживает $filter, $select и $orderBy.
imageDisplayName String Отображаемое имя образа операционной системы, используемого для подготовки. Например, Windows 11 Preview + Microsoft 365 Apps 23H2 23H2. Поддерживает $filter, $select и $orderBy.
imageId String Уникальный идентификатор, представляющий образ операционной системы, используемый для подготовки новых облачных компьютеров. Формат изображения типа коллекции: {publisherName_offerName_skuName}. Поддерживаемые значения для каждого из параметров:
  • Издателя: Microsoftwindowsdesktop
  • Предлагаем: windows-ent-cpc
  • sku: 21h1-ent-cpc-m365, 21h1-ent-cpc-os, 20h2-ent-cpc-m365, 20h2-ent-cpc-os, 20h1-ent-cpc-m365, 20h1-ent-cpc-os, 19h2-ent-cpc-m365, и 19h2-ent-cpc-os
Поддерживает $filter, $select и $orderBy.
imageType cloudPcProvisioningPolicyImageType Тип образа операционной системы (пользовательский или коллекции), используемый для подготовки на облачных компьютерах. Возможные значения: gallery, custom. Значение по умолчанию — gallery. Поддерживает $filter, $select и $orderBy.
localAdminEnabled Логический Если trueзадано значение , локальный администратор включен для облачных компьютеров; false указывает, что локальный администратор не включен для облачных компьютеров. Значение по умолчанию — false. Поддерживает $filter, $select и $orderBy.
Managedby cloudPcManagementService Указывает службу, управляющую политикой подготовки. Возможные значения: windows365, devBox, unknownFutureValue, rpaBox. Значение по умолчанию — windows365. Обратите внимание, что требуется использоваться заголовок запроса Prefer: include-unknown-enum-members, чтобы получить следующее значение в этом расширяемом перечислении: rpaBox. Поддерживает $filter, $select и $orderBy.
microsoftManagedDesktop microsoftManagedDesktop Конкретные параметры microsoftManagedDesktop , которые позволяют клиентам Microsoft Managed Desktop получать управляемые устройствами интерфейс для облачного компьютера. Чтобы включить microsoftManagedDesktop для предоставления дополнительных значений, администратор должен указать в нем определенные параметры. Поддерживает $filter, $select и $orderBy.
provisioningType cloudPcProvisioningType Указывает тип лицензии, используемой при подготовке облачных компьютеров с помощью этой политики. По умолчанию типом лицензии является dedicated , если provisioningType не указан при создании cloudPcProvisioningPolicy. Это свойство нельзя изменить после создания cloudPcProvisioningPolicy . Возможные значения: dedicated, shared, unknownFutureValue.
windowsSetting cloudPcWindowsSettings Указывает конкретный параметр Windows для настройки во время создания облачных компьютеров для этой политики подготовки. Поддерживает $select.
domainJoinConfiguration (не рекомендуется) cloudPcDomainJoinConfiguration Указывает способ присоединения облачных компьютеров к Microsoft Entra ID. Свойство domainJoinConfiguration устарело и перестанет возвращать данные 31 мая 2024 г. В дальнейшем используйте свойство domainJoinConfigurations .
onPremisesConnectionId (не рекомендуется) String Идентификатор cloudPcOnPremisesConnection. Чтобы убедиться, что облачные компьютеры имеют сетевое подключение и присоединение к домену, выберите подключение к виртуальной сети, проверенное службой облачного компьютера. Свойство onPremisesConnectionId устарело и перестанет возвращать данные 31 мая 2024 г. В дальнейшем используйте свойство domainJoinConfigurations .
windowsSettings (не рекомендуется) cloudPcWindowsSettings Конкретные параметры Windows, которые необходимо настроить во время создания облачных компьютеров для этой политики подготовки. Поддерживает $select. Свойство windowsSettings устарело и перестанет возвращать данные 31 января 2024 г. В дальнейшем используйте свойство windowsSetting .

Значения cloudPcProvisioningType

Member Описание
Выделенный Указывает, что выделенная лицензия используется для подготовки облачных компьютеров. Значение по умолчанию.
общие Указывает, что общая лицензия используется для подготовки облачных компьютеров.
unknownFutureValue Изменяемое значение перечисления sentinel. Не используйте.

Связи

Связь Тип Описание
assignments коллекция cloudPcProvisioningPolicyAssignment Определенная коллекция назначений политики подготовки. Представляет набор групп Microsoft 365 и групп безопасности в Microsoft Entra ID, которым назначена политика подготовки. Возвращается только с помощью оператора $expand. Пример получения связи назначений см. в разделе Получение cloudPcProvisioningPolicy.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "alternateResourceUrl": "String",
  "cloudPcGroupDisplayName": "String",
  "cloudPcNamingTemplate": "String",
  "description": "String",
  "displayName": "String",
  "domainJoinConfiguration": {
    "@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"
  },
  "domainJoinConfigurations": [{"@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"}],
  "enableSingleSignOn": "Boolean",
  "gracePeriodInHours": "Int32",
  "id": "String (identifier)",
  "imageDisplayName": "String",
  "imageId": "String",
  "imageType": "String",
  "localAdminEnabled": "Boolean",
  "managedBy": "String",
  "microsoftManagedDesktop": {
    "@odata.type": "microsoft.graph.microsoftManagedDesktop"
  },
  "onPremisesConnectionId": "String",
  "provisioningType": "String",
  "windowsSetting": {
    "@odata.type": "microsoft.graph.cloudPcWindowsSetting"
  },
  "windowsSettings": {
    "@odata.type": "microsoft.graph.cloudPcWindowsSettings"
  }
}