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 , , not ne , ge , le und 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 | String | Benutzerdefinierte Eigenschaften, die von Intune festgelegt werden, um Geräte automatisch zu Gruppen hinzuzufügen und die Verwaltung von Geräten zu vereinfachen. |
deviceId | String | 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 | String | 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 | String | 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, false andernfalls . 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, false andernfalls . 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 | String | 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 | String | 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 | String | Anwendungsbezeichner, der zum Registrieren des Geräts bei MDM verwendet wird. Schreibgeschützt. Unterstützt $filter (eq , ne , not , startsWith ). |
model | String | 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 | String | 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 , , not ne , ge , le , startsWith und eq für -null Werte). |
operatingSystemVersion | String | Die Version des Betriebssystems auf dem Gerät. Erforderlich. Unterstützt $filter (eq , , not ne , ge , le , startsWith und eq für -null Werte). |
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"
}
Verwandte Inhalte
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