Compartir a través de

cloudPC: reprovision

Espacio de nombres: microsoft.graph

Reprovisione un equipo en la nube específico.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) CloudPC. ReadWrite. All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación CloudPC. ReadWrite. All No disponible.

Solicitud HTTP

Para volver a aprovisionar el cloudPC del usuario especificado (que es el usuario que inició sesión) en la organización mediante el permiso delegado:

POST /me/cloudPCs/{id}/reprovision
POST /users/{userId}/cloudPCs/{id}/reprovision

Para volver a aprovisionar el cloudPC especificado en la organización, use el permiso delegado (el usuario que inició sesión debe ser el administrador) o el permiso de aplicación:

POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/reprovision

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

Nota: Solo las API para el cuerpo de la solicitud de soporte técnico del administrador .

En el cuerpo de la solicitud, proporcione una representación JSON de los parámetros.

La siguiente tabla muestra los parámetros que se pueden usar con esta acción.

Parámetro Tipo Description
osVersion cloudPcOperatingSystem Versión del sistema operativo (SO) que se va a aprovisionar en equipos en la nube. Los valores posibles son: windows10, windows11y unknownFutureValue.
userAccountType cloudPcUserAccountType Tipo de cuenta del usuario en equipos en la nube aprovisionados. Los valores posibles son: standardUser, administratory unknownFutureValue.

valores de cloudPcOperatingSystem

Member Descripción
windows10 Sistema operativo Windows 10.
windows11 Sistema operativo Windows 11.
unknownFutureValue Valor de sentinel de enumeración evolvable. No usar.

valores cloudPcUserAccountType

Member Descripción
standardUser Un usuario sin permisos administrativos locales en el equipo en la nube. Standard usuarios solo pueden instalar contenido desde la aplicación Microsoft Store, pero no pueden modificar la configuración de Windows que requiere privilegios administrativos locales.
Administrador Un usuario con permisos administrativos locales completos en el equipo en la nube. Los administradores pueden instalar cualquier software y modificar cualquier archivo o configuración en el equipo en la nube.
unknownFutureValue Valor de sentinel de enumeración evolvable. No usar.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content.

Ejemplos

Ejemplo 1: Reprovisionar cloudPC para el administrador

En el ejemplo siguiente se muestra cómo volver a aprovisionar el equipo en la nube para el administrador.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/cloudPCs/4b5ad5e0-6a0b-4ffc-818d-36bb23cf4dbd/reprovision
Content-Type: application/json
Content-length: 61

{
  "userAccountType": "administrator",
  "osVersion": "windows10"
}

Respuesta

HTTP/1.1 204 No Content

En el ejemplo siguiente se muestra cómo volver a aprovisionar el equipo en la nube para el usuario que ha iniciado sesión.

Ejemplo 2: Reprovisionar cloudPC para el usuario que ha iniciado sesión

En el ejemplo siguiente se muestra cómo volver a aprovisionar el equipo en la nube para el usuario que ha iniciado sesión.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/v1.0/me/cloudPCs/36bd4942-0ca8-11ed-861d-0242ac120002/reprovision

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content
  • Last updated on