Windows 365 (предварительная версия)

Windows 365 — это облачная служба, которая автоматически создает новый тип Windows виртуальной машины (облачные компьютеры) для конечных пользователей. Каждому облачному компьютеру назначается отдельный пользователь в качестве выделенного Windows устройства. Windows 365 обеспечивает преимущества повышения производительности, безопасности и совместной работы Microsoft 365.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate за исключением следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     - Azure для государственных организаций регионы
     - Azure регионы Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate за исключением следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Microsoft
URL https://powerautomate.microsoft.com/en-us/support/
Метаданные соединителя
Publisher Microsoft
Веб-сайт https://www.microsoft.com/en-us/windows-365
Политика конфиденциальности https://privacy.microsoft.com/en-us/privacystatement
Категории ИТ-операции; Продуктивность
Service Класс Regions
Copilot Studio Премия Все регионы Power Automate
Логические приложения Премия Все регионы Logic Apps
Power Apps Премия Все регионы Power Apps
Power Automate Премия Все регионы Power Automate
Контакт
Имя Windows 365
URL https://learn.microsoft.com/en-us/connectors/windows365
Адрес электронной почты W365powerplatform@microsoft.com

Известные проблемы и ограничения

Соединитель Windows 365 в настоящее время находится в общедоступной предварительной версии.

Корпорации Microsoft нужно убедиться, что соединитель стабилен, прежде чем сделать его общедоступным. До этого времени соединитель находится в режиме предварительной версии. Предварительные версии предоставляются на основе «как есть», «со всеми ошибками» и «как доступно». Они исключены из соглашений об уровне обслуживания (SLA), но доступны на основе предварительной версии, чтобы вы могли получить ранний доступ и оставить отзыв. Узнайте больше о предварительных версиях функции и о том, как активировать их. Предварительные версии могут не охватываться поддержкой клиентов. Они могут быть прекращены в любое время без предварительного уведомления и могут быть не выпущены в общую доступность.

Мы рекомендуем вам попробовать предварительные версии соединителей и оставить отзыв. Это поможет нам стабилизировать и улучшить соединители. Вы можете использовать форумы по продуктам, чтобы поделиться проблемами и оставить отзыв. Поддержка Microsoft может быть недоступна для предварительных версий функций, включая соединители, но мы постараемся предоставить поддержку по мере возможности.

Дополнительные сведения см. в разделах "Соединители" в предварительной версии.

Общие ограничения

  1. Возможности и ограничения соответствуют базовым API Graph.
  2. При необходимости вызывать что-то в бета-конечной точке Graph используйте действие HTTP-запроса.

Действия:

Вывод списка облачных компьютеров

Идентификатор операции: ListCloudPCs

Это действие позволяет перечислить облачные компьютеры.

Параметры

Имя Обязательно Тип Description
$select нет струна $select позволяет выбрать, какие свойства возвращаются из Graph.
$filter нет струна $filter позволяет получить только подмножество коллекции из Graph.

Возвраты

Имя Тип Description
aadDeviceId String Идентификатор устройства Microsoft Entra для облачного компьютера, также известный как идентификатор устройства Azure Active Directory (Azure AD), состоящий из 32 символов в формате GUID. Созданная на виртуальной машине, присоединенной к Microsoft Entra ID. Только для чтения.
diskEncryptionState String Показывает состояние шифрования диска.
displayName String Отображаемое имя облачного компьютера. Максимальная длина — 64 символа. Только для чтения.
gracePeriodEndDateTime DateTimeOffset Дата и время окончания льготного периода, а также повторная подготовка или отзыв. Требуется только в том случае, если состояние находится в InGracePeriod. Метка времени отображается в формате ISO 8601 и в формате UTC. Например, полночь в формате UTC 1 января 2014 г. — 2014-01-01T00:00:00Z.
id String Уникальный идентификатор сущности облачного компьютера, которая состоит из 32 символов в формате GUID. Только для чтения.
imageDisplayName String Имя образа операционной системы, используемого для облачного компьютера. Максимальная длина — 50 символов. Для этого свойства допускаются только буквы (A–Z, a–z), цифры (0–9) и специальные символы (-,_,.). Значение свойства не может начинаться или заканчиваться символом подчеркивания. Только для чтения.
lastModifiedDateTime DateTimeOffset Дата и время последнего изменения облачного компьютера. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, полночь в формате UTC 1 января 2014 г. — 2014-01-01T00:00:00Z.
managedDeviceId String Intune зарегистрированный идентификатор устройства для облачного компьютера, состоящий из 32 символов в формате GUID. Свойство managedDeviceId Windows 365 для бизнеса облачных пк всегда имеет значение NULL, так как Windows 365 для бизнеса облачные компьютеры не регистрируются автоматически Windows 365. Только для чтения.
managedDeviceName String Имя зарегистрированного устройства Intune для облачного компьютера. Свойство managedDeviceName облачных компьютеров Windows 365 для бизнеса всегда имеет значение NULL, так как Windows 365 для бизнеса облачные компьютеры не Intune автоматически регистрируются Windows 365. Только для чтения.
onPremisesConnectionName String Локальное подключение, примененное во время подготовки облачных компьютеров. Только для чтения.
provisioningPolicyId String Идентификатор политики подготовки для облачного компьютера, состоящий из 32 символов в формате GUID. Политика определяет тип облачного компьютера, который пользователь хочет создать. Только для чтения.
provisioningPolicyName String Политика подготовки, применяемая во время подготовки облачных компьютеров. Максимальная длина — 120 символов. Только для чтения.
provisioningType String Показывает тип подготовки.
servicePlanId String Идентификатор плана обслуживания для облачного компьютера, состоящий из 32 символов в формате GUID. Дополнительные сведения о планах обслуживания см. в разделе Названия продуктов и идентификаторы планов обслуживания для лицензирования. Только для чтения.
servicePlanName String Имя плана обслуживания для сущности облачного компьютера, используемого клиентом. Только для чтения.
servicePlanType String Отображает тип плана.
userPrincipalName. String Имя участника-пользователя (UPN) пользователя, назначенного облачному компьютеру. Максимальная длина — 113 символов. Дополнительные сведения о политиках имен пользователей см. в статье Политики паролей и ограничения учетных записей в Microsoft Entra ID. Только для чтения.

