cloudPC-Ressourcentyp
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. |
| Bereitgestellte Cloud-PCs abrufen | cloudPC-Sammlung | Abrufen aller bereitgestellten Cloud-PCs eines bestimmten Serviceplans für Benutzer unter einer Microsoft Entra Benutzergruppe. |
| Benutzerkontotyp ändern | 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. |
| 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. |
| Resize | Keine | Führen Sie ein Upgrade oder Downgrade eines vorhandenen Cloud-PCs auf eine Konfiguration mit einer neuen virtuellen CPU (vCPU) und Speichergröße durch. |
| Start | Keine | Starten Sie einen bestimmten Cloud-PC. Derzeit werden nur Windows 365 Frontline Cloud-PCs unterstützt. |
| Stop | Keine | Beenden Sie eine bestimmte Cloud. 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. |
| Überprüfungsstatus festlegen | Keine | Legen Sie die Überprüfung status eines bestimmten Cloud-PC-Geräts fest, indem Sie die Cloud-PC-ID verwenden. |
| Überprüfungsstatus abrufen | cloudPcReviewStatus | Rufen Sie die status eines Cloud-PCs ab. |
| Liste für Benutzer | cloudPC-Sammlung | Listet die Cloud-PC-Geräte auf, die dem angemeldeten Benutzer zugeordnet sind. |
| Startinformationen abrufen | cloudPcLaunchInfo | Rufen Sie cloudPCLaunchInfo für einen bestimmten Cloud-PC ab. |
| Verbindungsverlauf abrufen | cloudPcConnectivityEvent-Sammlung | Rufen Sie den Cloud-PC-Konnektivitätsverlauf ab. |
| Unterstützte Remoteaktionen abrufen | 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. |
| Ergebnisse von Remoteaktionen abrufen | cloudPcRemoteActionResult-Sammlung | Rufen Sie Remoteaktionsergebnisse ab, und überprüfen Sie die status einer bestimmten Remoteaktion, die auf dem zugeordneten Cloud-PC-Gerät ausgeführt wird. |
| 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 überprüfen | 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. |
| Schnappschuss erstellen | Keine | Erstellen Sie eine Momentaufnahme für ein bestimmtes Cloud-PC-Gerät. |
| Abrufen von Momentaufnahmen | cloudPcSnapshot-Sammlung | Rufen Sie eine Liste der cloudPcSnapshot-Ressourcen für einen Cloud-PC ab. |
| Frontline-Zugriffsstatus abrufen | frontlineCloudPcAccessState | Rufen Sie den Zugriffsstatus des Cloud-PCs in Service und Produktion ab. Mögliche Werte sind: unassigned, noLicensesAvailable, activationFailed, active, activating, standbyMode, unknownFutureValue. Das noLicensesAvailable Mitglied ist veraltet und wird am 30. September 2024 nicht mehr zurückgegeben. |
| Remoteaktion für massenweise erneute Bereitstellung (veraltet) | Keine | Massenbasierte erneute Bereitstellung einer Gruppe von Cloud-PC-Geräten mit Intune verwalteten Geräte-IDs. Diese API ist veraltet und gibt am 28. Februar 2025 keine Daten mehr zurück. Verwenden Sie in Zukunft die CloudPcBulkReprovision-Ressource . |
| Massenänderung der Größe (veraltet) | 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 . Diese API ist veraltet und gibt am 28. Februar 2025 keine Daten mehr zurück. Verwenden Sie in Zukunft die CloudPcBulkResize-Ressource . |
| Remoteaktion für die massenweise Wiederherstellung (veraltet) | 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. Diese API ist veraltet und gibt am 28. Februar 2025 keine Daten mehr zurück. Verwenden Sie in Zukunft die CloudPcBulkRestore-Ressource . |
| Ergebnisse von Remoteaktionen abrufen (veraltet) | cloudPcRemoteActionResult | Überprüfen Sie die Vom Cloud-PC angegebenen Remoteaktionsergebnisse für ein Cloud-PC-Gerät. Diese API ist veraltet und gibt am 28. Februar 2025 keine Daten mehr zurück. Verwenden Sie in Zukunft die api retrieveCloudPcRemoteActionResults . |
| Überprüfungsstatus abrufen (veraltet) | cloudPcReviewStatus | Rufen Sie die überprüfung status eines bestimmten Cloud-PC-Geräts nach managedDeviceId ab. Diese API ist veraltet und gibt am 28. Februar 2025 keine Daten mehr zurück. Verwenden Sie in Zukunft die cloudPC: retrieveReviewStatus-API . |
| Überprüfungsstatus festlegen (veraltet) | Keine | Legen Sie die Überprüfung status eines bestimmten Cloud-PC-Geräts mithilfe der VERWALTETen Geräte-ID fest. Diese API ist veraltet und gibt am 28. Februar 2025 keine Daten mehr zurück. Verwenden Sie in Zukunft die cloudPC: setReviewStatus-API . |
| Überprüfungsstatus per Massenaktion festlegen (veraltet) | Keine | 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. Diese API ist veraltet und gibt am 28. Februar 2025 keine Daten mehr zurück. Verwenden Sie in Zukunft die Ressource cloudPcBulkSetReviewStatus . |
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 dedicatednullder 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. |
| deviceRegionName | String | Der Name der geografischen Region, in der der Cloud-PC derzeit bereitgestellt wird. Beispiel: westus3, eastus2und southeastasia. Schreibgeschützt. |
| disasterRecoveryCapability | cloudPcDisasterRecoveryCapability | Die Notfallwiederherstellung status des Cloud-PCs, einschließlich der primären Region, der sekundären Region und des Funktionstyps. Der Standardwert ist null , der angibt, dass die Einstellung für die Notfallwiederherstellung deaktiviert ist. Um eine Antwort mit der disasterRecoveryCapability-Eigenschaft$select und $filter dieser disasterRecoveryCapability/{subProperty} in der Anforderungs-URL zu erhalten. Weitere Informationen finden Sie unter Beispiel 4: Auflisten von Cloud-PCs gefiltert nach Dem Typ der Notfallwiederherstellung. Schreibgeschützt. |
| 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 istinGracePeriod. 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:00Zbeispielsweise . |
| 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 , sharedByEntraGroup. 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 sind: notProvisioned, provisioning, provisioned, inGracePeriod, deprovisioning, , failed, resizingprovisionedWithWarnings, restoring, pendingProvision, unknownFutureValue, movingRegionresizePendingLicense, , modifyingSingleSignOn, . preparing Sie müssen den Anforderungsheader Prefer: include-unknown-enum-members verwenden, um die folgenden Werte aus dieser verteilbaren Enumeration abzurufen: movingRegion, resizePendingLicense, modifyingSingleSignOn, preparing. |
| statusDetails (veraltet) | cloudPcStatusDetails | Die Details der Cloud-PC-status. Beispiel: { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null }. Diese Eigenschaft ist veraltet und wird ab dem 31. August 2024 nicht mehr unterstützt. Verwenden Sie stattdessen statusDetail. |
| statusDetail | cloudPcStatusDetail | Gibt die detaillierten status im Zusammenhang mit Cloud-PC an, einschließlich Fehler-/Warnungscode, Fehler-/Warnmeldung, zusätzlicheInformation. Beispiel: { "code": "internalServerError", "message": "There was an error during the Cloud PC upgrade. Please contact support.", "additionalInformation": null }. |
| connectionSetting | cloudPcConnectionSetting | Die Verbindungseinstellung des Cloud-PCs. Mögliche Werte: enableSingleSignOn. Schreibgeschützt. |
| 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, modifyingSingleSignOn, preparing.
| 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. |
| misslungen | 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. |
| umlagernd | 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. |
| modifyingSingleSignOn | Gibt an, dass der Cloud-PC die Einstellung für einmaliges Anmelden aktualisiert. |
| vorbereitend | Gibt an, dass der Cloud-PC mit einer vom IT-Administrator definierten Konfiguration (Anwendungen, Konfiguration und Sicherheit) vorbereitet wird, wird nach der Bereitstellung status angezeigt. Gilt nur für gemeinsam genutzte Frontline-Geräte. |
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 (veraltet) | Gibt an, dass alle Gemeinsam genutzten Lizenzen verwendet werden. Das noLicensesAvailable Mitglied ist veraltet und wird am 30. September 2024 nicht mehr zurückgegeben. |
| 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. |
| aktivierend | 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. |
Beziehungen
Keine.
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.cloudPC",
"aadDeviceId": "String",
"allotmentDisplayName": "String",
"connectivityResult": "String",
"deviceRegionName": "String",
"disasterRecoveryCapability": {"@odata.type": "microsoft.graph.cloudPcDisasterRecoveryCapability"},
"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"
}