Тип ресурса cloudPC

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

Важно!

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

Представляет управляемый облаком виртуальный рабочий стол. Этот облачный компьютер также зарегистрирован в Intune и управляется через портал Microsoft Endpoint Manager, поэтому облачный компьютер также имеет соответствующий идентификатор устройства, управляемый Intune.

Методы

Метод	Тип возвращаемых данных	Описание
Перечисление облачных ПК	Коллекция cloudPC	Перечисление свойств и связей объектов Cloud PC.
Получение cloudPC	cloudPC	Чтение свойств и связей объекта Cloud PC.
Получение подготовленных облачных компьютеров	Коллекция cloudPC	Получите все подготовленные облачные компьютеры определенного плана обслуживания для пользователей в группе пользователей Microsoft Entra.
Изменение типа учетной записи пользователя	Нет	Измените тип учетной записи пользователя на определенном облачном компьютере.
Окончание льготного периода	Нет	Окончание льготного периода для объекта Cloud PC.
Получение результатов удаленного действия	cloudPcRemoteActionResult	Проверьте результаты удаленных действий, указанных облачным компьютером , для устройства облачного компьютера.
Включение питания	Нет	Включите определенный объект Windows Frontline Cloud PC. Это действие поддерживает сценарии администрирования MEM.
Выключение питания	Нет	Отключите определенный объект Windows Frontline Cloud PC. Это действие поддерживает сценарии администрирования MEM.
Перезагрузки	Нет	Перезагрузите определенный объект Cloud PC.
Rename	Нет	Переименуйте определенный объект Cloud PC. Используйте этот API для обновления displayName для сущности Cloud PC.
Повторная подготовка	Нет	Повторная подготовка объекта Cloud PC.
Массовая повторная подготовка удаленного действия	Нет	Массовая повторная подготовка набора устройств облачных компьютеров с Intune управляемыми идентификаторами устройств.
Изменение размера удаленного действия	Нет	Обновление или понижение уровня существующего облачного компьютера до другой конфигурации с новым виртуальным ЦП и размером хранилища с помощью Intune управляемого идентификатора устройства.
Start	Нет	Запустите определенный облачный компьютер для пользователя. В настоящее время поддерживаются только Windows 365 Frontline облачные компьютеры.
Stop	Нет	Остановите определенный облачный компьютер для пользователя. В настоящее время поддерживаются только Windows 365 Frontline облачные компьютеры.
Устранение неполадок	Нет	Устранение неполадок с определенным объектом Cloud PC. Используйте этот API для проверка состояния работоспособности облачного компьютера и узла сеансов.
Восстановление	Нет	Восстановление объекта Cloud PC до предыдущего состояния из snapshot.
Удаленное действие массового восстановления	cloudPcBulkRemoteActionResult	Восстановите несколько облачных компьютеров с помощью одного запроса, включающего идентификаторы Intune управляемых устройств, а также дату и время точки восстановления.
Установка состояния проверки	Нет	Задайте состояние проверки определенного облачного компьютера.
Получение состояния проверки	cloudPcReviewStatus	Получение состояния проверки определенного облачного компьютера.
Состояние массовой проверки	cloudPcBulkRemoteActionResult	Задайте состояние проверки нескольких облачных компьютеров с помощью одного запроса, включающего идентификаторы Intune управляемых устройств.
Список пользователей	Коллекция cloudPC	Выведите список устройств Cloud PC, которые относятся к вошедшего пользователя.
Получение сведений о запуске для пользователя	cloudPcLaunchInfo	Получите cloudPcLaunchInfo для вошедшего пользователя.
Получение журнала подключений	Коллекция cloudPcConnectivityEvent	Получите журнал подключений к облачному компьютеру.
Получение поддерживаемых удаленных действий	Коллекция cloudPcRemoteActionCapability	Получите список поддерживаемых удаленных действий облачного компьютера для определенного устройства Cloud PC, включая имена действий и возможности.
Повторная установка агента партнера	Нет	Повторите установку для агентов партнеров, которые не удалось установить на облачном компьютере.
Массовое изменение размера	Коллекция cloudPcRemoteActionResult	Выполните действие массового изменения размера, чтобы изменить размер группы облачных компьютеров, успешно прошедших проверку (cloudPC: validateBulkResize). Если какие-либо устройства не могут быть изменены, они помечаются как "изменение размера не удалось", в то время как остальные устройства предназначены provisioned для изменения размера.
Проверка массового изменения размера	коллекция cloudPcResizeValidateResult	Убедитесь, что набор устройств облачных компьютеров соответствует требованиям к массовому размеру.
Получение состояния доступа к передней линии	frontlineCloudPcAccessState	Получите состояние доступа для переднего облачного компьютера. Возможные значения: unassigned, noLicensesAvailable, activationFailed, active, activating, standbyMode, unknownFutureValue.
Получение состояния доступа к рабочей смене (не рекомендуется)	shiftWorkCloudPcAccessState	Получите состояние доступа для рабочего сменного облачного компьютера. Возможные значения: , , , , , activating, waitlisted, unknownFutureValue, . standbyModeactiveactivationFailednoLicensesAvailableunassigned Обратите внимание, что необходимо использовать Prefer: include-unknown-enum-members заголовок запроса, чтобы получить следующее значение в этой развиваемой перечислении: standbyMode. Этот API является устаревшим и перестанет возвращать данные 31 декабря 2023 г. В дальнейшем используйте API getFrontlineCloudPcAccessState .
Повторная подготовка удаленного действия (не рекомендуется)	Нет	Повторная подготовка облачного компьютера с помощью Intune управляемого идентификатора устройства. Этот API является устаревшим и перестанет возвращать данные 30 сентября 2023 г. В дальнейшем используйте API повторной подготовки .
Удаленное действие восстановления (не рекомендуется)	Нет	Восстановление устройства облачного компьютера до предыдущего состояния с помощью Intune управляемого идентификатора устройства. Этот API является устаревшим и перестанет возвращать данные 30 сентября 2023 г. В дальнейшем используйте API восстановления .