Получение политик подготовки

Идентификатор операции: GetProvisioningPoliciesV1

Это действие позволяет возвращать сведения о политиках подготовки.

Параметры

Имя Обязательно Тип Description
$select нет String $select позволяет выбрать, какие свойства возвращаются из Graph.
$filter нет String $filter позволяет получить только подмножество коллекции из Graph.
$expand нет String $expand позволяет возвращать связанные ресурсы из Graph.

Возвраты

Используйте $expand со значением назначений, чтобы просмотреть возвращаемые значения ниже:

Имя Тип Description
cloudPCNamingTemplate String Шаблон, используемый для имен облачных компьютеров, подготовленных с помощью этой политики. Шаблон может содержать пользовательские маркеры текста и замены, включая %USERNAME:x% и %RAND:x%, которые представляют имя пользователя и случайно созданное число соответственно. Например, CPC-%USERNAME:4%-%RAND:5% означает, что имя облачного компьютера начинается с CPC-, за которым следует четырехзначное имя пользователя, а — символ, а затем пять случайных символов. Общая длина текста, созданного шаблоном, не может превышать 15 символов.
description String Описание политики подготовки.
displayName String Отображаемое имя политики подготовки.
domainJoinConfiguration Коллекция cloudPcDomainJoinConfiguration Задает список, упорядоченный по приоритету, в том, как облачные компьютеры присоединяются Microsoft Entra ID (Azure AD).
enableSingleSignOn Boolean Значение true, если к подготовленному облачному компьютеру можно получить доступ с помощью единого входа. False указывает, что подготовленный облачный компьютер не поддерживает эту функцию. По умолчанию используется значение false. Windows 365 пользователи могут использовать единый вход для проверки подлинности для Microsoft Entra ID с помощью параметров без пароля (например, ключей FIDO) для доступа к облачному компьютеру
id String Уникальный идентификатор, связанный с политикой подготовки. Этот идентификатор заполняется автоматически во время создания новой политики подготовки. Только для чтения.
imageDisplayName String Отображаемое имя образа операционной системы, используемого для подготовки. Например, Windows 11 preview + Приложения Microsoft 365 23H2 23H2.
imageId String Уникальный идентификатор, представляющий образ операционной системы, используемый для подготовки новых облачных компьютеров. Формат изображения типа коллекции: {publisherName_offerName_skuName}. Поддерживаемые значения для каждого параметра:
  • publisher: 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
imageType cloudPcProvisioningPolicyImageType Тип образа операционной системы (пользовательский или коллекции), используемый для подготовки на облачных компьютерах. Возможные значения: коллекция, пользовательская. Значение по умолчанию — коллекция.

Получение политики подготовки

Идентификатор операции: GetAProvisioningPolicyV1

Это действие позволяет получить сведения о конкретной политике подготовки.

Параметры

Имя Обязательно Тип Description
Идентификатор политики подготовки Да String Идентификатор политики подготовки. Необходимо включить.
$select нет String $select позволяет выбрать, какие свойства возвращаются из Graph.
$filter нет String $filter позволяет получить только подмножество коллекции из Graph.

Возвраты

Выходные данные этой операции являются динамическими.

Создание политики подготовки

Идентификатор операции: CreateAProvisioningPolicyV1

Это действие позволяет создать политику подготовки.

Параметры

Имя Обязательно Тип Description
Name Да String Политика подготовки, применяемая во время подготовки облачных компьютеров. Максимальная длина — 120 символов
Описание Да String Описание политики подготовки.
Конфигурация присоединения к домену Да
Идентификатор изображения Да String Это идентификатор образа, который вы хотите использовать для подготовки облачных компьютеров.
Отображаемое имя изображения Да String Имя образа операционной системы, используемого для облачного компьютера. Максимальная длина — 50 символов. Для этого свойства допускаются только буквы (A–Z, a–z), цифры (0–9) и специальные символы (-,_,.). Значение свойства не может начинаться или заканчиваться символом подчеркивания.
Тип изображения Да String Пользовательская или коллекция.
Тип подготовки Да String Общий или выделенный.
Windows параметр/языковой стандарт Да String Укажите язык или языковой стандарт, который вы хотите использовать. Windows 365 предоставляет более 30 таких языков или пар регионов.

