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. Par conséquent, le PC cloud a également un ID d’appareil géré par Intune.
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. |
| 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. |
| Réapprovisionner | Aucun | Reprovisionner un objet PC cloud. |
| Resize | Aucun | Mettez à niveau ou rétrogradez un PC cloud existant vers une configuration avec un nouveau processeur virtuel (vCPU) et une nouvelle taille de stockage. |
| 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 les 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é. |
| Définir le status de révision | Aucun | Définissez le status de révision d’un appareil PC cloud spécifique à l’aide de l’ID de PC cloud. |
| Récupérer les status de révision | cloudPcReviewStatus | Obtenez la révision status d’un PC cloud. |
| 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. |
| Récupérer les résultats de l’action à distance | collection cloudPcRemoteActionResult | Récupérez les résultats de l’action à distance et case activée la status d’une action à distance spécifique effectuée sur l’appareil PC cloud associé. |
| 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. |
| 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. |
| Créer instantané | Aucun | Créez un instantané pour un appareil PC cloud spécifique. |
| Récupérer des instantanés | Collection cloudPcSnapshot | Obtenez la liste des ressources cloudPcSnapshot pour un PC cloud. |
| 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. Le noLicensesAvailable membre est déconseillé et cessera de revenir le 30 septembre 2024. |
| Action à distance de reprovisionnement en bloc (déconseillée) | Aucun | Reprovisionner en bloc un ensemble d’appareils PC cloud avec des ID d’appareil gérés Intune. Cette API est déconseillée et a cessé de retourner des données le 24 septembre 2023. À l’avenir, utilisez la ressource cloudPcBulkReprovision . |
| Redimensionnement en bloc (déconseillé) | 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. Cette API est déconseillée et a cessé de retourner des données le 24 septembre 2023. À l’avenir, utilisez la ressource cloudPcBulkResize . |
| Action à distance de restauration en bloc (déconseillée) | 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. Cette API est déconseillée et a cessé de retourner des données le 24 septembre 2023. À l’avenir, utilisez la ressource cloudPcBulkRestore . |
| Obtenir les résultats de l’action à distance (déconseillé) | cloudPcRemoteActionResult | Vérifiez les résultats de l’action à distance spécifiée par le PC cloud pour un appareil PC cloud. Cette API est déconseillée et cessera de retourner des données le 30 septembre 2024. À l’avenir, utilisez l’API retrieveCloudPcRemoteActionResults . |
| Obtenir la révision status (déconseillé) | cloudPcReviewStatus | Obtenez la révision status d’un appareil PC cloud spécifique par managedDeviceId. Cette API est déconseillée et a cessé de retourner des données le 30 avril 2024. À l’avenir, utilisez l’API cloudPC : retrieveReviewStatus . |
| 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 . |
| Redimensionner l’action à distance (déconseillé) | 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é. Cette API est déconseillée et a cessé de retourner des données le 30 octobre 2023. À l’avenir, utilisez l’API cloudPC : resize . |
| 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 . |
| Définir le status de révision (déconseillé) | Aucun | Définissez le status de révision d’un appareil PC cloud spécifique à l’aide de l’ID d’appareil géré. Cette API est déconseillée et a cessé de retourner des données le 30 avril 2024. À l’avenir, utilisez l’API cloudPC : setReviewStatus . |
| Status de révision d’ensemble en bloc (déconseillé) | Aucun | 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. Cette API est déconseillée et a cessé de retourner des données le 30 septembre 2024. À l’avenir, utilisez la ressource cloudPcBulkSetReviewStatus . |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| aadDeviceId | String | ID d’appareil Microsoft Entra du PC cloud. |
| allotmentDisplayName | String | Le nom de l’allocation divise les licences de locataire en lots ou groupes plus petits qui permettent 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é. |
| deviceRegionName | String | Nom de la région géographique où le PC cloud est actuellement approvisionné. Par exemple, westus3, eastus2et southeastasia. En lecture seule. |
| disasterRecoveryCapability | cloudPcDisasterRecoveryCapability | La récupération d’urgence status du PC cloud, y compris la région primaire, la région secondaire et le type de capacité. La valeur par défaut indique null que le paramètre de récupération d’urgence est désactivé. Pour recevoir une réponse avec la propriété disasterRecoveryCapability et $select$filter celle-ci dans disasterRecoveryCapability/{subProperty} l’URL de la requête. Pour plus d’informations, consultez Exemple 4 : Répertorier les PC cloud filtrés par type de capacité de récupération d’urgence. En lecture seule. |
| diskEncryptionState | cloudPcDiskEncryptionState | Chiffrement de disque appliqué au PC cloud. Les valeurs possibles sont notAvailable, notEncrypted, encryptedUsingPlatformManagedKey, encryptedUsingCustomerManagedKey et unknownFutureValue. |
| displayName | String | Nom complet du PC cloud. |
| gracePeriodEndDateTime | DateTimeOffset | Date et heure de fin de la période de grâce et de reprovisionnement ou de déprovisionnement. 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 | String | Identificateur unique du PC cloud. En lecture seule. |
| imageDisplayName | String | 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, minuit UTC le 1er janvier 2014 est 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 | String | ID d’appareil Intune du PC cloud. |
| managedDeviceName | String | Nom de l’appareil Intune du PC cloud. |
| onPremisesConnectionName | String | 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 | String | ID de stratégie d’approvisionnement du PC cloud. |
| provisioningPolicyName | String | 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, unknownFutureValueshared,sharedByUsersharedByEntraGroup , . 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. La valeur par défaut est dedicated. ATTENTION : Le shared membre est déconseillé et cessera de revenir le 30 avril 2027 ; à l’avenir, utilisez le sharedByUser membre. |
| servicePlanId | String | ID du plan de service du PC cloud. |
| servicePlanName | String | 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, provisionedprovisioning, inGracePeriod, deprovisioning, failed, provisionedWithWarningsresizing, restoring, pendingProvision, , unknownFutureValue, movingRegion, resizePendingLicense. modifyingSingleSignOn 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, modifyingSingleSignOn. |
| statusDetails (déconseillé) | cloudPcStatusDetails | Détails de l’status pc cloud. Par exemple : { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null }. Cette propriété est déconseillée et ne sera plus prise en charge à compter du 31 août 2024. Utilisez statusDetail à la place. |
| statusDetail | cloudPcStatusDetail | Indique les status détaillées associées au PC cloud, y compris le code d’erreur/avertissement, le message d’erreur/avertissement, les informations supplémentaires. Par exemple : { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null }. |
| connectionSetting | cloudPcConnectionSetting | Paramètre de connexion du PC cloud. Valeurs possibles : enableSingleSignOn. En lecture seule. |
| 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 provisionné 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 |
|---|---|
| course | 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, modifyingSingleSignOn.
| Member | Description |
|---|---|
| notProvisioned | Le PC cloud n’a pas encore été provisionné. |
| fourniture | 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. |
| raté | 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 pendant la 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. |
| modifyingSingleSignOn | Indique que le PC cloud met à jour le paramètre d’authentification unique. |
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 (déconseillé) | Indique que toutes les licences à utilisation partagée sont en cours d’utilisation. Le noLicensesAvailable membre est déconseillé et cessera de revenir le 30 septembre 2024. |
| 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. |
| actif | 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 dans un état de secours est toujours accessible par l’utilisateur. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
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",
"deviceRegionName": "String",
"disasterRecoveryCapability": {"@odata.type": "microsoft.graph.cloudPcDisasterRecoveryCapability"},
"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"
}