Freigeben über

cloudPcDeviceImage-Ressourcentyp

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 Erstellen Sie ein neues cloudPcDeviceImage-Objekt .
Löschen 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 sind: 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.
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 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.
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, 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
anhängig Gibt an, dass der Bildupload ausgeführt wird.
fertig Gibt an, dass das Image für die Verwendung auf Cloud-PCs bereit ist.
misslungen 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 veranschaulicht 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"
}
  • Last updated on