Geräteressourcentyp

Namespace: microsoft.graph

Stellt ein Gerät dar, das in der Organisation registriert ist. Geräte werden mithilfe des Geräteregistrierungsdiensts oder von Intune in der Cloud erstellt. Sie werden von Richtlinien für bedingten Zugriff für mehrstufige Authentifizierung verwendet. Diese Geräte können Desktopcomputer, Laptops sowie Mobiltelefone und Tablets umfassen. Erbt von directoryObject.

Diese Ressource ist ein offener Typ, mit dem andere Eigenschaften übergeben werden können. Sie können auch eigene Daten als Erweiterungen zu benutzerdefinierten Eigenschaften hinzufügen.

Methoden

Methode Rückgabetyp Beschreibung
Get device Gerät Dient zum Lesen der Eigenschaften und der Beziehungen eines Geräteobjekts.
List devices Gerätesammlung Dient zum Abrufen einer Liste von Geräten, die in dem Verzeichnis registriert sind.
Update device Gerät Dient zum Aktualisieren der Eigenschaften eines Geräteobjekts.
Delete device Keine Dient zum Löschen eines Geräteobjekts.
delta Gerätesammlung Abrufen inkrementeller Änderungen für Geräte.
List memberOf directoryObject collection Listet die Gruppen und Verwaltungseinheiten auf, in denen das Gerät ein direktes Mitglied ist.
List transitive memberOf directoryObject-Sammlung Listet die Gruppen und Verwaltungseinheiten auf, in denen das Gerät Mitglied ist. Dieser Vorgang ist transitiv.
List registeredOwners directoryObject-Sammlung Dient zum Abrufen der Benutzer, die registrierte Besitzer des Geräts in der registeredOwners-Navigationseigenschaft sind.
List registeredUsers directoryObject-Sammlung Dient zum Abrufen registrierter Benutzer des Geräts aus der registeredUsers-Navigationseigenschaft.
checkMemberObjects String-Sammlung Überprüfen Sie die Mitgliedschaft in einer Liste von Gruppen, Verzeichnisrollen oder Verwaltungseinheitenobjekten.
getMemberObjects String collection Gibt alle Gruppen, Verwaltungseinheiten und Verzeichnisrollen zurück, denen das Gerät angehört. Die Überprüfung ist transitiv.
Offene Erweiterungen
Offene Erweiterung erstellen openTypeExtension Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften zu einer neuen oder vorhandenen Ressource hinzu.
Offene Erweiterung abrufen openTypeExtension-Sammlung Dient zum Abrufen einer offenen Erweiterung, die durch den Erweiterungsnamen identifiziert wird.
Schemaerweiterungen
Schemaerweiterungswerte hinzufügen Dient zum Erstellen einer Schemaerweiterungsdefinition und anschließenden Verwenden der Definition zum Hinzufügen benutzerdefinierter typisierter Daten zu einer Ressource.

Eigenschaften

Wichtig

Die spezifische Verwendung von $filter und des Abfrageparameters $search wird nur unterstützt, wenn Sie die Kopfzeile ConsistencyLevel verwenden, die auf eventual und $count festgelegt ist. Weitere Informationen finden Sie unter Erweiterte Abfragefunktionen für Verzeichnisobjekte.

Eigenschaft Typ Beschreibung
accountEnabled Boolesch true, wenn das Konto aktiviert ist; andernfalls false. Erforderlich. Der Standardwert ist true.

