managedDevice-Ressourcentyp

Namespace: microsoft.graph

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Über Intune verwaltete oder vorab registrierte Geräte

Methoden

Methode	Rückgabetyp	Beschreibung
managedDevices auflisten	managedDevice-Sammlung	Auflisten von Eigenschaften und Beziehungen der managedDevice-Objekte.
managedDevice abrufen	managedDevice	Lesen von Eigenschaften und Beziehungen des managedDevice-Objekts.
managedDevice erstellen	managedDevice	Erstellen eines neuen managedDevice-Objekts.
managedDevice löschen	Keine	Löscht ein managedDevice löschen.
managedDevice aktualisieren	managedDevice	Aktualisieren der Eigenschaften eines managedDeviceOverview-Objekts.

|Aktion außer Kraft setzen|Keine|Gerät außer Betrieb setzen | |Aktion zurücksetzen|Keine|Zurücksetzen eines Geräts | |resetPasscode-Aktion|Keine|Kennung zurücksetzen | |remoteLock-Aktion|Keine|Remotesperre| |requestRemoteAssistance-Aktion |Keine|Anfordern von Remoteunterstützung | |disableLostMode-Aktion|Keine|Modus für verlorene Geräte deaktivieren | |locateDevice-Aktion|Keine|Suchen eines Geräts | |bypassActivationLock-Aktion|Keine|Umgehung der Aktivierungssperre | |rebootNow-Aktion|Keine|Gerät neu starten | |shutDown-Aktion|Keine|Gerät herunterfahren | |recoverPasscode-Aktion |Keine|Kennung wiederherstellen | |CleanWindowsDevice-Aktion |Keine|Windows-Gerät bereinigen | |logoutSharedAppleDeviceActiveUser-Aktion |Keine|Abmelden eines aktiven Benutzers für freigegebenes Apple-Gerät | |deleteUserFromSharedAppleDevice-Aktion|Keine|Löschen eines Benutzers von einem freigegebenen Apple-Gerät | |syncDevice-Aktion|Keine|| |windowsDefenderScan-Aktion |Keine|| |windowsDefenderUpdateSignatures-Aktion|Keine|| |updateWindowsDeviceAccount-Aktion|Keine||

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	String	Eindeutiger Bezeichner für das Gerät. Diese Eigenschaft ist schreibgeschützt.
userId	String	Eindeutiger Bezeichner für den Benutzer, der dem Gerät zugeordnet ist. Diese Eigenschaft ist schreibgeschützt.
deviceName	String	Name des Geräts. Diese Eigenschaft ist schreibgeschützt.
managedDeviceOwnerType	managedDeviceOwnerType	Besitzer des Geräts. Kann "unternehmen" oder "persönlich" sein. Mögliche Werte sind: unknown, company und personal.
deviceActionResults	deviceActionResult-Sammlung	Liste von ComplexType DeviceActionResult-Objekten. Diese Eigenschaft ist schreibgeschützt.
enrolledDateTime	DateTimeOffset	Registrierungszeit des Geräts. Unterstützt $filter Operatoren "lt" und "gt". Diese Eigenschaft ist schreibgeschützt.
lastSyncDateTime	DateTimeOffset	Datum und Uhrzeit, zu dem bzw. der das Gerät zuletzt eine erfolgreiche Synchronisierung mit Intune durchgeführt hat. Unterstützt $filter Operatoren "lt" und "gt". Diese Eigenschaft ist schreibgeschützt.
operatingSystem	String	Betriebssystem des Geräts Windows, iOS usw. Diese Eigenschaft ist schreibgeschützt.
complianceState	complianceState	Compliancestatus des Geräts. Beispiele: Konform, Konflikt, Fehler usw. Der Standardwert ist unbekannt. Unterstützt $filter Operatoren "eq" und "or". Diese Eigenschaft ist schreibgeschützt. Mögliche Werte: unknown, compliant, noncompliant, conflict, error, inGracePeriod, configManager.
jailBroken	String	Ob das Gerät jailbreak oder root ist. Der Standardwert ist eine leere Zeichenfolge. Unterstützt $filter Operatoren "eq" und "or". Diese Eigenschaft ist schreibgeschützt.
managementAgent	managementAgentType	Verwaltungskanal des Geräts. Beispiele: Intune, EAS usw. Der Standardwert ist unbekannt. Unterstützt $filter Operatoren "eq" und "or". Diese Eigenschaft ist schreibgeschützt. Mögliche Werte: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController.
osVersion	String	Betriebssystemversion auf dem Gerät. Diese Eigenschaft ist schreibgeschützt.
easActivated	Boolean	Gibt an, ob das Gerät über Exchange ActiveSync-aktiviert ist. Diese Eigenschaft ist schreibgeschützt.
easDeviceId	String	Exchange ActiveSync-ID des Geräts. Diese Eigenschaft ist schreibgeschützt.
easActivationDateTime	DateTimeOffset	Exchange ActivationSync-Aktivierungszeit des Geräts. Diese Eigenschaft ist schreibgeschützt.
azureADRegistered	Boolean	Gibt an, ob das Gerät für Azure Active Directory registriert ist. Diese Eigenschaft ist schreibgeschützt.
deviceEnrollmentType	deviceEnrollmentType	Registrierungstyp des Geräts. Diese Eigenschaft ist schreibgeschützt. Mögliche Werte: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement, windowsAzureADJoinUsingDeviceAuth, appleUserEnrollment, appleUserEnrollmentWithServiceAccount.
activationLockBypassCode	String	Der Code, mit dem die Aktivierungssperre auf einem verwalteten Gerät umgangen werden kann. Der Standardwert ist Null (Non-Default-Eigenschaft) für diese Eigenschaft, wenn es als Teil der managedDevice-Entität im LIST-Aufruf zurückgegeben wird. Um die tatsächlichen Werte abzurufen, muss GET-Aufruf erfolgen, wobei die Geräte-ID im Select-Parameter enthalten ist. Unterstützt: $select. $Search wird nicht unterstützt. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt.
emailAddress	String	Email für den Benutzer, der dem Gerät zugeordnet ist. Diese Eigenschaft ist schreibgeschützt.
azureADDeviceId	String	Die eindeutige ID für das Azure Active Directory-Gerät. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt.
deviceRegistrationState	deviceRegistrationState	Geräteregistrierungsstatus Diese Eigenschaft ist schreibgeschützt. Mögliche Werte: notRegistered, registered, revoked, keyConflict, approvalPending, certificateReset, notRegisteredPendingEnrollment, unknown.
deviceCategoryDisplayName	String	Anzeigename der Gerätekategorie. Der Standardwert ist eine leere Zeichenfolge. Unterstützt $filter Operatoren "eq" und "or". Diese Eigenschaft ist schreibgeschützt.
isSupervised	Boolesch	Vom Gerät überwachte status. Diese Eigenschaft ist schreibgeschützt.
exchangeLastSuccessfulSyncDateTime	DateTimeOffset	Letzter Zeitpunkt, zu dem das Gerät Exchange kontaktiert hat. Diese Eigenschaft ist schreibgeschützt.
exchangeAccessState	deviceManagementExchangeAccessState	Der Zugriffsstatus des Geräts in Exchange. Diese Eigenschaft ist schreibgeschützt. Mögliche Werte: none, unknown, allowed, blocked, quarantined.
exchangeAccessStateReason	deviceManagementExchangeAccessStateReason	Grund für den Zugriffsstatus des Geräts in Exchange. Diese Eigenschaft ist schreibgeschützt. Mögliche Werte sind: none, unknown, exchangeGlobalRule, exchangeIndividualRule, exchangeDeviceRule, exchangeUpgrade, exchangeMailboxPolicy, other, compliant, notCompliant, notEnrolled, unknownLocation, mfaRequired, azureADBlockDueToAccessPolicy, compromisedPassword, deviceNotKnownWithManagedApp.
remoteAssistanceSessionUrl	String	Die URL, die ermöglicht, dass mit dem Gerät eine Remoteunterstützungssitzung eingerichtet wird. Der Standardwert ist eine leere Zeichenfolge. Um die tatsächlichen Werte abzurufen, muss GET-Aufruf erfolgen, wobei die Geräte-ID im Select-Parameter enthalten ist. Diese Eigenschaft ist schreibgeschützt.
remoteAssistanceSessionErrorDetails	String	Eine Fehlerzeichenfolge, die Probleme beim Erstellen von Objekten für die Remoteunterstützungssitzung identifiziert. Diese Eigenschaft ist schreibgeschützt.
isEncrypted	Boolesch	Geräteverschlüsselung status. Diese Eigenschaft ist schreibgeschützt.
userPrincipalName	String	Name des Gerätebenutzerprinzipals. Diese Eigenschaft ist schreibgeschützt.
model	String	Modell des Geräts. Diese Eigenschaft ist schreibgeschützt.
Hersteller	String	Hersteller des Geräts. Diese Eigenschaft ist schreibgeschützt.
imei	String	IMEI. Diese Eigenschaft ist schreibgeschützt.
complianceGracePeriodExpirationDateTime	DateTimeOffset	Die DateTime, wenn die Toleranzperiode für die Gerätekonformität abläuft. Diese Eigenschaft ist schreibgeschützt.
serialNumber	String	Serialnumber. Diese Eigenschaft ist schreibgeschützt.
PhoneNumber	String	Telefonnummer des Geräts. Diese Eigenschaft ist schreibgeschützt.
androidSecurityPatchLevel	String	Android-Sicherheitspatchebene. Diese Eigenschaft ist schreibgeschützt.
userDisplayName	String	Anzeigename des Benutzers. Diese Eigenschaft ist schreibgeschützt.
configurationManagerClientEnabledFeatures	configurationManagerClientEnabledFeatures	Clientfähige ConfigrMgr-Features. Diese Eigenschaft ist schreibgeschützt.
wiFiMacAddress	String	Wi-Fi MAC. Diese Eigenschaft ist schreibgeschützt.
deviceHealthAttestationState	deviceHealthAttestationState	Integritätsnachweis für Geräte – Status Diese Eigenschaft ist schreibgeschützt.
subscriberCarrier	String	Netzbetreiber des Abonnenten. Diese Eigenschaft ist schreibgeschützt.
meid	String	MEID. Diese Eigenschaft ist schreibgeschützt.
totalStorageSpaceInBytes	Int64	Gesamtspeicher in Bytes. Diese Eigenschaft ist schreibgeschützt.
freeStorageSpaceInBytes	Int64	Freier Speicher in Bytes. Der Standardwert ist 0. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt.
managedDeviceName	String	Automatisch generierter Name zum Identifizieren eines Geräts. Kann mit einem Anzeigenamen überschrieben werden.
partnerReportedThreatState	managedDevicePartnerReportedHealthState	Gibt den Bedrohungsstatus eines Geräts an, wenn ein vom Konto und Gerät ein Mobile Threat Defense-Partner verwendet wird. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. Mögliche Werte: unknown, activated, deactivated, secured, lowSeverity, mediumSeverity, highSeverity, unresponsive, compromised, misconfigured.
requireUserEnrollmentApproval	Boolesch	Meldet, ob es sich bei dem verwalteten iOS-Gerät um die Registrierung der Benutzergenehmigung handelt. Diese Eigenschaft ist schreibgeschützt.
managementCertificateExpirationDate	DateTimeOffset	Meldet das Ablaufdatum des Geräteverwaltungszertifikats. Diese Eigenschaft ist schreibgeschützt.
iccid	String	Integrated Circuit Card Identifier, es ist die eindeutige Identifikationsnummer einer SIM-Karte. Der Standardwert ist eine leere Zeichenfolge. Um die tatsächlichen Werte abzurufen, muss GET-Aufruf erfolgen, wobei die Geräte-ID im Select-Parameter enthalten ist. Unterstützt: $select. $Search wird nicht unterstützt. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt.
Udid	String	Eindeutiger Gerätebezeichner für iOS- und macOS-Geräte. Der Standardwert ist eine leere Zeichenfolge. Um die tatsächlichen Werte abzurufen, muss GET-Aufruf erfolgen, wobei die Geräte-ID im Select-Parameter enthalten ist. Unterstützt: $select. $Search wird nicht unterstützt. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt.
notes	String	Hinweise zu dem gerät, das von der IT-Admin erstellt wurde. Der Standardwert ist NULL. Um die tatsächlichen Werte abzurufen, muss GET-Aufruf erfolgen, wobei die Geräte-ID im Select-Parameter enthalten ist. Unterstützt: $select. $Search wird nicht unterstützt.
ethernetMacAddress	String	Gibt die Ethernet-MAC-Adresse des Geräts an. Der Standardwert ist Null (Non-Default-Eigenschaft) für diese Eigenschaft, wenn sie als Teil der managedDevice-Entität zurückgegeben wird. Ein einzelner Get-Aufruf mit Auswahlabfrageoptionen ist erforderlich, um die tatsächlichen Werte abzurufen. Beispiel: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select. $Search wird nicht unterstützt. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt.
physicalMemoryInBytes	Int64	Gesamtspeicher in Bytes. Der Standardwert lautet „0“. Um die tatsächlichen Werte abzurufen, muss GET-Aufruf erfolgen, wobei die Geräte-ID im Select-Parameter enthalten ist. Unterstützt: $select. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt.
enrollmentProfileName	String	Name des Registrierungsprofils, das dem Gerät zugewiesen ist. Der Standardwert ist eine leere Zeichenfolge, die angibt, dass kein Registrierungsprofil assgined wurde. Diese Eigenschaft ist schreibgeschützt.

