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 | Zeichenfolge | 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 | Zeichenfolge | 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 | Zeichenfolge | 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 | Zeichenfolge | 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 | Zeichenfolge | E-Mails 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 | Zeichenfolge | Anzeigename der Gerätekategorie. Der Standardwert ist eine leere Zeichenfolge. Unterstützt $filter Operatoren "eq" und "or". Diese Eigenschaft ist schreibgeschützt. |
| isSupervised | Boolesch | Status des überwachten Geräts. 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üsselungsstatus. Diese Eigenschaft ist schreibgeschützt. |
| userPrincipalName | Zeichenfolge | Name des Gerätebenutzerprinzipals. Diese Eigenschaft ist schreibgeschützt. |
| model | Zeichenfolge | Modell des Geräts. Diese Eigenschaft ist schreibgeschützt. |
| Hersteller | Zeichenfolge | Hersteller des Geräts. Diese Eigenschaft ist schreibgeschützt. |
| imei | Zeichenfolge | 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 | Zeichenfolge | SerialNumber. Diese Eigenschaft ist schreibgeschützt. |
| PhoneNumber | Zeichenfolge | Telefonnummer des Geräts. Diese Eigenschaft ist schreibgeschützt. |
| androidSecurityPatchLevel | Zeichenfolge | 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 | Zeichenfolge | Wi-Fi MAC. Diese Eigenschaft ist schreibgeschützt. |
| deviceHealthAttestationState | deviceHealthAttestationState | Integritätsnachweis für Geräte – Status Diese Eigenschaft ist schreibgeschützt. |
| subscriberCarrier | Zeichenfolge | Netzbetreiber des Abonnenten. Diese Eigenschaft ist schreibgeschützt. |
| meid | Zeichenfolge | 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 | Zeichenfolge | 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 | Zeichenfolge | 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 vom IT-Administrator 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 | Zeichenfolge | 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 | Zeichenfolge | 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 | Der Geräteschutzstatus. 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"
}