tipo de recurso cloudPC

Artículo
04/01/2024

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa un escritorio virtual administrado en la nube. Este equipo en la nube también se inscribe en Intune y se administra a través del portal de Microsoft Endpoint Manager, por lo que el equipo en la nube también tiene un identificador de dispositivo administrado Intune correspondiente.

Métodos

Método	Tipo devuelto	Descripción
Lista de cloudPC	colección cloudPC	Enumera las propiedades y las relaciones de los objetos de PC en la nube.
Obtención de cloudPC	cloudPC	Lea las propiedades y las relaciones de un objeto de PC en la nube.
Obtención de equipos en la nube aprovisionados	colección cloudPC	Obtenga todos los equipos en la nube aprovisionados de un plan de servicio específico para los usuarios en un grupo de usuarios Microsoft Entra.
Cambio del tipo de cuenta de usuario	Ninguno	Cambie el tipo de cuenta del usuario en un equipo en la nube específico.
Fin del período de gracia	Ninguno	Finalizar el período de gracia de un objeto de PC en la nube.
Obtención de resultados de acciones remotas	cloudPcRemoteActionResult	Compruebe los resultados de la acción remota especificada por pc en la nube para un dispositivo de PC en la nube.
Encendido	Ninguno	Encienda un objeto específico de PC en la nube de Frontline de Windows. Esta acción admite escenarios de administración de MEM.
Apagado	Ninguno	Apague un objeto específico de PC en la nube de Frontline de Windows. Esta acción admite escenarios de administración de MEM.
Reiniciar	Ninguno	Reinicie un objeto de PC en la nube específico.
Rename	Ninguno	Cambie el nombre de un objeto de PC en la nube específico. Use esta API para actualizar displayName para la entidad pc en la nube.
Reprovision	Ninguno	Reprovisione un objeto de PC en la nube.
Revisión masiva de la acción remota	Ninguno	Reprovisione de forma masiva un conjunto de dispositivos de PC en la nube con Intune identificadores de dispositivo administrados.
Cambiar el tamaño de la acción remota	Ninguno	Actualice o reduzca un equipo en la nube existente a otra configuración con la nueva vCPU y el tamaño de almacenamiento a través de Intune identificador de dispositivo administrado.
Start	Ninguno	Inicie un equipo en la nube específico para un usuario. Actualmente, solo se admiten Windows 365 Frontline pc en la nube.
Stop	Ninguno	Detenga un equipo en la nube específico para un usuario. Actualmente, solo se admiten Windows 365 Frontline pc en la nube.
Solucionar problemas	Ninguno	Solución de problemas de un objeto de PC en la nube específico. Use esta API para comprobar el estado de mantenimiento del equipo en la nube y del host de sesión.
Restaurar	Ninguno	Restaure un objeto de PC en la nube a un estado anterior a partir de una instantánea.
Acción remota de restauración masiva	cloudPcBulkRemoteActionResult	Restaure varios dispositivos de PC en la nube con una única solicitud que incluya los identificadores de Intune dispositivos administrados y una fecha y hora de punto de restauración.
Establecer el estado de revisión	Ninguno	Establezca el estado de revisión de un dispositivo de PC en la nube específico.
Obtención del estado de revisión	cloudPcReviewStatus	Obtenga el estado de revisión de un dispositivo de PC en la nube específico.
Estado de revisión del conjunto masivo	cloudPcBulkRemoteActionResult	Establezca el estado de revisión de varios dispositivos de PC en la nube con una sola solicitud que incluya los identificadores de Intune dispositivos administrados.
Lista para el usuario	colección cloudPC	Enumere los dispositivos de PC en la nube que se atribuyen al usuario que ha iniciado sesión.
Obtener información de inicio para el usuario	cloudPcLaunchInfo	Obtenga cloudPcLaunchInfo para el usuario que ha iniciado sesión.
Obtención del historial de conectividad	Colección cloudPcConnectivityEvent	Obtenga el historial de conectividad del equipo en la nube.
Obtención de acciones remotas admitidas	colección cloudPcRemoteActionCapability	Obtenga una lista de las acciones remotas de PC en la nube admitidas para un dispositivo de PC en la nube específico, incluidos los nombres de acción y las funcionalidades.
Reintentar la instalación del agente asociado	Ninguno	Vuelva a intentar la instalación de los agentes asociados que no se pudieron instalar en el equipo en la nube.
Cambio de tamaño masivo	colección cloudPcRemoteActionResult	Realice una acción de cambio de tamaño masiva para cambiar el tamaño de un grupo de equipos en la nube que han pasado correctamente la validación (cloudPC: validateBulkResize). Si no se puede cambiar el tamaño de los dispositivos, se etiquetan como "error de cambio de tamaño", mientras que los dispositivos restantes son `provisioned` para el proceso de cambio de tamaño.
Validación del cambio de tamaño masivo	Colección cloudPcResizeValidateResult	Valide que un conjunto de dispositivos de PC en la nube cumple los requisitos para cambiar el tamaño en masa.
Obtener el estado de acceso de primera línea	frontlineCloudPcAccessState	Obtenga el estado de acceso del equipo en la nube de primera línea. Los valores posibles son: `unassigned`, `noLicensesAvailable`, `activationFailed`, `active`, `activating`, `standbyMode` y `unknownFutureValue`.
Obtener el estado de acceso al trabajo por turnos (en desuso)	shiftWorkCloudPcAccessState	Obtenga el estado de acceso del equipo en la nube de trabajo de turnos. Los valores posibles son: `unassigned`, `noLicensesAvailable`, , `activeactivationFailed`, `activating`, `waitlisted`, , `unknownFutureValue`. `standbyMode` Tenga en cuenta que debe usar el encabezado de `Prefer: include-unknown-enum-members` solicitud para obtener el siguiente valor en esta enumeración evolvable: `standbyMode`. Esta API está en desuso y dejará de devolver datos el 31 de diciembre de 2023. En el futuro, use la API getFrontlineCloudPcAccessState .
Reprovisionar acción remota (en desuso)	Ninguno	Reprovisione un equipo en la nube con un identificador de dispositivo administrado Intune. Esta API está en desuso y dejará de devolver datos el 30 de septiembre de 2023. En el futuro, use la API de reprovision .
Restauración de la acción remota (en desuso)	Ninguno	Restaure un dispositivo de PC en la nube a un estado anterior con un identificador de dispositivo administrado de Intune. Esta API está en desuso y dejará de devolver datos el 30 de septiembre de 2023. En el futuro, use la API de restauración .