Beziehungen

Beziehung	Typ	Beschreibung
deviceCategory	deviceCategory	Gerätekategorie
windowsProtectionState	windowsProtectionState	Die geräteschutz-status. Diese Eigenschaft ist schreibgeschützt.
users	Benutzersammlung	Die primären Benutzer, die dem verwalteten Gerät zugeordnet sind.
logCollectionRequests	deviceLogCollectionResponse-Sammlung	Liste der Protokollsammlungsanforderungen

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "@odata.type": "#microsoft.graph.managedDevice",
  "id": "String (identifier)",
  "userId": "String",
  "deviceName": "String",
  "managedDeviceOwnerType": "String",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "String",
      "actionState": "String",
      "startDateTime": "String (timestamp)",
      "lastUpdatedDateTime": "String (timestamp)"
    }
  ],
  "enrolledDateTime": "String (timestamp)",
  "lastSyncDateTime": "String (timestamp)",
  "operatingSystem": "String",
  "complianceState": "String",
  "jailBroken": "String",
  "managementAgent": "String",
  "osVersion": "String",
  "easActivated": true,
  "easDeviceId": "String",
  "easActivationDateTime": "String (timestamp)",
  "azureADRegistered": true,
  "deviceEnrollmentType": "String",
  "activationLockBypassCode": "String",
  "emailAddress": "String",
  "azureADDeviceId": "String",
  "deviceRegistrationState": "String",
  "deviceCategoryDisplayName": "String",
  "isSupervised": true,
  "exchangeLastSuccessfulSyncDateTime": "String (timestamp)",
  "exchangeAccessState": "String",
  "exchangeAccessStateReason": "String",
  "remoteAssistanceSessionUrl": "String",
  "remoteAssistanceSessionErrorDetails": "String",
  "isEncrypted": true,
  "userPrincipalName": "String",
  "model": "String",
  "manufacturer": "String",
  "imei": "String",
  "complianceGracePeriodExpirationDateTime": "String (timestamp)",
  "serialNumber": "String",
  "phoneNumber": "String",
  "androidSecurityPatchLevel": "String",
  "userDisplayName": "String",
  "configurationManagerClientEnabledFeatures": {
    "@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
    "inventory": true,
    "modernApps": true,
    "resourceAccess": true,
    "deviceConfiguration": true,
    "compliancePolicy": true,
    "windowsUpdateForBusiness": true
  },
  "wiFiMacAddress": "String",
  "deviceHealthAttestationState": {
    "@odata.type": "microsoft.graph.deviceHealthAttestationState",
    "lastUpdateDateTime": "String",
    "contentNamespaceUrl": "String",
    "deviceHealthAttestationStatus": "String",
    "contentVersion": "String",
    "issuedDateTime": "String (timestamp)",
    "attestationIdentityKey": "String",
    "resetCount": 1024,
    "restartCount": 1024,
    "dataExcutionPolicy": "String",
    "bitLockerStatus": "String",
    "bootManagerVersion": "String",
    "codeIntegrityCheckVersion": "String",
    "secureBoot": "String",
    "bootDebugging": "String",
    "operatingSystemKernelDebugging": "String",
    "codeIntegrity": "String",
    "testSigning": "String",
    "safeMode": "String",
    "windowsPE": "String",
    "earlyLaunchAntiMalwareDriverProtection": "String",
    "virtualSecureMode": "String",
    "pcrHashAlgorithm": "String",
    "bootAppSecurityVersion": "String",
    "bootManagerSecurityVersion": "String",
    "tpmVersion": "String",
    "pcr0": "String",
    "secureBootConfigurationPolicyFingerPrint": "String",
    "codeIntegrityPolicy": "String",
    "bootRevisionListInfo": "String",
    "operatingSystemRevListInfo": "String",
    "healthStatusMismatchInfo": "String",
    "healthAttestationSupportedStatus": "String"
  },
  "subscriberCarrier": "String",
  "meid": "String",
  "totalStorageSpaceInBytes": 1024,
  "freeStorageSpaceInBytes": 1024,
  "managedDeviceName": "String",
  "partnerReportedThreatState": "String",
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "String (timestamp)",
  "iccid": "String",
  "udid": "String",
  "notes": "String",
  "ethernetMacAddress": "String",
  "physicalMemoryInBytes": 1024,
  "enrollmentProfileName": "String"
}