Partager via


Type de ressource cloudPcProvisioningPolicy

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente une stratégie d’approvisionnement de PC cloud.

Méthodes

Méthode Type de retour Description
List collection cloudPcProvisioningPolicy Répertorie les propriétés et les relations des objets cloudPcProvisioningPolicy .
Obtenir cloudPcProvisioningPolicy Lisez les propriétés et les relations d’un objet cloudPcProvisioningPolicy .
Create cloudPcProvisioningPolicy Créez un objet cloudPcProvisioningPolicy .
Mettre à jour cloudPcProvisioningPolicy Mettez à jour les propriétés d’un objet cloudPcProvisioningPolicy .
Supprimer Aucun Supprime un objet cloudPcProvisioningPolicy .
Assign Aucun Affectez une stratégie cloudPcProvisioningPolicy à des groupes d’utilisateurs.
Appliquer Aucun Appliquez la configuration actuelle de la stratégie d’approvisionnement à tous les appareils PC cloud sous une stratégie spécifiée. Actuellement, vous pouvez uniquement modifier la région.
Appliquer la configuration Aucun Mettez à jour la configuration de la stratégie d’approvisionnement pour un ensemble d’appareils PC cloud en fonction de leurs ID.

Propriétés

Propriété Type Description
alternateResourceUrl String URL de l’autre ressource liée à cette stratégie d’approvisionnement. En lecture seule.
autopatch cloudPcProvisioningPolicyAutopatch Paramètres spécifiques pour Windows Autopatch qui permettent à ses clients de l’expérimenter sur un PC cloud. Les paramètres prennent effet lorsque le locataire s’inscrit dans Windows Autopatch et que le managedType de la propriété microsoftManagedDesktop est défini sur starterManaged. Prend en charge $select.
autopilotConfiguration cloudPcAutopilotConfiguration Paramètres spécifiques pour Windows Autopilot qui permettent aux clients Windows 365 de l’expérimenter sur un PC cloud. Prend en charge $select.
cloudPcGroupDisplayName String Nom complet du groupe de PC cloud dans lequel résident les PC cloud. En lecture seule.
cloudPcNamingTemplate String 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 String Description de la stratégie d’approvisionnement. Prise en charge $filter, $select, et $orderBy
displayName String 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 (Azure AD). Prend en charge $select.
enableSingleSignOn Boolean True si l’authentification unique peut accéder au PC cloud approvisionné. 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.
gracePeriodInHours Int32 Nombre d’heures d’attente avant le réapprovisionnement/déprovisionnement. En lecture seule.
id String Identificateur unique associé à la stratégie d’approvisionnement. Cet ID est renseigné automatiquement lors de la création d’une stratégie d’approvisionnement. En lecture seule. Prise en charge $filter, $select, et $orderBy
imageDisplayName String Nom complet de l’image du système d’exploitation utilisée pour l’approvisionnement. Par exemple : Windows 11 Preview + Microsoft 365 Apps 23H2 23H2. Prise en charge $filter, $select, et $orderBy
imageId String Identificateur unique qui représente une image de système d’exploitation utilisée pour l’approvisionnement de nouveaux PC cloud. Le format d’une image de type galerie est : {publisherName_offerName_skuName}. Les valeurs prises en charge pour chacun des paramètres sont les suivantes :
  • éditeur: Microsoftwindowsdesktop
  • offrir: windows-ent-cpc
  • référence sku : 21h1-ent-cpc-m365, 21h1-ent-cpc-os, 20h2-ent-cpc-m365, 20h2-ent-cpc-os, 20h1-ent-cpc-os20h1-ent-cpc-m365, 19h2-ent-cpc-m365, et19h2-ent-cpc-os
