cloudPC-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Stellt einen in der Cloud verwalteten virtuellen Desktop dar. Dieser Cloud-PC wird auch bei Intune registriert und über das Microsoft Endpoint Manager-Portal verwaltet, sodass der Cloud-PC auch über eine entsprechende Intune verwaltete Geräte-ID verfügt.

Methoden

Methode	Rückgabetyp	Beschreibung
cloudPCs	cloudPC-Sammlung	Listet die Eigenschaften und Beziehungen der cloudPC-Objekte auf.
Abrufen von cloudPC	cloudPC	Lesen sie die Eigenschaften und Beziehungen eines cloudPC-Objekts .
Ändern des Benutzerkontotyps	Keine	Ändern Sie den Kontotyp des Benutzers auf einem bestimmten Cloud-PC.
Karenzzeit beenden	Keine	Beenden Sie die Karenzzeit für ein cloudPC-Objekt .
Abrufen von Remoteaktionsergebnissen	cloudPcRemoteActionResult	Überprüfen Sie die von Cloud PC angegebenen Remoteaktionsergebnisse für ein Cloud-PC-Gerät.
Neustart	Keine	Starten Sie ein bestimmtes cloudPC-Objekt neu.
Rename	Keine	Benennen Sie ein bestimmtes cloudPC-Objekt um. Verwenden Sie diese API, um den displayName für die Cloud PC-Entität zu aktualisieren.
Neuaufteilung	Keine	Erneutes Bereitstellen eines cloudPC-Objekts .
Remoteaktion erneut bereitstellen	Keine	Erneutes Bereitstellen eines Cloud-PCs mit einer Intune managed-Geräte-ID.
Remoteaktion "Massenreprovision"	Keine	Massenreprovision einer Reihe von Cloud-PC-Geräten mit Intune verwalteten Geräte-IDs.
Ändern der Größe der Remoteaktion	Keine	Upgrade oder Downgrade eines vorhandenen Cloud-PCs auf eine andere Konfiguration mit neuer vCPU und Speichergröße über Intune verwaltete Geräte-ID.
Problembehandlung	Keine	Problembehandlung für ein bestimmtes cloudPC-Objekt . Verwenden Sie diese API, um den Integritätsstatus des Cloud-PCs und des Sitzungshosts zu überprüfen.
Remoteaktion wiederherstellen	Keine	Stellen Sie ein Cloud-PC-Gerät aus einer Momentaufnahme in einen vorherigen Zustand zurück.
Massenwiederherstellungs-Remoteaktion	cloudPcBulkRemoteActionResult	Stellen Sie mehrere Cloud-PC-Geräte mit einer einzigen Anforderung wieder her, die die IDs von Intune verwalteten Geräten und einen Wiederherstellungspunkt für Datum und Uhrzeit enthält.
Überprüfungsstatus festlegen	Keine	Legen Sie den Überprüfungsstatus eines bestimmten Cloud-PC-Geräts fest.
Abrufen des Überprüfungsstatus	cloudPcReviewStatus	Rufen Sie den Überprüfungsstatus eines bestimmten Cloud-PC-Geräts ab.
Massenvorgangsüberprüfungsstatus festlegen	cloudPcBulkRemoteActionResult	Legen Sie den Überprüfungsstatus mehrerer Cloud-PC-Geräte mit einer einzigen Anforderung fest, die die IDs von Intune verwalteten Geräten enthält.
Liste für Benutzer	cloudPC-Sammlung	Listen Sie die cloudPC-Geräte auf, die dem angemeldeten Benutzer zugeordnet sind.
Abrufen von Startinformationen für Benutzer	cloudPCLaunchInfo	Rufen Sie die cloudPCLaunchInfo für den angemeldeten Benutzer ab.

Eigenschaften

