tipo de recurso de 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 PC en la nube también está inscrito en Intune y se administra a través del portal Microsoft Endpoint Manager, por lo que el PC en la nube también tiene un identificador de dispositivo administrado por Intune correspondiente.

Métodos

Método Tipo devuelto Description
Lista de cloudPC colección cloudPC Enumerar las propiedades y relaciones de los objetos de PC en la nube.
Obtener cloudPC cloudPC Lea las propiedades y relaciones de un objeto de PC en la nube.
Obtener equipos en la nube aprovisionados colección cloudPC Obtenga todos los PC en la nube aprovisionados de un plan de servicio específico para los usuarios de un grupo de usuarios de Microsoft Entra.
Cambiar el tipo de cuenta de usuario Ninguno Cambie el tipo de cuenta del usuario en un PC en la nube específico.
Fin del período de gracia Ninguno Finalizar el período de gracia para un objeto de PC en la nube.
Encender Ninguno Encienda un objeto específico de PC en la nube de Windows Frontline. Esta acción admite escenarios de administración de MEM.
Apagar Ninguno Apague un objeto específico de PC en la nube de Windows Frontline. Esta acción admite escenarios de administración de MEM.
Reiniciar Ninguno Reiniciar un objeto específico de PC en la nube.
Rename Ninguno Cambiar el nombre de un objeto específico de la PC en la nube. Use esta API para actualizar el displayName de la entidad de PC en la nube.
Reaprovisionamiento Ninguno Reaprovisionar un objeto de PC en la nube.
Resize Ninguno Actualice o degrade un PC en la nube existente a una configuración con una nueva CPU virtual (vCPU) y tamaño de almacenamiento.
Start Ninguno Iniciar un PC en la nube específico. Actualmente, solo se admiten PC en la nube de primera línea con Windows 365.
Stop Ninguno Detener una nube específica. Actualmente, solo se admiten PC en la nube de primera línea con Windows 365.
Solucionar problemas Ninguno Solucionar problemas de un objeto específico de la PC en la nube. Use esta API para comprobar el estado de mantenimiento del PC en la nube y del host de sesión.
Restaurar Ninguno Restaurar un objeto de PC en la nube a un estado anterior a partir de una instantánea.
Establecer el estado de la revisión Ninguno Establezca el estado de revisión de un dispositivo de PC en la nube específico con el id. de PC en la nube.
Recuperar estado de revisión cloudPcReviewStatus Obtener el estado de revisión de un PC en la nube.
Recuperar recuento de PC en la nube por estado Recopilación cloudPcStatusSummary Recupera el recuento de PC en la nube agrupado por estado.
Lista para usuarios colección cloudPC Enumere los dispositivos de PC en la nube que se atribuyen al usuario que ha iniciado sesión.
Recuperar detalles de lanzamiento cloudPcLaunchDetail Obtenga el cloudPcLaunchDetail de un PC en la nube específico que pertenezca al usuario que ha iniciado sesión actualmente.
Obtener historial de conectividad cloudPcConnectivityColección de eventos Obtenga el historial de conectividad de PC en la nube.
Obtener acciones remotas compatibles Recopilación de cloudPcRemoteActionCapability Obtenga una lista de las acciones remotas de PC en la nube compatibles para un dispositivo de PC en la nube específico, incluidos los nombres de acción y las capacidades.
Recuperar resultados de acciones remotas Recopilació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.
Reintente la instalación del agente del partner Ninguno Vuelva a intentar la instalación de los agentes de asociados que no se pudieron instalar en el PC en la nube.
Validar el cambio de tamaño masivo Colección cloudPcResizeValidateResult Valide que un conjunto de dispositivos PC en la nube cumplan los requisitos para el cambio de tamaño masivo.
Crear instantáneas Ninguno Cree una instantánea para un dispositivo de PC en la nube específico.
Recuperar instantáneas Colección cloudPcSnapshot Obtenga una lista de recursos de cloudPcSnapshot para un PC en la nube.
Compartir instantánea Ninguno Comparta una instantánea para un dispositivo PC en la nube específico.
Obtener estado de acceso de primera línea frontlineCloudPcAccessState Obtener el estado de acceso del PC 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 dejó de volver el 30 de septiembre de 2024.
Obtener información de lanzamiento (en desuso) cloudPcLaunchInfo Obtenga cloudPCLaunchInfo para un PC en la nube específico que pertenezca al usuario que ha iniciado sesión actualmente. Esta API está en desuso y dejará de devolver datos el 30 de octubre de 2026. De ahora en adelante, usa la API Recuperar detalles del lanzamiento .
Recuperar detalles de PC en la nube de primera línea frontlineCloudPcDetail Obtenga el frontlineCloudPcDetail de un PC en la nube de primera línea.
Desencadenar una acción de organización de PC en la nube cloudPcOrganizationActionDetail Desencadenar una acción de organización de PC en la nube.
Recuperar un detalle de la acción de la organización de PC en la nube cloudPcOrganizationActionDetail Recuperar los detalles de cloudPcOrganizationActionDetail.

