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épertorier les propriétés et les relations des objets cloudPcProvisioningPolicy . |
| Obtenir | cloudPcProvisioningPolicy | Lire les propriétés et les relations d’un objet cloudPcProvisioningPolicy . |
| Create | cloudPcProvisioningPolicy | Créez un objet cloudPcProvisioningPolicy . |
| Mettre à jour | cloudPcProvisioningPolicy | Mettre à jour les propriétés d’un objet cloudPcProvisioningPolicy . |
| Supprimer | Aucun | Supprimez un objet cloudPcProvisioningPolicy . |
| Assign | Aucun | Attribuez une stratégie cloudPcProvisioningPolicy aux groupes d’utilisateurs. |
| Appliquer | Aucun | Appliquez la configuration de stratégie d’approvisionnement actuelle à tous les appareils PC cloud sous une stratégie spécifiée. |
| Appliquer la configuration | Aucun | Mettez à jour la configuration de la stratégie d’approvisionnement pour un ensemble d’appareils PC cloud par leurs ID. |
| Réessayer | Aucun | Recommencez l’opération d’approvisionnement pour les PC cloud qui ont utilisé la stratégie partagée de première ligne actuelle et qui n’ont pas appliqué la stratégie d’approvisionnement. |
| Planifier la tâche d’application de la stratégie | Aucun | Planifiez une tâche d’application de stratégie pour une stratégie d’approvisionnement. |
| Récupérer le résultat de l’action d’application de la stratégie | cloudPcPolicyApplyActionResult | Récupérer le résultat d’une action d’application de stratégie pour une stratégie d’approvisionnement. |
| Calendrier d’application de la stratégie Récupérer | cloudPcPolicyScheduledApplyActionDetail | Récupérer la planification d’une action d’application de stratégie pour une stratégie d’approvisionnement. |
| Récupérer le résultat du status de mise à jour de la stratégie | cloudPcPolicyPendingApplyStatusResult | Récupérez le status d’application en attente d’une stratégie d’approvisionnement pour déterminer si des modifications non appliquées existent pour les PC cloud. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| alternateResourceUrl | String | URL de l’autre ressource liée à cette stratégie d’approvisionnement. En lecture seule. |
| mise en cache automatique | cloudPcProvisioningPolicyAutopatch | Indique les paramètres de mise en pause automatique Windows pour les PC cloud à l’aide de cette stratégie d’approvisionnement. Les paramètres prennent effet lorsque le client s’inscrit à Autopatch et que le managedType de la propriété microsoftManagedDesktop est défini comme starterManaged. Lorsque vous créez ou mettez à jour une stratégie d’approvisionnement avec autopatch, vous devez utiliser un jeton délégué et l’utilisateur connecté doit avoir le rôle d’administrateur Intune. Prend en charge $select. |
| autopilotConfiguration | cloudPcAutopilotConfiguration | Les paramètres spécifiques de Windows Autopilot qui permettent aux clients de Windows 365 d’en faire l’expérience sur PC cloud. Lorsque vous créez ou mettez à jour une stratégie d’approvisionnement avec autopilotConfiguration, utilisez les autorisations Microsoft Graph requises répertoriées sur les pages de création et de mise à jour d’API correspondantes. Dans les scénarios délégués, l’utilisateur connecté doit également disposer de l’autorisation Microsoft.Intune/DeviceConfigurations/Assign RBAC Intune. Prend en charge $select. |
| cloudPcGroupDisplayName | String | Nom d’affichage 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 configuré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 respectivement le nom de l’utilisateur et un nombre généré de façon aléatoire. Par exemple, CPC-%USERNAME:4%-%RAND:5% signifie que le nom du PC cloud commence par CPC-, suivi d’un nom d’utilisateur de 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 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 configuré ne prend pas en charge cette fonctionnalité. La valeur par défaut est false. Les utilisateurs de Windows 365 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 nouvelle stratégie d’approvisionnement. En lecture seule. Prise en charge $filter, $select, et $orderBy |
| imageDisplayName | String | Nom d’affichage de l’image du système d’exploitation utilisée pour la mise en service. Par exemple : Windows 11 Preview + Microsoft 365 Apps 23H2 23H2. Prise en charge $filter, $select, et $orderBy |
| ID d’image | String | Identificateur unique qui représente une image de système d’exploitation utilisée pour la mise en service 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é ou galerie) utilisée pour l’approvisionnement 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 true, 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 de Prefer: include-unknown-enum-members 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 de microsoftManagedDesktop qui permettent aux clients Microsoft Managed Desktop d’obtenir une expérience gérée par l’appareil pour Cloud PC. Pour permettre à microsoftManagedDesktop de fournir plus de valeur, un administrateur doit y spécifier certains paramètres. Prise en charge $filter, $select, et $orderBy |
| ApprovisionnementType | cloudPcProvisioningType | Spécifie le type de licences à utiliser lors de l’approvisionnement des PC cloud à l’aide de cette stratégie. Les valeurs possibles sont dedicated, , unknownFutureValueshared, sharedByUsersharedByEntraGroupreserve. Utilisez l’en-tête de Prefer: include-unknown-enum-members requête pour obtenir les valeurs suivantes à partir de cette énumération évolutive : sharedByUser, , sharedByEntraGroupreserve. Le shared membre est déconseillé et cessera de revenir le 30 avril 2027 ; à l’avenir, utilisez le sharedByUser membre. Par exemple, vous pouvez attribuer un dedicated plan de services à un seul utilisateur et approvisionner un seul PC cloud. Les shared plans et sharedByUser exigent que les clients achètent un plan de services partagés. 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 services partagés. Chaque licence partagée dans le cadre de ce plan peut activer un PC cloud, qui est partagé pour le groupe en fonction des attributions de cette stratégie. Par défaut, le type de licence est dedicated si le ProvisioningType n’est pas spécifié lorsque vous créez le cloudPcProvisioningPolicy. Vous ne pouvez pas modifier cette propriété après la création de cloudPcProvisioningPolicy . |
| scopeIds | String collection | Liste des ID de balise d’étendue pour cette ressource. En lecture seule. |
| snapshotResetMode | cloudPcSnapshotResetMode | Indique si la réinitialisation d’instantané est disponible pour cette stratégie d’approvisionnement. Les valeurs possibles sont : notApplicable, enabled, disabled, unknownFutureValue. La valeur par défaut est notApplicable. |
| 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 uniquement accéder 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. Si elle n’est pas spécifiée lors de la création, la valeur par défaut est cloudPc. Lorsque cloudApp est sélectionné, le provisioningType doit être sharedByEntraGroup. Prend en charge $filter, $select, $orderBy. |
| userSettingsPersistenceConfiguration | cloudPcUserSettingsPersistenceConfiguration | Indique les paramètres spécifiques qui permettent la persistance des paramètres d’application utilisateur entre les sessions Cloud PC. 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. |
| 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 comment 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 se joignent au 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 renvoyer 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 évolutive. Utilisez l’en-tête de Prefer: include-unknown-enum-members 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 des PC cloud. Valeur par défaut. |
| Partagé (déconseillé) | Indique qu’une licence partagée est utilisée pour l’approvisionnement 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 sentinelle d’énumération évolutive. Ne pas utiliser. |
| sharedByUser | Indique la stratégie d’approvisionnement lorsqu’un PC cloud dédié est configuré pour chaque utilisateur du groupe d’attribution. Les utilisateurs sont toujours connectés au même PC cloud. Toutefois, la disponibilité d’un PC dans le cloud est limitée par le nombre total de sessions actives. |
| sharedByEntraGroup | Indique la stratégie de provisionnement 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’attribution Microsoft Entra ID pour s’y connecter. Les utilisateurs peuvent être connectés à un PC cloud différent à chaque connexion et la disponibilité est limitée par le nombre de PC cloud provisionnés. |
| réserver | Indique que la stratégie doit utiliser des licences dédiées, par utilisateur et limitées dans le temps lors de l’approvisionnement des PC cloud. Ces PC cloud qui utilisent la stratégie de réserve peuvent être extraits et archivés par l’utilisateur plusieurs fois, et la licence limitée dans le temps est consommée uniquement après l’extraction du PC cloud. Actuellement, chaque utilisateur peut obtenir 10 heures de temps d’utilisation de chaque instance de plan de service de réserve. |
Valeurs cloudPcSnapshotResetMode
| Member | Description |
|---|---|
| notApplicable | Indique que la réinitialisation de l’instantané n’est pas applicable à la stratégie d’approvisionnement. |
| activé | Indique que la réinitialisation de l’instantané est activée pour la stratégie d’approvisionnement. |
| désactivé | Indique que la réinitialisation de l’instantané est désactivée pour la stratégie d’approvisionnement. |
| unknownFutureValue | Valeur sentinelle d’énumération évolutive. Ne pas utiliser. |
valeurs cloudPcUserExperienceType
| Member | Description |
|---|---|
| Ordinateur cloud | Indique que les utilisateurs finaux peuvent accéder à l’intégralité du bureau. |
| CloudApp | Indique que les utilisateurs finaux peuvent uniquement accéder aux applications cloud publiées dans le cadre de cette stratégie d’approvisionnement. |
| unknownFutureValue | Valeur sentinelle d’énumération évolutive. Ne pas utiliser. |
Relations
| Relation | Type | Description |
|---|---|---|
| affectations | collection cloudPcProvisioningPolicyAssignment | Collection définie d’affectations de stratégie d’approvisionnement. Représente l’ensemble des groupes Microsoft 365 et des groupes de sécurité dans Microsoft Entra ID auxquels une stratégie de provisionnement est attribuée. Renvoyé uniquement sur $expand. Pour obtenir un exemple sur la façon d’obtenir la relation 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",
"scopeIds": ["String"],
"snapshotResetMode": "String",
"userExperienceType": "String",
"userSettingsPersistenceConfiguration": {"@odata.type": "microsoft.graph.cloudPcUserSettingsPersistenceConfiguration"},
"windowsSetting": {"@odata.type": "microsoft.graph.cloudPcWindowsSetting"},
"windowsSettings": {"@odata.type": "microsoft.graph.cloudPcWindowsSettings"}
}