Geräteressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Stellt ein im Verzeichnis registriertes Gerät dar. 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 benutzerdefinierten Eigenschaften auch eigene Daten als Erweiterungen hinzufügen.

Methoden

Methode	Rückgabetyp	Beschreibung
Get device	Gerät	Dient zum Lesen der Eigenschaften und der Beziehungen des 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 des Geräteobjekts.
Delete device	Keine	Löschen Sie das Geräteobjekt.
List memberOf	directoryObject collection	Listet die Gruppen und administrativen Einheiten auf, bei denen das Gerät ein direktes Mitglied ist.
Transitive memberOf auflisten	directoryObject-Sammlung	Listet die Gruppen und administrativen Einheiten 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.
Liste usageRights	usageRight Sammlung	Rufen Sie eine Sammlung von Nutzungsrechten ab, die dem Gerät gewährt wurden.
checkMemberGroups	Zeichenfolgensammlung	Sucht nach einer Mitgliedschaft in einer Liste von Gruppen. Die Überprüfung ist transitiv.
getMemberGroups	String-Sammlung	Gibt alle Gruppen zurück, bei denen das Gerät Mitglied ist. Die Überprüfung ist transitiv.
checkMemberObjects	String-Sammlung	Überprüfen Sie die Mitgliedschaft in einer Liste von Gruppen, Verzeichnisrollen oder administrativen Einheitenobjekten.
getMemberObjects	String-Sammlung	Gibt alle Gruppen, administrativen Einheiten und Verzeichnisrollen zurück, bei denen das Gerät Mitglied ist. 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 Azure AD-Verzeichnisobjekte.

Eigenschaft	Typ	Beschreibung
accountEnabled	Boolesch	true, wenn das Konto aktiviert ist; andernfalls false. Der Standardwert ist true. Unterstützt $filter (eq, ne, not, in). Nur Aufrufer in den Rollen "Globaler Administrator" und "Cloudgeräteadministrator" können diese Eigenschaft festlegen.
alternativeSecurityIds	alternativeSecurityId-Sammlung	Nur für internen Gebrauch. 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 wird 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, ne, not, ge, leund eq auf null Werten) 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 wird 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 Automatisch Geräte zu Gruppen hinzuzufügen und die Verwaltung von Geräten zu vereinfachen.
deviceId	String	Bezeichner, der vom Azure-Geräteregistrierungsdienst zum Zeitpunkt der Registrierung festgelegt wurde. Unterstützt $filter (eq, ne, not, startsWith).
deviceMetadata	String	Nur für internen Gebrauch. Auf null festlegen.
deviceOwnership	Zeichenfolge	Besitz 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	Zeichenfolge	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.
Domänname	Zeichenfolge	Der lokale Domänenname von hybriden Azure AD-geräten. Diese Eigenschaft wird von Intune festgelegt.
enrollmentProfileName	Zeichenfolge	Auf das Gerät angewendetes Registrierungsprofil. Beispiel: Apple Device Enrollment Profile, Device enrollment - Corporate device identifiersoder 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 erweiterungsattribute 1-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 Azure AD festgelegt werden. Unterstützt $filter (eq, not, startsWith und eq auf null Werten).
id	Zeichenfolge	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	Boolean	truewenn das Gerät den Richtlinien von Mobile Geräteverwaltung (MDM) entspricht; falseandernfalls . Schreibgeschützt. Dies kann nur von Intune für jeden Gerätebetriebssystemtyp oder von einer genehmigten MDM-App für Windows-Betriebssystemgeräte aktualisiert werden. Unterstützt $filter (eq, ne, not).
isManaged	Boolean	truewenn das Gerät von einer Mobile Geräteverwaltung (MDM)-App verwaltet wird; falseandernfalls . Dies kann nur von Intune für jeden Gerätebetriebssystemtyp oder von einer genehmigten MDM-App für Windows-Betriebssystemgeräte aktualisiert werden. Unterstützt $filter (eq, ne, not).
isRooted	Boolesch	true wenn das Gerät gerootet ist; false wenn das Gerät im Gefängnis beschädigt ist. Dies kann nur von Intune aktualisiert werden.
managementType	String	Verwaltungskanal des Geräts. Diese Eigenschaft wird von Intune festgelegt. Mögliche Werte: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController.
Hersteller	String	Hersteller des Geräts. Schreibgeschützt.
mdmAppId	Zeichenfolge	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-Zeit am 1. Januar 2014 ist 2014-01-01T00:00:00Z beispielsweise schreibgeschützt. Unterstützt $filter (eq, ne, not, ge, le, in).
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, ne, not, ge, leund startsWith``eq auf null Werten).
operatingSystemVersion	String	Betriebssystemversion auf dem Gerät. Erforderlich. Unterstützt $filter (eq, ne, not, ge, leund startsWith``eq auf null Werten).
physicalIds	String collection	Nur für internen Gebrauch. Lässt keine Nullwerte zu. Unterstützt $filter (eq, not, ge, leund startsWithzählen leere Sammlungen).
profileType	Zeichenfolge	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 wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z. Schreibgeschützt.
systemLabels	String-Sammlung	Liste der vom System auf das Gerät angewendeten Bezeichnungen. Unterstützt $filter (eq beim Zählen leerer Auflistungen).
Hostnamen	String-Sammlung	Liste der hostNames für das Gerät.
trustType	String	Typ von Vertrauensstellung für das beigetretene Gerät. Schreibgeschützt. Mögliche Werte: Workplace (gibt an, dass Sie Ihre eigenen persönlichen Geräte mitbringen), AzureAd (nur in der Cloud eingebundene Geräte) ServerAd (lokale, in die Domäne eingebundene Geräte, die mit Azure AD verbunden sind). Weitere Informationen hierzu finden Sie unter Einführung in die Geräteverwaltung in Azure Active Directory
name	Zeichenfolge	Anzeigename eines Geräts. Wird nur zurückgegeben, wenn sich der Benutzer mit einem Microsoft-Konto als Teil von Project Rome anmeldet.
status	Zeichenfolge	Das Gerät ist online oder offline. Wird nur zurückgegeben, wenn sich der Benutzer mit einem Microsoft-Konto als Teil von Project Rome anmeldet.
Plattform	Zeichenfolge	Plattform des Geräts. Wird nur zurückgegeben, wenn sich der Benutzer mit einem Microsoft-Konto als Teil von Project Rome anmeldet. Wird nur zurückgegeben, wenn sich der Benutzer mit einem Microsoft-Konto als Teil von Project Rome anmeldet.
kind	Zeichenfolge	Formfaktor des Geräts. Wird nur zurückgegeben, wenn sich der Benutzer mit einem Microsoft-Konto als Teil von Project Rome anmeldet.
model	String	Modell des Geräts. Wird nur zurückgegeben, wenn sich der Benutzer mit einem Microsoft-Konto als Teil von Project Rome anmeldet.
Hersteller	String	Hersteller des Geräts. Wird nur zurückgegeben, wenn sich der Benutzer mit einem Microsoft-Konto als Teil von Project Rome anmeldet.