Propiedades

Propiedad Tipo Description
aadDeviceId Cadena El id. del dispositivo Microsoft Entra del PC en la nube.
allotmentDisplayName Cadena El nombre de la 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 la asignación es null. Solo lectura.
connectivityResult cloudPcConnectivityResult Resultado de la comprobación de estado de conectividad de un PC en la nube, incluida la marca de tiempo actualizada y si el PC en la nube se puede conectar.
connectionSetting cloudPcConnectionSetting La configuración de conexión del PC en la nube. Valores posibles: enableSingleSignOn. Solo lectura.
deviceRegionName Cadena Nombre de la región geográfica donde se aprovisiona actualmente el PC en la nube. Por ejemplo, westus3, , eastus2y southeastasia. Solo lectura.
disasterRecoveryCapability cloudPcDisasterRecoveryCapability El estado de recuperación ante desastres del PC en la nube, incluida la región primaria, la región secundaria y el tipo de funcionalidad. El valor predeterminado es null el que indica que la configuración de recuperación ante desastres está deshabilitada. Para recibir una respuesta con la propiedad $selectdisasterRecoveryCapability y $filter mediante disasterRecoveryCapability/{subProperty} en la dirección URL de la solicitud. Para obtener más información, consulte el Ejemplo 3: Enumerar PC en la nube filtrados por tipo de funcionalidad de recuperación ante desastres. Solo lectura.
diskEncryptionState cloudPcDiskEncryptionState El cifrado de disco aplicado al PC en la nube. Valores posibles: notAvailable, notEncrypted, encryptedUsingPlatformManagedKey, encryptedUsingCustomerManagedKey y unknownFutureValue.
displayName Cadena El nombre para mostrar del PC en la nube.
gracePeriodEndDateTime DateTimeOffset La 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.
groupDetail cloudPcEntraGroupDetail Los detalles del grupo de Microsoft Entra (por ejemplo, id. y nombre para mostrar) para el grupo de id. de Entra asociado a la asignación de PC en la nube de reserva del usuario. Solo lectura.
id Cadena El identificador único del PC en la nube. Solo lectura.
imageDisplayName Cadena Nombre de la imagen del sistema operativo que se encuentra en el PC en la nube.
isDisasterRecoveryActive Booleano Indica si el PC en la nube se ejecuta actualmente en su región de recuperación ante desastres después de un evento de conmutación por error. true si el PC en la nube se está ejecutando actualmente en su región de recuperación ante desastres; de lo contrario, false. Solo lectura.
lastLoginResult cloudPcLoginResult El último resultado de inicio de sesión del PC en la nube. Por ejemplo, { "time": "2014-01-01T00:00:00Z"}.
lastLogoffDateTime DateTimeOffset La fecha y hora en que el usuario cerró sesión por última vez en la sesión de PC en la nube. Devuelve null si el usuario nunca ha establecido una sesión o si hay una sesión activa actualmente. La marca de tiempo se muestra en formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Solo lectura. Solo se devuelve cuando se selecciona explícitamente con $select.
lastModifiedDateTime DateTimeOffset La fecha y hora de la última modificación del PC 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, medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z.
lastRemoteActionResult cloudPcRemoteActionResult El resultado de la última acción remota de los PC en la nube empresariales. Las acciones remotas admitidas son: Reboot, Rename, Reprovision, Restore, Troubleshoot, .
managedDeviceId Cadena El id. del dispositivo de Intune del PC en la nube.
managedDeviceName Cadena El nombre del dispositivo de Intune del PC 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 La versión del sistema operativo (SO) que se aprovisionará en los PC en la nube. Los valores posibles son: windows10, windows11, unknownFutureValue.
partnerAgentInstallResults Recopilación cloudPcPartnerAgentInstallResult Los resultados del estado de instalación de cada agente asociado en la PC en la nube.
powerState cloudPcPowerState El estado de energía de un PC en la nube. Los valores posibles son: running, poweredOff, unknown. Esta propiedad solo admite PC en la nube de trabajo por turnos.
productType cloudPcProductType El tipo de producto del PC en la nube. Los valores posibles son: enterprise, frontline, devBox, powerAutomate, business, unknownFutureValue. Para conocer los planes de servicio disponibles y los precios de enterprise, frontline, y businessconsulta Windows 365 para empresas. Para obtener información sobre precios de devBox, consulte Precios de Microsoft Dev Box. Para conocer los planes disponibles y los precios de , consulte Precios de powerAutomatePower Automate. El valor predeterminado es enterprise. Admite $filter y $select. Para obtener más información, consulte el ejemplo 4: Enumerar equipos en la nube filtrados por tipo de producto. Solo lectura.
provisionedDateTime DateTimeOffset La fecha y hora aprovisionadas más recientes, generadas y asignadas automáticamente durante el aprovisionamiento inicial o cualquier reaprovisionamiento posterior del PC en la nube. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z.
provisioningConfiguration cloudPcProvisioningConfiguration La configuración derivada de la directiva del PC en la nube. Contiene propiedades heredadas de la directiva de aprovisionamiento que se aplicaron durante el aprovisionamiento o reaprovisionamiento más reciente. Solo se devuelve cuando se selecciona explícitamente con $select. Solo lectura.
provisioningPolicyId Cadena El id. de la directiva de aprovisionamiento del PC en la nube.
provisioningPolicyName Cadena La directiva de aprovisionamiento que se aplica durante el aprovisionamiento de los PC en la nube.
provisioningType cloudPcProvisioningType El tipo de licencias que se usarán al aprovisionar equipos en la nube mediante esta directiva. Los valores posibles son: dedicated, shared, unknownFutureValue, sharedByUser, sharedByEntraGroup, reserve. Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolutiva: sharedByUser, , reservesharedByEntraGroup. El valor predeterminado es dedicated. El shared miembro está en desuso y dejará de volver el 30 de abril de 2027; en el futuro, usa el sharedByUser miembro.
scopeIds Colección string Identificadores de ámbito del permiso correspondiente. Actualmente, es el identificador de etiqueta de ámbito de Intune. Solo lectura.
servicePlanId Cadena El id. del plan de servicio del PC en la nube.
servicePlanName Cadena El nombre del plan de servicio del PC en la nube.
servicePlanType cloudPcServicePlanType El tipo de plan de servicio del PC en la nube.
sharedDeviceDetail cloudPcFrontlineSharedDeviceDetail Indica los detalles del dispositivo PC en la nube asociados al plan de servicio compartido de primera línea, incluido el UPN del usuario y la fecha y hora de inicio de la sesión.
status cloudPcStatus El estado del PC en la nube. Los valores posibles son: notProvisioned, provisioning, provisionedinGracePerioddeprovisioningfailedprovisionedWithWarningsresizingrestoringpendingProvisionunknownFutureValuemovingRegionresizePendingLicensemodifyingSingleSignOnrefreshPolicyConfigurationpreparingfailoverInProgressfailbackInProgress Use el encabezado de Prefer: include-unknown-enum-members solicitud para obtener los siguientes valores de esta enumeración evolutiva: movingRegion, resizePendingLicense, modifyingSingleSignOn, refreshPolicyConfigurationpreparing, failoverInProgress, failbackInProgress.
Detalles del estado cloudPcStatusDetail Indica el estado detallado asociado con la PC en la nube, incluido el código de error/advertencia, el mensaje de error/advertencia, información adicional. Por ejemplo, { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null }.
userAccountType cloudPcUserAccountType El tipo de cuenta del usuario en los PC en la nube aprovisionados. Los valores posibles son: standardUser, administrator, unknownFutureValue.
userExperienceType cloudPcUserExperienceType Especifica el tipo de objeto de nube al que puede tener acceso el usuario final. Los valores posibles son: cloudPc, cloudApp, unknownFutureValue. Cuando se establece en cloudPc, indica que el usuario final puede acceder a todo el escritorio. Cuando se establece en cloudApp, indica que el usuario final solo puede acceder a las aplicaciones en la nube publicadas bajo la directiva de aprovisionamiento asociada. Dado que la experiencia de aplicaciones en la nube también crea dispositivos PC en la nube que aparecen en la lista de dispositivos de PC en la nube, esta propiedad ayuda a diferenciarlos. El valor predeterminado es cloudPc. Esta propiedad se define en la directiva de aprovisionamiento.
userDetail cloudPcEntraUserDetail Los detalles de usuario (por ejemplo, ID y nombre para mostrar) del usuario asociado a una asignación de Reserve Cloud PC. Solo lectura.
userPrincipalName Cadena El nombre principal de usuario (UPN) del usuario asignado al PC en la nube.
connectionSettings (obsoleto) cloudPcConnectionSettings La configuración de conexión del PC en la nube. Valores posibles: enableSingleSignOn. Solo lectura. Esta propiedad quedó en desuso y dejó de reajustar los datos el 31 de agosto de 2024. En el futuro, usa la propiedad connectionSetting .
frontlineCloudPcAvailability (en desuso) frontlineCloudPcAvailability La disponibilidad actual de un PC en la nube asignado de primera línea. Valores posibles: notApplicable, available, notAvailabley unknownFutureValue. El valor predeterminado es notApplicable. Solo lectura. Esta propiedad está en desuso y dejará de devolver datos el 30 de octubre de 2025. De ahora en adelante, use la API retrieveFrontlineCloudPcDetail .
statusDetails (obsoleto) cloudPcStatusDetails Los detalles del estado del PC 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 será compatible a partir del 31 de agosto de 2024. Use statusDetail en su lugar.

