Geräteressourcentypdevice resource type

Stellt ein Gerät dar, das in der Organisation registriert ist.Represents a device registered in the organization. Geräte werden mithilfe des Geräteregistrierungsdiensts oder von Intune in der Cloud erstellt.Devices are created in the cloud using the Device Registration Service or by Intune. Sie werden von Richtlinien für bedingten Zugriff für mehrstufige Authentifizierung verwendet.They're used by conditional access policies for multi-factor authentication. Diese Geräte können Desktopcomputer, Laptops sowie Mobiltelefone und Tablets umfassen.These devices can range from desktop and laptop machines to phones and tablets. Erbt von directoryObject.Inherits from directoryObject.

Diese Ressource ermöglicht es Ihnen, benutzerdefinierten Eigenschaften mithilfe von Erweiterungen eigene Daten hinzuzufügen.This resource lets you add your own data to custom properties using extensions.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Get deviceGet device devicedevice Dient zum Lesen der Eigenschaften und der Beziehungen eines Geräteobjekts.Read properties and relationships of a device object.
List devicesList devices Gerätesammlungdevice collection Dient zum Abrufen einer Liste von Geräten, die in dem Verzeichnis registriert sind.Retrieve a list of devices registered in the directory.
Update deviceUpdate device Gerätdevice Dient zum Aktualisieren der Eigenschaften eines Geräteobjekts.Update the properties of a device object.
Delete deviceDelete device KeineNone Dient zum Löschen eines Geräteobjekts.Delete a device object.
memberOf auflistenList memberOf directoryObject-SammlungdirectoryObject collection Auflisten der Gruppen, in denen das Gerät ein direktes Mitglied ist.List the groups that the device is a direct member of.
List registeredOwnersList registeredOwners directoryObject-SammlungdirectoryObject collection Dient zum Abrufen der Benutzer, die registrierte Besitzer des Geräts in der registeredOwners-Navigationseigenschaft sind.Get the users that are registered owners of the device from the registeredOwners navigation property.
List registeredUsersList registeredUsers directoryObject-SammlungdirectoryObject collection Dient zum Abrufen registrierter Benutzer des Geräts aus der registeredUsers-Navigationseigenschaft.Get the registered users of the device from the registeredUsers navigation property.
Offene ErweiterungenOpen extensions
Offene Erweiterung erstellenCreate open extension openTypeExtensionopenTypeExtension Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften zu einer neuen oder vorhandenen Ressource hinzu.Create an open extension and add custom properties to a new or existing resource.
Offene Erweiterung abrufenGet open extension openTypeExtension-SammlungopenTypeExtension collection Dient zum Abrufen einer offenen Erweiterung, die durch den Erweiterungsnamen identifiziert wird.Get an open extension identified by the extension name.
SchemaerweiterungenSchema extensions
Schemaerweiterungswerte hinzufügenAdd schema extension values Dient zum Erstellen einer Schemaerweiterungsdefinition und anschließenden Verwenden der Definition zum Hinzufügen benutzerdefinierter typisierter Daten zu einer Ressource.Create a schema extension definition and then use it to add custom typed data to a resource.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
accountEnabledaccountEnabled Boolescher WertBoolean true, wenn das Konto aktiviert ist; andernfalls false. Erforderlich.true if the account is enabled; otherwise, false. Required.
alternativeSecurityIdsalternativeSecurityIds alternativeSecurityId-SammlungalternativeSecurityId collection Nur für internen Gebrauch.For internal use only. Lässt keine Nullwerte zu.Not nullable.
approximateLastSignInDateTimeapproximateLastSignInDateTime DateTimeOffsetDateTimeOffset Der timestamp-Typ stellt Datums-und Uhrzeitinformationen im Format ISO 8601 dar und ist immer in UTC-Zeit.The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Schreibgeschützt.Read-only.
complianceExpirationDateTimecomplianceExpirationDateTime DateTimeOffsetDateTimeOffset Der Zeitstempel, wenn das Gerät nicht mehr als konform gilt.The timestamp when the device is no longer deemed compliant. Der timestamp-Typ stellt Datums-und Uhrzeitinformationen im Format ISO 8601 dar und ist immer in UTC-Zeit.The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Schreibgeschützt.Read-only.
deviceIddeviceId stringstring Der eindeutige Bezeichner, der vom Azure-Geräteregistrierungsdienst bei der Registrierung festgelegt wird.Unique identifier set by Azure Device Registration Service at the time of registration.
deviceMetadatadeviceMetadata StringString Nur für internen Gebrauch.For interal use only. Auf Null festgelegt.Set to null.
deviceVersiondeviceVersion Int32Int32 Nur für internen Gebrauch.For interal use only.
displayNamedisplayName ZeichenfolgeString Der Anzeigename für das Gerät. Erforderlich.The display name for the device. Required.
idid StringString Die eindeutige ID für das Gerät. Geerbt von directoryObject. Schlüssel, lässt keine Nullwerte zu. Schreibgeschützt.The unique identifier for the device. Inherited from directoryObject. Key, Not nullable. Read-only.
isCompliantisCompliant BooleschBoolean true, wenn das Gerät den Richtlinien für mobile Geräteverwaltung ( Mobile Device Management, MDM) entspricht; andernfalls false.true if the device complies with Mobile Device Management (MDM) policies; otherwise, false. Schreibgeschützt.Read-only. Dies kann nur von InTune für alle Gerätebetriebssystem-Typen oder durch eine genehmigte MDM-App für Windows OS-Geräte aktualisiert werden.This can only be updated by Intune for any device OS type or by an approved MDM app for Windows OS devices.
isManagedisManaged BooleanBoolean true, wenn das Gerät durch die mobile Geräteverwaltungs-App verwaltet wird; andernfalls false.true if the device is managed by a Mobile Device Management (MDM) app; otherwise, false. Dies kann nur von InTune für alle Gerätebetriebssystem-Typen oder durch eine genehmigte MDM-App für Windows OS-Geräte aktualisiert werden.This can only be updated by Intune for any device OS type or by an approved MDM app for Windows OS devices.
onPremisesLastSyncDateTimeonPremisesLastSyncDateTime DateTimeOffsetDateTimeOffset Der Zeitpunkt der letzten Synchronisierung des Objekts mit dem lokalen Verzeichnis. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben.The last time at which the object was synced with the on-premises directory.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z' Schreibgeschützt.For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z' Read-only.
onPremisesSyncEnabledonPremisesSyncEnabled BooleanBoolean 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).true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default). Schreibgeschützt.Read-only.
operatingSystemoperatingSystem StringString Der Typ des Betriebssystems auf dem Gerät. Erforderlich.The type of operating system on the device. Required.
operatingSystemVersionoperatingSystemVersion ZeichenfolgeString Die Version des Betriebssystems auf dem Gerät. Erforderlich.The version of the operating system on the device. Required.
physicalIdsphysicalIds ZeichenfolgenauflistungString collection Nur für internen Gebrauch.For interal use only. Lässt keine Nullwerte zu.Not nullable.
Profile TypeprofileType StringString Der Profiltyp des Geräts.The profile type of the device. Mögliche Werte:Possible values:
RegisteredDevice StandardRegisteredDevice (default)
SecureVMSecureVM
PrinterPrinter
SharedShared
IOTIoT
systemLabelssystemLabels String collectionString collection Liste der Bezeichnungen, die vom System auf das Gerät angewendet wurden.List of labels applied to the device by the system.
trustTypetrustType StringString Typ von Vertrauensstellung für das beigetretene Gerät.Type of trust for the joined device. Schreibgeschützt.Read-only. Mögliche Werte:Possible values:
Arbeitsplatz - Gibt an , dass eigene persönliche Geräte mitgebracht werden sollenWorkplace - indicates bring your own personal devices
AzureAd - Nur Geräte, die mit der Cloud verknüpft sindAzureAd - Cloud only joined devices
ServerAd - Lokale Geräte, die der Domäne beigetreten sind, die mit Azure AD verknüpft sind.ServerAd - on-premises domain joined devices joined to Azure AD. Weitere Informationen hierzu finden Sie unter Einführung in die Geräteverwaltung in Azure Active DirectoryFor more details, see Introduction to device management in Azure Active Directory

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
Erweiterungenextensions extension-Sammlungextension collection Die Sammlung der für das Gerät definierten offenen Erweiterungen. Schreibgeschützt. Lässt Nullwerte zu.The collection of open extensions defined for the device. Read-only. Nullable.
memberOfmemberOf directoryObject-SammlungdirectoryObject collection Gruppen, bei denen diese Gruppe Mitglied ist. HTTP-Methoden: GET (unterstützt für alle Gruppen). Schreibgeschützt. Lässt NULL-Werte zu.Groups that this group is a member of. HTTP Methods: GET (supported for all groups). Read-only. Nullable.
Transitive memberOf auflistenList transitive memberOf directoryObject-SammlungdirectoryObject collection Listet die Gruppen auf, bei denen das Gerät Mitglied ist.List the groups that the device is a member of. Dieser Vorgang ist transitiv.This operation is transitive.
registeredOwnersregisteredOwners directoryObject-SammlungdirectoryObject collection Der Benutzer, dessen Gerät mit der Cloud verknüpft ist oder der sein persönliches Gerät registriert hat.The user that cloud joined the device or registered their personal device. Der registrierte Besitzer wird zum Zeitpunkt der Registrierung festgelegt.The registered owner is set at the time of registration. Derzeit kann jeweils nur ein Besitzer vorhanden sein.Currently, there can be only one owner. Schreibgeschützt.Read-only. Nullwerte zulassend.Nullable.
registeredUsersregisteredUsers directoryObject-SammlungdirectoryObject collection Auflistung von Benutzern, die registrierte Benutzer des Geräts sind.Collection of registered users of the device. 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.For cloud joined devices and registered personal devices, registered users are set to the same value as registered owners at the time of registration. Schreibgeschützt.Read-only. Nullwerte zulassend.Nullable.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource

{
  "accountEnabled": true,
  "alternativeSecurityIds": [{"@odata.type": "microsoft.graph.alternativeSecurityId"}],
  "approximateLastSignInDateTime": "String (timestamp)",
  "complianceExpirationDateTime": "String (timestamp)",
  "deviceId": "string",
  "deviceMetadata": "string",
  "deviceVersion": 1024,
  "displayName": "string",
  "id": "string (identifier)",
  "isCompliant": true,
  "isManaged": true,
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSyncEnabled": true,
  "operatingSystem": "string",
  "operatingSystemVersion": "string",
  "physicalIds": ["string"],
  "profileType": "string",
  "systemLabels": ["string"],
  "trustType": "string"
}

Siehe auchSee also