Compartir a través de


tipo de recurso cloudPC

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.
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.
Apagar 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.
Reaprovisionamiento Ninguno Reprovisione un objeto de PC en la nube.
Resize Ninguno Actualice o reduzca un equipo en la nube existente a una configuración con una nueva CPU virtual (vCPU) y un tamaño de almacenamiento.
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.
Establecer el estado de revisión Ninguno Establezca el estado de revisión de un dispositivo de PC en la nube específico mediante el id. de PC en la nube.
Recuperar el estado de revisión cloudPcReviewStatus Obtenga el estado de revisión de un equipo en la nube.
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.
Recuperación de resultados de acciones remotas colección cloudPcRemoteActionResult Recupere los resultados de la acción remota y compruebe el estado de una acción remota específica realizada en el dispositivo de PC en la nube asociado.
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.
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.
Creación de una instantánea Ninguno Cree una instantánea para un dispositivo de PC en la nube específico.
Recuperación de instantáneas colección cloudPcSnapshot Obtenga una lista de recursos cloudPcSnapshot para un equipo en la nube.
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. El noLicensesAvailable miembro está en desuso y dejará de devolverse el 30 de septiembre de 2024.
Acción remota de reaprovisionamiento masivo (en desuso) Ninguno Reprovisione de forma masiva un conjunto de dispositivos de PC en la nube con Intune identificadores de dispositivo administrados. Esta API está en desuso y dejó de devolver datos el 24 de septiembre de 2023. En el futuro, use el recurso cloudPcBulkReprovision .
Cambio masivo (en desuso) 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. Esta API está en desuso y dejó de devolver datos el 24 de septiembre de 2023. En el futuro, use el recurso cloudPcBulkResize .
Acción remota de restauración masiva (en desuso) 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. Esta API está en desuso y dejó de devolver datos el 24 de septiembre de 2023. En el futuro, use el recurso cloudPcBulkRestore .
Obtener resultados de acción remota (en desuso) cloudPcRemoteActionResult Compruebe los resultados de la acción remota especificada por pc en la nube para un dispositivo de PC en la nube. Esta API está en desuso y dejará de devolver datos el 30 de septiembre de 2024. En el futuro, use la API retrieveCloudPcRemoteActionResults .
Obtener estado de revisión (en desuso) cloudPcReviewStatus Obtenga el estado de revisión de un dispositivo de PC en la nube específico mediante managedDeviceId. Esta API está en desuso y dejó de devolver datos el 30 de abril de 2024. En adelante, use cloudPC: retrieveReviewStatus API.
Establecer el estado de revisión (en desuso) Ninguno Establezca el estado de revisión de un dispositivo de PC en la nube específico mediante el identificador de dispositivo administrado. Esta API está en desuso y dejó de devolver datos el 30 de abril de 2024. En el futuro, use cloudPC: setReviewStatus API.
Estado de revisión del conjunto masivo (en desuso) Ninguno 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. Esta API está en desuso y dejó de devolver datos el 30 de septiembre de 2024. En el futuro, use el recurso cloudPcBulkSetReviewStatus .

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.
deviceRegionName Cadena Nombre de la región geográfica donde se aprovisiona actualmente el equipo en la nube. Por ejemplo, westus3, eastus2y southeastasia. Solo lectura.
disasterRecoveryCapability cloudPcDisasterRecoveryCapability Estado de recuperación ante desastres del equipo en la nube, incluida la región primaria, la región secundaria y el tipo de funcionalidad. El valor predeterminado es null que indica que la configuración de recuperación ante desastres está deshabilitada. Para recibir una respuesta con la propiedad disasterRecoveryCapability y $select$filter por disasterRecoveryCapability/{subProperty} en la dirección URL de la solicitud. Para obtener más información, consulte Ejemplo 4: Enumerar equipos en la nube filtrados por el tipo de funcionalidad de recuperación ante desastres. Solo lectura.
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 UTC del 1 de enero de 2014 es 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, unknownFutureValue, ,sharedByUser , sharedByEntraGroup. Debe usar el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolvable: sharedByUser, sharedByEntraGroup. El valor predeterminado es dedicated. PRECAUCIÓN: El shared miembro está en desuso y dejará de volver el 30 de abril de 2027; en el futuro, use el sharedByUser miembro.
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. Los valores posibles son: , , , , inGracePerioddeprovisioning, failed, provisionedWithWarnings, resizing, , restoring, pendingProvision, unknownFutureValue, movingRegion, resizePendingLicense, , preparingmodifyingSingleSignOn. provisionedprovisioningnotProvisioned Debe usar el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolvable: movingRegion, resizePendingLicense, modifyingSingleSignOn, preparing.
statusDetails (en desuso) cloudPcStatusDetails Detalles del estado del equipo en la nube. Por ejemplo, { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null }. Esta propiedad está en desuso y ya no se admitirá a partir del 31 de agosto de 2024. Use statusDetail en su lugar.
statusDetail cloudPcStatusDetail Indica el estado detallado asociado a Cloud PC, incluido el código de error/advertencia, el mensaje de error o advertencia, additionalInformation. Por ejemplo, { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null }.
connectionSetting cloudPcConnectionSetting Configuración de conexión del equipo en la nube. Valores posibles: enableSingleSignOn. Solo lectura.
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
corriente 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, modifyingSingleSignOn, preparing.

Member Descripción
notProvisioned El equipo en la nube aún no se ha aprovisionado.
aprovisionamiento 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.
fracasado 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.
modifyingSingleSignOn Indica que el equipo en la nube está actualizando la configuración de inicio de sesión único.
Preparando Indica que el equipo en la nube se está preparando con la configuración definida por el administrador de TI (aplicaciones, configuración y seguridad) después del estado de aprovisionamiento. Solo se aplica a dispositivos compartidos de primera línea.

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 (en desuso) Indica que todas las licencias de uso compartido están en uso. El noLicensesAvailable miembro está en desuso y dejará de devolverse el 30 de septiembre de 2024.
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.
activador 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.

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",
  "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"
}