Type de ressource cloudPcProvisioningPolicy

Article
09/25/2024

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`, et`19h2-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 `true`la 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"
  }
}

Partager via