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 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 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.
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.
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. Erforderlich. 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.
deviceId	String	Der eindeutige Bezeichner, der vom Azure-Geräteregistrierungsdienst bei der Registrierung festgelegt wird. Unterstützt $filter (eq, ne, not, startsWith).
deviceMetadata	String	Nur für internen Gebrauch. Auf null festlegen.
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.
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).
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	Die Version des Betriebssystems 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	deviceProfileType	Der Profiltyp des Geräts. Mögliche Werte: RegisteredDevice (Standard), SecureVM, Printer, Shared, IoT.
systemLabels	String-Sammlung	Liste der vom System auf das Gerät angewendeten Bezeichnungen. Unterstützt $filter (eq beim Zählen leerer Auflistungen).
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

Beziehungen

Beziehung	Typ	Beschreibung
Erweiterungen	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. Nullwerte zulassend. Unterstützt $expand.
transitiveMemberOf	directoryObject collection	Gruppen und administrative Einheiten, bei denen das Gerät Mitglied ist. Dieser Vorgang ist transitiv. 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.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "accountEnabled": true,
  "alternativeSecurityIds": [{"@odata.type": "microsoft.graph.alternativeSecurityId"}],
  "approximateLastSignInDateTime": "String (timestamp)",
  "complianceExpirationDateTime": "String (timestamp)",
  "deviceId": "string",
  "deviceMetadata": "string",
  "deviceVersion": 1024,
  "displayName": "string",
  "extensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "id": "string (identifier)",
  "isCompliant": true,
  "isManaged": true,
  "manufacturer": "string",
  "mdmAppId": "string",
  "model": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSyncEnabled": true,
  "operatingSystem": "string",
  "operatingSystemVersion": "string",
  "physicalIds": ["string"],
  "profileType": "string",
  "systemLabels": ["string"],
  "trustType": "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