Тип ресурса 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.
Включение питания	Нет	Включите определенный объект Windows Frontline Cloud PC. Это действие поддерживает сценарии администрирования MEM.
Выключение питания	Нет	Отключите определенный объект Windows Frontline Cloud PC. Это действие поддерживает сценарии администрирования MEM.
Перезагрузить	Нет	Перезагрузите определенный объект Cloud PC.
Rename	Нет	Переименуйте определенный объект Cloud PC. Используйте этот API для обновления displayName для сущности Cloud PC.
Повторная подготовка	Нет	Повторная подготовка объекта Cloud PC.
Resize	Нет	Обновите или понизите существующий облачный компьютер до конфигурации с новым виртуальным ЦП (vCPU) и размером хранилища.
Start	Нет	Запустите определенный облачный компьютер для пользователя. В настоящее время поддерживаются только облачные компьютеры с Windows 365 Frontline.
Stop	Нет	Остановите определенный облачный компьютер для пользователя. В настоящее время поддерживаются только облачные компьютеры с Windows 365 Frontline.
Устранение неполадок	Нет	Устранение неполадок с определенным объектом Cloud PC. Используйте этот API для проверки состояния работоспособности облачного компьютера и узла сеансов.
Восстановление	Нет	Восстановление объекта Cloud PC до предыдущего состояния из моментального снимка.
Установка состояния проверки	Нет	Задайте состояние проверки определенного облачного компьютера с помощью идентификатора облачного компьютера.
Получение состояния проверки	cloudPcReviewStatus	Получение состояния проверки облачного компьютера.
Состояние массовой проверки	cloudPcBulkRemoteActionResult	Задайте состояние проверки нескольких облачных компьютеров с помощью одного запроса, включающего идентификаторы управляемых устройств Intune.
Список пользователей	Коллекция cloudPC	Выведите список устройств Cloud PC, которые относятся к вошедшего пользователя.
Получение сведений о запуске для пользователя	cloudPcLaunchInfo	Получите cloudPcLaunchInfo для вошедшего пользователя.
Получение журнала подключений	Коллекция cloudPcConnectivityEvent	Получите журнал подключений к облачному компьютеру.
Получение поддерживаемых удаленных действий	Коллекция cloudPcRemoteActionCapability	Получите список поддерживаемых удаленных действий облачного компьютера для определенного устройства Cloud PC, включая имена действий и возможности.
Получение результатов удаленного действия	Коллекция cloudPcRemoteActionResult	Получите результаты удаленного действия и проверьте состояние определенного удаленного действия, выполненного на связанном облачном компьютере.
Повторная установка агента партнера	Нет	Повторите установку для агентов партнеров, которые не удалось установить на облачном компьютере.
Проверка массового изменения размера	коллекция cloudPcResizeValidateResult	Убедитесь, что набор устройств облачных компьютеров соответствует требованиям к массовому размеру.
Создание моментального снимка	Нет	Создайте моментальный снимок для определенного устройства облачного компьютера.
Получение состояния доступа к передней линии	frontlineCloudPcAccessState	Получите состояние доступа для переднего облачного компьютера. Возможные значения: unassigned, noLicensesAvailable, activationFailed, active, activating, standbyMode, unknownFutureValue.
Массовая повторная подготовка удаленного действия (не рекомендуется)	Нет	Массовая повторная подготовка набора облачных компьютеров с управляемыми идентификаторами устройств Intune. Этот API устарел и перестал возвращать данные 24 сентября 2023 г. В дальнейшем используйте ресурс cloudPcBulkReprovision .
Массовое изменение размера (не рекомендуется)	Коллекция cloudPcRemoteActionResult	Выполните действие массового изменения размера, чтобы изменить размер группы облачных компьютеров, успешно прошедших проверку (cloudPC: validateBulkResize). Если какие-либо устройства не могут быть изменены, они помечаются как "изменение размера не удалось", в то время как остальные устройства предназначены provisioned для изменения размера. Этот API устарел и перестал возвращать данные 24 сентября 2023 г. В дальнейшем используйте ресурс cloudPcBulkResize .
Удаленное действие массового восстановления (не рекомендуется)	cloudPcBulkRemoteActionResult	Восстановите несколько облачных компьютеров с помощью одного запроса, включающего идентификаторы управляемых устройств Intune, а также дату и время точки восстановления. Этот API устарел и перестал возвращать данные 24 сентября 2023 г. В дальнейшем используйте ресурс cloudPcBulkRestore .
Получение результатов удаленных действий (не рекомендуется)	cloudPcRemoteActionResult	Проверьте результаты удаленных действий, указанных облачным компьютером , для устройства облачного компьютера. Этот API является устаревшим и перестанет возвращать данные 30 сентября 2024 г. В дальнейшем используйте API retrieveCloudPcRemoteActionResults .
Получение состояния проверки (не рекомендуется)	cloudPcReviewStatus	Получение состояния проверки определенного облачного компьютера с помощью managedDeviceId. Этот API устарел и не возвращает данные 30 апреля 2024 г. В дальнейшем используйте API cloudPC: retrieveReviewStatus .
Получение состояния доступа к рабочей смене (не рекомендуется)	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 изменения размера cloudPC .
Удаленное действие восстановления (не рекомендуется)	Нет	Восстановление устройства облачного компьютера до предыдущего состояния с помощью управляемого идентификатора устройства Intune. Этот API является устаревшим и перестанет возвращать данные 30 сентября 2023 г. В дальнейшем используйте API восстановления .
Установка состояния проверки (не рекомендуется)	Нет	Задайте состояние проверки определенного облачного компьютера с помощью идентификатора управляемого устройства. Этот API устарел и не возвращает данные 30 апреля 2024 г. В дальнейшем используйте API cloudPC: setReviewStatus .

