cloudPC-Ressourcentyp

Artikel
04/18/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 einen in der Cloud verwalteten virtuellen Desktop dar. Dieser Cloud-PC ist auch in 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	Auflisten der Eigenschaften und Beziehungen der Cloud-PC-Objekte.
CloudPC abrufen	cloudPC	Lesen der Eigenschaften und Beziehungen eines Cloud-PC-Objekts.
Abrufen bereitgestellter Cloud-PCs	cloudPC-Sammlung	Abrufen aller bereitgestellten Cloud-PCs eines bestimmten Serviceplans für Benutzer unter einer Microsoft Entra Benutzergruppe.
Ändern des Benutzerkontotyps	Keine	Ändern Sie den Kontotyp des Benutzers auf einem bestimmten Cloud-PC.
Karenzzeit beenden	Keine	Beenden Sie die Toleranzperiode für ein Cloud-PC-Objekt.
Abrufen von Remoteaktionsergebnissen	cloudPcRemoteActionResult	Überprüfen Sie die Vom Cloud-PC angegebenen Remoteaktionsergebnisse für ein Cloud-PC-Gerät.
Einschalten	Keine	Schalten Sie ein bestimmtes Windows Frontline Cloud PC-Objekt ein. Diese Aktion unterstützt MEM-Administratorszenarien.
Ausschalten	Keine	Schalten Sie ein bestimmtes Windows Frontline Cloud PC-Objekt aus. Diese Aktion unterstützt MEM-Administratorszenarien.
Neustart	Keine	Starten Sie ein bestimmtes Cloud-PC-Objekt neu.
Rename	Keine	Benennen Sie ein bestimmtes Cloud-PC-Objekt um. Verwenden Sie diese API, um den displayName für die Cloud-PC-Entität zu aktualisieren.
Erneute Bereitstellung	Keine	Erneutes Bereitstellen eines Cloud-PC-Objekts.
Massenrevisions-Remoteaktion	Keine	Massenbasierte erneute Bereitstellung einer Gruppe von Cloud-PC-Geräten mit Intune verwalteten Geräte-IDs.
Remoteaktion "Größe ändern"	Keine	Aktualisieren oder Downgrade eines vorhandenen Cloud-PCs auf eine andere Konfiguration mit einer neuen vCPU und Speichergröße über Intune verwaltete Geräte-ID.
Start	Keine	Starten Sie einen bestimmten Cloud-PC für einen Benutzer. Derzeit werden nur Windows 365 Frontline Cloud-PCs unterstützt.
Stop	Keine	Beenden Sie einen bestimmten Cloud-PC für einen Benutzer. Derzeit werden nur Windows 365 Frontline Cloud-PCs unterstützt.
Problembehandlung	Keine	Problembehandlung für ein bestimmtes Cloud-PC-Objekt. Verwenden Sie diese API, um die Integrität status des Cloud-PCs und des Sitzungshosts zu überprüfen.
Wiederherstellen	Keine	Wiederherstellen eines Cloud-PC-Objekts in einem vorherigen Zustand aus einem Momentaufnahme.
Remoteaktion für die Massenwiederherstellung	cloudPcBulkRemoteActionResult	Stellen Sie mehrere Cloud-PC-Geräte mit einer einzigen Anforderung wieder her, die die IDs von Intune verwalteten Geräten sowie Datum und Uhrzeit der Wiederherstellung enthält.
Überprüfungs-status festlegen	Keine	Legen Sie die Überprüfung status eines bestimmten Cloud-PC-Geräts fest.
Abrufen von status	cloudPcReviewStatus	Erhalten Sie die Überprüfung status eines bestimmten Cloud-PC-Geräts.
Status für Massenüberprüfungen	cloudPcBulkRemoteActionResult	Legen Sie die Überprüfung status mehrerer Cloud-PC-Geräte mit einer einzigen Anforderung fest, die die IDs Intune verwalteten Geräte enthält.
Liste für Benutzer	cloudPC-Sammlung	Listet die Cloud-PC-Geräte auf, die dem angemeldeten Benutzer zugeordnet sind.
Abrufen der Startinformationen für den Benutzer	cloudPcLaunchInfo	Rufen Sie cloudPcLaunchInfo für den angemeldeten Benutzer ab.
Abrufen des Konnektivitätsverlaufs	cloudPcConnectivityEvent-Sammlung	Rufen Sie den Cloud-PC-Konnektivitätsverlauf ab.
Abrufen unterstützter Remoteaktionen	cloudPcRemoteActionCapability-Sammlung	Rufen Sie eine Liste der unterstützten Cloud-PC-Remoteaktionen für ein bestimmtes Cloud-PC-Gerät ab, einschließlich der Aktionsnamen und -funktionen.
Partner-Agent-Installation wiederholen	Keine	Wiederholen Sie die Installation für die Partner-Agents, die auf dem Cloud-PC nicht installiert werden konnten.
Massenänderung der Größe	cloudPcRemoteActionResult-Sammlung	Führen Sie eine Massenänderungsaktion aus, um die Größe einer Gruppe von Cloud-PCs zu ändern, die die Überprüfung erfolgreich bestanden haben (cloudPC: validateBulkResize). Wenn die Größe von Geräten nicht geändert werden kann, werden sie als "Fehler beim Ändern der Größe" bezeichnet, während die übrigen Geräte für den Größenänderungsprozess vorgesehen sind `provisioned` .
Überprüfen der Massenänderung der Größe	cloudPcResizeValidateResult-Sammlung	Überprüfen Sie, ob eine Gruppe von Cloud-PC-Geräten die Anforderungen für eine Massenänderung der Größe erfüllt.
Abrufen des Zugriffsstatus in Service und Produktion	frontlineCloudPcAccessState	Rufen Sie den Zugriffsstatus des Cloud-PCs in Service und Produktion ab. Mögliche Werte sind: `unassigned`, `noLicensesAvailable`, `activationFailed`, `active`, `activating`, `standbyMode`, `unknownFutureValue`.
Abrufen des Schichtarbeitszugriffsstatus (veraltet)	shiftWorkCloudPcAccessState	Rufen Sie den Zugriffsstatus des Schichtarbeits-Cloud-PCs ab. Mögliche Werte: `unassigned`, `noLicensesAvailable`, , `activationFailedactive`, `activating`, `waitlisted`, `unknownFutureValue`, , . `standbyMode` Beachten Sie, dass Sie den Anforderungsheader `Prefer: include-unknown-enum-members` verwenden müssen, um den folgenden Wert in dieser verteilbaren Enumeration abzurufen: `standbyMode`. Diese API ist veraltet und gibt am 31. Dezember 2023 keine Daten mehr zurück. Verwenden Sie in Zukunft die getFrontlineCloudPcAccessState-API .
Remoteaktion erneut bereitstellen (veraltet)	Keine	Erneutes Bereitstellen eines Cloud-PCs mit einer Intune verwalteten Geräte-ID. Diese API ist veraltet und gibt am 30. September 2023 keine Daten mehr zurück. Verwenden Sie in Zukunft die API für die erneute Bereitstellung .
Remoteaktion wiederherstellen (veraltet)	Keine	Wiederherstellen eines Cloud-PC-Geräts in einem früheren Zustand mit einer Intune verwalteten Geräte-ID. Diese API ist veraltet und gibt am 30. September 2023 keine Daten mehr zurück. Verwenden Sie in Zukunft die Wiederherstellungs-API .