Вы также можете добавить другие поля из Graph в разделе "Дополнительные параметры".

Возвраты

Выходные данные этой операции являются динамическими.

Назначение политики подготовки группе

Идентификатор операции: AssignAProvisioningPolicyToAGroupV1

Это действие позволяет назначить группу политике подготовки.

Параметры

Имя Обязательно Тип Description
Идентификатор политики подготовки Да String Это идентификатор политики подготовки, которому вы хотите назначить группу.
Назначения — идентификатор
Назначения — идентификатор целевой группы Да String Группа пользователей из идентификатора Entra.

Возвраты

Выходные данные этой операции являются динамическими.

Обновление политики подготовки

Идентификатор операции: UpdateAProvisioningPolicyV1

Это действие позволяет обновить политику подготовки.

Параметры

Имя Обязательно Тип Description
Идентификатор политики подготовки Да String Это идентификатор политики подготовки политики подготовки политики подготовки, которую вы хотите обновить.
Описание нет String Это то, что будет обновлено описание политики подготовки.

Вы также можете добавить другие поля из Graph в разделе "Дополнительные параметры".

Возвраты

Выходные данные этой операции являются динамическими.

Получение политики подготовки

Идентификатор операции: GetAProvisioningPolicyV1

Это действие позволяет получить сведения о политике подготовки.

Параметры

Имя Обязательно Тип Description
Идентификатор политики подготовки Да String Идентификатор политики подготовки для облачного компьютера, состоящий из 32 символов в формате GUID. Политика определяет тип облачного компьютера, который пользователь хочет создать.
$select нет String $select позволяет выбрать, какие свойства возвращаются из Graph.
$expand нет String $expand позволяет возвращать связанные ресурсы из Graph.

Вы также можете добавить другие поля из Graph в разделе "Дополнительные параметры".

Возвраты

Выходные данные этой операции являются динамическими.

Запуск удаленного действия

Идентификатор операции: RemoteActions

Это действие позволяет запускать удаленное действие на облачном компьютере.

Параметры

Имя Обязательно Тип Description
Идентификатор облачного КОМПЬЮТЕРА Да String Это позволяет указать, какой идентификатор облачного КОМПЬЮТЕРА вы хотите использовать с помощью удаленного действия.
Удаленное действие Да String Это позволяет выбрать, когда удаленные действия необходимо выполнить на облачном компьютере.
Удаленное действие — идентификатор моментального снимка нет String Если вы выбираете восстановление облачного компьютера, необходимо также указать идентификатор моментального снимка.
Удаленное действие — отображаемое имя нет String Если вы выбираете переименовать облачный компьютер, необходимо также указать отображаемое имя.

Возвраты

В случае успешного выполнения возвращается код отклика на содержимое 204 без содержимого.

Отправка HTTP-запроса Microsoft Graph

Идентификатор операции: HttpRequest

Это действие позволяет вызывать Graph напрямую и настраивать вызов.

Параметры

Имя Обязательно Тип Description
URI-адрес Да String Это позволяет указать URI для вызова, например: https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/auditEvents
Метод Да String Это позволяет определить метод вызова.

Вы также можете добавить другие поля (заголовки, текст и т. д.) в разделе "Дополнительные параметры".

Возвраты

Выходные данные этой операции являются динамическими.

Триггеры:

Все сценарии являются частью одного триггера, который можно выбрать в самом тексте триггера.

При активации удаленного действия на облачном компьютере Позволяет активировать поток при активации удаленного действия.
После завершения удаленного действия на облачном компьютере Позволяет активировать поток при завершении удаленного действия на облачном компьютере.
При обновлении политики подготовки Позволяет активировать поток при обновлении политики подготовки
При создании новой политики подготовки Позволяет запустить поток при создании политики подготовки.
При создании облачного компьютера Этот триггер позволяет запустить поток при создании облачного компьютера.

При обновлении политики подготовки или облачного компьютера

Идентификатор операции: Веб-перехватчик

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

Параметры

Имя Обязательно Тип Description
Сценарий Да Раскрывающийся список Вы можете выбрать один из поддерживаемых сценариев:
  1. При создании облачного компьютера
  2. При создании новой политики подготовки
  3. При обновлении политики подготовки
  4. После завершения удаленного действия на облачном компьютере
  5. При активации удаленного действия на облачном компьютере

Возвраты

Выходные данные этой операции являются динамическими.

Обновления документации 9/15:

  1. Добавьте "нерекомендуемый" в заголовок "При обновлении политики подготовки или облачного компьютера (не рекомендуется)" триггера
  2. Добавьте в его раздел: "Этот триггер может продолжать использоваться для существующих потоков, но в будущем не будет новых обновлений. Мы рекомендуем использовать новые триггеры".
  3. Добавьте новые документы для новых триггеров следующим образом:

При создании новой политики подготовки

Идентификатор операции: WebhookProvisioningPolicyCreated

Параметры:

