deviceManagement abrufen
Namespace: microsoft.graph
Wichtig: APIs unter der /beta-Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Lesen von Eigenschaften und Beziehungen des deviceManagement-Objekts.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
Berechtigungstyp (nach Workflow) | Berechtigungen (von der Berechtigung mit den meisten Rechten zu der mit den wenigsten Rechten) |
---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | |
Android for Work | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All |
Überwachung | DeviceManagementApps.ReadWrite.All, DeviceManagementApps.Read.All |
Geschäftsbedingungen des Unternehmens | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Gerätekonfiguration | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All |
Geräteabsicht | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All |
Geräteverwaltung | DeviceManagementManagedDevices.ReadWrite.All, DeviceManagementManagedDevices.Read.All |
Elektronische SIM | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All |
Registrierung | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Fechten | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All |
Benachrichtigung | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Odj | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Onboarding | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Richtliniensatz | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
RBAC | DeviceManagementRBAC.ReadWrite.All, DeviceManagementRBAC.Read.All |
Remotezugriff | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All |
Remoteunterstützung | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Softwareupdate | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Telecom Expense Management | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Problembehandlung | DeviceManagementManagedDevices.ReadWrite.All, DeviceManagementManagedDevices.Read.All |
Windows Information Protection | DeviceManagementApps.ReadWrite.All, DeviceManagementApps.Read.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
Anwendung | |
Android for Work | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All |
Überwachung | DeviceManagementApps.ReadWrite.All, DeviceManagementApps.Read.All |
Geschäftsbedingungen des Unternehmens | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Gerätekonfiguration | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All |
Geräteabsicht | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All |
Geräteverwaltung | DeviceManagementManagedDevices.ReadWrite.All, DeviceManagementManagedDevices.Read.All |
Elektronische SIM | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All |
Registrierung | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Fechten | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All |
Benachrichtigung | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Odj | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Onboarding | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Richtliniensatz | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
RBAC | DeviceManagementRBAC.ReadWrite.All, DeviceManagementRBAC.Read.All |
Remotezugriff | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All |
Remoteunterstützung | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Softwareupdate | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Telecom Expense Management | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementServiceConfig.Read.All |
Problembehandlung | DeviceManagementManagedDevices.ReadWrite.All, DeviceManagementManagedDevices.Read.All |
Windows Information Protection | DeviceManagementApps.ReadWrite.All, DeviceManagementApps.Read.All |
HTTP-Anforderung
GET /deviceManagement
Optionale Abfrageparameter
Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Annehmen | application/json |
Anforderungstext
Geben Sie für diese Methode keinen Anforderungstext an.
Antwort
Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK
und ein deviceManagement-Objekt im Antworttext zurückgegeben.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
GET https://graph.microsoft.com/beta/deviceManagement
Antwort
Im Folgenden finden Sie ein Beispiel für die Antwort.
Hinweis: Die hier gezeigten Antwortobjekte können aus Gründen der Kürze abgeschnitten werden.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 130
{
"value": {
"@odata.type": "#microsoft.graph.deviceManagement",
"id": "0b283420-3420-0b28-2034-280b2034280b"
}
}
Für den Workflow geeignete Eigenschaften werden zurückgegeben.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 918
{
"value": {
"@odata.type": "#microsoft.graph.deviceManagement",
"id": "0b283420-3420-0b28-2034-280b2034280b",
"subscriptionState": "active",
"subscriptions": "intune",
"adminConsent": {
"@odata.type": "microsoft.graph.adminConsent",
"shareAPNSData": "granted"
},
"deviceProtectionOverview": {
"@odata.type": "microsoft.graph.deviceProtectionOverview",
"totalReportedDeviceCount": 8,
"inactiveThreatAgentDeviceCount": 14,
"unknownStateThreatAgentDeviceCount": 2,
"pendingSignatureUpdateDeviceCount": 1,
"cleanDeviceCount": 0,
"pendingFullScanDeviceCount": 10,
"pendingRestartDeviceCount": 9,
"pendingManualStepsDeviceCount": 13,
"pendingOfflineScanDeviceCount": 13,
"criticalFailuresDeviceCount": 11
},
"accountMoveCompletionDateTime": "2017-01-01T00:01:17.9006709-08:00"
}
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für