Eigenschaften

Eigenschaft	Typ	Beschreibung
aadDeviceId	String	Die Microsoft Entra Geräte-ID des Cloud-PCs.
allotmentDisplayName	String	Der Zuweisungsname unterteilt Mandantenlizenzen in kleinere Batches oder Gruppen, die dazu beitragen, die Anzahl der lizenzen einzuschränken, die für die Verwendung in einer bestimmten Zuweisung verfügbar sind. Wenn provisioningType ist, lautet `dedicatednull`der Zuweisungsname . Schreibgeschützt.
connectivityResult	cloudPcConnectivityResult	Das Ergebnis der Konnektivitätsintegritätsprüfung eines Cloud-PCs, einschließlich des aktualisierten Zeitstempels und ob der Cloud-PC verbunden werden kann.
diskEncryptionState	cloudPcDiskEncryptionState	Die Datenträgerverschlüsselung, die auf den Cloud-PC angewendet wird. Mögliche Werte: `notAvailable`, `notEncrypted`, `encryptedUsingPlatformManagedKey`, `encryptedUsingCustomerManagedKey` und `unknownFutureValue`.
displayName	String	Der Anzeigename des Cloud-PCs.
gracePeriodEndDateTime	DateTimeOffset	Das Datum und die Uhrzeit des Ablaufs der Karenzzeit und die erneute Bereitstellung oder Aufhebung der Bereitstellung. Nur erforderlich, wenn die status ist`inGracePeriod`. Der Zeitstempel wird im ISO 8601-Format und koordinierter Weltzeit (UTC) angezeigt. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist `2014-01-01T00:00:00Z`.
id	String	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	Datum und 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. Mitternacht UTC am 1. Januar 2014 ist `2014-01-01T00:00:00Z`beispielsweise .
lastRemoteActionResult	cloudPcRemoteActionResult	Das letzte Remoteaktionsergebnis der Unternehmens-Cloud-PCs. Die unterstützten Remoteaktionen sind: `Reboot`, `Rename`, `Reprovision`, `Restore`, `Troubleshoot`.
managedDeviceId	String	Die Intune Geräte-ID des Cloud-PCs.
managedDeviceName	String	Der Intune Gerätename des Cloud-PCs.
onPremisesConnectionName	String	Die Azure-Netzwerkverbindung, die während der Bereitstellung von Cloud-PCs angewendet wird.
osVersion	cloudPcOperatingSystem	Die Version des Betriebssystems, das auf Cloud-PCs bereitgestellt werden soll. Mögliche Werte sind: `windows10`, `windows11` und `unknownFutureValue`.
partnerAgentInstallResults	cloudPcPartnerAgentInstallResult-Sammlung	Die Ergebnisse der Installation jedes Partner-Agents status auf Cloud-PC.
powerState	cloudPcPowerState	Der Energiezustand eines Cloud-PCs. Die möglichen Werte sind: `running`, `poweredOff`, `unknown`. Diese Eigenschaft unterstützt nur Schichtarbeits-Cloud-PCs.
provisioningPolicyId	String	Die Bereitstellungsrichtlinien-ID des Cloud-PCs.
provisioningPolicyName	String	Die Bereitstellungsrichtlinie, die während der Bereitstellung von Cloud-PCs angewendet wird.
provisioningType	cloudPcProvisioningType	Der Typ der Lizenzen, die bei der Bereitstellung von Cloud-PCs mit dieser Richtlinie verwendet werden sollen. Mögliche Werte sind: `dedicated`, `shared`, `unknownFutureValue`,`sharedByUser` , `sharedByUser`. Sie müssen den Anforderungsheader `Prefer: include-unknown-enum-members` verwenden, um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: `sharedByUser`, `sharedByEntraGroup`. Der Standardwert ist `dedicated`. ACHTUNG: Der `shared` Member ist veraltet und wird am 30. April 2027 nicht mehr zurückgegeben. Verwenden Sie in Zukunft den `sharedByUser` Member.
servicePlanId	String	Die Dienstplan-ID des Cloud-PCs.
servicePlanName	String	Der Dienstplanname des Cloud-PCs.
servicePlanType	cloudPcServicePlanType	Der Dienstplantyp des Cloud-PCs.
status	microsoft.graph.cloudPcStatus	Die status des Cloud-PCs. Mögliche Werte: `notProvisioned`, `provisioning`, `provisioned`, `inGracePeriod`, `deprovisioning`, `failed`, `provisionedWithWarnings`, `resizing`, `restoring`, `pendingProvision`, `unknownFutureValue`, `movingRegion`, `resizePendingLicense`. Sie müssen den Anforderungsheader `Prefer: include-unknown-enum-members` verwenden, um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: `movingRegion`, `resizePendingLicense`.
statusDetails	cloudPcStatusDetails	Die Details der Cloud-PC-status.
userAccountType	cloudPcUserAccountType	Der Kontotyp des Benutzers auf bereitgestellten Cloud-PCs. Mögliche Werte sind: `standardUser`, `administrator` und `unknownFutureValue`.
userPrincipalName	String	Der Benutzerprinzipalname (UPN) des Benutzers, der dem Cloud-PC zugewiesen ist.