Имя Обязательно Тип Description
Фильтрация имени политики подготовки нет String Это позволяет задать фильтры, если вы хотите активировать поток на основе шаблона имени политики. Например, если в организации используются шаблоны имен политики подготовки и вы хотите активировать поток, основанный на этом, можно указать шаблон здесь.
Идентификатор политики подготовки фильтра нет String Это позволяет выбрать один или несколько идентификаторов политик, на которых активируется этот поток.
Тип подготовки фильтра нет String Это позволяет выбрать один или несколько конкретных типов подготовки, для которых активируется этот поток. Например, может потребоваться активировать поток только для Windows 365 Корпоративная политик подготовки.

Возвраты

Выходные данные этой операции являются динамическими.

При создании облачного компьютера

Идентификатор операции: WebhookCloudPcProvisioned

Этот триггер позволяет активировать поток на основе создания облачного компьютера.

Параметры

Имя Обязательно Тип Description
Тип подготовки фильтра нет String Это позволяет указать, какой выпуск Windows 365 активирует этот поток. В фильтре можно указать несколько типов в связи "OR".

Возвраты

Выходные данные этой операции являются динамическими.

При обновлении политики подготовки

Идентификатор операции: WebhookProvisioningPolicyUpdated

Этот триггер позволяет активировать поток на основе обновления политики подготовки.

Параметры

Имя Обязательно Тип Description
Фильтрация имени политики подготовки нет String Это позволяет выбрать одно или несколько определенных имен политик, для которых активируется этот поток.
Идентификатор политики подготовки фильтра нет String Это позволяет выбрать один или несколько идентификаторов политик, на которых активируется этот поток.
Тип подготовки фильтра нет String Это позволяет выбрать один или несколько конкретных типов подготовки, для которых активируется этот поток. Например, может потребоваться активировать поток только для Windows 365 Корпоративная политик подготовки.

Возвраты

Имя Тип Description
provisioningPolicyId String Обновленный идентификатор политики подготовки. Состоит из 32 символов в формате GUID.
provisioningPolicyName String Имя политики подготовки, которое было обновлено.

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

Идентификатор операции: WebhookCloudPcRemoteActionTriggered

Этот триггер позволяет активировать поток на основе удаленного действия на облачном компьютере.

Параметры

Имя Обязательно Тип Description
Тип подготовки фильтра нет String Это позволяет выбрать один или несколько конкретных типов подготовки, для которых активируется этот поток. Например, может потребоваться активировать поток удаленных действий только для облачных компьютеров, связанных с политиками подготовки Windows 365 Корпоративная.

Возвраты

Имя Тип Description
CloudPcId String Идентификатор облачного КОМПЬЮТЕРА, который выполнил удаленное действие.
provisioningType String Тип подготовки, в котором показан выпуск Windows 365 Cloud PC.
Тип действия String Тип удаленного действия, например перезапуск.

После завершения удаленного действия на облачном компьютере

Идентификатор операции: Webhook.CloudPC.ActionCompleted

Этот триггер позволяет активировать поток на основе удаленного действия на облачном компьютере.

Параметры

Имя Обязательно Тип Description
Тип подготовки фильтра нет String Это позволяет выбрать один или несколько конкретных типов подготовки, для которых активируется этот поток. Например, может потребоваться активировать поток удаленных действий только для облачных компьютеров, связанных с политиками подготовки Windows 365 Корпоративная.

Возвраты

Имя Тип Description
CloudPcId String Идентификатор облачного КОМПЬЮТЕРА, который выполнил удаленное действие.
provisioningType String Тип подготовки, в котором показан выпуск Windows 365 Cloud PC.
Тип действия String Тип удаленного действия, например перезапуск.

Ограничения регулирования

Имя. Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Вывод списка облачных компьютеров

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

Запустите удаленное действие на облачном компьютере.
Назначение политики подготовки группе

Назначьте политику подготовки группе.
Обновление политики подготовки

Обновляет политику подготовки.
Отправка HTTP-запроса Microsoft Graph (предварительная версия)

Создание запроса REST API Microsoft Graph
Получение облачного компьютера

Возвращает облачный компьютер
Получение политик подготовки

Возвращает список политик подготовки.
Получение политики подготовки

Возвращает определенную политику подготовки.
Создание политики подготовки

Создает политику подготовки.
Удаление политики подготовки

Удаляет политику подготовки.

Вывод списка облачных компьютеров

Идентификатор операции:
ListCloudPCs

Вывод списка облачных компьютеров

Параметры

Имя. Ключ Обязательно Тип Описание
Выберите
 $select string

Выберите свойства для возврата.
Filter
 $filter string

Например: provisioningPolicyName eq 'XXX' и userPrincipalName eq 'XXX'

Возвращаемое значение

Имя. Путь Тип Описание
Идентификатор
 id string

Уникальный идентификатор сущности облачного компьютера, которая состоит из 32 символов в формате GUID.
Идентификатор устройства Entra
 aadDeviceId string

Идентификатор устройства Microsoft Entra для облачного компьютера, также известный как идентификатор устройства Azure Active Directory (Azure AD), состоящий из 32 символов в формате GUID. Созданная на виртуальной машине, присоединенной к Microsoft Entra ID. Только для чтения.
Показать имя
 displayName string

Отображаемое имя облачного компьютера. Максимальная длина — 64 символа. Только для чтения.
Отображаемое имя изображения
 imageDisplayName string

