Freigeben über

Geräte auflisten

  • Artikel

API-Beschreibung

Ruft eine Liste von Geräten ab, die von Microsoft Managed Desktop verwaltet werden.

Unterstützte OData V4-Abfrageoperatoren :

searchText on name, serialNumber, globalDeviceId, userUpn, userEmail

$skip

$top

Voraussetzungen

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 Berechtigungen
Delegiert MWaaSDevice.Read
App MmdSupport.ReadWrite

HTTP-Anforderung

Es folgt ein Beispiel für eine HTTP-Anforderung.

GET https://mmdls.microsoft.com/support/odata/v1/tenants/{tenantId}/devices

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token} (erforderlich)
Annehmen application/json

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 200 OK und eine Liste der Geräte im Antworttext zurück.

Beispiel 1: Auflisten aller Geräte

Auflisten aller Geräteanforderung

Es folgt ein Beispiel für die HTTP-Anforderung.

GET https://mmdls.microsoft.com/support/odata/v1/tenants/{tenantId}/devices

Auflisten aller Geräteantwort

Es folgt ein Beispiel für die JSON-Antwort.

Hinweis

Die angezeigte Antwortliste kann aus Gründen der Kürze abgeschnitten werden. Alle Geräte werden von einem tatsächlichen Anruf zurückgegeben.

{ 
    "@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Devices", 
    "value": [ 
        { 
            "name": "Device name value", 
            "intuneId": "Intune Id Value", 
            "manufacturer": "Microsoft Corporation", 
            "model": "Surface Laptop", 
            "serialNumber": "Serial number value", 
            "globalDeviceId": "g:value", 
            "enrolledIntoIntuneDateTimeUtc": "2021-11-11T15:01:07.5381567Z", 
            "tenantId": "Tenant Id value", 
            "tenantName": null, 
            "assignedUser": "firstName lastName", 
            "userUpn": "username@contoso.onmicrosoft.com", 
            "userEmail": "username@contoso.onmicrosoft.com", 
            "complianceState": "Compliant", 
            "osVersion": "10.0.19043.1586", 
            "primaryUpdateRing": "Broad", 
            "lastIntuneSyncDateTimeUtc": "2021-04-13T09:19:06.6991927Z", 
            "ageInMonths": 13.978561, 
            "planType": "Premium", 
            "persona": "Standard", 
            "aadDeviceId": "aadDevice Id value", 
            "managementAgent": "Intune", 
            "operatingSystemEdition": "Enterprise", 
            "profileAssignmentStatus": "Successful", 
            "groups": [], 
            "configurations": [] 
        }, 
        { 
            "name": "Device name value", 
            "intuneId": "Intune Id Value", 
            "manufacturer": "Microsoft Corporation", 
            "model": "Virtual Machine", 
            "serialNumber": "Serial number value", 
            "globalDeviceId": "g:value", 
            "enrolledIntoIntuneDateTimeUtc": "2021-02-25T07:42:07Z", 
            "tenantId": "Tenant Id value", 
            "tenantName": null, 
            "assignedUser": "firstName lastName", 
            "userUpn": "username@contoso.onmicrosoft.com", 
            "userEmail": "username@contoso.onmicrosoft.com", 
            "complianceState": "Compliant", 
            "osVersion": "10.0.19043.1586", 
            "primaryUpdateRing": "First", 
            "lastIntuneSyncDateTimeUtc": "2021-03-16T11:10:04Z", 
            "ageInMonths": 1.5491623, 
            "planType": "Premium", 
            "persona": "Standard", 
            "aadDeviceId": "aadDevice Id value", 
            "managementAgent": "Intune", 
            "operatingSystemEdition": "Enterprise", 
            "profileAssignmentStatus": "Successful", 
            "groups": [], 
            "configurations": [] 
        }, 
        { 
            "name": "", 
            "intuneId": null, 
            "manufacturer": "Microsoft Corporation", 
            "model": "Surface Pro 4", 
            "serialNumber": "Serial number value", 
            "globalDeviceId": null, 
            "enrolledIntoIntuneDateTimeUtc": null, 
            "tenantId": "Tenant Id value", 
            "tenantName": null, 
            "assignedUser": null, 
            "userUpn": null, 
            "userEmail": null, 
            "complianceState": "Unknown", 
            "osVersion": null, 
            "primaryUpdateRing": "Test", 
            "lastIntuneSyncDateTimeUtc": null, 
            "ageInMonths": 11.417163, 
            "planType": "Premium", 
            "persona": "Standard", 
            "aadDeviceId": "aadDevice Id value", 
            "managementAgent": null, 
            "operatingSystemEdition": null, 
            "profileAssignmentStatus": "Successful", 
            "groups": [], 
            "configurations": [] 
        } 
    ] 
}

Beispiel 2: Auflisten von Geräten mit Filtern

Auflisten von Geräten mit Filteranforderung

