managedDevice-RessourcentypmanagedDevice resource type

Namespace: microsoft.graphNamespace: microsoft.graph

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Über Intune verwaltete oder vorab registrierte GeräteDevices that are managed or pre-enrolled through Intune

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
managedDevices auflistenList managedDevices managedDevice-SammlungmanagedDevice collection Auflisten von Eigenschaften und Beziehungen der managedDevice-Objekte.List properties and relationships of the managedDevice objects.
managedDevice abrufenGet managedDevice managedDevicemanagedDevice Lesen von Eigenschaften und Beziehungen des managedDevice-Objekts.Read properties and relationships of the managedDevice object.
managedDevice erstellenCreate managedDevice managedDevicemanagedDevice Erstellen eines neuen managedDevice-Objekts.Create a new managedDevice object.
managedDevice löschenDelete managedDevice KeineNone Löscht ein managedDevice löschen.Deletes a managedDevice.
managedDevice aktualisierenUpdate managedDevice managedDevicemanagedDevice Aktualisieren der Eigenschaften eines managedDeviceOverview-Objekts.Update the properties of a managedDevice object.
retire-Aktionretire action KeineNone Zurückziehen eines GerätsRetire a device
wipe-Aktionwipe action KeineNone Zurücksetzen eines GerätsWipe a device
resetPasscode-AktionresetPasscode action KeineNone Kennung zurücksetzenReset passcode
remoteLock-AktionremoteLock action KeineNone RemotesperreRemote lock
requestRemoteAssistance-AktionrequestRemoteAssistance action KeineNone Remoteunterstützung anfordernRequest remote assistance
disableLostMode-AktiondisableLostMode action KeineNone Modus für verlorene Geräte deaktivierenDisable lost mode
locateDevice-AktionlocateDevice action KeineNone Suchen eines GerätsLocate a device
bypassActivationLock-AktionbypassActivationLock action KeineNone Aktivierungssperre umgehenBypass activation lock
rebootNow-AktionrebootNow action KeineNone Gerät neu startenReboot device
shutDown-AktionshutDown action KeineNone Gerät abschaltenShut down device
recoverPasscode-AktionrecoverPasscode action KeineNone Kennung wiederherstellenRecover passcode
cleanWindowsDevice-AktioncleanWindowsDevice action KeineNone Windows-Gerät bereinigenClean Windows device
logoutSharedAppleDeviceActiveUser-AktionlogoutSharedAppleDeviceActiveUser action KeineNone Aktiven Benutzer von freigegebenem Apple-Gerät abmeldenLogout shared Apple device active user
deleteUserFromSharedAppleDevice-AktiondeleteUserFromSharedAppleDevice action KeineNone Benutzer von freigegebenem Apple-Gerät löschenDelete user from shared Apple device
syncDevice-AktionsyncDevice action KeinerNone Noch nicht dokumentiert.Not yet documented
windowsDefenderScan-AktionwindowsDefenderScan action KeinerNone Noch nicht dokumentiert.Not yet documented
windowsDefenderUpdateSignatures-AktionwindowsDefenderUpdateSignatures action KeinerNone Noch nicht dokumentiert.Not yet documented
updateWindowsDeviceAccount-AktionupdateWindowsDeviceAccount action KeineNone Noch nicht dokumentiertNot yet documented

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
idid ZeichenfolgeString Eindeutiger Bezeichner für das GerätUnique Identifier for the device
userIduserId StringString Eindeutiger Bezeichner des Benutzers, der dem Gerät zugeordnet istUnique Identifier for the user associated with the device
deviceNamedeviceName StringString Der Name des Geräts.Name of the device
managedDeviceOwnerTypemanagedDeviceOwnerType managedDeviceOwnerTypemanagedDeviceOwnerType Besitz des Geräts.Ownership of the device. Kann "Unternehmen" oder "persönlich" sein.Can be 'company' or 'personal'. Mögliche Werte sind: unknown, company und personal.Possible values are: unknown, company, personal.
deviceActionResultsdeviceActionResults deviceActionResult-SammlungdeviceActionResult collection Liste von ComplexType DeviceActionResult-Objekten.List of ComplexType deviceActionResult objects.
enrolledDateTimeenrolledDateTime DateTimeOffsetDateTimeOffset Registrierungszeit des Geräts.Enrollment time of the device.
lastSyncDateTimelastSyncDateTime DateTimeOffsetDateTimeOffset Datum und Uhrzeit, zu dem bzw. der das Gerät zuletzt eine erfolgreiche Synchronisierung mit Intune durchgeführt hat.The date and time that the device last completed a successful sync with Intune.
operatingSystemoperatingSystem StringString Betriebssystem des GerätsOperating system of the device. Windows, iOS, etc.Windows, iOS, etc.
complianceStatecomplianceState complianceStatecomplianceState Compliancestatus des Geräts.Compliance state of the device. Mögliche Werte: unknown, compliant, noncompliant, conflict, error, inGracePeriod, configManager.Possible values are: unknown, compliant, noncompliant, conflict, error, inGracePeriod, configManager.
jailBrokenjailBroken StringString Gibt an, ob es sich um ein Gerät mit Jailbreak oder Rootzugriff handelt.whether the device is jail broken or rooted.
managementAgentmanagementAgent managementAgentTypemanagementAgentType Verwaltungskanal des Geräts.Management channel of the device. Intune, EAS usw. Mögliche Werte sind: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController.Intune, EAS, etc. Possible values are: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController.
osVersionosVersion StringString Betriebssystemversion auf dem Gerät.Operating system version of the device.
easActivatedeasActivated Boolescher WertBoolean Gibt an, ob das Gerät über Exchange ActiveSync-aktiviert ist.Whether the device is Exchange ActiveSync activated.
easDeviceIdeasDeviceId StringString Exchange ActiveSync-ID des Geräts.Exchange ActiveSync Id of the device.
easActivationDateTimeeasActivationDateTime DateTimeOffsetDateTimeOffset Exchange ActivationSync-Aktivierungszeit des Geräts.Exchange ActivationSync activation time of the device.
azureADRegisteredazureADRegistered Boolescher WertBoolean Gibt an, ob das Gerät für Azure Active Directory registriert ist.Whether the device is Azure Active Directory registered.
deviceEnrollmentTypedeviceEnrollmentType deviceEnrollmentTypedeviceEnrollmentType Registrierungstyp des Geräts.Enrollment type of the device. Mögliche Werte: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement.Possible values are: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement.
activationLockBypassCodeactivationLockBypassCode StringString Code, der ermöglicht, dass die Aktivierungssperre auf einem Gerät umgangen wird.Code that allows the Activation Lock on a device to be bypassed.
emailAddressemailAddress StringString E-Mail(s) für den Benutzer, der dem Gerät zugeordnet istEmail(s) for the user associated with the device
azureADDeviceIdazureADDeviceId StringString Die eindeutige ID für das Azure Active Directory-Gerät.The unique identifier for the Azure Active Directory device. Schreibgeschützt.Read only.
deviceRegistrationStatedeviceRegistrationState deviceRegistrationStatedeviceRegistrationState GeräteregistrierungsstatusDevice registration state. Mögliche Werte: notRegistered, registered, revoked, keyConflict, approvalPending, certificateReset, notRegisteredPendingEnrollment, unknown.Possible values are: notRegistered, registered, revoked, keyConflict, approvalPending, certificateReset, notRegisteredPendingEnrollment, unknown.
deviceCategoryDisplayNamedeviceCategoryDisplayName StringString Anzeigename der GerätekategorieDevice category display name
isSupervisedisSupervised BooleschBoolean Überwachter GerätestatusDevice supervised status
exchangeLastSuccessfulSyncDateTimeexchangeLastSuccessfulSyncDateTime DateTimeOffsetDateTimeOffset Letzter Zeitpunkt, zu dem das Gerät Exchange kontaktiert hat.Last time the device contacted Exchange.
exchangeAccessStateexchangeAccessState deviceManagementExchangeAccessStatedeviceManagementExchangeAccessState Der Zugriffsstatus des Geräts in Exchange.The Access State of the device in Exchange. Mögliche Werte: none, unknown, allowed, blocked, quarantined.Possible values are: none, unknown, allowed, blocked, quarantined.
exchangeAccessStateReasonexchangeAccessStateReason deviceManagementExchangeAccessStateReasondeviceManagementExchangeAccessStateReason Grund für den Zugriffsstatus des Geräts in Exchange.The reason for the device's access state in Exchange. Mögliche Werte sind: none, unknown, exchangeGlobalRule, exchangeIndividualRule, exchangeDeviceRule, exchangeUpgrade, exchangeMailboxPolicy, other, compliant, notCompliant, notEnrolled, unknownLocation, mfaRequired, azureADBlockDueToAccessPolicy, compromisedPassword, deviceNotKnownWithManagedApp.Possible values are: none, unknown, exchangeGlobalRule, exchangeIndividualRule, exchangeDeviceRule, exchangeUpgrade, exchangeMailboxPolicy, other, compliant, notCompliant, notEnrolled, unknownLocation, mfaRequired, azureADBlockDueToAccessPolicy, compromisedPassword, deviceNotKnownWithManagedApp.
remoteAssistanceSessionUrlremoteAssistanceSessionUrl StringString Die URL, die ermöglicht, dass mit dem Gerät eine Remoteunterstützungssitzung eingerichtet wird.Url that allows a Remote Assistance session to be established with the device.
remoteAssistanceSessionErrorDetailsremoteAssistanceSessionErrorDetails StringString Eine Fehlerzeichenfolge, die Probleme beim Erstellen von Objekten für die Remoteunterstützungssitzung identifiziert.An error string that identifies issues when creating Remote Assistance session objects.
isEncryptedisEncrypted BooleanBoolean GeräteverschlüsselungsstatusDevice encryption status
userPrincipalNameuserPrincipalName StringString Benutzerprinzipalname für das GerätDevice user principal name
modelmodel StringString Das Modell des Geräts.Model of the device
Herstellermanufacturer StringString Hersteller des GerätsManufacturer of the device
imeiimei StringString IMEIIMEI
complianceGracePeriodExpirationDateTimecomplianceGracePeriodExpirationDateTime DateTimeOffsetDateTimeOffset Datum und Uhrzeit des Ablaufs der Karenzzeit für die GerätekonformitätThe DateTime when device compliance grace period expires
serialNumberserialNumber StringString SerialNumberSerialNumber
PhoneNumberphoneNumber StringString Telefonnummer des GerätsPhone number of the device
androidSecurityPatchLevelandroidSecurityPatchLevel StringString Sicherheitspatchlevel von AndroidAndroid security patch level
userDisplayNameuserDisplayName StringString Anzeigename des BenutzersUser display name
configurationManagerClientEnabledFeaturesconfigurationManagerClientEnabledFeatures configurationManagerClientEnabledFeaturesconfigurationManagerClientEnabledFeatures Für ConfigrMgr-Client aktivierte FeaturesConfigrMgr client enabled features
wiFiMacAddresswiFiMacAddress StringString Wi-Fi-MACWi-Fi MAC
deviceHealthAttestationStatedeviceHealthAttestationState deviceHealthAttestationStatedeviceHealthAttestationState Integritätsnachweis für Geräte – StatusThe device health attestation state.
subscriberCarriersubscriberCarrier StringString Netzbetreiber des AbonnentenSubscriber Carrier
meidmeid StringString MEIDMEID
totalStorageSpaceInBytestotalStorageSpaceInBytes Int64Int64 Gesamtspeicher in ByteTotal Storage in Bytes
freeStorageSpaceInBytesfreeStorageSpaceInBytes Int64Int64 Freier Speicher in ByteFree Storage in Bytes
managedDeviceNamemanagedDeviceName StringString Automatisch generierter Name zum Identifizieren eines Geräts.Automatically generated name to identify a device. Kann mit einem Anzeigenamen überschrieben werden.Can be overwritten to a user friendly name.
partnerReportedThreatStatepartnerReportedThreatState managedDevicePartnerReportedHealthStatemanagedDevicePartnerReportedHealthState Gibt den Bedrohungsstatus eines Geräts an, wenn ein vom Konto und Gerät ein Mobile Threat Defense-Partner verwendet wird.Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. Schreibgeschützt.Read Only. Mögliche Werte: unknown, activated, deactivated, secured, lowSeverity, mediumSeverity, highSeverity, unresponsive, compromised, misconfigured.Possible values are: unknown, activated, deactivated, secured, lowSeverity, mediumSeverity, highSeverity, unresponsive, compromised, misconfigured.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
deviceCategorydeviceCategory deviceCategorydeviceCategory GerätekategorieDevice category

JSON-DarstellungJSON Representation

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

{
  "@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"
}