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 por 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 de un grupo de usuarios de 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 equipos en la nube de primera línea de Windows 365. |
| Stop | Ninguno | Detenga un equipo en la nube específico para un usuario. Actualmente, solo se admiten equipos en la nube de primera línea de Windows 365. |
| 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. |
| Estado de revisión del conjunto masivo | cloudPcBulkRemoteActionResult | Establezca el estado de revisión de varios dispositivos de PC en la nube con una única solicitud que incluya los identificadores de los dispositivos administrados de Intune. |
| 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. |
| 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 identificadores de dispositivo administrados por Intune. 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 los dispositivos administrados de Intune 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. |
| 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 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 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 reprovision . |
| Cambiar el tamaño de la acción remota (en desuso) | Ninguno | Actualice o reduzca un equipo en la nube existente a otra configuración con una nueva vCPU y un tamaño de almacenamiento a través del identificador de dispositivo administrado de Intune. Esta API está en desuso y dejó de devolver datos el 30 de octubre de 2023. En el futuro, use cloudPC: resize API. |
| 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 . |
| 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. |
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 de Intune del equipo en la nube. |
| managedDeviceName | Cadena | Nombre del dispositivo de 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, , modifyingSingleSignOnresizePendingLicense. 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. |
| 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.
| 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. |
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. |
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. |
| activador | 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 turno Pc en la nube se encuentra en un 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",
"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"
}