Свойства

Свойство	Тип	Описание
aadDeviceId	String	Идентификатор Microsoft Entra устройства облачного компьютера.
allotmentDisplayName	String	Имя выделения разделяет лицензии клиента на небольшие пакеты или группы, которые помогают ограничить количество лицензий, доступных для использования в определенном назначении. Если provisioningType имеет значение dedicated, то имя выделения — null. Только для чтения.
connectivityResult	cloudPcConnectivityResult	Работоспособность подключения проверка результатом работы облачного компьютера, включая обновленную метку времени и возможность подключения облачного компьютера.
diskEncryptionState	cloudPcDiskEncryptionState	Шифрование диска, примененное к облачному компьютеру. Возможные значения: notAvailable, notEncrypted, encryptedUsingPlatformManagedKey, encryptedUsingCustomerManagedKey и unknownFutureValue.
displayName	String	Отображаемое имя облачного компьютера.
gracePeriodEndDateTime	DateTimeOffset	Дата и время окончания льготного периода, а также повторная подготовка или отзыв. Требуется только в том случае, если состояние равно inGracePeriod. Метка времени отображается в формате ISO 8601 и в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
id	String	Уникальный идентификатор облачного компьютера. Только для чтения.
imageDisplayName	String	Имя образа ОС, который находится на облачном компьютере.
lastLoginResult	cloudPcLoginResult	Последний результат входа облачного компьютера. Например, { "time": "2014-01-01T00:00:00Z"}.
lastModifiedDateTime	DateTimeOffset	Дата и время последнего изменения облачного компьютера. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, полночь в формате UTC 1 января 2014 г. имеет значение 2014-01-01T00:00:00Z.
lastRemoteActionResult	cloudPcRemoteActionResult	Последний результат удаленного действия корпоративных облачных компьютеров. Поддерживаемые удаленные действия: Reboot, Rename, Reprovision, Restore, , Troubleshoot.
managedDeviceId	String	Идентификатор Intune устройства облачного компьютера.
managedDeviceName	String	Intune имя устройства облачного компьютера.
onPremisesConnectionName	String	Сетевое подключение Azure, применяемое во время подготовки облачных компьютеров.
osVersion	cloudPcOperatingSystem	Версия операционной системы (ОС), подготавливаемая на облачных компьютерах. Возможные значения: windows10, windows11, unknownFutureValue.
partnerAgentInstallResults	коллекция cloudPcPartnerAgentInstallResult	Результаты установки каждого агента-партнера на облачном компьютере.
powerState	cloudPcPowerState	Состояние питания облачного компьютера. Допустимые значения: running, poweredOff, unknown. Это свойство поддерживает только облачные компьютеры с сменой работы.
provisioningPolicyId	String	Идентификатор политики подготовки облачного компьютера.
provisioningPolicyName	String	Политика подготовки, применяемая во время подготовки облачных компьютеров.
provisioningType	cloudPcProvisioningType	Тип лицензий, используемых при подготовке облачных компьютеров с помощью этой политики. Возможные значения: dedicated, shared, unknownFutureValue,sharedByUser , sharedByUser. Необходимо использовать Prefer: include-unknown-enum-members заголовок запроса, чтобы получить следующие значения из этого развиваемого перечисления: sharedByUser, sharedByEntraGroup. Значение по умолчанию — dedicated. ВНИМАНИЕ! Участник shared не рекомендуется использовать и перестанет возвращаться 30 апреля 2027 г.; в будущем используйте sharedByUser его.
servicePlanId	String	Идентификатор плана обслуживания облачного компьютера.
servicePlanName	String	Имя плана обслуживания облачного компьютера.
servicePlanType	cloudPcServicePlanType	Тип плана обслуживания облачного компьютера.
status	microsoft.graph.cloudPcStatus	Состояние облачного компьютера. Возможные значения: notProvisioned, provisioning, provisioned, inGracePeriod, deprovisioning, failed, provisionedWithWarnings, resizing, restoring, pendingProvision, unknownFutureValue, movingRegion, resizePendingLicense. Необходимо использовать Prefer: include-unknown-enum-members заголовок запроса, чтобы получить следующие значения из этого развиваемого перечисления: movingRegion, resizePendingLicense.
statusDetails	cloudPcStatusDetails	Сведения о состоянии облачного компьютера.
userAccountType	cloudPcUserAccountType	Тип учетной записи пользователя на подготовленных облачных компьютерах. Возможные значения: standardUser, administrator, unknownFutureValue.
userPrincipalName	String	Имя участника-пользователя (UPN) пользователя, назначенного облачному компьютеру.