Eigenschaft	Typ	Beschreibung
aadDeviceId	Zeichenfolge	Die Azure Active Directory (Azure AD)-Geräte-ID des Cloud-PCs.
displayName	Zeichenfolge	Der Anzeigename des Cloud-PCs.
gracePeriodEndDateTime	DateTimeOffset	Datum und Uhrzeit, zu dem die Nachfrist endet und die Erneute Bereitstellung/Deprovisionierung erfolgt. Nur erforderlich, wenn der Status inGracePeriodlautet. Der Zeitstempel wird im ISO 8601-Format und der koordinierten Weltzeit (UTC) angezeigt. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
id	Zeichenfolge	Der eindeutige Bezeichner für den Cloud-PC. Schreibgeschützt.
imageDisplayName	String	Name des Betriebssystemimages, das sich auf dem Cloud-PC befindet.
lastLoginResult	cloudPcLoginResult	Das letzte Anmeldeergebnis des Cloud-PCs. Beispiel: { "time": "2014-01-01T00:00:00Z"}.
lastModifiedDateTime	DateTimeOffset	Das Datum und die Uhrzeit der letzten Änderung des Cloud-PCs. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z.
lastRemoteActionResult	cloudPcRemoteActionResult	Das letzte Remoteaktionsergebnis der Cloud-PCs des Unternehmens. Die unterstützten Remoteaktionen sind: Reboot, Rename, Reprovision, Restoreund Troubleshoot.
managedDeviceId	Zeichenfolge	Die Intune Geräte-ID des Cloud-PCs.
managedDeviceName	String	Der Intune Gerätename des Cloud-PCs.
onPremisesConnectionName	Zeichenfolge	Die Azure-Netzwerkverbindung, die während der Bereitstellung von Cloud-PCs angewendet wird.
osVersion	cloudPcOperatingSystem	Die Version des Betriebssystems (Os), das auf Cloud-PCs bereitgestellt werden soll. Mögliche Werte sind: windows10, windows11und unknownFutureValue.
provisioningPolicyId	Zeichenfolge	Die Bereitstellungsrichtlinien-ID des Cloud-PCs.
provisioningPolicyName	String	Die Bereitstellungsrichtlinie, die während der Bereitstellung von Cloud-PCs angewendet wird.
servicePlanId	String	Die Serviceplan-ID des Cloud-PCs.
servicePlanName	String	Der Dienstplanname des Cloud-PCs.
servicePlanType	cloudPcServicePlanType	Der Serviceplantyp des Cloud-PCs.
status	cloudPcStatus	Der Status des Cloud-PCs. Mögliche Werte: notProvisioned, provisioning, provisioned, upgrading, inGracePeriod, deprovisioning, failed, restoring.
statusDetails	cloudPcStatusDetails	Die Details des Cloud-PC-Status.
userAccountType	cloudPcUserAccountType	Der Kontotyp des Benutzers auf bereitgestellten Cloud-PCs. Mögliche Werte sind: standardUser, administratorund unknownFutureValue.
userPrincipalName	Zeichenfolge	Der Benutzerprinzipalname (USER Principal Name, UPN) des Benutzers, der dem Cloud-PC zugewiesen ist.

cloudPcStatus-Werte

Member	Beschreibung
notProvisioned	Der Cloud-PC wurde nicht bereitgestellt.
Bereitstellung	Die Bereitstellung von Cloud-PCs wird ausgeführt.
Bereitgestellt	Der Cloud-PC wird bereitgestellt und kann von Endbenutzern aufgerufen werden.
inGracePeriod	Der Cloud-PC befindet sich in der einwöchigen Karenzzeit, bevor er aufgehoben wird.
Deprovisioning	Die Bereitstellung des Cloud-PCs wird aufgehoben.
Fehlgeschlagen	Der Vorgang auf dem Cloud-PC ist fehlgeschlagen.
provisionedWithWarnings	Der Cloud-PC wird bereitgestellt und kann von Endbenutzern aufgerufen werden, jedoch mit einigen Warnungen. Der Benutzer kann diesen Cloud-PC weiterhin verwenden.
Größenänderung	Die Größe des Cloud-PCs wird geändert.
pendingProvision	Die Bereitstellung steht auf dem Cloud-PC aus. In diesem Fall beträgt die Anzahl der Cloud-PCs in der Karenzzeit mehr als die Anzahl der insgesamt verfügbaren Lizenzen.
Wiederherstellen	Der Cloud-PC wird wiederhergestellt.
unknownFutureValue	Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@odata.type": "#microsoft.graph.cloudPC",
  "id": "String (identifier)",
  "displayName": "String",
  "imageDisplayName": "String",
  "aadDeviceId": "String",
  "managedDeviceId": "String",
  "managedDeviceName": "String",
  "provisioningPolicyId": "String",
  "provisioningPolicyName": "String",
  "onPremisesConnectionName": "String",
  "servicePlanId": "String",
  "servicePlanType": "String",
  "servicePlanName": "String",
  "status": "String",
  "userPrincipalName": "String",
  "lastModifiedDateTime": "String (timestamp)",
  "gracePeriodEndDateTime": "String (timestamp)",
  "userAccountType": "String",
  "osVersion": "String",
  "lastRemoteActionResult": "String",
  "lastLoginResult": "String"
}