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 la ressource image sur un PC cloud.
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| List | collection cloudPcDeviceImage | Répertorie les propriétés et les relations des objets cloudPcDeviceImage . |
| Obtenir | cloudPcDeviceImage | Lisez les propriétés et les relations d’un objet cloudPcDeviceImage . |
| Create | cloudPcDeviceImage | Créez un objet cloudPcDeviceImage . |
| Supprimer | Aucun | Supprime un objet cloudPcDeviceImage . |
| Obtenir des images sources | collection cloudPcSourceDeviceImage | Obtenir des objets cloudPcSourceDeviceImage . |
| Reupload | Aucun | Rechargez un objet cloudPcDeviceImage qui n’a pas pu être chargé. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| displayName | String | Nom complet de l’image d’appareil associée. Le nom complet et la version de l’image de l’appareil sont utilisés pour identifier de manière unique l’image de l’appareil PC cloud. En lecture seule. |
| errorCode | cloudPcDeviceImageErrorCode | Code d’erreur du status de l’image qui indique la raison de l’échec du chargement, le cas échéant. Les valeurs possibles sont internalServerError, sourceImageNotFound, osVersionNotSupported, sourceImageInvalid, sourceImageNotGeneralized, unknownFutureValue, vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation, sourceImageWithDataDiskNotSupported, sourceImageWithDiskEncryptionSetNotSupported, sourceImageWithAzureDiskEncryptionNotSupported. Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes de cette énumération évolutive : vmAlreadyAzureAdJoined, sourceImageNotSupportCustomizeVMNamepaidSourceImageNotSupport, sourceImageSizeExceedsLimitation, sourceImageWithDataDiskNotSupported, , sourceImageWithDiskEncryptionSetNotSupported, sourceImageWithAzureDiskEncryptionNotSupported, , fSLogixInstalledSourceImageNotSupported. startMenuAppLimitExceeded En lecture seule. |
| expirationDate | Date | Date à laquelle l’image est devenue indisponible. En lecture seule. |
| id | String | Identificateur unique (ID) de la ressource image sur le PC cloud. En lecture seule. |
| lastModifiedDateTime | DateTimeOffset | Données et heure de la dernière modification de l’image. L’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. |
| operatingSystem | String | Système d’exploitation de l’image. Par exemple : Windows 11 Enterprise. En lecture seule. |
| osBuildNumber | String | Version de build du système d’exploitation de l’image. Par exemple : 1909. En lecture seule. |
| osStatus | cloudPcDeviceImageOsStatus | Le système d’exploitation status de cette image. Les valeurs possibles sont : supported, supportedWithWarning, unknown, unknownFutureValue. La valeur par défaut est unknown. En lecture seule. |
| osVersionNumber | String | Version du système d’exploitation de cette image. Par exemple : 10.0.22000.296. En lecture seule. |
| sizeInGB | Int32 | Taille de l’image en Go. Par exemple : 64. En lecture seule. |
| sourceImageResourceId | String | Identificateur unique (ID) de la ressource d’image source sur Azure. Le format d’ID requis est : « /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName} ». En lecture seule. |
| status | cloudPcDeviceImageStatus | Status de l’image sur le PC cloud. Les valeurs possibles sont : pending, ready, warning, failed, unknownFutureValue. En lecture seule. |
| version | String | Version de l’image. Par exemple, 0.0.1 et 1.5.13. En lecture seule. |
| statusDetails (déconseillé) | cloudPcDeviceImageStatusDetails | Les détails de la status de l’image qui indiquent la raison de l’échec du chargement, le cas échéant. Les valeurs possibles sont les suivantes : internalServerError, sourceImageNotFound, osVersionNotSupported, sourceImageInvalid, sourceImageNotGeneralized, unknownFutureValue, vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName et sourceImageSizeExceedsLimitation. Utilisez l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes à partir de cette énumération évolutive : vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. En lecture seule. La propriété statusDetails est déconseillée et cessera de retourner des données le 31 janvier 2024. À l’avenir, utilisez la propriété errorCode . |
Valeurs cloudPcDeviceImageErrorCode
| Member | Description |
|---|---|
| internalServerError | Une erreur de serveur interne s’est produite pendant le traitement de l’image. |
| sourceImageNotFound | L’image source est inaccessible ou introuvable. |
| osVersionNotSupported | La version du système d’exploitation n’est pas prise en charge. |
| sourceImageInvalid | L’image source n’est pas valide pour le provisionnement d’une machine virtuelle Windows. |
| sourceImageNotGeneralized | L’image chargée n’est pas généralisée. Rechargez l’image après avoir exécuté la commande sysprep/generalize. Pour plus d’informations, consultez Supprimer des informations spécifiques à l’ordinateur en déprovisionnant ou en généralisant une machine virtuelle avant de créer une image. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
| vmAlreadyAzureAdJoined | La machine virtuelle qui génère une image source pour créer une image d’appareil a déjà été jointe à Microsoft Entra. Cela empêche le processus de validation d’autoriser la création d’une image d’appareil à l’aide d’une telle image source. |
| paidSourceImageNotSupport | Cette image source est générée à partir d’une autre image payante à partir de la Place de marché Azure et n’est pas prise en charge. Utilisez une autre source pour continuer. |
| sourceImageNotSupportCustomizeVMName | Un problème de paramètre de nom d’ordinateur existe sur l’image généralisée résultante, ce qui empêche la personnalisation du nom de la machine virtuelle avec l’image fournie. |
| sourceImageSizeExceedsLimitation | La taille de l’image source chargée par le client dépasse les limites de la galerie d’images partagées (SIG), ce qui entraîne un échec de création d’image. |
| sourceImageWithDataDiskNotSupported | Indique le code d’erreur dans lequel un disque de données associé est attaché à l’image source. La configuration d’une stratégie d’approvisionnement avec cette configuration n’est pas prise en charge avec W365 Frontline. |
| sourceImageWithDiskEncryptionSetNotSupported | Indique que l’image chargée utilise un jeu de chiffrement de disque avec une clé gérée par le client, ce qui n’est pas pris en charge dans Windows 365. Chargez une nouvelle image chiffrée avec une clé gérée par la plateforme. |
| sourceImageWithAzureDiskEncryptionNotSupported | Indique que l’image chargée a été capturée à partir d’une machine virtuelle Azure sur laquelle Azure chiffrement de disque était activé, ce qui n’est pas pris en charge dans Windows 365. Chargez une nouvelle image capturée à partir d’une machine virtuelle chiffrée uniquement avec une clé gérée par la plateforme. |
| fSLogixInstalledSourceImageNotSupported | Indique le code d’erreur où FSLogix a été détecté sur l’image et qu’il n’est pas pris en charge dans Windows 365. Supprimez FSLogix de l’image et rechargez-la. |
| startMenuAppLimitExceeded | Indique le code d’erreur où l’image chargée contient au moins 3 000 applications/liens dans le menu Démarrer, qui est supérieur au nombre pris en charge par les images personnalisées. Supprimez les applications/liens dans le menu Démarrer et chargez à nouveau l’image. |
Valeurs cloudPcDeviceImageOsStatus
| Member | Description |
|---|---|
| Pris en charge | Indique que le système d’exploitation d’image d’appareil PC cloud est actif et prêt à être utilisé pour l’approvisionnement. |
| supportedWithWarning | Indique que le système d’exploitation de l’image d’appareil PC cloud a expiré, mais que cloud PC continue à prendre en charge. Si les utilisateurs continuent à l’utiliser, il se peut qu’ils ne puissent pas obtenir les mises à jour de sécurité. |
| unknown | Valeur par défaut. Indique que la status de l’image du système d’exploitation pour l’appareil PC cloud est inconnue. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
Valeurs cloudPcDeviceImageStatus
| Member | Description |
|---|---|
| Attente | Le chargement de l’image est en cours. |
| Prêt | L’image est prête à être utilisée sur les PC cloud. |
| warning | Indique que l’image de PC cloud chargée peut ne pas être provisionnée dans certains scénarios. Pour plus d’informations, consultez le message d’erreur. |
| Échoué | Indique que le chargement de l’image a échoué. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
valeurs cloudPcDeviceImageStatusDetails
| Member | Description |
|---|---|
| internalServerError | Une erreur de serveur interne s’est produite pendant le traitement de l’image. |
| sourceImageNotFound | L’image source est inaccessible ou introuvable. |
| osVersionNotSupported | La version du système d’exploitation n’est pas prise en charge. |
| sourceImageInvalid | L’image source n’est pas valide pour le provisionnement d’une machine virtuelle Windows. |
| sourceImageNotGeneralized | L’image chargée n’est pas généralisée. Rechargez l’image après avoir exécuté la commande sysprep/generalize. Pour plus d’informations, consultez Supprimer des informations spécifiques à l’ordinateur en déprovisionnant ou en généralisant une machine virtuelle avant de créer une image. |
| unknownFutureValue | Valeur sentinel de l’énumération évolutive. Ne pas utiliser. |
| vmAlreadyAzureAdJoined | Machine virtuelle qui génère une image source pour créer une image d’appareil jointe Microsoft Entra. Cela empêche le processus de validation d’autoriser la création d’une image d’appareil à l’aide d’une telle image source. |
| paidSourceImageNotSupport | Cette image source est générée à partir d’une autre image payante à partir de la Place de marché Azure et n’est pas prise en charge. Utilisez une autre source pour continuer. |
| sourceImageNotSupportCustomizeVMName | Un problème de paramètre de nom d’ordinateur existe sur l’image généralisée résultante, ce qui empêche la personnalisation du nom de la machine virtuelle avec l’image fournie. |
| sourceImageSizeExceedsLimitation | La taille de l’image source chargée par le client dépasse les limites de la galerie d’images partagées (SIG), ce qui entraîne un échec de création d’image. |
Relations
Aucun.
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.cloudPcDeviceImage",
"displayName": "String",
"errorCode": "String",
"expirationDate": "String (timestamp)",
"id": "String (identifier)",
"lastModifiedDateTime": "String (timestamp)",
"operatingSystem": "String",
"osBuildNumber": "String",
"osStatus": "String",
"osVersionNumber": "String",
"sizeInGB": "Int32",
"sourceImageResourceId": "String",
"status": "String",
"statusDetails": "String",
"version": "String"
}