Im Folgenden sehen Sie ein HTTP-Beispiel, um den ersten Datensatz zu überspringen und die nächsten beiden ersten Datensätze aufzulisten.

GET https://mmdls.microsoft.com/support/odata/v1/tenants/{tenantId}/devices?$skip=1&$top=2

Auflisten von Geräten mit Filterantwort

Es folgt ein Beispiel für die JSON-Antwort.

Hinweis

Die hier gezeigte Antwortliste kann aus Gründen der Kürze abgeschnitten werden. Alle Geräte werden von einem tatsächlichen Anruf zurückgegeben.

{ 
    "@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Devices", 
    "value": [ 
        { 
            "name": "Device name value", 
            "intuneId": "Intune Id Value", 
            "manufacturer": "Microsoft Corporation", 
            "model": "Virtual Machine", 
            "serialNumber": "Serial number value", 
            "globalDeviceId": "g:value", 
            "enrolledIntoIntuneDateTimeUtc": "2021-02-25T07:42:07Z", 
            "tenantId": "Tenant Id value", 
            "tenantName": null, 
            "assignedUser": "firstName lastName", 
            "userUpn": "username@contoso.onmicrosoft.com", 
            "userEmail": "username@contoso.onmicrosoft.com", 
            "complianceState": "Compliant", 
            "osVersion": "10.0.19043.1586", 
            "primaryUpdateRing": "First", 
            "lastIntuneSyncDateTimeUtc": "2021-03-16T11:10:04Z", 
            "ageInMonths": 1.5491623, 
            "planType": "Premium", 
            "persona": "Standard", 
            "aadDeviceId": "aadDevice Id value", 
            "managementAgent": "Intune", 
            "operatingSystemEdition": "Enterprise", 
            "profileAssignmentStatus": "Successful", 
            "groups": [], 
            "configurations": [] 
        }, 
        { 
            "name": "", 
            "intuneId": null, 
            "manufacturer": "Microsoft Corporation", 
            "model": "Surface Pro 4", 
            "serialNumber": "Serial number value", 
            "globalDeviceId": null, 
            "enrolledIntoIntuneDateTimeUtc": null, 
            "tenantId": "Tenant Id value", 
            "tenantName": null, 
            "assignedUser": null, 
            "userUpn": null, 
            "userEmail": null, 
            "complianceState": "Unknown", 
            "osVersion": null, 
            "primaryUpdateRing": "Test", 
            "lastIntuneSyncDateTimeUtc": null, 
            "ageInMonths": 11.417163, 
            "planType": "Premium", 
            "persona": "Standard", 
            "aadDeviceId": "aadDevice Id value", 
            "managementAgent": null, 
            "operatingSystemEdition": null, 
            "profileAssignmentStatus": "Successful", 
            "groups": [], 
            "configurations": [] 
        } 
    ] 
}

Beispiel 3: Auflisten von Geräten mit userUpn

Auflisten von Geräten mit userUpn-Anforderung

Im Folgenden finden Sie ein HTTP-Beispiel, das eine Liste von Geräten basierend auf der Suche nach dem UPN des Benutzers zurückgibt.

GET https://mmdls.microsoft.com/support/odata/v1/tenants/{tenantId}/devices?$searchText=jdoe@contoso.onmicrosoft.com

Auflisten von Geräten mit userUpn-Antwort

Es folgt ein Beispiel für die JSON-Antwort.

Hinweis

Die hier gezeigte Antwortliste kann aus Gründen der Kürze abgeschnitten werden. Alle Geräte werden von einem tatsächlichen Anruf zurückgegeben.

{ 
    "@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Devices", 
    "value": [ 
        { 
            "name": "Device name value", 
            "intuneId": "Intune Id Value", 
            "manufacturer": "Microsoft Corporation", 
            "model": "Virtual Machine", 
            "serialNumber": "Serial number value", 
            "globalDeviceId": "g:value", 
            "enrolledIntoIntuneDateTimeUtc": "2021-02-25T07:42:07Z", 
            "tenantId": "Tenant Id value", 
            "tenantName": null, 
            "assignedUser": "John Doe", 
            "userUpn": "jdoe@contoso.onmicrosoft.com", 
            "userEmail": "jdoe@contoso.onmicrosoft.com", 
            "complianceState": "Compliant", 
            "osVersion": "10.0.19043.1586", 
            "primaryUpdateRing": "First", 
            "lastIntuneSyncDateTimeUtc": "2021-03-16T11:10:04Z", 
            "ageInMonths": 1.5491623, 
            "planType": "Premium", 
            "persona": "Standard", 
            "aadDeviceId": "aadDevice Id value", 
            "managementAgent": "Intune", 
            "operatingSystemEdition": "Enterprise", 
            "profileAssignmentStatus": "Successful", 
            "groups": [], 
            "configurations": [] 
        } 
    ] 
}