Partager via


Mettre à jour cloudPcProvisioningPolicy

Espace de noms: microsoft.graph

Mettez à jour les propriétés d’un objet cloudPcProvisioningPolicy .

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

PATCH /deviceManagement/virtualEndpoint/provisioningPolicies/{id}

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

Dans le corps de la demande, fournissez une représentation JSON de l’objet cloudPcProvisioningPolicy .

Le tableau suivant présente les propriétés qui peuvent être mises à jour pour cloudPcProvisioningPolicy.

Propriété Type Description
cloudPcNamingTemplate Chaîne Modèle utilisé pour nommer les PC cloud approvisionnés à l’aide de cette stratégie. Le modèle peut contenir du texte personnalisé et des jetons de remplacement, y compris %USERNAME:x% et %RAND:x%, qui représentent le nom de l’utilisateur et un nombre généré de manière aléatoire, respectivement. Par exemple, CPC-%USERNAME:4%-%RAND:5% signifie que le nom du PC cloud commence par CPC-, suivi d’un nom d’utilisateur à quatre caractères, d’un - caractère, puis de cinq caractères aléatoires. La longueur totale du texte généré par le modèle ne peut pas dépasser 15 caractères. Prise en charge $filter, $select, et $orderby
description Chaîne Description de la stratégie d’approvisionnement.
displayName Chaîne Nom complet de la stratégie d’approvisionnement.
domainJoinConfigurations Collection cloudPcDomainJoinConfiguration Spécifie une liste triée par priorité sur la façon dont les PC cloud rejoignent Microsoft Entra ID.
enableSingleSignOn Valeur booléenne True si le PC cloud provisionné est accessible par l’authentification unique. False indique que le PC cloud provisionné ne prend pas en charge cette fonctionnalité. La valeur par défaut est false. Windows 365 utilisateurs peuvent utiliser l’authentification unique pour s’authentifier auprès de Microsoft Entra ID avec des options sans mot de passe (par exemple, des clés FIDO) pour accéder à leur PC cloud. Optional.
imageDisplayName Chaîne Nom complet de l’image de système d’exploitation que vous approvisionnez.
Imageid Chaîne ID de l’image de système d’exploitation que vous souhaitez approvisionner sur les PC cloud. Le format d’une image de type galerie est : {publisher_offer_sku}. Les valeurs prises en charge pour chacun des paramètres sont les suivantes :
  • publisher : Microsoftwindowsdesktop.
  • offer : windows-ent-cpc.
  • sku : 21h1-ent-cpc-m365, 21h1-ent-cpc-os, 20h2-ent-cpc-m365, 20h2-ent-cpc-os, 20h1-ent-cpc-m36520h1-ent-cpc-os, , 19h2-ent-cpc-m365et 19h2-ent-cpc-os.
imageType cloudPcProvisioningPolicyImageType Type d’image de système d’exploitation (personnalisée ou galerie) que vous souhaitez approvisionner sur les PC cloud. Les valeurs possibles sont gallery, custom et unknownFutureValue.
microsoftManagedDesktop microsoftManagedDesktop Les paramètres spécifiques à microsoftManagedDesktop qui permettent aux clients Microsoft Managed Desktop d’obtenir une expérience managée d’appareil pour PC cloud. Pour permettre à microsoftManagedDesktop de fournir plus de valeur, un administrateur doit y spécifier certains paramètres. Prise en charge $filter, $select, et $orderBy
windowsSetting cloudPcWindowsSetting Indique un paramètre Windows spécifique à configurer lors de la création de PC cloud pour cette stratégie d’approvisionnement. Prend en charge $select.

Réponse

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

Exemples

Demande

L’exemple suivant illustre une demande.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/provisioningPolicies/1d164206-bf41-4fd2-8424-a3192d39ffff
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "displayName": "HR provisioning policy",
  "description": "Provisioning policy for India HR employees"
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content