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, der über die hier dokumentierten hinaus zusätzliche Eigenschaften zulässt.

Diese Ressource unterstützt Folgendes:

Methoden

Methode Rückgabetyp Beschreibung
List Gerätesammlung Dient zum Abrufen einer Liste von Geräten, die in dem Verzeichnis registriert sind.
Create device Registrieren Sie ein neues Gerät im Verzeichnis.
Get device Dient zum Lesen der Eigenschaften und der Beziehungen eines Geräteobjekts.
Update device Dient zum Aktualisieren der Eigenschaften eines Geräteobjekts.
Löschen Keine Dient zum Löschen eines Geräteobjekts.
Gerät: Bereitstellen provisionResponse Bereitstellen eines Geräts im Auftrag eines genehmigten Virtual Desktop Infrastructure (VDI)-Anbieters.
Delta abrufen Gerätesammlung Abrufen inkrementeller Änderungen für Geräte.
memberOf auflisten directoryObject collection Listen Sie die Gruppen und Verwaltungseinheiten auf, in denen das Gerät ein direktes Mitglied ist.
Auflisten transitiver Mitglieder von directoryObject collection Listen Sie die Gruppen und Verwaltungseinheiten auf, denen das Gerät angehört. Dieser Vorgang ist transitiv.
Registrierte Besitzer auflisten directoryObject collection Dient zum Abrufen der Benutzer, die registrierte Besitzer des Geräts in der registeredOwners-Navigationseigenschaft sind.
Registrierte Besitzende hinzufügen directoryObject collection Fügen Sie registrierte Besitzer des Geräts hinzu.
Registrierte Besitzende entfernen directoryObject collection Löschen Sie registrierte Besitzer von dem Gerät.
Registrierte Benutzer auflisten directoryObject collection Dient zum Abrufen registrierter Benutzer des Geräts aus der registeredUsers-Navigationseigenschaft.
Registrierte Benutzende hinzufügen directoryObject collection Registrierte Benutzer des Geräts hinzufügen .
Registrierte Benutzende entfernen directoryObject collection Entfernen Sie registrierte Benutzer vom Gerät.
Überprüfen von Mitgliederobjekten String collection Überprüfen Sie die Mitgliedschaft in einer Liste von Gruppen, Verzeichnisrollen- oder Verwaltungseinheitsobjekten.
Mitgliedsobjekte abrufen String collection Gibt alle Gruppen, Verwaltungseinheiten und Verzeichnisrollen zurück, in denen das Gerät Mitglied ist. Die Überprüfung ist transitiv.

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, die mindestens über die Rolle "Cloudgeräteadministrator" verfügen, 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 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, gele, und eq on-Wertenull) und $orderby.
complianceExpirationDateTime DateTimeOffset Der Zeitstempel, zu dem das Gerät nicht mehr kompatibel ist. 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 Eigenschaft, die von Intune festgelegt wird, 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. Dieser Alternativschlüssel kann verwendet werden, 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 Besitz des Geräts. Intune legt diese Eigenschaft fest. Die möglichen Werte sind: unknown, company, personal.
deviceVersion Int32 Ausschließlich für interne Zwecke.
displayName String Der Anzeigename für das Gerät. Die maximale Länge beträgt 256 Zeichen. Erforderlich. Unterstützt $filter (eq, ne, not, ge, le, in, startsWith und eq für null-Werte), $search und $orderby.
enrollmentProfileName Zeichenfolge Auf das Gerät angewendetes Registrierungsprofil. 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. Intune legt diese Eigenschaft fest. Die möglichen Werte sind: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUserwindowsAzureADJoinUsingDeviceAuth.appleUserEnrollmentappleUserEnrollmentWithServiceAccountwindowsAzureADJoinwindowsBulkUserlesswindowsAutoEnrollmentwindowsBulkAzureDomainJoinwindowsCoManagement