Значения cloudPcDiskEncryptionState

Member	Описание
notAvailable	Облачный компьютер не подготовлен или находится в состоянии, когда шифрование недоступно.
notEncrypted	Облачный компьютер должен быть зашифрован, но шифрование еще не выполнено (зарезервировано, не должно происходить).
encryptedUsingPlatformManagedKey	Облачный компьютер шифруется с помощью ключа, управляемого платформой. Этот элемент является значением по умолчанию, если ключ, управляемый клиентом, не включен.
encryptedUsingCustomerManagedKey	Облачный компьютер шифруется с помощью ключа, управляемого клиентом.
unknownFutureValue	Изменяемое значение перечисления sentinel. Не используйте.

Значения cloudPcPowerState

Member	Описание
Запущена	Состояние облачного компьютера запущено.
poweredOff	Состояние облачного компьютера отключено.
unknown	Состояние облачного компьютера неизвестно.

Значения cloudPcStatus

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

Member	Описание
NotProvisioned	Облачный компьютер еще не подготовлен.
Подготовки	Выполняется подготовка облачных компьютеров.
Подготовлено	Облачный компьютер подготовлен, и пользователи могут получить к нему доступ.
inGracePeriod	Облачный компьютер находится в течение одной недели льготного периода до отзыва.
отзыв	Облачный компьютер отзывается.
Сбой при	Операция на облачном компьютере завершилась сбоем.
provisionedWithWarnings	Облачный компьютер подготовлен, и пользователи могут получить к нему доступ с некоторыми предупреждениями. Пользователь может продолжать использовать этот облачный компьютер.
Изменение размера	Размер облачного компьютера выполняется.
pendingProvision	Подготовка ожидается на облачном компьютере. В этом случае число облачных компьютеров в льготный период больше, чем общее количество доступных лицензий.
Восстановление	Облачный компьютер восстанавливается.
unknownFutureValue	Изменяемое значение перечисления sentinel. Не используйте.
movingRegion	Указывает, что облачный компьютер перемещается из одного региона в другой.
resizePendingLicense	Указывает, что процесс изменения размера облачного компьютера был инициирован, но не может быть завершен, так как целевая лицензия не определена. В настоящее время клиент ожидает действий по устранению проблемы с лицензированием.

значения frontlineCloudPcAccessState

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

значения shiftWorkCloudPcAccessState (не рекомендуется)

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

Member	Описание
unassigned	Установите значение unassigned, если облачный компьютер не использует лицензии общего использования. Значение по умолчанию — unassigned.
noLicensesAvailable	Указывает, что используются все лицензии общего использования.
activationFailed	Указывает, что активация рабочей смены облачного компьютера завершилась сбоем после того, как пользователь запросил смену рабочего облачного компьютера.
Активных	Указывает, что рабочий облачный компьютер находится в активном состоянии с назначенной лицензией общего использования, и пользователь может подключиться к облачному компьютеру.
Активация	Указывает, что пользователь попросил подключить облачный компьютер и служба запускается.
waitlisted (не рекомендуется)	Указывает, что рабочий облачный компьютер находится в списке ожидания после того, как пользователь запросит подключение к этому облачному компьютеру и активно используются все лицензии общего использования. Это значение не рекомендуется и перестанет возвращаться 17 мая 2023 г.
unknownFutureValue	Изменяемое значение перечисления sentinel. Не используйте.
standbyMode	Указывает, что рабочий рабочий режим смены Облачный компьютер находится в режиме ожидания перед завершением работы и освобождением. Сменный рабочий облачный компьютер в режиме ожидания по-прежнему доступен пользователю.

Связи

Отсутствуют.

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

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

{
  "@odata.type": "#microsoft.graph.cloudPC",
  "aadDeviceId": "String",
  "allotmentDisplayName": "String",
  "connectivityResult": "String",
  "diskEncryptionState": "String",
  "displayName": "String",
  "gracePeriodEndDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "imageDisplayName": "String",
  "lastLoginResult": "String",
  "lastModifiedDateTime": "String (timestamp)",
  "lastRemoteActionResult": "String",
  "managedDeviceId": "String",
  "managedDeviceName": "String",
  "onPremisesConnectionName": "String",
  "powerState": "String",
  "osVersion": "String",
  "partnerAgentInstallResults": "String",
  "provisioningPolicyId": "String",
  "provisioningPolicyName": "String",
  "provisioningType": "String",
  "servicePlanId": "String",
  "servicePlanName": "String",
  "servicePlanType": "String",
  "status": "String",
  "userAccountType": "String",
  "userPrincipalName": "String"
}