Тип ресурса cloudPcProvisioningPolicy

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

Важно!

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

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

Методы

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

Свойства

Свойство Тип Описание
alternateResourceUrl String URL-адрес альтернативного ресурса, который ссылается на эту политику подготовки. Только для чтения.
автоматическое исправление cloudPcProvisioningPolicyAutopatch Указывает параметры автоматического исправления Windows для облачных компьютеров, использующих эту политику подготовки. Параметры вступают в силу, когда клиент регистрируется в autopatch, а параметр managedType свойства microsoftManagedDesktop имеет значение starterManaged. Поддерживает $select.
autopilotConfiguration cloudPcAutopilotConfiguration Конкретные параметры Windows Autopilot, которые позволяют Windows 365 клиентам использовать его на облачном компьютере. Поддерживает $select.
cloudPcGroupDisplayName String Отображаемое имя группы облачных компьютеров, в которой находятся облачные компьютеры. Только для чтения.
cloudPcNamingTemplate String Шаблон, используемый для имен облачных компьютеров, подготовленных с помощью этой политики. Шаблон может содержать настраиваемый текст и маркеры замены, включая %USERNAME:x% и %RAND:x%, которые представляют имя пользователя и случайно созданное число соответственно. Например, означает, CPC-%USERNAME:4%-%RAND:5% что имя облачного компьютера начинается с CPC-, за которым следует имя пользователя из четырех символов, - символ, а затем пять случайных символов. Общая длина текста, созданного шаблоном, не может превышать 15 символов. Поддерживает $filter, $select и $orderby.
createdBy String Уникальный идентификатор пользователя, создавшего эту политику. Например, 5ccb8d35-dd04-473e-a287-69bb4473208b. Только для чтения. Поддерживает $select.
createdDateTime DateTimeOffset Метка времени создания этой политики подготовки. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Только для чтения. Поддерживает $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 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.
lastModifiedBy String Уникальный идентификатор пользователя, который в последний раз обновлял эту политику. Например, 5ccb8d35-dd04-473e-a287-69bb4473208b. Только для чтения. Поддерживает $select.
lastModifiedDateTime DateTimeOffset Метка времени последнего изменения этой политики подготовки. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Только для чтения. Поддерживает $select и $orderBy.
localAdminEnabled Логический Если trueзадано значение , локальный администратор включен для облачных компьютеров; false указывает, что локальный администратор не включен для облачных компьютеров. Значение по умолчанию — false. Поддерживает $filter, $select и $orderBy.
Managedby cloudPcManagementService Указывает службу, управляющую политикой подготовки. Допустимые значения: windows365, devBox, unknownFutureValue, rpaBox, microsoft365Opal, microsoft365BizChat. Значение по умолчанию — 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, . reserve Prefer: include-unknown-enum-members Используйте заголовок запроса, чтобы получить следующие значения из этого развиваемого перечисления: sharedByUser, sharedByEntraGroup, reserve. Участник shared является устаревшим и перестанет возвращаться 30 апреля 2027 г. в дальнейшем используйте sharedByUser его. Например, dedicated план обслуживания можно назначить только одному пользователю и подготовить только один облачный компьютер. Для shared планов и sharedByUser требуется, чтобы клиенты приобрели общий план обслуживания. Для каждой приобретенной общей лицензии можно включить до трех облачных компьютеров, при этом одновременно входил только один пользователь. Для sharedByEntraGroup этого плана также требуется приобрести общий план службы. Каждая общая лицензия в рамках этого плана может включить один облачный компьютер, который является общим для группы в соответствии с назначениями этой политики. По умолчанию типом лицензии является dedicated , если provisioningType не указан при создании cloudPcProvisioningPolicy. Это свойство нельзя изменить после создания cloudPcProvisioningPolicy .
scopeIds Коллекция строк Список идентификаторов тегов область для этого ресурса. Только для чтения.
userExperienceType cloudPcUserExperienceType Указывает тип облачного объекта, к который может получить доступ конечный пользователь. Допустимые значения: cloudPc, cloudApp, unknownFutureValue. cloudPc указывает, что пользователь может получить доступ ко всему рабочему столу. cloudApp указывает, что конечный пользователь может получить доступ только к приложениям, опубликованным в рамках этой политики подготовки. Тип нельзя изменить после создания политики подготовки. Если во время создания не указано, значение по умолчанию — cloudPc. Если cloudApp выбран параметр provisioningType , он должен иметь значение sharedByEntraGroup. Поддерживает $filter, $select, $orderBy.
userSettingsPersistenceConfiguration cloudPcUserSettingsPersistenceConfiguration Указывает конкретные параметры, которые обеспечивают сохранение параметров пользовательского приложения между сеансами облачного компьютера. Значение по умолчанию — null. Эта функция доступна только для политик подготовки облачных компьютеров типа sharedByEntraGroup. Поддерживает $select.
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, . reserve

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

Значения cloudPcUserExperienceType

Member Описание
cloudPc Указывает, что конечные пользователи могут получить доступ ко всему рабочему столу.
cloudApp Указывает, что конечные пользователи могут получить доступ только к облачным приложениям, опубликованным в соответствии с этой политикой подготовки.
unknownFutureValue Изменяемое значение перечисления sentinel. Не используйте.

Связи

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

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

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

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "alternateResourceUrl": "String",
  "autopatch": {"@odata.type": "microsoft.graph.cloudPcProvisioningPolicyAutopatch"},
  "autopilotConfiguration": {"@odata.type": "microsoft.graph.cloudPcAutopilotConfiguration"},
  "cloudPcGroupDisplayName": "String",
  "cloudPcNamingTemplate": "String",
  "createdBy": "String",
  "createdDateTime": "String (timestamp)",
  "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",
  "lastModifiedBy": "String",
  "lastModifiedDateTime": "String (timestamp)",
  "localAdminEnabled": "Boolean",
  "managedBy": "String",
  "microsoftManagedDesktop": {"@odata.type": "microsoft.graph.microsoftManagedDesktop"},
  "onPremisesConnectionId": "String",
  "provisioningType": "String",
  "scopeIds": ["String"],
  "userExperienceType": "String",
  "userSettingsPersistenceConfiguration": {"@odata.type": "microsoft.graph.cloudPcUserSettingsPersistenceConfiguration"},
  "windowsSetting": {"@odata.type": "microsoft.graph.cloudPcWindowsSetting"},
  "windowsSettings": {"@odata.type": "microsoft.graph.cloudPcWindowsSettings"}
}
  • Last updated on