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
Propriétés
| Propriété | Type | Description |
|---|---|---|
| alternateResourceUrl | Chaîne | URL de l’autre ressource liée à cette stratégie d’approvisionnement. En lecture seule. |
| cloudPcGroupDisplayName | Chaîne | Nom complet du groupe de PC cloud dans lequel résident les PC cloud. En lecture seule. |
| 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. Prise en charge $filter, $select, et $orderBy |
| 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 (Azure AD). Prend en charge $select. |
| enableSingleSignOn | Valeur booléenne | 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 | Chaîne | 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 | Chaîne | 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 | Chaîne | 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 les suivantes : gallery, custom. La valeur par défaut est gallery. Prend en charge $filter, $select et $orderBy. |
| localAdminEnabled | Valeur booléenne | 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é) | Chaîne | 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é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. |
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",
"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"
}
}
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour