cloudPcDeviceImage-Ressourcentyp

Namespace: microsoft.graph

Stellt die Imageressource auf einem Cloud-PC dar.

Erbt von entity.

Methoden

Methode	Rückgabetyp	Beschreibung
DeviceImages auflisten	cloudPcDeviceImage-Sammlung	Listet die Eigenschaften und Beziehungen von cloudPcDeviceImage-Objekten (Betriebssystemimages) auf, die auf cloud PC hochgeladen wurden.
Abrufen von cloudPcDeviceImage	cloudPcDeviceImage	Liest die Eigenschaften und Beziehungen eines bestimmten 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	Rufen Sie cloudPcSourceDeviceImage-Objekte ab, die hochgeladen und auf Cloud-PCs verwendet werden können.

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. Geerbt von entity.
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.

cloudPcDeviceImageErrorCode-Werte

Member	Beschreibung
internalServerError	Gibt an, dass bei der Verarbeitung des Images ein interner Serverfehler aufgetreten ist.
sourceImageNotFound	Gibt an, dass auf das Quellimage nicht zugegriffen werden kann oder nicht gefunden wird.
osVersionNotSupported	Gibt an, dass die Betriebssystemversion nicht unterstützt wird.
sourceImageInvalid	Gibt an, dass das Quellimage für die Bereitstellung eines virtuellen Windows-Computers (VM) ungültig ist.
sourceImageNotGeneralized	Gibt an, dass das hochgeladene Bild nicht generalisiert wurde. 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	Gibt an, dass der virtuelle Computer, der ein Quellimage zum Erstellen eines Geräteimages generiert, bereits mit Microsoft Entra verknüpft wurde. Dadurch wird verhindert, dass der Überprüfungsprozess die Erstellung eines Geräteimages mit einem solchen Quellimage zulässt.
paidSourceImageNotSupport	Gibt an, dass dieses Quellimage aus einem anderen kostenpflichtigen Image aus dem Azure Marketplace erstellt und nicht unterstützt wird. Verwenden Sie eine andere Quelle, um fortzufahren.
sourceImageNotSupportCustomizeVMName	Gibt an, dass ein Problem mit der Computernameneinstellung für das resultierende generalisierte Image vorliegt, das die Anpassung des VM-Namens mit dem bereitgestellten Image verhindert.
sourceImageSizeExceedsLimitation	Gibt an, dass die Größe des vom Kunden hochgeladenen Quellimages die Sig-Einschränkungen (Shared Image Gallery) überschreitet, 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 ist und für die Bereitstellung bereit 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	Gibt an, dass der Bildupload ausgeführt wird.
Bereit	Gibt an, dass das Image für die Verwendung auf Cloud-PCs bereit ist.
Fehlgeschlagen	Gibt an, dass das Bild nicht hochgeladen werden konnte.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.cloudPcDeviceImage",
  "displayName": "String",
  "errorCode": "String",
  "expirationDate": "String (Date)",
  "id": "String (identifier)",
  "lastModifiedDateTime": "String (timestamp)",
  "operatingSystem": "String",
  "osBuildNumber": "String",
  "osStatus": "String",
  "sourceImageResourceId": "String",
  "status": "String",
  "version": "String"
}