HINWEIS: Diese Eigenschaft kann andere als die aufgelisteten Werte zurückgeben.
extensionAttributes onPremisesExtensionAttributes Enthält die Erweiterungsattribute 1-15 für das Gerät. Die einzelnen Erweiterungsattribute können nicht ausgewählt werden. Diese Eigenschaften werden in der Cloud verwaltet 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 Boolean truewenn das Gerät den Richtlinien für Mobile Geräteverwaltung (MDM) entspricht; andernfalls. false Schreibgeschützt. Dies kann nur über 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 Boolean truewenn das Gerät von einer Mobile Geräteverwaltung (MDM)-App verwaltet wird, falseandernfalls . Dies kann nur über 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).
isManagementRestricted Boolean Gibt an, ob das Gerät Mitglied einer Verwaltungseinheit mit eingeschränkter Verwaltung ist. Wenn nicht festgelegt, ist null der Standardwert und das Standardverhalten falsch. Schreibgeschützt.

Um ein Gerät zu verwalten, das Mitglied einer Verwaltungseinheit mit eingeschränkter Verwaltung ist, muss dem Administrator oder der aufrufenden App eine Microsoft Entra Rolle im Bereich der Verwaltungseinheit für eingeschränkte Verwaltung zugewiesen werden.

Erfordert $select zum Abrufen.
isRooted Boolean true Wenn das Gerät gerootet ist oder einen Jail-Break hat. Diese Eigenschaft kann nur über Intune aktualisiert werden.
managementType Zeichenfolge Der Verwaltungskanal des Geräts. Diese Eigenschaft wird von Intune festgelegt. Die möglichen Werte sind: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClientjamfconfigurationManagerClientMdmunknownconfigurationManagerClientMdmEasgoogleCloudDevicePolicyController.
Hersteller Zeichenfolge Hersteller des Geräts. Schreibgeschützt.
mdmAppId Zeichenfolge Anwendungs-ID, die 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 Der Zeitpunkt, zu dem das Objekt das letzte Mal 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. Beispielsweise ist 2014-01-01T00:00:00Z Mitternacht UTC am 1. Januar 2014 schreibgeschützt. Unterstützt $filter (eq, ne, not, ge, le, in).
onPremisesSecurityIdentifier Zeichenfolge Die lokale Sicherheits-ID (SID) für den Benutzer, der aus der lokalen Umgebung mit der Cloud synchronisiert wurde. Schreibgeschützt. Erfordert $select zum Abrufen. 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, ne, not, ge, lestartsWith, , und eq on-Wertenull).
operatingSystemVersion String Die Version des Betriebssystems auf dem Gerät. Erforderlich. Unterstützt $filter (eq, ne, not, ge, lestartsWith, , und eq on-Wertenull).
physicalIds String collection Ausschließlich für interne Zwecke. Lässt keine NULL-Werte zu. Unterstützt $filter (eq, not, ge, lestartsWith,, /$count ne 0)./$count eq 0
profileType deviceProfileType Der Profiltyp des Geräts. Mögliche Werte: RegisteredDevice (Standard), SecureVM, Printer, Shared, IoT.
registrationDateTime DateTimeOffset Datum und Uhrzeit, zu dem das Gerät registriert wurde. 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 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 an, dass Sie Ihre eigenen persönlichen Geräte mitbringen), AzureAd (Nur in die Cloud eingebundene Geräte), (in die lokale Domäne eingebundene Geräte, ServerAd die in Microsoft Entra ID eingebunden sind). Weitere Informationen finden Sie unter Einführung in die Geräteverwaltung in Microsoft Entra ID. Unterstützt $filter (eq, ne, not, in).

Beziehungen

Beziehung Typ Beschreibung
Erweiterungen extension-Sammlung Die Auflistung der für das Gerät definierten offenen Erweiterungen. Schreibgeschützt. Lässt Nullwerte zu.
memberOf directoryObject collection Gruppen und Verwaltungseinheiten, in 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. 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 Verwaltungseinheiten, denen das Gerät angehört. Dieser Vorgang ist transitiv. Unterstützt $expand.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "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",
  "isManagementRestricted": "Boolean",
  "isRooted": "Boolean",
  "managementType": "String",
  "manufacturer": "String",
  "mdmAppId": "String",
  "model": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": "Boolean",
  "operatingSystem": "String",
  "operatingSystemVersion": "String",
  "physicalIds": ["String"],
  "profileType": "String",
  "registrationDateTime": "String (timestamp)",
  "systemLabels": ["String"],
  "trustType": "String"
}

Verwandte Inhalte

  • Last updated on