Тип ресурса cloudPcProvisioningPolicy

Статья
05/02/2024

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

Важно!

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

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

Методы

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

Свойства

Свойство	Тип	Описание
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`, `shared`, `unknownFutureValue`, `sharedByUser`, `sharedByEntraGroup`. Необходимо использовать `Prefer: include-unknown-enum-members` заголовок запроса, чтобы получить следующие значения из этого развиваемого перечисления: `sharedByUser`, `sharedByEntraGroup`. Участник `shared` является устаревшим и перестанет возвращаться 30 апреля 2027 г. в дальнейшем используйте `sharedByUser` его. Например, `dedicated` план обслуживания можно назначить только одному пользователю и подготовить только один облачный компьютер. Для `shared` планов и `sharedByUser` требуется, чтобы клиенты приобрели общий план обслуживания. Для каждой приобретенной общей лицензии можно включить до трех облачных компьютеров, при этом одновременно входил только один пользователь. Для `sharedByEntraGroup` этого плана также требуется приобрести общий план службы. Каждая общая лицензия в рамках этого плана может включить один облачный компьютер, который является общим для группы в соответствии с назначениями этой политики. По умолчанию типом лицензии является `dedicated` , если provisioningType не указан при создании cloudPcProvisioningPolicy. Это свойство нельзя изменить после создания cloudPcProvisioningPolicy .
windowsSetting	cloudPcWindowsSettings	Указывает конкретный параметр Windows для настройки во время создания облачных компьютеров для этой политики подготовки. Поддерживает `$select`.
domainJoinConfiguration (не рекомендуется)	cloudPcDomainJoinConfiguration	Указывает способ присоединения облачных компьютеров к Microsoft Entra ID. Свойство domainJoinConfiguration устарело и перестанет возвращать данные 31 мая 2024 г. В дальнейшем используйте свойство domainJoinConfigurations .
onPremisesConnectionId (не рекомендуется)	String	Идентификатор cloudPcOnPremisesConnection. Чтобы убедиться, что облачные компьютеры имеют сетевое подключение и присоединение к домену, выберите подключение к виртуальной сети, которую служба cloud PC проверила. Свойство onPremisesConnectionId устарело и перестанет возвращать данные 31 мая 2024 г. В дальнейшем используйте свойство domainJoinConfigurations .
windowsSettings (не рекомендуется)	cloudPcWindowsSettings	Конкретные параметры Windows, которые необходимо настроить во время создания облачных компьютеров для этой политики подготовки. Поддерживает `$select`. Свойство windowsSettings устарело и перестанет возвращать данные 31 января 2024 г. В дальнейшем используйте свойство windowsSetting .

Значения cloudPcProvisioningType

В следующей таблице перечислены члены расширяемого перечисления. Чтобы получить следующие значения в этой развиваемой перечислении, необходимо использовать Prefer: include-unknown-enum-members заголовок запроса: sharedByUser, sharedByEntraGroup.

Member	Описание
Выделенный	Указывает, что выделенная лицензия используется для подготовки облачных компьютеров. Значение по умолчанию.
общий (не рекомендуется)	Указывает, что общая лицензия используется для подготовки облачных компьютеров. Участник `shared` является устаревшим и перестанет возвращаться 30 апреля 2027 г. В дальнейшем используйте `sharedByUser` элемент .
unknownFutureValue	Изменяемое значение перечисления sentinel. Не используйте.
sharedByUser	Указывает политику подготовки при подготовке выделенного облачного компьютера для каждого пользователя в группе назначений. Пользователи всегда подключены к одному и тому же облачному компьютеру. Однако доступность облачных компьютеров ограничена общим количеством активных сеансов.
sharedByEntraGroup	Указывает политику подготовки, связанную с облачными компьютерами, совместно используемыми группой Microsoft Entra (Azure AD). При подготовке общего облачного компьютера он становится доступным для любого пользователя в группе назначения Microsoft Entra ID, к которой нужно подключиться. Пользователи могут быть подключены к другому облачному компьютеру при каждом подключении, и доступность ограничена количеством подготовленных облачных компьютеров.

Связи

Связь	Тип	Описание
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"
  }
}

Поделиться через