Freigeben über

cloudPcDeviceImage-Ressourcentyp

  • Artikel

Namespace: microsoft.graph

Stellt die Imageressource auf einem Cloud-PC dar.

Erbt von entity.

Methoden

Methode Rückgabetyp Beschreibung
List cloudPcDeviceImage-Sammlung Listet die Eigenschaften und Beziehungen von cloudPcDeviceImage-Objekten (Betriebssystemimages) auf, die auf cloud PC hochgeladen wurden.
Get cloudPcDeviceImage Liest die Eigenschaften und Beziehungen eines bestimmten cloudPcDeviceImage-Objekts .
Create cloudPcDeviceImage Create ein neues cloudPcDeviceImage-Objekt.
Delete Keine Löschen Sie ein cloudPcDeviceImage-Objekt .
Abrufen von Quellimages cloudPcSourceDeviceImage-Sammlung Rufen Sie cloudPcSourceDeviceImage-Objekte ab, die hochgeladen und auf Cloud-PCs verwendet werden können.

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. 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 Zeichenfolge 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 Zeichenfolge Das Betriebssystem des Images. Beispiel: Windows 10 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: supported, supportedWithWarning, unknown, unknownFutureValue Der Standardwert ist unknown. Schreibgeschützt.
sourceImageResourceId Zeichenfolge 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 Zeichenfolge 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"
}