Имя образа операционной системы, используемого для облачного компьютера. Максимальная длина — 50 символов.
Идентификатор политики подготовки
 provisioningPolicyId string

Идентификатор политики подготовки для облачного компьютера, состоящий из 32 символов в формате GUID. Политика определяет тип облачного компьютера, который пользователь хочет создать.
Имя политики подготовки
 provisioningPolicyName string

Политика подготовки, применяемая во время подготовки облачных компьютеров.
Имя локального подключения
 onPremisesConnectionName string

Azure сетевое подключение, применяемое во время подготовки облачных компьютеров.
Идентификатор плана обслуживания
 servicePlanId string

Идентификатор плана обслуживания для облачного компьютера, состоящий из 32 символов в формате GUID.
Имя плана службы
 servicePlanName string

Имя плана обслуживания для сущности cloud PC для клиента.
статус
 status string

статус
Основное имя пользователя
 userPrincipalName string

Имя участника-пользователя (UPN) пользователя, назначенного облачному компьютеру.
Дата и время последнего изменения
 lastModifiedDateTime string

Дата и время последнего изменения облачного компьютера. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC.
Идентификатор управляемого устройства
 managedDeviceId string

Intune зарегистрированный идентификатор устройства для облачного компьютера, состоящий из 32 символов в формате GUID.
Имя управляемого устройства
 managedDeviceName string

Имя зарегистрированного устройства Intune для облачного компьютера.
Льготный период окончания даты и времени
 gracePeriodEndDateTime string

Дата и время окончания льготного периода, а также повторная подготовка или отзыв.
Состояние шифрования диска
 diskEncryptionState string

Состояние шифрования диска
Тип подготовки
 provisioningType string

Тип лицензий, используемых при подготовке облачных компьютеров с помощью этой политики.
Отображаемое имя выделения
 allotmentDisplayName string

Отображаемое имя выделения
Сведения о состоянии
 statusDetail string

Сведения о состоянии
Включение единого входа
 connectionSetting.enableSingleSignOn boolean

Указывает, включена ли политика подготовки единого входа для облачных компьютеров.
partnerAgentInstallResults
 partnerAgentInstallResults array of string

partnerAgentInstallResults

Запуск удаленного действия

Идентификатор операции:
RemoteActions

Запустите удаленное действие на облачном компьютере.

Параметры

Имя. Ключ Обязательно Тип Описание
Идентификатор облачного КОМПЬЮТЕРА
 cloudPcId True string

Уникальный идентификатор облачного компьютера.
Удаленное действие
 remoteAction True string

Удаленное действие, выполняемое на облачном компьютере.
Идентификатор моментального снимка облачного компьютера
 cloudPcSnapshotId string

Требуется для восстановления
Показать имя
 displayName string

Требуется для переименования

Назначение политики подготовки группе

Идентификатор операции:
AssignAProvisioningPolicyToAGroupV1

Назначьте политику подготовки группе.

Параметры

Имя. Ключ Обязательно Тип Описание
Идентификатор политики подготовки
 id True string

id
Идентификатор политики подготовки
 id string

Это идентификатор политики подготовки, которым вы хотите назначить группу
Идентификатор группы
 groupId True string

groupId
servicePlanId
 servicePlanId string

Идентификатор целевого плана обслуживания

Обновление политики подготовки

Идентификатор операции:
UpdateAProvisioningPolicyV1

Обновляет политику подготовки.

Параметры

Имя. Ключ Обязательно Тип Описание
Идентификатор политики подготовки
 id True string

id
Идентификатор группы
 autopatchGroupId string

autopatchGroupId
Идентификатор профиля подготовки устройства
 devicePreparationProfileId string

devicePreparationProfileId
Время ожидания приложения в минутах
 applicationTimeoutInMinutes integer

applicationTimeoutInMinutes
При отказе доступа к устройству отказано
 onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
Description
 description string

описание
Показать имя
 displayName string

отображаемое имя
Тип присоединения к домену
 domainJoinType string

domainJoinType
Локальный идентификатор подключения
 onPremisesConnectionId string

onPremisesConnectionId
Группа регионов
 regionGroup string

regionGroup
Имя региона
 regionName string

regionName
Тип
 type string

type
Включение единого входа
 enableSingleSignOn boolean

enableSingleSignOn
Отображаемое имя изображения
 imageDisplayName string

imageDisplayName
Идентификатор изображения
 imageId string

imageId
Тип изображения
 imageType string

тип изображения
Управляемый тип
 managedType string

managedType
Profile
 profile string

profile
Региональные настройки
 locale string

местность
Другие поля
 otherFields object

Другие поля

Отправка HTTP-запроса Microsoft Graph (предварительная версия)

Идентификатор операции:
HttpRequest

Создание запроса REST API Microsoft Graph

Параметры

Имя. Ключ Обязательно Тип Описание
URI
 Uri True string

Полный или относительный универсальный код ресурса (URI). Пример: https://graph.microsoft.com/{version}/{resource}
Метод
 Method True string

Метод HTTP (по умолчанию — GET)
Тело
 Body binary

Содержимое текста запроса
Тип контента
 ContentType string