Prise en charge $filter, $select, et $orderBy
imageType cloudPcProvisioningPolicyImageType Type d’image de système d’exploitation (personnalisée ou galerie) utilisée pour le provisionnement sur les PC cloud. Les valeurs possibles sont les suivantes : gallery, custom. La valeur par défaut est gallery. Prend en charge $filter, $select et $orderBy.
localAdminEnabled Boolean Lorsque truela valeur est , l’administrateur local est activé pour les PC cloud ; false indique que l’administrateur local n’est pas activé pour les PC cloud. La valeur par défaut est false. Prise en charge $filter, $select, et $orderBy
managedBy cloudPcManagementService Indique le service qui gère la stratégie d’approvisionnement. Les valeurs possibles sont les suivantes : windows365, devBox, unknownFutureValue, rpaBox. La valeur par défaut est windows365. Vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir la valeur suivante dans cette énumération évolutive : rpaBox. Prise en charge $filter, $select, et $orderBy
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
provisioningType cloudPcProvisioningType Spécifie le type de licences à utiliser lors de l’approvisionnement de PC cloud à l’aide de cette stratégie. Les valeurs possibles sont dedicated, shared, unknownFutureValue, sharedByUser, sharedByEntraGroup. Vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes de cette énumération évolutive : sharedByUser, sharedByEntraGroup. Le shared membre est déconseillé et cessera de revenir le 30 avril 2027 ; à l’avenir, utilisez le sharedByUser membre. Par exemple, un dedicated plan de service peut être attribué à un seul utilisateur et provisionner un seul PC cloud. Les shared plans et sharedByUser exigent que les clients achètent un plan de service partagé. Chaque licence partagée achetée peut activer jusqu’à trois PC cloud, avec un seul utilisateur connecté à la fois. Le sharedByEntraGroup plan nécessite également l’achat d’un plan de service partagé. Chaque licence partagée dans le cadre de ce plan peut activer un PC cloud, qui est partagé pour le groupe en fonction des affectations de cette stratégie. Par défaut, le type de licence est dedicated si provisioningType n’est pas spécifié lorsque vous créez cloudPcProvisioningPolicy. Vous ne pouvez pas modifier cette propriété après la création de cloudPcProvisioningPolicy .
windowsSetting cloudPcWindowsSettings 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.
domainJoinConfiguration (déconseillé) cloudPcDomainJoinConfiguration Spécifie la façon dont les PC cloud se joignent Microsoft Entra ID. La propriété domainJoinConfiguration est déconseillée et cessera de retourner des données le 31 mai 2024. À l’avenir, utilisez la propriété domainJoinConfigurations .
onPremisesConnectionId (déconseillé) String ID de cloudPcOnPremisesConnection. Pour vous assurer que les PC cloud disposent d’une connectivité réseau et qu’ils sont joints à un domaine, choisissez une connexion avec un réseau virtuel que le service PC cloud a validé. La propriété onPremisesConnectionId est déconseillée et cessera de retourner des données le 31 mai 2024. À l’avenir, utilisez la propriété domainJoinConfigurations .
windowsSettings (déconseillé) cloudPcWindowsSettings Paramètres Windows spécifiques à configurer lors de la création de PC cloud pour cette stratégie d’approvisionnement. Prend en charge $select. La propriété windowsSettings est déconseillée et cessera de retourner des données le 31 janvier 2024. À l’avenir, utilisez la propriété windowsSetting .

Valeurs cloudPcProvisioningType

Le tableau suivant répertorie les membres d’une énumération évolutif. Vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes dans cette énumération évolutive : sharedByUser, sharedByEntraGroup.

Member Description
dévoué Indique qu’une licence dédiée est utilisée pour l’approvisionnement de PC cloud. Valeur par défaut.
partagé (déconseillé) Indique qu’une licence partagée est utilisée pour le provisionnement des PC cloud. Le shared membre est déconseillé et cessera de revenir le 30 avril 2027. À l’avenir, utilisez le sharedByUser membre .
unknownFutureValue Valeur sentinel de l’énumération évolutive. Ne pas utiliser.
sharedByUser Indique la stratégie d’approvisionnement lorsqu’un PC cloud dédié est approvisionné pour chaque utilisateur du groupe d’affectations. Les utilisateurs sont toujours connectés au même PC cloud. Toutefois, la disponibilité des PC cloud est limitée par le nombre total de sessions actives.
sharedByEntraGroup Indique la stratégie d’approvisionnement associée aux PC cloud partagés par un groupe Microsoft Entra (Azure AD). Lorsqu’un PC cloud partagé est provisionné, il devient disponible pour tout utilisateur du groupe d’affectation Microsoft Entra ID auquel se connecter. Les utilisateurs peuvent être connectés à un PC cloud différent sur chaque connexion et la disponibilité est limitée par le nombre de PC cloud provisionnés.

Relations

Relation Type Description
affectations Collection cloudPcProvisioningPolicyAssignment Collection définie d’attributions de stratégie d’approvisionnement. Représente l’ensemble des groupes et groupes de sécurité Microsoft 365 dans Microsoft Entra ID auxquels la stratégie d’approvisionnement est affectée. Renvoyé uniquement sur $expand. Pour obtenir un exemple sur la façon d’obtenir la relation d’affectations, consultez Obtenir cloudPcProvisioningPolicy.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "alternateResourceUrl": "String",
  "autopatch": {"@odata.type": "microsoft.graph.cloudPcProvisioningPolicyAutopatch"},
  "autopilotConfiguration": {"@odata.type": "microsoft.graph.cloudPcAutopilotConfiguration"},
  "cloudPcGroupDisplayName": "String",
  "cloudPcNamingTemplate": "String",
  "description": "String",
  "displayName": "String",
  "domainJoinConfiguration": {
    "@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"
  },
  "domainJoinConfigurations": [{"@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"}],
  "enableSingleSignOn": "Boolean",
  "gracePeriodInHours": "Int32",
  "id": "String (identifier)",
  "imageDisplayName": "String",
  "imageId": "String",
  "imageType": "String",
  "localAdminEnabled": "Boolean",
  "managedBy": "String",
  "microsoftManagedDesktop": {
    "@odata.type": "microsoft.graph.microsoftManagedDesktop"
  },
  "onPremisesConnectionId": "String",
  "provisioningType": "String",
  "windowsSetting": {
    "@odata.type": "microsoft.graph.cloudPcWindowsSetting"
  },
  "windowsSettings": {
    "@odata.type": "microsoft.graph.cloudPcWindowsSettings"
  }
}