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

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
Категории ИТ-операции; Продуктивность

Соединитель Windows 365 предоставляет действия для управления компьютерами с облачными компьютерами Windows 365 и политиками подготовки в среде Microsoft Intune. Этот соединитель позволяет автоматизировать операции жизненного цикла облачных ПК, управление политиками подготовки и административные задачи с помощью потоков Power Automate.

Служба, класс и регионы

Служба Класс 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 Intune
  • Достаточные привилегии в управлении доступом на основе ролей (RBAC) Microsoft Intune для управления ресурсами Windows 365
  • Учетная запись Azure AD с соответствующими разрешениями

Необходимые разрешения

У пользователей должна быть одна из следующих ролей RBAC Intune:

  • Глобальный администратор
  • Администратор службы Intune
  • Администратор Windows365 (для операций с облачными компьютерами)
  • Пользовательская роль с разрешениями Windows 365 (требуется Webhook.Create и Webhook.Delete для операций триггера)

Важно. Для этого соединителя требуются лицензии Windows 365 и соответствующие разрешения Microsoft Intune RBAC. Все операции используют API Microsoft Graph и применяются к ограничениям регулирования API Graph.

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

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

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

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

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

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

Действия

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

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

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

Параметры

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

Возвраты

Имя Тип Description
aadDeviceId String Microsoft Entra идентификатор устройства для облачного компьютера, также известный как идентификатор устройства Azure Active Directory (Azure AD), состоящий из 32 символов в формате GUID. Создано на виртуальной машине, присоединенной к Microsoft Entra ID. Только для чтения.
diskEncryptionState String Показывает состояние шифрования диска.
отображаемое имя 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 для бизнеса облачные компьютеры не Intune автоматически регистрируются Windows 365. Только для чтения.
managedDeviceName String Имя зарегистрированного устройства Intune для облачного компьютера. Свойство managedDeviceName для компьютеров с облачными компьютерами Windows 365 business Cloud всегда имеет значение NULL, так как компьютеры с облачными компьютерами Windows 365 для бизнеса не регистрируются автоматически в 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. Только для чтения.

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

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

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

Параметры

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

Возвраты

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

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

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

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

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

Параметры

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

Возвраты

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

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

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

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

Параметры

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

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

Возвраты

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

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

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

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

Параметры

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

Возвраты

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

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

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

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

Параметры

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

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

Возвраты

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

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

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

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

Параметры

Имя Обязательно Тип 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 Это позволяет определить метод вызова.

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

Возвраты

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

Triggers

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

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

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

  • Идентификатор операции: Веб-перехватчик
  • Описание: Этот триггер запускается при обновлении политики подготовки или облачного компьютера.

Параметры

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

Возвраты

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

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

Имя Вызовы Период обновления
Вызовы 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

Триггеры

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

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

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

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

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

Параметры

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

сценарий

Определения

ObjectWithoutType