Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Stellt die Imageressource auf einem Cloud-PC dar.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | cloudPcDeviceImage-Sammlung | Listet die Eigenschaften und Beziehungen von cloudPcDeviceImage-Objekten auf . |
| Get | cloudPcDeviceImage | Liest die Eigenschaften und Beziehungen eines cloudPcDeviceImage-Objekts . |
| Create | cloudPcDeviceImage | Erstellen Sie ein neues cloudPcDeviceImage-Objekt . |
| Löschen | Keine | Löschen Sie ein cloudPcDeviceImage-Objekt . |
| Abrufen von Quellimages | cloudPcSourceDeviceImage-Sammlung | Abrufen von cloudPcSourceDeviceImage-Objekten . |
| Erneutes Laden | Keine | Laden Sie ein cloudPcDeviceImage-Objekt erneut hoch, das nicht hochgeladen werden konnte. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| displayName | Zeichenfolge | Der Anzeigename des zugeordneten Gerätebilds. Der Anzeigename des Geräteimages und die Version werden verwendet, um das Cloud-PC-Geräteimage eindeutig zu identifizieren. Schreibgeschützt. |
| errorCode | cloudPcDeviceImageErrorCode | Der Fehlercode des status des Bilds, der angibt, warum der Upload fehlgeschlagen ist, falls zutreffend. Die möglichen Werte sind: internalServerError, sourceImageNotFound, osVersionNotSupported, sourceImageInvalid, sourceImageNotGeneralized, , vmAlreadyAzureAdJoinedunknownFutureValue, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation, sourceImageWithDataDiskNotSupported, sourceImageWithDiskEncryptionSetNotSupported, . sourceImageWithAzureDiskEncryptionNotSupported Verwenden Sie den Anforderungsheader Prefer: include-unknown-enum-members , um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation, sourceImageWithDataDiskNotSupported, sourceImageWithDiskEncryptionSetNotSupported, sourceImageWithAzureDiskEncryptionNotSupported. Schreibgeschützt. |
| expirationDate | Datum | Das Datum, an dem das Image nicht mehr verfügbar war. Schreibgeschützt. |
| id | Zeichenfolge | Der eindeutige Bezeichner (ID) der Imageressource auf dem Cloud-PC. Schreibgeschützt. |
| lastModifiedDateTime | DateTimeOffset | Die Daten und die Uhrzeit, zu der das Bild zuletzt geändert wurde. Der Zeitstempel stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Schreibgeschützt. |
| operatingSystem | Zeichenfolge | Das Betriebssystem des Images. Beispiel: Windows 11 Enterprise. Schreibgeschützt. |
| osBuildNumber | Zeichenfolge | Die Buildversion des Betriebssystems des Images. Beispiel: 1909. Schreibgeschützt. |
| osStatus | cloudPcDeviceImageOsStatus | Die Betriebssystem-status dieses Images. Mögliche Werte sind: supported, supportedWithWarning, unknown, unknownFutureValue. Der Standardwert ist unknown. Schreibgeschützt. |
| osVersionNumber | Zeichenfolge | Die Betriebssystemversion dieses Images. Beispiel: 10.0.22000.296. Schreibgeschützt. |
| sizeInGB | Int32 | Die Größe des Images in GB. Beispiel: 64. Schreibgeschützt. |
| sourceImageResourceId | Zeichenfolge | Der eindeutige Bezeichner (ID) der Quellimageressource auf Azure. Das erforderliche ID-Format lautet: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/images/{imageName}". Schreibgeschützt. |
| status | cloudPcDeviceImageStatus | Die status des Images auf dem Cloud-PC. Mögliche Werte sind: pending, ready, warning, failed, unknownFutureValue. Schreibgeschützt. |
| Version | Zeichenfolge | Die Imageversion. Beispiel: 0.0.1 und 1.5.13. Schreibgeschützt. |
| statusDetails (veraltet) | cloudPcDeviceImageStatusDetails | Die Details der status des Bilds, die angeben, warum der Upload fehlgeschlagen ist, falls zutreffend. Mögliche Werte: internalServerError, sourceImageNotFound, osVersionNotSupported, sourceImageInvalid, sourceImageNotGeneralized, unknownFutureValue, vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. Verwenden Sie den Anforderungsheader Prefer: include-unknown-enum-members , um die folgenden Werte aus dieser verwertbaren Enumeration abzurufen: vmAlreadyAzureAdJoined, paidSourceImageNotSupport, sourceImageNotSupportCustomizeVMName, sourceImageSizeExceedsLimitation. Schreibgeschützt. Die statusDetails-Eigenschaft ist veraltet und gibt am 31. Januar 2024 keine Daten mehr zurück. Verwenden Sie in Zukunft die errorCode-Eigenschaft . |
cloudPcDeviceImageErrorCode-Werte
| Member | Beschreibung |
|---|---|
| internalServerError | Bei der Verarbeitung des Images ist ein interner Serverfehler aufgetreten. |
| sourceImageNotFound | Auf das Quellimage kann nicht zugegriffen werden oder nicht gefunden werden. |
| osVersionNotSupported | Die Betriebssystemversion wird nicht unterstützt. |
| sourceImageInvalid | Das Quellimage ist für die Bereitstellung eines virtuellen Windows-Computers (VM) ungültig. |
| sourceImageNotGeneralized | Das hochgeladene Bild ist nicht generalisiert. Laden Sie das Image erneut hoch, nachdem Sie den Befehl sysprep/generalize ausgeführt haben. Weitere Informationen finden Sie unter Entfernen von computerspezifischen Informationen durch Aufheben der Bereitstellung oder Generalisierung eines virtuellen Computers vor dem Erstellen eines Images. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
| vmAlreadyAzureAdJoined | Der virtuelle Computer, der ein Quellimage zum Erstellen eines Geräteimages generiert, wurde bereits mit Microsoft Entra verknüpft. Dadurch wird verhindert, dass der Überprüfungsprozess die Erstellung eines Geräteimages mit einem solchen Quellimage zulässt. |
| paidSourceImageNotSupport | Dieses Quellimage basiert auf einem anderen kostenpflichtigen Image aus dem Azure Marketplace und wird nicht unterstützt. Verwenden Sie eine andere Quelle, um fortzufahren. |
| sourceImageNotSupportCustomizeVMName | Für das resultierende generalisierte Image liegt ein Problem mit der Computernameneinstellung vor, das die Anpassung des VM-Namens an das bereitgestellte Image verhindert. |
| sourceImageSizeExceedsLimitation | Die Größe des vom Kunden hochgeladenen Quellimages überschreitet die Sig-Einschränkungen (Shared Image Gallery), was zu einem Fehler bei der Imageerstellung führt. |
| sourceImageWithDataDiskNotSupported | Gibt den Fehlercode an, bei dem dem Quellimage ein zugeordneter Datenträger angefügt ist. Das Einrichten einer Bereitstellungsrichtlinie mit dieser Konfiguration wird mit W365 Frontline nicht unterstützt. |
| sourceImageWithDiskEncryptionSetNotSupported | Gibt an, dass das hochgeladene Image einen Datenträgerverschlüsselungssatz mit einem kundenseitig verwalteten Schlüssel verwendet, der in Windows 365 nicht unterstützt wird. Laden Sie ein neues Image hoch, das mit einem plattformseitig verwalteten Schlüssel verschlüsselt ist. |
| sourceImageWithAzureDiskEncryptionNotSupported | Gibt an, dass das hochgeladene Image von einem Azure virtuellen Computer erfasst wurde, auf dem Azure Datenträgerverschlüsselung aktiviert war, was in Windows 365 nicht unterstützt wird. Laden Sie ein neues Image hoch, das von einem virtuellen Computer erfasst wurde, der nur mit einem plattformseitig verwalteten Schlüssel verschlüsselt wurde. |
cloudPcDeviceImageOsStatus-Werte
| Member | Beschreibung |
|---|---|
| unterstützt | Gibt an, dass das Betriebssystem des Cloud-PC-Geräteimages aktiv und bereit für die Bereitstellung ist. |
| supportedWithWarning | Gibt an, dass das Betriebssystem des Cloud-PC-Geräteimages abgelaufen ist, Cloud-PC jedoch weiterhin unterstützt wird. Wenn Benutzer es weiterhin verwenden, können sie möglicherweise keine Sicherheitsupdates erhalten. |
| unknown | Standard. Gibt an, dass die status des Betriebssystemimages für das Cloud-PC-Gerät unbekannt ist. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
cloudPcDeviceImageStatus-Werte
| Member | Beschreibung |
|---|---|
| anhängig | Der Bildupload wird ausgeführt. |
| fertig | Das Image kann auf Cloud-PCs verwendet werden. |
| warning | Gibt an, dass das hochgeladene Cloud-PC-Image in bestimmten Szenarien möglicherweise nicht bereitgestellt wird. Weitere Informationen finden Sie in der Fehlermeldung. |
| misslungen | Gibt an, dass das Bild nicht hochgeladen werden konnte. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
cloudPcDeviceImageStatusDetails-Werte
| Member | Beschreibung |
|---|---|
| internalServerError | Bei der Verarbeitung des Images ist ein interner Serverfehler aufgetreten. |
| sourceImageNotFound | Auf das Quellimage kann nicht zugegriffen werden oder nicht gefunden werden. |
| osVersionNotSupported | Die Betriebssystemversion wird nicht unterstützt. |
| sourceImageInvalid | Das Quellimage ist für die Bereitstellung eines virtuellen Windows-Computers (VM) ungültig. |
| sourceImageNotGeneralized | Das hochgeladene Bild ist nicht generalisiert. Laden Sie das Image erneut hoch, nachdem Sie den Befehl sysprep/generalize ausgeführt haben. Weitere Informationen finden Sie unter Entfernen von computerspezifischen Informationen durch Aufheben der Bereitstellung oder Generalisierung eines virtuellen Computers vor dem Erstellen eines Images. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
| vmAlreadyAzureAdJoined | Der virtuelle Computer, der ein Quellimage zum Erstellen eines Geräteimages generiert, das Microsoft Entra. Es verhindert, dass der Überprüfungsprozess die Erstellung eines Geräteimages mit einem solchen Quellimage zulässt. |
| paidSourceImageNotSupport | Dieses Quellimage basiert auf einem anderen kostenpflichtigen Image aus dem Azure Marketplace und wird nicht unterstützt. Verwenden Sie eine andere Quelle, um fortzufahren. |
| sourceImageNotSupportCustomizeVMName | Für das resultierende generalisierte Image liegt ein Problem mit der Computernameneinstellung vor, das die Anpassung des VM-Namens an das bereitgestellte Image verhindert. |
| sourceImageSizeExceedsLimitation | Die Größe des vom Kunden hochgeladenen Quellimages überschreitet die Sig-Einschränkungen (Shared Image Gallery), was zu einem Fehler bei der Imageerstellung führt. |
Beziehungen
Keine.
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"@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"
}