Заголовок типа контента для текста (по умолчанию — application/json)
CustomHeader1
 CustomHeader1 string

Пользовательский заголовок 1. Укажите в формате: header-name: header-value
CustomHeader2
 CustomHeader2 string

Пользовательский заголовок 2. Укажите в формате: header-name: header-value
CustomHeader3
 CustomHeader3 string

Пользовательский заголовок 3. Укажите в формате: header-name: header-value
CustomHeader4
 CustomHeader4 string

Пользовательский заголовок 4. Укажите в формате: header-name: header-value
CustomHeader5
 CustomHeader5 string

Пользовательский заголовок 5. Укажите в формате: header-name: header-value

Возвращаемое значение

response
ObjectWithoutType

Получение облачного компьютера

Идентификатор операции:
GetACloudPCObject

Возвращает облачный компьютер

Параметры

Имя. Ключ Обязательно Тип Описание
Идентификатор облачного КОМПЬЮТЕРА
 cloudPcId True string

Уникальный идентификатор облачного компьютера.
Выберите
 $select string

Выберите свойства для возврата.

Возвращаемое значение

Имя. Путь Тип Описание
Идентификатор
 id string

Уникальный идентификатор сущности облачного компьютера, которая состоит из 32 символов в формате GUID.
Идентификатор устройства Entra
 aadDeviceId string

Идентификатор устройства Microsoft Entra для облачного компьютера, также известный как идентификатор устройства Azure Active Directory (Azure AD), состоящий из 32 символов в формате GUID. Созданная на виртуальной машине, присоединенной к Microsoft Entra ID. Только для чтения.
Показать имя
 displayName string

Отображаемое имя облачного компьютера. Максимальная длина — 64 символа. Только для чтения.
Отображаемое имя изображения
 imageDisplayName string

Имя образа операционной системы, используемого для облачного компьютера. Максимальная длина — 50 символов.
Идентификатор политики подготовки
 provisioningPolicyId string

Идентификатор политики подготовки для облачного компьютера, состоящий из 32 символов в формате GUID. Политика определяет тип облачного компьютера, который пользователь хочет создать.
Имя политики подготовки
 provisioningPolicyName string

Политика подготовки, применяемая во время подготовки облачных компьютеров.
Имя локального подключения
 onPremisesConnectionName string

Azure сетевое подключение, применяемое во время подготовки облачных компьютеров.
Идентификатор плана обслуживания
 servicePlanId string

Идентификатор плана обслуживания для облачного компьютера, состоящий из 32 символов в формате GUID.
Имя плана службы
 servicePlanName string

Имя плана обслуживания для сущности cloud PC для клиента.
статус
 status string

статус
Основное имя пользователя
 userPrincipalName string

Имя участника-пользователя (UPN) пользователя, назначенного облачному компьютеру.
Дата и время последнего изменения
 lastModifiedDateTime string

Дата и время последнего изменения облачного компьютера. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC.
Идентификатор управляемого устройства
 managedDeviceId string

Intune зарегистрированный идентификатор устройства для облачного компьютера, состоящий из 32 символов в формате GUID.
Имя управляемого устройства
 managedDeviceName string

Имя зарегистрированного устройства Intune для облачного компьютера.
Льготный период окончания даты и времени
 gracePeriodEndDateTime string

Дата и время окончания льготного периода, а также повторная подготовка или отзыв.
Состояние шифрования диска
 diskEncryptionState string

Состояние шифрования диска
Тип подготовки
 provisioningType string

Тип лицензий, используемых при подготовке облачных компьютеров с помощью этой политики.
Отображаемое имя выделения
 allotmentDisplayName string

Отображаемое имя выделения
Сведения о состоянии
 statusDetail string

Сведения о состоянии
Включение единого входа
 connectionSetting.enableSingleSignOn boolean

Включение единого входа
partnerAgentInstallResults
 partnerAgentInstallResults array of string

partnerAgentInstallResults

Получение политик подготовки

Идентификатор операции:
GetProvisioningPoliciesV1

Возвращает список политик подготовки.

Параметры

Имя. Ключ Обязательно Тип Описание
Выберите
 $select string

Возвращает свойства по умолчанию, если не указано; первый параметр возвращает все свойства.
Filter
 $filter string

Фильтрация элементов по значениям свойств.
Развернуть
 $expand string

Развертывает связанные сущности в строку.

Возвращаемое значение

Имя. Путь Тип Описание
value
 value array of object

value
assignments
 value.assignments array of object
items
 value.assignments object
Description
 value.description string

Описание политики подготовки.
Показать имя
 value.displayName string

Отображаемое имя политики подготовки.
Конфигурации присоединения к домену
 value.domainJoinConfigurations array of object

Задает список, упорядоченный по приоритету по принципу соединения облачных компьютеров Microsoft Entra ID.
onPremisesConnectionId
 value.domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
type
 value.domainJoinConfigurations.type string

type
managedType
 value.microsoftManagedDesktop.managedType string

managedType
profile
 value.microsoftManagedDesktop.profile string

profile
autopatchGroupId
 value.autopatch.autopatchGroupId string

autopatchGroupId
devicePreparationProfileId
 value.autopilotConfiguration.devicePreparationProfileId string

devicePreparationProfileId
applicationTimeoutInMinutes
 value.autopilotConfiguration.applicationTimeoutInMinutes integer

applicationTimeoutInMinutes
onFailureDeviceAccessDenied
 value.autopilotConfiguration.onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
Включение единого входа
 value.enableSingleSignOn boolean

Указывает, включена ли политика подготовки единого входа для облачных компьютеров.
Идентификатор
 value.id string

id
Отображаемое имя изображения
 value.imageDisplayName string

Отображаемое имя образа ОС, который вы подготавливаете.
Идентификатор изображения
 value.imageId string

Идентификатор образа операционной системы, который требуется подготовить на облачных компьютерах.
Тип изображения
 value.imageType string

Тип образа ОС (пользовательский или коллекцию), который требуется подготовить на облачных компьютерах.
местность
 value.windowsSetting.locale string

местность
Managedby
 value.managedBy string

Managedby
Тип подготовки
 value.provisioningType string

Указывает тип лицензии, используемой при подготовке облачных компьютеров с помощью этой политики.

Получение политики подготовки

Идентификатор операции:
GetAProvisioningPolicyV1

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

Параметры

Имя. Ключ Обязательно Тип Описание
Идентификатор политики подготовки
 id True string

id
Выберите
 $select string

Возвращает свойства по умолчанию, если не указано; первый параметр возвращает все свойства.
Развернуть
 $expand string

Развертывает связанные сущности в строку.

Возвращаемое значение

Имя. Путь Тип Описание
assignments
 assignments array of object
items
 assignments object
Description
 description string

Описание политики подготовки.
Показать имя
 displayName string

Отображаемое имя политики подготовки.
Конфигурации присоединения к домену
 domainJoinConfigurations array of object

Задает список, упорядоченный по приоритету по принципу соединения облачных компьютеров Microsoft Entra ID.
onPremisesConnectionId
 domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
type
 domainJoinConfigurations.type string

type
managedType
 microsoftManagedDesktop.managedType string

managedType
profile
 microsoftManagedDesktop.profile string

profile
autopatchGroupId
 autopatch.autopatchGroupId string

autopatchGroupId
devicePreparationProfileId
 autopilotConfiguration.devicePreparationProfileId string

devicePreparationProfileId
applicationTimeoutInMinutes
 autopilotConfiguration.applicationTimeoutInMinutes integer

applicationTimeoutInMinutes
onFailureDeviceAccessDenied
 autopilotConfiguration.onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
Включение единого входа
 enableSingleSignOn boolean

Указывает, включена ли политика подготовки единого входа для облачных компьютеров.
Идентификатор
 id string

id
Отображаемое имя изображения
 imageDisplayName string

Отображаемое имя образа ОС, который вы подготавливаете.
Идентификатор изображения
 imageId string

Идентификатор образа операционной системы, который требуется подготовить на облачных компьютерах.
Тип изображения
 imageType string

Тип образа ОС (пользовательский или коллекцию), который требуется подготовить на облачных компьютерах.
местность
 windowsSetting.locale string

местность
Managedby
 managedBy string

Managedby
Тип подготовки
 provisioningType string

Указывает тип лицензии, используемой при подготовке облачных компьютеров с помощью этой политики.

Создание политики подготовки

Идентификатор операции:
CreateAProvisioningPolicyV1

Создает политику подготовки.

Параметры

Имя. Ключ Обязательно Тип Описание
Имя
 displayName True string

отображаемое имя
Description
 description True string

описание
domainJoinType
 domainJoinType string
type
 type string
regionName
 regionName string
onPremisesConnectionId
 onPremisesConnectionId string
regionGroup
 regionGroup string
Другие поля
 otherFields object

Другие поля
Включение единого входа
 enableSingleSignOn boolean

enableSingleSignOn
Идентификатор изображения
 imageId True string

imageId
Отображаемое имя изображения
 imageDisplayName True string

imageDisplayName
Тип изображения
 imageType True string

тип изображения
Тип подготовки
 provisioningType True string

provisioningType
Региональные настройки
 locale True string

местность
Управляемый тип
 managedType string

managedType
Profile
 profile string

profile

Возвращаемое значение

Имя. Путь Тип Описание
id
 id string

id
Показать имя
 displayName string

Отображаемое имя политики подготовки.
Description
 description string

Описание политики подготовки.
Идентификатор изображения
 imageId string

Идентификатор образа операционной системы, который требуется подготовить на облачных компьютерах.
Отображаемое имя изображения
 imageDisplayName string

Отображаемое имя образа ОС, который вы подготавливаете.
Тип изображения
 imageType string

Тип образа ОС (пользовательский или коллекцию), который требуется подготовить на облачных компьютерах.
Включение единого входа
 enableSingleSignOn boolean

Указывает, включена ли политика подготовки единого входа для облачных компьютеров.
Шаблон именования облачных компьютеров
 cloudPcNamingTemplate string

Шаблон, используемый для имен облачных компьютеров, подготовленных с помощью этой политики.
Тип подготовки
 provisioningType string

Указывает тип лицензии, используемой при подготовке облачных компьютеров с помощью этой политики.
Managedby
 managedBy string

Managedby
scopeIds
 scopeIds array of