valores de cloudPcDiskEncryptionState

Member Descripción
notAvailable El PC en la nube no está aprovisionado o se encuentra en un estado en el que el cifrado no está disponible.
notEncrypted El PC en la nube debería estar cifrado, pero el cifrado aún no se ha realizado (reservado, no debería suceder).
encryptedUsingPlatformManagedKey El PC en la nube se cifra con una clave administrada por la plataforma. Este miembro es el valor predeterminado si la clave administrada por el cliente no está habilitada.
encryptedUsingCustomerManagedKey El PC en la nube se cifra con la clave administrada por el cliente.
unknownFutureValue Valor centinela de enumeración evolutiva. No usar.

valores de cloudPcPowerState

Member Descripción
en ejecución El estado de la PC en la nube se está ejecutando.
poweredOff El estado del PC en la nube es Apagado.
desconocido Se desconoce el estado del PC en la nube.

valores de cloudPcStatus

Member Descripción
notProvisioned El PC en la nube aún no se ha aprovisionado.
dispositivos masivos El aprovisionamiento de PC en la nube está en curso.
aprovisionado El PC en la nube está aprovisionado y los usuarios pueden acceder a él.
inGracePeriod El PC en la nube se encuentra en el período de gracia de una semana antes del desaprovisionamiento.
desaprovisionamiento El PC en la nube se está desaprovisionando.
con errores Error en la operación en el PC en la nube.
provisionedWithWarnings El PC en la nube está aprovisionado y los usuarios finales pueden acceder a él con algunas advertencias. El usuario puede seguir usando este PC en la nube.
Ajustar el tamaño El PC en la nube está cambiando de tamaño.
restaurando El PC en la nube se está restaurando.
pendingProvision El aprovisionamiento está pendiente en el PC en la nube. En este caso, el número de PC en la nube en el período de gracia es mayor que el número total de licencias disponibles.
unknownFutureValue Valor centinela de enumeración evolutiva. No usar.
movingRegion Indica que el PC 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 PC en la nube, pero no se puede completar porque no se ha identificado la licencia de destino. Actualmente, está esperando la acción del cliente para resolver el problema de licencia.
modifyingSingleSignOn Indica que el PC en la nube está actualizando la configuración de inicio de sesión único.
refreshPolicyConfiguration Indica que el PC en la nube está en proceso de actualización de las nuevas configuraciones de directiva.
Preparación Indica que el PC en la nube se está preparando con la configuración definida por el administrador de TI (Aplicaciones, Configuración y Seguridad), aparece después del estado de aprovisionamiento. Solo se aplica a los dispositivos compartidos de primera línea.
failoverInProgress Indica que la conmutación por error a la región de recuperación ante desastres está en curso para el PC en la nube.
failbackInProgress Indica que la conmutación por recuperación a la región primaria está en curso para el PC en la nube.

