Type de ressource cloudPC
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 un bureau virtuel géré dans le cloud. Ce PC cloud est également inscrit dans Intune et géré via le portail Microsoft Endpoint Manager, de sorte que le PC cloud a également un ID d’appareil géré Intune correspondant.
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| Répertorier les PC cloudPCs | Collection cloudPC | Répertorie les propriétés et les relations des objets PC cloud. |
| Obtenir cloudPC | cloudPC | Lire les propriétés et les relations d’un objet PC cloud. |
| Obtenir des PC cloud provisionnés | Collection cloudPC | Obtenez tous les PC cloud provisionnés d’un plan de service spécifique pour les utilisateurs sous un groupe d’utilisateurs Microsoft Entra. |
| Modifier le type de compte d’utilisateur | Aucun | Modifiez le type de compte de l’utilisateur sur un PC cloud spécifique. |
| Mettre fin à la période de grâce | Aucun | Mettre fin à la période de grâce pour un objet PC cloud. |
| Obtenir les résultats de l’action à distance | cloudPcRemoteActionResult | Vérifiez les résultats de l’action à distance spécifiée par le PC cloud pour un appareil PC cloud. |
| Mise sous tension | Aucun | Mettez sous tension un objet PC Windows Frontline Cloud spécifique. Cette action prend en charge les scénarios d’administration MEM. |
| Mise hors tension | Aucun | Mettez hors tension un objet PC Windows Frontline Cloud spécifique. Cette action prend en charge les scénarios d’administration MEM. |
| Redémarrer | Aucun | Redémarrez un objet PC cloud spécifique. |
| Rename | Aucun | Renommez un objet PC cloud spécifique. Utilisez cette API pour mettre à jour displayName pour l’entité PC cloud. |
| Reprovisionner | Aucun | Reprovisionner un objet PC cloud. |
| Action à distance de reprovisionnement en bloc | Aucun | Reprovisionner en bloc un ensemble d’appareils PC cloud avec des ID d’appareil gérés Intune. |
| Redimensionner l’action à distance | Aucun | Mettez à niveau ou rétrogradez un PC cloud existant vers une autre configuration avec un nouveau processeur virtuel et une nouvelle taille de stockage via Intune’ID d’appareil géré. |
| Start | Aucun | Démarrez un PC cloud spécifique pour un utilisateur. Actuellement, seuls Windows 365 Frontline PC cloud sont pris en charge. |
| Stop | Aucun | Arrêtez un PC cloud spécifique pour un utilisateur. Actuellement, seuls Windows 365 Frontline PC cloud sont pris en charge. |
| Résoudre des problèmes | Aucun | Résoudre les problèmes d’un objet PC cloud spécifique. Utilisez cette API pour case activée l’status d’intégrité du PC cloud et de l’hôte de session. |
| Restaurer | Aucun | Restaurer un objet PC cloud à un état précédent à partir d’un instantané. |
| Action à distance de restauration en bloc | cloudPcBulkRemoteActionResult | Restaurez plusieurs appareils PC cloud avec une seule requête qui inclut les ID de Intune appareils gérés et une date et une heure de point de restauration. |
| Définir le status de révision | Aucun | Définissez le status de révision d’un appareil PC cloud spécifique. |
| Obtenir des status de révision | cloudPcReviewStatus | Obtenez la révision status d’un appareil PC cloud spécifique. |
| Status de révision des ensembles en bloc | cloudPcBulkRemoteActionResult | Définissez la status de révision de plusieurs appareils PC cloud avec une seule requête qui inclut les ID des appareils gérés Intune. |
| Liste de l’utilisateur | Collection cloudPC | Répertoriez les appareils PC cloud attribués à l’utilisateur connecté. |
| Obtenir des informations de lancement pour l’utilisateur | cloudPcLaunchInfo | Obtenez cloudPcLaunchInfo pour l’utilisateur connecté. |
| Obtenir l’historique de connectivité | collection cloudPcConnectivityEvent | Obtenez l’historique de connectivité du PC cloud. |
| Obtenir les actions à distance prises en charge | Collection cloudPcRemoteActionCapability | Obtenez la liste des actions à distance de PC cloud prises en charge pour un appareil PC cloud spécifique, y compris les noms d’actions et les fonctionnalités. |
| Nouvelle tentative d’installation de l’agent partenaire | Aucun | Réessayez l’installation des agents partenaires qui n’ont pas pu être installés sur le PC cloud. |
| Redimensionnement en bloc | collection cloudPcRemoteActionResult | Effectuez une action de redimensionnement en bloc pour redimensionner un groupe de PC cloud qui ont réussi la validation (cloudPC : validateBulkResize). Si des appareils ne peuvent pas être redimensionnés, ils sont étiquetés comme « échec du redimensionnement », tandis que les appareils restants sont provisioned destinés au processus de redimensionnement. |
| Valider le redimensionnement en bloc | collection cloudPcResizeValidateResult | Vérifiez qu’un ensemble d’appareils PC cloud répond aux conditions requises pour être redimensionnés en bloc. |
| Obtenir l’état d’accès de première ligne | frontlineCloudPcAccessState | Obtenez l’état d’accès du PC cloud de première ligne. Les valeurs possibles sont unassigned, noLicensesAvailable, activationFailed, active, activating, standbyMode, unknownFutureValue. |
| Obtenir l’état d’accès au travail par équipe (déconseillé) | shiftWorkCloudPcAccessState | Obtenez l’état d’accès du PC cloud de travail par équipe. Les valeurs possibles sont : unassigned, noLicensesAvailable, activationFailed, active, activating, waitlisted, unknownFutureValue, , . standbyMode Notez que 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 : standbyMode. Cette API est déconseillée et cessera de retourner des données le 31 décembre 2023. À l’avenir, utilisez l’API getFrontlineCloudPcAccessState . |
| Reprovisionner l’action à distance (déconseillée) | Aucun | Reprovisionner un PC cloud avec un ID d’appareil géré Intune. Cette API est déconseillée et cessera de retourner des données le 30 septembre 2023. À l’avenir, utilisez l’API de reprovisionnement . |
| Restaurer l’action à distance (déconseillée) | Aucun | Restaurez un appareil PC cloud à un état antérieur avec un ID d’appareil géré Intune. Cette API est déconseillée et cessera de retourner des données le 30 septembre 2023. À l’avenir, utilisez l’API de restauration . |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| aadDeviceId | Chaîne | ID d’appareil Microsoft Entra du PC cloud. |
| allotmentDisplayName | Chaîne | Le nom de l’allocation divise les licences de locataire en lots ou groupes plus petits, ce qui permet de limiter le nombre de licences disponibles pour une utilisation dans une affectation spécifique. Lorsque provisioningType a la valeur dedicated, le nom de l’allocation est null. En lecture seule. |
| connectivityResult | cloudPcConnectivityResult | L’intégrité de la connectivité case activée résultat d’un PC cloud, y compris l’horodatage mis à jour et si le PC cloud peut être connecté. |
| diskEncryptionState | cloudPcDiskEncryptionState | Chiffrement de disque appliqué au PC cloud. Les valeurs possibles sont notAvailable, notEncrypted, encryptedUsingPlatformManagedKey, encryptedUsingCustomerManagedKey et unknownFutureValue. |
| displayName | Chaîne | Nom complet du PC cloud. |
| gracePeriodEndDateTime | DateTimeOffset | Date et heure auxquelles la période de grâce se termine et où le reprovisionnement ou le déprovisionnement se produisent. Obligatoire uniquement si le status est inGracePeriod. L’horodatage est affiché au format ISO 8601 et au temps universel coordonné (UTC). Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| id | Chaîne | Identificateur unique du PC cloud. En lecture seule. |
| imageDisplayName | Chaîne | Nom de l’image du système d’exploitation qui se trouve sur le PC cloud. |
| lastLoginResult | cloudPcLoginResult | Dernier résultat de connexion du PC cloud. Par exemple : { "time": "2014-01-01T00:00:00Z"}. |
| lastModifiedDateTime | DateTimeOffset | Date et heure de la dernière modification du PC cloud. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| lastRemoteActionResult | cloudPcRemoteActionResult | Dernier résultat de l’action à distance des PC cloud d’entreprise. Les actions à distance prises en charge sont les suivantes : Reboot, Rename, Reprovision, Restore, Troubleshoot. |
| managedDeviceId | Chaîne | ID d’appareil Intune du PC cloud. |
| managedDeviceName | Chaîne | Nom de l’appareil Intune du PC cloud. |
| onPremisesConnectionName | Chaîne | Connexion réseau Azure appliquée lors de l’approvisionnement des PC cloud. |
| osVersion | cloudPcOperatingSystem | Version du système d’exploitation à provisionner sur les PC cloud. Les valeurs possibles sont windows10, windows11 et unknownFutureValue. |
| partnerAgentInstallResults | collection cloudPcPartnerAgentInstallResult | Les résultats de l’installation de chaque agent partenaire status sur un PC cloud. |
| powerState | cloudPcPowerState | État d’alimentation d’un PC cloud. Les valeurs possibles sont running, poweredOff, unknown. Cette propriété prend uniquement en charge les PC cloud de travail en équipe. |
| provisioningPolicyId | Chaîne | ID de stratégie d’approvisionnement du PC cloud. |
| provisioningPolicyName | Chaîne | Stratégie d’approvisionnement appliquée pendant l’approvisionnement des PC cloud. |
| provisioningType | cloudPcProvisioningType | Type de licences à utiliser lors de l’approvisionnement de PC cloud à l’aide de cette stratégie. Les valeurs possibles sont dedicated, shared et unknownFutureValue. La valeur par défaut est dedicated. |
| servicePlanId | Chaîne | ID du plan de service du PC cloud. |
| servicePlanName | Chaîne | Nom du plan de service du PC cloud. |
| servicePlanType | cloudPcServicePlanType | Type de plan de service du PC cloud. |
| status | microsoft.graph.cloudPcStatus | Status du PC cloud. Les valeurs possibles sont notProvisioned, provisioning, provisioned, inGracePeriod, deprovisioning, failed, provisionedWithWarnings, resizing, restoring, pendingProvision, unknownFutureValue, movingRegion, resizePendingLicense. 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 : movingRegion, resizePendingLicense. |
| statusDetails | cloudPcStatusDetails | Détails de l’status pc cloud. |
| userAccountType | cloudPcUserAccountType | Type de compte de l’utilisateur sur les PC cloud provisionnés. Les valeurs possibles sont standardUser, administrator et unknownFutureValue. |
| userPrincipalName | String | Nom d’utilisateur principal (UPN) de l’utilisateur affecté au PC cloud. |
Valeurs cloudPcDiskEncryptionState
| Member | Description |
|---|---|
| notAvailable | Le PC cloud n’est pas approvisionné ou se trouve dans un état où le chiffrement n’est pas disponible. |
| notEncrypted | Le PC cloud doit être chiffré, mais le chiffrement n’est pas encore effectué (réservé, ne doit pas se produire). |
| encryptedUsingPlatformManagedKey | Le PC cloud est chiffré à l’aide d’une clé gérée par la plateforme. Ce membre est la valeur par défaut si la clé gérée par le client n’est pas activée. |
| encryptedUsingCustomerManagedKey | Le PC cloud est chiffré à l’aide de la clé gérée par le client. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
Valeurs cloudPcPowerState
| Member | Description |
|---|---|
| Exécution | Le status pc cloud est en cours d’exécution. |
| poweredOff | Le pc cloud status est hors tension. |
| unknown | Le status pc cloud est inconnu. |
Valeurs cloudPcStatus
Le tableau suivant répertorie les membres d’une énumération évolutif. Notez que 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 : movingRegion, resizePendingLicense.
| Member | Description |
|---|---|
| notProvisioned | Le PC cloud n’a pas encore été provisionné. |
| Approvisionnement | Le provisionnement de PC cloud est en cours. |
| mis en service | Le PC cloud est approvisionné et les utilisateurs peuvent y accéder. |
| inGracePeriod | Le PC cloud est dans la période de grâce d’une semaine avant le déprovisionnement. |
| déprovisionnement | Le PC cloud est en cours de déprovisionnement. |
| Échoué | L’opération sur le PC cloud a échoué. |
| provisionedWithWarnings | Le PC cloud est provisionné et les utilisateurs finaux peuvent y accéder avec des avertissements. L’utilisateur peut continuer à utiliser ce PC cloud. |
| Redimensionnement | Le PC cloud est en cours de redimensionnement. |
| pendingProvision | L’approvisionnement est en attente sur le PC cloud. Dans ce cas, le nombre de PC cloud en période de grâce est supérieur au nombre total de licences disponibles. |
| Restauration | Le PC cloud est en cours de restauration. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
| movingRegion | Indique que le PC cloud est déplacé d’une région à une autre. |
| resizePendingLicense | Indique que le processus de redimensionnement du PC cloud a été lancé, mais ne peut pas être terminé, car la licence cible n’a pas été identifiée. Il est actuellement en attente d’action du client pour résoudre le problème de licence. |
Valeurs frontlineCloudPcAccessState
| Member | Description |
|---|---|
| non attribué | Définissez sur non attribué si le PC cloud ne consomme pas de licences à usage partagé. La valeur par défaut est unassigned. |
| noLicensesAvailable | Indique que toutes les licences à utilisation partagée sont en cours d’utilisation. |
| activation Échec de l’activation | Indique que l’activation du PC cloud de première ligne a échoué après que l’utilisateur a demandé un PC cloud de première ligne. |
| Active | Indique que le PC cloud de première ligne est dans un état actif avec une licence d’utilisation partagée affectée, et que l’utilisateur peut se connecter au PC cloud. |
| Activation | Indique qu’un utilisateur a demandé à connecter le PC cloud et que le service démarre. |
| standbyMode | Indique que le PC cloud de première ligne est en état de secours avant son arrêt et sa libération. Un PC cloud de première ligne en état de secours est toujours accessible par l’utilisateur. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
valeurs shiftWorkCloudPcAccessState (déconseillées)
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 : standbyMode.
| Member | Description |
|---|---|
| non attribué | Définissez sur unassigned si le PC cloud ne consomme pas de licences à usage partagé. La valeur par défaut est unassigned. |
| noLicensesAvailable | Indique que toutes les licences à utilisation partagée sont en cours d’utilisation. |
| activation Échec de l’activation | Indique que l’activation du PC cloud de travail en équipe a échoué après que l’utilisateur a demandé un pc cloud de travail en équipe. |
| Active | Indique que le PC cloud de travail par équipe est dans un état actif avec une licence d’utilisation partagée affectée, et que l’utilisateur peut se connecter au PC cloud. |
| Activation | Indique qu’un utilisateur a demandé à connecter le PC cloud et que le service démarre. |
| liste d’attente (déconseillé) | Indique que le PC cloud de travail par équipe est dans un état de liste d’attente après que l’utilisateur demande à connecter ce PC cloud et que toutes les licences d’utilisation partagée sont activement utilisées. Cette valeur est déconseillée et cessera de retourner le 17 mai 2023. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
| standbyMode | Indique que le PC cloud de travail en équipe est en état de secours avant son arrêt et sa libération. Un PC cloud de travail en équipe en état de secours est toujours accessible par l’utilisateur. |
Relations
Aucun.
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.cloudPC",
"aadDeviceId": "String",
"allotmentDisplayName": "String",
"connectivityResult": "String",
"diskEncryptionState": "String",
"displayName": "String",
"gracePeriodEndDateTime": "String (timestamp)",
"id": "String (identifier)",
"imageDisplayName": "String",
"lastLoginResult": "String",
"lastModifiedDateTime": "String (timestamp)",
"lastRemoteActionResult": "String",
"managedDeviceId": "String",
"managedDeviceName": "String",
"onPremisesConnectionName": "String",
"powerState": "String",
"osVersion": "String",
"partnerAgentInstallResults": "String",
"provisioningPolicyId": "String",
"provisioningPolicyName": "String",
"provisioningType": "String",
"servicePlanId": "String",
"servicePlanName": "String",
"servicePlanType": "String",
"status": "String",
"userAccountType": "String",
"userPrincipalName": "String"
}
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