Propiedades

Propiedad	Tipo	Descripción
aadDeviceId	Cadena	El identificador de dispositivo Microsoft Entra del equipo en la nube.
allotmentDisplayName	Cadena	El nombre de asignación divide las licencias de inquilino en lotes o grupos más pequeños que ayudan a restringir el número de licencias disponibles para su uso en una asignación específica. Cuando provisioningType es `dedicated`, el nombre de asignación es `null`. Solo lectura.
connectivityResult	cloudPcConnectivityResult	Resultado de la comprobación de estado de conectividad de un equipo en la nube, incluida la marca de tiempo actualizada y si el equipo en la nube se puede conectar.
diskEncryptionState	cloudPcDiskEncryptionState	Cifrado de disco aplicado al equipo en la nube. Valores posibles: `notAvailable`, `notEncrypted`, `encryptedUsingPlatformManagedKey`, `encryptedUsingCustomerManagedKey` y `unknownFutureValue`.
displayName	Cadena	Nombre para mostrar del equipo en la nube.
gracePeriodEndDateTime	DateTimeOffset	Fecha y hora en que finaliza el período de gracia y se produce el reaprovisionamiento o desaprovisionamiento. Solo es necesario si el estado es `inGracePeriod`. La marca de tiempo se muestra en formato ISO 8601 y hora universal coordinada (UTC). Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería `2014-01-01T00:00:00Z`.
id	Cadena	Identificador único del equipo en la nube. Solo lectura.
imageDisplayName	Cadena	Nombre de la imagen del sistema operativo que se encuentra en el equipo en la nube.
lastLoginResult	cloudPcLoginResult	El último resultado de inicio de sesión del equipo en la nube. Por ejemplo, `{ "time": "2014-01-01T00:00:00Z"}`.
lastModifiedDateTime	DateTimeOffset	Fecha y hora de la última modificación del equipo en la nube. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería `2014-01-01T00:00:00Z`.
lastRemoteActionResult	cloudPcRemoteActionResult	El último resultado de la acción remota de los equipos en la nube empresariales. Las acciones remotas admitidas son: `Reboot`, `Rename`, `Reprovision`, , `Restore`. `Troubleshoot`
managedDeviceId	Cadena	El identificador de dispositivo Intune del equipo en la nube.
managedDeviceName	Cadena	Nombre del dispositivo Intune del equipo en la nube.
onPremisesConnectionName	Cadena	La conexión de red de Azure que se aplica durante el aprovisionamiento de equipos en la nube.
osVersion	cloudPcOperatingSystem	Versión del sistema operativo (SO) que se va a aprovisionar en equipos en la nube. Los valores posibles son: `windows10`, `windows11` y `unknownFutureValue`.
partnerAgentInstallResults	Colección cloudPcPartnerAgentInstallResult	Resultados del estado de instalación de cada agente asociado en el equipo en la nube.
powerState	cloudPcPowerState	Estado de potencia de un equipo en la nube. Los valores posibles son: `running`, `poweredOff`, `unknown`. Esta propiedad solo admite equipos en la nube de trabajo por turnos.
provisioningPolicyId	Cadena	Identificador de directiva de aprovisionamiento del equipo en la nube.
provisioningPolicyName	Cadena	Directiva de aprovisionamiento que se aplica durante el aprovisionamiento de equipos en la nube.
provisioningType	cloudPcProvisioningType	Tipo de licencias que se van a usar al aprovisionar equipos en la nube mediante esta directiva. Los valores posibles son: `dedicated`, `shared` y `unknownFutureValue`. El valor predeterminado es `dedicated`.
servicePlanId	Cadena	Identificador del plan de servicio del equipo en la nube.
servicePlanName	Cadena	Nombre del plan de servicio del equipo en la nube.
servicePlanType	cloudPcServicePlanType	Tipo de plan de servicio del equipo en la nube.
status	microsoft.graph.cloudPcStatus	Estado del equipo en la nube. Valores posibles: `notProvisioned`, `provisioning`, `provisioned`, `inGracePeriod`, `deprovisioning`, `failed`, `provisionedWithWarnings`, `resizing`, `restoring`, `pendingProvision`, `unknownFutureValue`, `movingRegion`, `resizePendingLicense`. Debe usar el encabezado de `Prefer: include-unknown-enum-members` solicitud para obtener los siguientes valores de esta enumeración evolvable: `movingRegion`, `resizePendingLicense`.
statusDetails	cloudPcStatusDetails	Detalles del estado del equipo en la nube.
userAccountType	cloudPcUserAccountType	Tipo de cuenta del usuario en equipos en la nube aprovisionados. Los valores posibles son: `standardUser`, `administrator` y `unknownFutureValue`.
userPrincipalName	Cadena	Nombre principal de usuario (UPN) del usuario asignado al equipo en la nube.