valores de frontlineCloudPcAccessState

Member Descripción
unassigned Establézcalo en sin asignar si el PC 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 volver el 30 de septiembre de 2024.
activationFailed Indica que se produjo un error en la activación del PC en la nube de primera línea después de que el usuario solicitara un PC en la nube de primera línea.
activo Indica que el PC 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 PC en la nube.
Activación Indica que un usuario solicitó conectarse al PC en la nube y el servicio se está iniciando.
modo de espera Indica que el PC en la nube de primera línea está en estado de espera antes de apagarse y desasignarse. El usuario sigue teniendo acceso a un PC en la nube de primera línea en estado de espera.
unknownFutureValue Valor centinela de enumeración evolutiva. No usar.

valores de cloudPcProductType

Member Descripción
empresa Valor predeterminado. Indica el tipo de producto de PC en la nube para empresas más grandes que desean implementar PC en la nube en toda su organización para un número ilimitado de usuarios.
primera línea Indica el tipo de producto de PC en la nube para que los trabajadores de primera línea y a tiempo parcial compartan dispositivos, lo que les permite usar PC en la nube durante sus turnos.
Caja de datos Indica el tipo de producto de PC en la nube preconfigurado con herramientas, servicios y recursos para desarrolladores, equipos de desarrollo y profesionales de TI.
PowerAutomate Indica el tipo de producto de PC en la nube para que los clientes de Power Automate ejecuten RPA (automatización robótica de procesos) atendidas y desatendidas en sus PC en la nube.
Negocios Indica el tipo de producto de PC en la nube para clientes de pequeñas empresas con hasta 300 usuarios.
unknownFutureValue Valor centinela de enumeración evolutiva. 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": {"@odata.type": "microsoft.graph.cloudPcConnectivityResult"},
  "connectionSetting": {"@odata.type": "microsoft.graph.cloudPcConnectionSetting"},
  "connectionSettings": {"@odata.type": "microsoft.graph.cloudPcConnectionSettings"},
  "deviceRegionName": "String",
  "disasterRecoveryCapability": {"@odata.type": "microsoft.graph.cloudPcDisasterRecoveryCapability"},
  "diskEncryptionState": "String",
  "displayName": "String",
  "gracePeriodEndDateTime": "String (timestamp)",
  "groupDetail": {"@odata.type": "microsoft.graph.cloudPcEntraGroupDetail"},
  "id": "String (identifier)",
  "imageDisplayName": "String",
  "isDisasterRecoveryActive": "Boolean",
  "lastLoginResult": "String",
  "lastLoginResult": {"@odata.type": "microsoft.graph.cloudPcLoginResult"},
  "lastLogoffDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "lastRemoteActionResult": {"@odata.type": "microsoft.graph.cloudPcRemoteActionResult"},
  "managedDeviceId": "String",
  "managedDeviceName": "String",
  "onPremisesConnectionName": "String",
  "osVersion": "String",
  "partnerAgentInstallResults": [{"@odata.type": "microsoft.graph.cloudPcPartnerAgentInstallResult"}],
  "powerState": "String",
  "productType": "String",
  "provisionedDateTime": "String (timestamp)",
  "provisioningConfiguration": {"@odata.type": "microsoft.graph.cloudPcProvisioningConfiguration"},
  "provisioningPolicyId": "String",
  "provisioningPolicyName": "String",
  "provisioningType": "String",
  "servicePlanId": "String",
  "servicePlanName": "String",
  "servicePlanType": "String",
  "scopeIds": ["String"],
  "sharedDeviceDetail": {"@odata.type": "microsoft.graph.cloudPcFrontlineSharedDeviceDetail"},
  "status": "String",
  "statusDetail": {"@odata.type": "microsoft.graph.cloudPcStatusDetail"},
  "userAccountType": "String",
  "userExperienceType": "String",
  "userDetail": {"@odata.type": "microsoft.graph.cloudPcEntraUserDetail"},
  "userPrincipalName": "String"
}
  • Last updated on