Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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. |
| Réessayer | Aucun | Réessayez l’opération d’approvisionnement pour les PC cloud qui utilisaient la stratégie partagée de première ligne actuelle et qui n’ont pas pu appliquer la stratégie d’approvisionnement. |
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 | Indique les paramètres windows autopatch pour les PC cloud à l’aide de cette stratégie d’approvisionnement. Les paramètres prennent effet lorsque le locataire s’inscrit dans Autopatch et que le managedType de la propriété microsoftManagedDesktop est défini comme 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 |
| createdBy | String | ID unique de l’utilisateur qui a créé cette stratégie. Par exemple : 5ccb8d35-dd04-473e-a287-69bb4473208b. En lecture seule. Prend en charge $select. |
| createdDateTime | DateTimeOffset | Horodatage lors de la création de cette stratégie d’approvisionnement. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. En lecture seule. Prend en charge $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 se joignent Microsoft Entra ID (Azure AD). Prend en charge $select. |
| enableSingleSignOn | Booléen |
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. Facultatif. |
| 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 :
$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 : gallery, custom. La valeur par défaut est gallery. Prend en charge $filter, $select et $orderBy. |
| lastModifiedBy | String | ID unique de l’utilisateur qui a mis à jour cette stratégie pour la dernière fois. Par exemple : 5ccb8d35-dd04-473e-a287-69bb4473208b. En lecture seule. Prend en charge $select. |
| lastModifiedDateTime | DateTimeOffset | Horodatage de la dernière modification de cette stratégie d’approvisionnement. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. En lecture seule. Prend en charge $select et $orderBy. |
| localAdminEnabled | Booléen | 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 windows365, devBox, unknownFutureValue, rpaBox, microsoft365Opal, microsoft365BizChat. La valeur par défaut est windows365. Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les membres suivants 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, reserve. Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes à partir de cette énumération évolutive : sharedByUser, sharedByEntraGroup, reserve. 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 . |
| userExperienceType | cloudPcUserExperienceType | Spécifie le type d’objet cloud auquel l’utilisateur final peut accéder. Les valeurs possibles sont cloudPc, cloudApp, unknownFutureValue.
cloudPc indique que l’utilisateur final peut accéder à l’intégralité du bureau.
cloudApp indique que l’utilisateur final peut accéder uniquement aux applications publiées dans le cadre de cette stratégie d’approvisionnement. Le type ne peut pas être modifié une fois la stratégie d’approvisionnement créée. S’il n’est pas spécifié lors de la création, la valeur par défaut est cloudPc. Lorsque cloudApp est sélectionné, provisioningType doit être sharedByEntraGroup. Prend en charge $filter, $select, $orderBy. |
| 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. |
| userSettingsPersistenceConfiguration | cloudPcUserSettingsPersistenceConfiguration | Indique des paramètres spécifiques qui activent la persistance des paramètres d’application utilisateur entre les sessions de PC cloud. La valeur par défaut est null. Cette fonctionnalité est disponible uniquement pour les stratégies d’approvisionnement de PC cloud de type sharedByEntraGroup. 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. Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes dans cette énumération évolutive : sharedByUser, sharedByEntraGroup, reserve.
| Member | Description |
|---|---|
| Dédié | 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. |
| Réserve | Indique que la stratégie doit utiliser des licences dédiées, par utilisateur, limitées dans le temps lorsque les PC cloud sont provisionnés. Ces PC cloud qui utilisent la stratégie de réserve peuvent être extraits et archivés plusieurs fois par l’utilisateur, et la licence limitée dans le temps n’est consommée qu’une fois le PC cloud extrait. Actuellement, chaque utilisateur peut obtenir 10 heures de temps d’utilisation à partir de chaque plan de service de réserve instance. |
Valeurs cloudPcUserExperienceType
| Member | Description |
|---|---|
| cloudPc | Indique que les utilisateurs finaux peuvent accéder à l’ensemble du bureau. |
| cloudApp | Indique que les utilisateurs finaux peuvent uniquement accéder à Cloud Apps publiées dans le cadre de cette stratégie d’approvisionnement. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
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",
"createdBy": "String",
"createdDateTime": "String (timestamp)",
"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",
"lastModifiedBy": "String",
"lastModifiedDateTime": "String (timestamp)",
"localAdminEnabled": "Boolean",
"managedBy": "String",
"microsoftManagedDesktop": {"@odata.type": "microsoft.graph.microsoftManagedDesktop"},
"onPremisesConnectionId": "String",
"provisioningType": "String",
"userExperienceType": "String",
"userSettingsPersistenceConfiguration": {"@odata.type": "microsoft.graph.cloudPcUserSettingsPersistenceConfiguration"},
"windowsSetting": {"@odata.type": "microsoft.graph.cloudPcWindowsSetting"},
"windowsSettings": {"@odata.type": "microsoft.graph.cloudPcWindowsSettings"}
}