valores cloudPcDiskEncryptionState

Member	Descripción
notAvailable	El equipo en la nube no está aprovisionado o está en un estado en el que el cifrado no está disponible.
notEncrypted	El equipo en la nube debe cifrarse, pero el cifrado aún no lo ha hecho (reservado, no debería ocurrir).
encryptedUsingPlatformManagedKey	El equipo en la nube se cifra mediante una clave administrada por la plataforma. Este miembro es el valor predeterminado si la clave administrada por el cliente no está habilitada.
encryptedUsingCustomerManagedKey	El equipo en la nube se cifra mediante la clave administrada por el cliente.
unknownFutureValue	Valor de sentinel de enumeración evolvable. No usar.

valores cloudPcPowerState

Member	Descripción
Corriendo	El estado del equipo en la nube se está ejecutando.
poweredOff	El estado del equipo en la nube está apagado.
desconocido	Se desconoce el estado del equipo en la nube.

valores cloudPcStatus

En la tabla siguiente se enumeran los miembros de una enumeración evolvable. Tenga en cuenta que debe usar el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores en esta enumeración evolvable: movingRegion, resizePendingLicense.

Member	Descripción
notProvisioned	El equipo en la nube aún no se ha aprovisionado.
Provisioning	El aprovisionamiento de equipos en la nube está en curso.
aprovisionado	El equipo en la nube se aprovisiona y los usuarios pueden acceder a él.
inGracePeriod	El equipo en la nube está en el período de gracia de una semana antes de desaprovisionar.
desaprovisionamiento	El equipo en la nube está desaprovisionando.
Fallado	Error en la operación en el equipo en la nube.
provisionedWithWarnings	El equipo en la nube se aprovisiona y los usuarios finales pueden acceder a él con algunas advertencias. El usuario puede seguir usando este equipo en la nube.
Redimensionar	El equipo en la nube está volviendo a cambiar el tamaño.
pendingProvision	El aprovisionamiento está pendiente en el equipo en la nube. En este caso, el número de equipos en la nube en el período de gracia es mayor que el número total de licencias disponibles.
Restaurar	El equipo en la nube se está restaurando.
unknownFutureValue	Valor de sentinel de enumeración evolvable. No usar.
movingRegion	Indica que el equipo en la nube se está moviendo de una región a otra.
resizePendingLicense	Indica que se inició el proceso de cambio de tamaño del equipo en la nube, pero no se puede completar porque no se ha identificado la licencia de destino. Actualmente está a la espera de la acción del cliente para resolver el problema de licencias.