Unterstützt $filter (eq, ne, not, in). Nur Aufrufer mit den Rollen "Globaler Administrator" und "Cloudgeräteadministrator" können diese Eigenschaft festlegen.
alternativeSecurityIds alternativeSecurityId-Sammlung Ausschließlich für interne Zwecke. Lässt keine NULL-Werte zu. Unterstützt $filter (eq, not, ge, le).
approximateLastSignInDateTime DateTimeOffset Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Schreibgeschützt. Unterstützt $filter (eq, , notne, ge, leund eq für null -Werte) und $orderby.
complianceExpirationDateTime DateTimeOffset Der Zeitstempel, wenn das Gerät nicht mehr als konform eingestuft wird. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Schreibgeschützt.
deviceCategory Zeichenfolge Benutzerdefinierte Eigenschaften, die von Intune festgelegt werden, um Geräte automatisch zu Gruppen hinzuzufügen und die Verwaltung von Geräten zu vereinfachen.
deviceId Zeichenfolge Der eindeutige Bezeichner, der vom Azure-Geräteregistrierungsdienst bei der Registrierung festgelegt wird. Dies ist ein alternativer Schlüssel, der verwendet werden kann, um auf das Geräteobjekt zu verweisen. Unterstützt $filter (eq, ne, not, startsWith).
deviceMetadata String Ausschließlich für interne Zwecke. Auf null festlegen.
deviceOwnership Zeichenfolge Besitzer des Geräts. Diese Eigenschaft wird von Intune festgelegt. Mögliche Werte sind: unknown, company und personal.
deviceVersion Int32 Ausschließlich für interne Zwecke.
displayName String Der Anzeigename für das Gerät. Erforderlich. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte), $search und $orderby.
enrollmentProfileName Zeichenfolge Registrierungsprofil, das auf das Gerät angewendet wird. Beispiel: Apple Device Enrollment Profile, Device enrollment - Corporate device identifiers oder Windows Autopilot profile name. Diese Eigenschaft wird von Intune festgelegt.
enrollmentType Zeichenfolge Registrierungstyp des Geräts. Diese Eigenschaft wird von Intune festgelegt. Mögliche Werte: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement.
extensionAttributes onPremisesExtensionAttributes Enthält die Erweiterungsattribute 1 bis 15 für das Gerät. Die einzelnen Erweiterungsattribute können nicht ausgewählt werden. Diese Eigenschaften werden in der Cloud gemastert und können während der Erstellung oder Aktualisierung eines Geräteobjekts in Microsoft Entra ID festgelegt werden.

Unterstützt $filter (eq, not, startsWith und eq auf null Werten).
id String Die eindeutige ID für das Gerät. Geerbt von directoryObject. Schlüssel, lässt keine Nullwerte zu. Schreibgeschützt. Unterstützt $filter (eq, ne, not, in).
isCompliant Boolesch true, wenn das Gerät den Mdm-Richtlinien (Mobile Geräteverwaltung) entspricht, falseandernfalls . Schreibgeschützt. Dies kann nur durch Intune für jeden Gerätebetriebssystemtyp oder durch eine genehmigte MDM-App für Windows-Betriebssystemgeräte aktualisiert werden. Unterstützt $filter (eq, ne, not).
isManaged Boolesch true, wenn das Gerät von einer Mobile Geräteverwaltung-App (MDM) verwaltet wird, falseandernfalls . Dies kann nur durch Intune für jeden Gerätebetriebssystemtyp oder durch eine genehmigte MDM-App für Windows-Betriebssystemgeräte aktualisiert werden. Unterstützt $filter (eq, ne, not).
Hersteller Zeichenfolge Hersteller des Geräts. Schreibgeschützt.
isRooted Boolesch true , wenn das Gerät gerootet ist; false , wenn das Gerät per Jailbreak beschädigt ist. Diese Eigenschaft kann nur von Intune aktualisiert werden.
managementType Zeichenfolge Der Verwaltungskanal des Geräts. Diese Eigenschaft wird von Intune festgelegt. Mögliche Werte: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController.
mdmAppId Zeichenfolge Anwendungsbezeichner, der zum Registrieren des Geräts bei MDM verwendet wird. Schreibgeschützt. Unterstützt $filter (eq, ne, not, startsWith).
model Zeichenfolge Modell des Geräts. Schreibgeschützt.
onPremisesLastSyncDateTime DateTimeOffset Das letzte Mal, zu dem das Objekt mit dem lokalen Verzeichnis synchronisiert wurde. 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 schreibgeschützt. Unterstützt $filter (eq, ne, not, ge, le, in).
onPremisesSecurityIdentifier Zeichenfolge Die lokale Sicherheits-ID (SID) für den Benutzer, der von der lokalen Umgebung mit der Cloud synchronisiert wurde. Schreibgeschützt. Wird nur auf $select zurückgegeben. Unterstützt $filter (eq).
onPremisesSyncEnabled Boolesch true, wenn das Objekt aus einem lokalen Verzeichnis synchronisiert wird; false, wenn das Objekt ursprünglich aus einem lokalen Verzeichnis synchronisiert wurde, aber nicht mehr synchronisiert wird; null, wenn dieses Objekt nie aus einem lokalen Verzeichnis synchronisiert wurde (Standard). Schreibgeschützt. Unterstützt $filter (eq, ne, not, in und eq für null-Werte).
operatingSystem String Der Typ des Betriebssystems auf dem Gerät. Erforderlich. Unterstützt $filter (eq, , notne, ge, le, startsWithund eq für -nullWerte).
operatingSystemVersion String Die Version des Betriebssystems auf dem Gerät. Erforderlich. Unterstützt $filter (eq, , notne, ge, le, startsWithund eq für -nullWerte).
physicalIds String collection Ausschließlich für interne Zwecke. Lässt keine NULL-Werte zu. Unterstützt $filter (eq, not, ge, le, startsWith, ,/$count eq 0 , , /$count ne 0).
profileType deviceProfileType Der Profiltyp des Geräts. Mögliche Werte: RegisteredDevice (Standard), SecureVM, Printer, Shared, . IoT
registrationDateTime DateTimeOffset Datum und Uhrzeit der Registrierung des Geräts. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Schreibgeschützt.
systemLabels String collection Liste der Bezeichnungen, die vom System auf das Gerät angewendet werden. Unterstützt $filter (/$count eq 0, /$count ne 0).
trustType String Typ von Vertrauensstellung für das beigetretene Gerät. Schreibgeschützt. Mögliche Werte: Workplace (gibt Bring Your Own Private Devices an), AzureAd (Nur in die Cloud eingebundene Geräte), ServerAd (lokale, in die Domäne eingebundene Geräte, die mit Microsoft Entra ID verbunden sind). Weitere Informationen finden Sie unter Einführung in die Geräteverwaltung in Microsoft Entra ID.