scopeIds
Параметры автозапачений
 autopatch string

Указывает параметры автопатчирования Windows для облачных компьютеров с помощью этой политики подготовки.
autopilotConfiguration
 autopilotConfiguration string

autopilotConfiguration
domainJoinConfigurations
 domainJoinConfigurations array of object

domainJoinConfigurations
domainJoinType
 domainJoinConfigurations.domainJoinType string

domainJoinType
type
 domainJoinConfigurations.type string

type
regionName
 domainJoinConfigurations.regionName string

regionName
onPremisesConnectionId
 domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
regionGroup
 domainJoinConfigurations.regionGroup string

regionGroup
managedType
 microsoftManagedDesktop.managedType string

managedType
type
 microsoftManagedDesktop.type string

type
profile
 microsoftManagedDesktop.profile string

profile
местность
 windowsSetting.locale string

местность
language
 windowsSettings.language string

language

Удаление политики подготовки

Идентификатор операции:
DeleteAProvisioningPolicyV1

Удаляет политику подготовки.

Параметры

Имя. Ключ Обязательно Тип Описание
Идентификатор политики подготовки
 id True string

id

Триггеры

После завершения удаленного действия на облачном компьютере

Позволяет активировать поток при завершении удаленного действия на облачном компьютере.
При активации удаленного действия на облачном компьютере

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

Позволяет активировать поток при обновлении политики подготовки
При обновлении политики подготовки или облачного компьютера (не рекомендуется) [DEPRECATED]

При обновлении политики подготовки или облачного компьютера (не рекомендуется)
При создании новой политики подготовки

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

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

После завершения удаленного действия на облачном компьютере

Идентификатор операции:
WebhookCloudPcRemoteActionCompleted

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

Параметры

Имя. Ключ Обязательно Тип Описание
Тип подготовки
 provisioningTypeNames array of string

Выберите один или несколько типов подготовки.

Возвращаемое значение

Имя. Путь Тип Описание
array of object
tenantId
 data.tenantId string

tenantId
category
 data.category string

category
действие
 data.action string

действие
CloudPCId
 data.data.cloudPCId string

CloudPCId
policyId
 data.data.policyId string

policyId

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

Идентификатор операции:
WebhookCloudPcRemoteActionTriggered

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

Параметры

Имя. Ключ Обязательно Тип Описание
Тип подготовки
 provisioningTypeNames array of string

Выберите один или несколько типов подготовки.

Возвращаемое значение

Имя. Путь Тип Описание
array of object
tenantId
 data.tenantId string

tenantId
category
 data.category string

category
действие
 data.action string

действие
CloudPCId
 data.data.cloudPCId string

CloudPCId
policyId
 data.data.policyId string

policyId

При обновлении политики подготовки

Идентификатор операции:
WebhookProvisioningPolicyUpdated

Позволяет активировать поток при обновлении политики подготовки

Параметры

Имя. Ключ Обязательно Тип Описание
Имя политики подготовки
 provisioningPolicyNames array of string

Выберите политику подготовки для отслеживания обновлений.
Идентификатор политики подготовки
 provisioningPolicyIds array of string

Введите один или несколько идентификаторов политик подготовки.
Тип подготовки
 provisioningTypeNames array of string

Выберите один или несколько типов подготовки.

Возвращаемое значение

Имя. Путь Тип Описание
array of object
tenantId
 data.tenantId string

tenantId
category
 data.category string

category
действие
 data.action string

действие
CloudPCId
 data.data.cloudPCId string

CloudPCId
policyId
 data.data.policyId string

policyId

При обновлении политики подготовки или облачного компьютера (не рекомендуется) [DEPRECATED]

Идентификатор операции:
Webhook

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

Параметры

Имя. Ключ Обязательно Тип Описание
сценарий
 scenario True string

сценарий

При создании новой политики подготовки

Идентификатор операции:
WebhookProvisioningPolicyCreated

Позволяет запустить поток при создании политики подготовки.

Параметры

Имя. Ключ Обязательно Тип Описание
Имя политики подготовки
 provisioningPolicyNames array of string

Выберите политику подготовки для отслеживания обновлений.
Идентификатор политики подготовки
 provisioningPolicyIds array of string

Введите один или несколько идентификаторов политик подготовки.
Тип подготовки
 provisioningTypeNames array of string

Выберите один или несколько типов подготовки.

Возвращаемое значение

Имя. Путь Тип Описание
array of object
tenantId
 data.tenantId string

tenantId
category
 data.category string

category
действие
 data.action string

действие
CloudPCId
 data.data.cloudPCId string

CloudPCId
policyId
 data.data.policyId string

policyId

При создании облачного компьютера

Идентификатор операции:
WebhookCloudPcProvisioned

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

Параметры

Имя. Ключ Обязательно Тип Описание
Тип подготовки
 provisioningTypeNames array of string

Выберите один или несколько типов подготовки.

Возвращаемое значение

Имя. Путь Тип Описание
array of object
tenantId
 data.tenantId string

tenantId
category
 data.category string

category
действие
 data.action string

действие
CloudPCId
 data.data.cloudPCId string

CloudPCId
policyId
 data.data.policyId string

policyId

Определения

ObjectWithoutType