Partager via

cloudPC : reprovisionnement

Espace de noms: microsoft.graph

Reprovisionner un PC cloud spécifique.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet
✅ ❌ ❌ ❌

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) CloudPC.ReadWrite.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application CloudPC.ReadWrite.All Non disponible.

Requête HTTP

Pour reprovisionner le cloudPC de l’utilisateur spécifié (qui est l’utilisateur connecté) dans le organization à l’aide de l’autorisation déléguée :

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

Pour reprovisionner le cloudPC spécifié dans le organization, à l’aide de l’autorisation déléguée (l’utilisateur connecté doit être l’administrateur) ou de l’autorisation d’application :

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

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json. Obligatoire.

Corps de la demande

Remarque : Seuls les API pour le corps de la demande de support administrateur .

Dans le corps de la demande, fournissez une représentation JSON des paramètres.

Le tableau suivant indique les paramètres utilisables avec cette action.

Paramètre Type Description
osVersion cloudPcOperatingSystem Version du système d’exploitation à provisionner sur les PC cloud. Les valeurs possibles sont , windows10windows11et unknownFutureValue.
userAccountType cloudPcUserAccountType Type de compte de l’utilisateur sur les PC cloud provisionnés. Les valeurs possibles sont , standardUseradministratoret unknownFutureValue.

Valeurs cloudPcOperatingSystem

Member Description
windows10 Système d’exploitation Windows 10.
windows11 Système d’exploitation Windows 11.
unknownFutureValue Valeur sentinel de l’énumération évolutive. Ne pas utiliser.

valeurs cloudPcUserAccountType

Member Description
standardUser Un utilisateur sans autorisations d’administration locales sur le PC cloud. Standard utilisateurs peuvent uniquement installer du contenu à partir de l’application du Microsoft Store, mais ils ne peuvent pas modifier les paramètres Windows qui nécessitent des privilèges d’administration locale.
Administrateur Un utilisateur disposant d’autorisations d’administration locales complètes sur le PC cloud. Les administrateurs peuvent installer n’importe quel logiciel et modifier n’importe quel fichier ou paramètre sur le PC cloud.
unknownFutureValue Valeur sentinel de l’énumération évolutive. Ne pas utiliser.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 204 No Content.

Exemples

Exemple 1 : Reprovisionner le cloudPC pour l’administrateur

L’exemple suivant montre comment reprovisionner le PC cloud pour l’administrateur.

Demande

L’exemple suivant illustre une demande.

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

Réponse

HTTP/1.1 204 No Content

L’exemple suivant montre comment reprovisionner le PC cloud pour l’utilisateur connecté.

Exemple 2 : Reprovisionner le cloudPC pour l’utilisateur connecté

L’exemple suivant montre comment reprovisionner le PC cloud pour l’utilisateur connecté.

Demande

L’exemple suivant illustre une demande.

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

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content
  • Last updated on