Beziehungen

Beziehung Typ Beschreibung
Erweiterungen extension-Sammlung Die Sammlung von offenen Erweiterungen, die für das Gerät definiert sind. Schreibgeschützt. Lässt Nullwerte zu.
memberOf directoryObject collection Gruppen und Verwaltungseinheiten, in denen dieses Gerät Mitglied ist. Schreibgeschützt. Nullwerte zulassend. Unterstützt $expand.
registeredOwners directoryObject-Sammlung Der Benutzer, dessen Gerät mit der Cloud verknüpft ist oder der sein persönliches Gerät registriert hat. Der registrierte Besitzer wird zum Zeitpunkt der Registrierung festgelegt. Schreibgeschützt. Nullwerte zulassend. Unterstützt $expand.
registeredUsers directoryObject-Sammlung Auflistung von Benutzern, die registrierte Benutzer des Geräts sind. Für mit der Cloud verknüpfte Geräte und registrierte persönliche Geräte werden registrierte Benutzer bei der Registrierung auf den gleichen Wert wie registrierte Besitzer festgelegt. Schreibgeschützt. Nullwerte zulassend. Unterstützt $expand.
transitiveMemberOf directoryObject collection Gruppen und Verwaltungseinheiten, in denen das Gerät Mitglied ist. Dieser Vorgang ist transitiv. Unterstützt $expand.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "accountEnabled": "Boolean",
  "alternativeSecurityIds": [{"@odata.type": "microsoft.graph.alternativeSecurityId"}],
  "approximateLastSignInDateTime": "String (timestamp)",
  "complianceExpirationDateTime": "String (timestamp)",
  "deviceCategory": "String",
  "deviceId": "String",
  "deviceMetadata": "String",
  "deviceOwnership": "String",
  "deviceVersion": "Int32",
  "displayName": "String",
  "enrollmentProfileName": "String",
  "enrollmentType": "String",
  "extensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "id": "String (identifier)",
  "isCompliant": "Boolean",
  "isManaged": "Boolean",
  "isRooted": "Boolean",
  "managementType": "String",
  "manufacturer": "String",
  "mdmAppId": "String",
  "model": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSecurityIdentifier": "Boolean",
  "onPremisesSyncEnabled": "Boolean",
  "operatingSystem": "String",
  "operatingSystemVersion": "String",
  "physicalIds": ["String"],
  "profileType": "String",
  "registrationDateTime": "String (timestamp)",
  "systemLabels": ["String"],
  "trustType": "String"
}