cloudPcDeviceImage-Ressourcentyp

Artikel
01/23/2024

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
DeviceImages auflisten	cloudPcDeviceImage-Sammlung	Listet die Eigenschaften und Beziehungen von cloudPcDeviceImage-Objekten auf .
Abrufen von cloudPcDeviceImage	cloudPcDeviceImage	Liest die Eigenschaften und Beziehungen eines cloudPcDeviceImage-Objekts .
Erstellen von cloudPcDeviceImage	cloudPcDeviceImage	Erstellen Sie ein neues cloudPcDeviceImage-Objekt .
Löschen von cloudPcDeviceImage	Keine	Löschen Sie ein cloudPcDeviceImage-Objekt .
getSourceImages	cloudPcSourceDeviceImage-Sammlung	Abrufen von cloudPcSourceDeviceImage-Objekten .
Erneutes Laden von cloudPcDeviceImage	Keine	Laden Sie ein cloudPcDeviceImage-Objekt erneut hoch, das nicht hochgeladen werden konnte.

Eigenschaften

Eigenschaft	Typ	Beschreibung
displayName	String	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. Mögliche Werte: `internalServerError`, `sourceImageNotFound`, `osVersionNotSupported`, `sourceImageInvalid`, `sourceImageNotGeneralized`, `unknownFutureValue`, `vmAlreadyAzureAdJoined`, `paidSourceImageNotSupport`, `sourceImageNotSupportCustomizeVMName`, `sourceImageSizeExceedsLimitation`. Beachten Sie, dass Sie den Anforderungsheader `Prefer: include-unknown-enum-members` verwenden müssen, um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: `vmAlreadyAzureAdJoined`, `paidSourceImageNotSupport`, `sourceImageNotSupportCustomizeVMName`, `sourceImageSizeExceedsLimitation`. Schreibgeschützt.
expirationDate	Datum	Das Datum, an dem das Image nicht mehr verfügbar war. Schreibgeschützt.
id	String	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	String	Das Betriebssystem des Images. Beispiel: `Windows 10 Enterprise`. Schreibgeschützt.
osBuildNumber	String	Die Buildversion des Betriebssystems des Images. Beispiel: `1909`. Schreibgeschützt.
osStatus	cloudPcDeviceImageOsStatus	Die Betriebssystem-status dieses Images. Mögliche Werte: `supported`, `supportedWithWarning`, `unknown`, `unknownFutureValue` Der Standardwert ist `unknown`. Schreibgeschützt.
sourceImageResourceId	String	Der eindeutige Bezeichner (ID) der Quellimageressource in 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: `pending`, `ready`, `failed`, `unknownFutureValue` Schreibgeschützt.
Version	String	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`. Beachten Sie, dass Sie den Anforderungsheader `Prefer: include-unknown-enum-members` verwenden müssen, um die folgenden Werte aus dieser verteilbaren 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 wurde 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.

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 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
Ausstehende	Der Bildupload wird ausgeführt.
Bereit	Das Image kann auf Cloud-PCs verwendet werden.
Fehlgeschlagen	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 wurde 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.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt 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",
  "sourceImageResourceId": "String",
  "status": "String",
  "statusDetails": "String",
  "version": "String"
}

Share via