cloudPcDiskEncryptionState-Werte

Member	Beschreibung
nicht Verfügbar	Der Cloud-PC wird nicht bereitgestellt oder befindet sich in einem Zustand, in dem keine Verschlüsselung verfügbar ist.
notEncrypted	Der Cloud-PC sollte verschlüsselt werden, aber die Verschlüsselung ist noch nicht erfolgt (reserviert, sollte nicht erfolgen).
encryptedUsingPlatformManagedKey	Der Cloud-PC wird mit einem plattformseitig verwalteten Schlüssel verschlüsselt. Dieser Member ist der Standardwert, wenn der kundenseitig verwaltete Schlüssel nicht aktiviert ist.
encryptedUsingCustomerManagedKey	Der Cloud-PC wird mit dem kundenseitig verwalteten Schlüssel verschlüsselt.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

cloudPcPowerState-Werte

Member	Beschreibung
Ausgeführte	Die Cloud-PC-status wird ausgeführt.
poweredOff	Die Cloud-PC-status ist ausgeschaltet.
unknown	Die Cloud-PC-status ist unbekannt.

cloudPcStatus-Werte

In der folgenden Tabelle sind die Elemente einer drehbaren Enumeration aufgeführt. Beachten Sie, dass Sie den Anforderungsheader Prefer: include-unknown-enum-members verwenden müssen, um die folgenden Werte in dieser verteilbaren Enumeration abzurufen: movingRegion, resizePendingLicense.