valores de frontlineCloudPcAccessState

Member	Descripción
unassigned	Establézcalo en sin asignar si el equipo en la nube no consume ninguna licencia de uso compartido. El valor predeterminado es `unassigned`.
noLicensesAvailable	Indica que todas las licencias de uso compartido están en uso.
activationFailed	Indica que se produjo un error en la activación del equipo en la nube de primera línea después de que el usuario solicitara un equipo en la nube de primera línea.
Activo	Indica que el equipo en la nube de primera línea está en un estado activo con una licencia de uso compartido asignada y el usuario puede conectarse al equipo en la nube.
Activar	Indica que un usuario solicitó conectar el equipo en la nube y que el servicio se está iniciando.
standbyMode	Indica que el equipo en la nube de primera línea está en estado de espera antes de apagarse y desasignarse. El usuario sigue teniendo acceso a un equipo en la nube de primera línea en estado de espera.
unknownFutureValue	Valor de sentinel de enumeración evolvable. No usar.

valores shiftWorkCloudPcAccessState (en desuso)

En la tabla siguiente se enumeran los miembros de una enumeración evolvable. Debe usar el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores en esta enumeración evolvable: standbyMode.

Member	Descripción
unassigned	Establézcalo en sin asignar si el equipo en la nube no consume licencias de uso compartido. El valor predeterminado es `unassigned`.
noLicensesAvailable	Indica que todas las licencias de uso compartido están en uso.
activationFailed	Indica que se produjo un error en la activación del equipo en la nube del trabajo de turnos después de que el usuario solicitara un trabajo de turnos en el equipo en la nube.
Activo	Indica que el trabajo de turnos Pc en la nube está en un estado activo con una licencia de uso compartido asignada y el usuario puede conectarse al equipo en la nube.
Activar	Indica que un usuario solicitó conectar el equipo en la nube y que el servicio se está iniciando.
lista de espera (en desuso)	Indica que el trabajo de turnos Pc en la nube está en estado de lista de espera después de que el usuario solicite conectar este equipo en la nube y se usen activamente todas las licencias de uso compartido. Este valor está en desuso y dejará de devolverse el 17 de mayo de 2023.
unknownFutureValue	Valor de sentinel de enumeración evolvable. No usar.
standbyMode	Indica que el equipo en la nube de trabajo de turnos está en estado de espera antes de apagarse y desasignarse. El usuario sigue teniendo acceso a un equipo en la nube de trabajo por turnos en estado de espera.

Relaciones

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@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"
}