Beziehungen

Beziehung	Typ	Beschreibung
-Befehle	Befehlssammlung	Satz von Befehlen, die an dieses Gerät gesendet werden.
extensions	extension-Sammlung	Die Sammlung der für das Gerät definierten offenen Erweiterungen. Schreibgeschützt. Lässt Nullwerte zu.
memberOf	directoryObject collection	Gruppen und administrative Einheiten, bei denen dieses Gerät Mitglied ist. Schreibgeschützt. Lässt NULL-Werte zu. 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. Derzeit kann jeweils nur ein Besitzer vorhanden sein. Schreibgeschützt. Lässt NULL-Werte zu. 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. Lässt NULL-Werte zu. Unterstützt $expand.
transitiveMemberOf	directoryObject collection	Gruppen und administrative Einheiten, bei denen dieses Gerät Mitglied ist. Dieser Vorgang ist transitiv. Unterstützt $expand.
usageRights	usageRight Sammlung	Stellt die Nutzungsrechte dar, die einem Gerät gewährt wurden.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "accountEnabled": true,
  "approximateLastSignInDateTime": "String (timestamp)",
  "complianceExpirationDateTime": "String (timestamp)",
  "deviceCategory": "string",
  "deviceId": "string",
  "deviceMetadata": "string",
  "deviceOwnership": "string",
  "deviceVersion": 1024,
  "displayName": "string",
  "domainName": "string",
  "enrollmentProfileName": "string",
  "enrollmentType": "string",
  "extensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "id": "string (identifier)",
  "isCompliant": true,
  "isManaged": true,
  "isRooted": true,
  "mdmAppId": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSyncEnabled": true,
  "operatingSystem": "string",
  "operatingSystemVersion": "string",
  "physicalIds": ["string"],
  "profileType": "string",
  "registrationDateTime": "String (timestamp)",
  "systemLabels": ["string"],
  "hostNames" : ["string"],
  "trustType": "string",
  "Name": "string",
  "Status": "string",
  "Platform": "string",
  "Kind": "string",
  "Model": "string",
  "managementType": "string",
  "Manufacturer": "string"
}

Siehe auch

• Hinzufügen von benutzerdefinierten Daten zu Ressourcen mithilfe von Erweiterungen
• Hinzufügen von benutzerdefinierten Daten zu Benutzern mithilfe offener Erweiterungen
• Hinzufügen von benutzerdefinierten Daten zu Gruppen mithilfe von Schemaerweiterungen