Member	Beschreibung
notProvisioned	Der Cloud-PC wurde noch nicht bereitgestellt.
Bereitstellung	Die Bereitstellung von Cloud-PCs wird ausgeführt.
Bereitgestellt	Der Cloud-PC wird bereitgestellt, und Benutzer können darauf zugreifen.
inGracePeriod	Der Cloud-PC befindet sich in der einwöchigen Karenzzeit, bevor die Bereitstellung aufgehoben wird.
Aufheben der Bereitstellung	Die Bereitstellung des Cloud-PCs wird aufgehoben.
Fehlgeschlagen	Fehler beim Vorgang auf dem Cloud-PC.
provisionedWithWarnings	Der Cloud-PC wird bereitgestellt, und Endbenutzer können mit einigen Warnungen darauf zugreifen. 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 ist die Anzahl der Cloud-PCs in der Karenzzeit höher als die Anzahl der insgesamt verfügbaren Lizenzen.
Wiederherstellen	Der Cloud-PC wird wiederhergestellt.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.
movingRegion	Gibt an, dass der Cloud-PC von einer Region in eine andere verschoben wird.
resizePendingLicense	Gibt an, dass der Prozess zum Ändern der Größe des Cloud-PCs initiiert wurde, aber nicht abgeschlossen werden kann, da die Ziellizenz nicht identifiziert wurde. Es wartet derzeit auf eine Kundenaktion, um das Lizenzierungsproblem zu beheben.

frontlineCloudPcAccessState-Werte

Member	Beschreibung
Nicht zugewiesen	Wird auf nicht zugewiesen festgelegt, wenn der Cloud-PC keine Gemeinsam genutzten Lizenzen nutzt. Der Standardwert ist `unassigned`.
noLicensesAvailable	Gibt an, dass alle Gemeinsam genutzten Lizenzen verwendet werden.
activationFailed	Gibt an, dass bei der Aktivierung des Cloud-PCs in Service und Produktion ein Fehler aufgetreten ist, nachdem der Benutzer einen Cloud-PC in Service und Produktion angefordert hat.
aktiv	Gibt an, dass sich der Frontline-Cloud-PC in einem aktiven Zustand mit zugewiesener Shared-Use-Lizenz befindet und der Benutzer eine Verbindung mit dem Cloud-PC herstellen kann.
Aktivieren	Gibt an, dass ein Benutzer die Verbindung mit dem Cloud-PC und dem Start des Diensts angefordert hat.
standbyMode	Gibt an, dass sich der Cloud-PC in Service und Produktion in einem Standbyzustand befindet, bevor er heruntergefahren und die Zuordnung aufgehoben wird. Auf einen Cloud-PC in Service und Produktion in einem Standbyzustand kann der Benutzer weiterhin zugreifen.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

shiftWorkCloudPcAccessState-Werte (veraltet)

In der folgenden Tabelle sind die Elemente einer drehbaren Enumeration aufgeführt. Sie müssen den Anforderungsheader Prefer: include-unknown-enum-members verwenden, um die folgenden Werte in dieser verteilbaren Enumeration abzurufen: standbyMode.

Member	Beschreibung
Nicht zugewiesen	Wird auf nicht zugewiesen festgelegt, wenn der Cloud-PC keine Gemeinsam genutzten Lizenzen nutzt. Der Standardwert ist `unassigned`.
noLicensesAvailable	Gibt an, dass alle Gemeinsam genutzten Lizenzen verwendet werden.
activationFailed	Gibt an, dass die Aktivierung des Cloud-PCs für Schichtarbeit fehlgeschlagen ist, nachdem der Benutzer einen Schichtarbeits-Cloud-PC angefordert hat.
aktiv	Gibt an, dass sich der Schichtarbeits-Cloud-PC in einem aktiven Zustand mit zugewiesener Shared-Use-Lizenz befindet und der Benutzer eine Verbindung mit dem Cloud-PC herstellen kann.
Aktivieren	Gibt an, dass ein Benutzer die Verbindung mit dem Cloud-PC und dem Start des Diensts angefordert hat.
wartelisted (veraltet)	Gibt an, dass sich der Schichtarbeits-Cloud-PC in einem Wartelistezustand befindet, nachdem der Benutzer eine Verbindung mit diesem Cloud-PC angefordert hat und alle Lizenzen für die gemeinsame Nutzung aktiv verwendet werden. Dieser Wert ist veraltet und wird am 17. Mai 2023 nicht mehr zurückgegeben.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.
standbyMode	Gibt an, dass sich der Schichtarbeits-Cloud-PC in einem Standbyzustand befindet, bevor er heruntergefahren und die Zuordnung aufgehoben wird. Ein Schichtarbeits-Cloud-PC im Standbyzustand ist weiterhin für den Benutzer zugänglich.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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

Share via