Свойства

Свойство	Тип	Описание
aadDeviceId	String	Идентификатор устройства Microsoft Entra облачного компьютера.
allotmentDisplayName	String	Имя выделения разделяет лицензии клиента на небольшие пакеты или группы, которые помогают ограничить количество лицензий, доступных для использования в определенном назначении. Если provisioningType имеет значение dedicated, то имя выделения — null. Только для чтения.
connectivityResult	cloudPcConnectivityResult	Результат проверки работоспособности подключения облачного компьютера, включая обновленную метку времени и возможность подключения к облачному компьютеру.
deviceRegionName	String	Имя географического региона, в котором в настоящее время подготовлен облачный компьютер. Например, westus3, eastus2и southeastasia. Только для чтения.
disasterRecoveryCapability	cloudPcDisasterRecoveryCapability	Состояние аварийного восстановления облачного компьютера, включая основной регион, дополнительный регион и тип возможности. Значение по умолчанию указывает null , что параметр аварийного восстановления отключен. Получение ответа со свойством $selectdisasterRecoveryCapability и $filter его по disasterRecoveryCapability/{subProperty} URL-адресу запроса. Дополнительные сведения см. в разделе Пример 4. Перечисление облачных компьютеров, отфильтрованных по типу возможностей аварийного восстановления. Только для чтения.
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 , sharedByEntraGroup. Необходимо использовать Prefer: include-unknown-enum-members заголовок запроса, чтобы получить следующие значения из этого развиваемого перечисления: sharedByUser, sharedByEntraGroup. Значение по умолчанию — dedicated. ВНИМАНИЕ! Участник shared не рекомендуется использовать и перестанет возвращаться 30 апреля 2027 г.; в будущем используйте sharedByUser его.
servicePlanId	String	Идентификатор плана обслуживания облачного компьютера.
servicePlanName	String	Имя плана обслуживания облачного компьютера.
servicePlanType	cloudPcServicePlanType	Тип плана обслуживания облачного компьютера.
status	microsoft.graph.cloudPcStatus	Состояние облачного компьютера. Возможные значения: notProvisioned, , provisionedprovisioning, inGracePeriod, deprovisioning, failed, provisionedWithWarnings, , resizing, restoring, pendingProvision, unknownFutureValue, movingRegion, , resizePendingLicense, . modifyingSingleSignOn Необходимо использовать Prefer: include-unknown-enum-members заголовок запроса, чтобы получить следующие значения из этого развиваемого перечисления: movingRegion, resizePendingLicense, modifyingSingleSignOn.
statusDetails (не рекомендуется)	cloudPcStatusDetails	Сведения о состоянии облачного компьютера. Например, { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null }. Это свойство устарело и больше не будет поддерживаться с 31 августа 2024 г. Вместо этого используйте statusDetail.
statusDetail	cloudPcStatusDetail	Указывает подробное состояние, связанное с облачным компьютером, включая код ошибки или предупреждения, сообщение об ошибке и предупреждение, дополнительные сведения. Например, { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null }.
connectionSetting	cloudPcConnectionSetting	Параметр подключения облачного компьютера. Возможные значения: enableSingleSignOn. Только для чтения.
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, . modifyingSingleSignOn

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

значения 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",
  "deviceRegionName": "String",
  "disasterRecoveryCapability": {"@odata.type": "microsoft.graph.cloudPcDisasterRecoveryCapability"},
  "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"
}