Erstellen von „managedDevice“
Namespace: microsoft.graph
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Diese Methode erstellt ein neues Objekt des Typs managedDevice.
Voraussetzungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.
| Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
|---|---|
| Delegiert (Geschäfts-, Schul- oder Unikonto) | DeviceManagementManagedDevices.ReadWrite.All |
| Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
| Anwendung | DeviceManagementManagedDevices.ReadWrite.All |
HTTP-Anforderung
POST /users/{usersId}/managedDevices
POST /deviceManagement/managedDevices
POST /deviceManagement/detectedApps/{detectedAppId}/managedDevices
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer<token> erforderlich |
| Annehmen | application/json |
Anforderungstext
Geben Sie als Anforderungstext eine JSON-Darstellung des Objekts des Typs „managedDevice“ an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs „managedDevice“ erstellen.
| 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 | Besitz des Geräts. Kann "Firma" 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. 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. 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. Diese Eigenschaft ist schreibgeschützt. Mögliche Werte: unknown, compliant, noncompliant, conflict, error, inGracePeriod, configManager. |
| jailBroken | String | Gibt an, ob es sich um ein Gerät mit Jailbreak oder Rootzugriff handelt. Diese Eigenschaft ist schreibgeschützt. |
| managementAgent | managementAgentType | Verwaltungskanal des Geräts. Intune, EAS usw. 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 | Code, der ermöglicht, dass die Aktivierungssperre auf einem Gerät umgangen wird. 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. Diese Eigenschaft ist schreibgeschützt. |
| isSupervised | Boolean | Überwachter Gerätestatus. 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. 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 | Boolean | Geräteverschlüsselungsstatus. Diese Eigenschaft ist schreibgeschützt. |
| userPrincipalName | Zeichenfolge | Benutzerprinzipalname des Geräts. 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 | DateTime, wenn die Nachfrist für die Gerätekompatibilität abläuft. Diese Eigenschaft ist schreibgeschützt. |
| serialNumber | String | Serialnumber. Diese Eigenschaft ist schreibgeschützt. |
| PhoneNumber | String | Die 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 | Für den ConfigrMgr-Client aktivierte 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 | Abonnent Carrier. 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. 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. |
| iccid | Zeichenfolge | Integrated Circuit Card Identifier, it is A SIM card's unique identification number. Diese Eigenschaft ist schreibgeschützt. |
| Udid | String | Eindeutiger Gerätebezeichner für iOS- und macOS-Geräte. Diese Eigenschaft ist schreibgeschützt. |
| notes | String | Notizen auf dem von der IT-Admin erstellten Gerät |
| ethernetMacAddress | Zeichenfolge | Ethernet MAC. Diese Eigenschaft ist schreibgeschützt. |
| physicalMemoryInBytes | Int64 | Gesamtspeicher in Bytes. Diese Eigenschaft ist schreibgeschützt. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 201 Created Antwortcode und ein managedDevice-Objekt im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/v1.0/users/{usersId}/managedDevices
Content-type: application/json
Content-length: 4821
{
"@odata.type": "#microsoft.graph.managedDevice",
"userId": "User Id value",
"deviceName": "Device Name value",
"managedDeviceOwnerType": "company",
"deviceActionResults": [
{
"@odata.type": "microsoft.graph.deviceActionResult",
"actionName": "Action Name value",
"actionState": "pending",
"startDateTime": "2016-12-31T23:58:46.7156189-08:00",
"lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
}
],
"enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
"operatingSystem": "Operating System value",
"complianceState": "compliant",
"jailBroken": "Jail Broken value",
"managementAgent": "mdm",
"osVersion": "Os Version value",
"easActivated": true,
"easDeviceId": "Eas Device Id value",
"easActivationDateTime": "2016-12-31T23:59:43.4878784-08:00",
"azureADRegistered": true,
"deviceEnrollmentType": "userEnrollment",
"activationLockBypassCode": "Activation Lock Bypass Code value",
"emailAddress": "Email Address value",
"azureADDeviceId": "Azure ADDevice Id value",
"deviceRegistrationState": "registered",
"deviceCategoryDisplayName": "Device Category Display Name value",
"isSupervised": true,
"exchangeLastSuccessfulSyncDateTime": "2017-01-01T00:00:45.8803083-08:00",
"exchangeAccessState": "unknown",
"exchangeAccessStateReason": "unknown",
"remoteAssistanceSessionUrl": "https://example.com/remoteAssistanceSessionUrl/",
"remoteAssistanceSessionErrorDetails": "Remote Assistance Session Error Details value",
"isEncrypted": true,
"userPrincipalName": "User Principal Name value",
"model": "Model value",
"manufacturer": "Manufacturer value",
"imei": "Imei value",
"complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00",
"serialNumber": "Serial Number value",
"phoneNumber": "Phone Number value",
"androidSecurityPatchLevel": "Android Security Patch Level value",
"userDisplayName": "User Display Name value",
"configurationManagerClientEnabledFeatures": {
"@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
"inventory": true,
"modernApps": true,
"resourceAccess": true,
"deviceConfiguration": true,
"compliancePolicy": true,
"windowsUpdateForBusiness": true
},
"wiFiMacAddress": "Wi Fi Mac Address value",
"deviceHealthAttestationState": {
"@odata.type": "microsoft.graph.deviceHealthAttestationState",
"lastUpdateDateTime": "Last Update Date Time value",
"contentNamespaceUrl": "https://example.com/contentNamespaceUrl/",
"deviceHealthAttestationStatus": "Device Health Attestation Status value",
"contentVersion": "Content Version value",
"issuedDateTime": "2016-12-31T23:58:22.1231038-08:00",
"attestationIdentityKey": "Attestation Identity Key value",
"resetCount": 10,
"restartCount": 12,
"dataExcutionPolicy": "Data Excution Policy value",
"bitLockerStatus": "Bit Locker Status value",
"bootManagerVersion": "Boot Manager Version value",
"codeIntegrityCheckVersion": "Code Integrity Check Version value",
"secureBoot": "Secure Boot value",
"bootDebugging": "Boot Debugging value",
"operatingSystemKernelDebugging": "Operating System Kernel Debugging value",
"codeIntegrity": "Code Integrity value",
"testSigning": "Test Signing value",
"safeMode": "Safe Mode value",
"windowsPE": "Windows PE value",
"earlyLaunchAntiMalwareDriverProtection": "Early Launch Anti Malware Driver Protection value",
"virtualSecureMode": "Virtual Secure Mode value",
"pcrHashAlgorithm": "Pcr Hash Algorithm value",
"bootAppSecurityVersion": "Boot App Security Version value",
"bootManagerSecurityVersion": "Boot Manager Security Version value",
"tpmVersion": "Tpm Version value",
"pcr0": "Pcr0 value",
"secureBootConfigurationPolicyFingerPrint": "Secure Boot Configuration Policy Finger Print value",
"codeIntegrityPolicy": "Code Integrity Policy value",
"bootRevisionListInfo": "Boot Revision List Info value",
"operatingSystemRevListInfo": "Operating System Rev List Info value",
"healthStatusMismatchInfo": "Health Status Mismatch Info value",
"healthAttestationSupportedStatus": "Health Attestation Supported Status value"
},
"subscriberCarrier": "Subscriber Carrier value",
"meid": "Meid value",
"totalStorageSpaceInBytes": 8,
"freeStorageSpaceInBytes": 7,
"managedDeviceName": "Managed Device Name value",
"partnerReportedThreatState": "activated",
"iccid": "Iccid value",
"udid": "Udid value",
"notes": "Notes value",
"ethernetMacAddress": "Ethernet Mac Address value",
"physicalMemoryInBytes": 5
}
Antwort
Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 4870
{
"@odata.type": "#microsoft.graph.managedDevice",
"id": "705c034c-034c-705c-4c03-5c704c035c70",
"userId": "User Id value",
"deviceName": "Device Name value",
"managedDeviceOwnerType": "company",
"deviceActionResults": [
{
"@odata.type": "microsoft.graph.deviceActionResult",
"actionName": "Action Name value",
"actionState": "pending",
"startDateTime": "2016-12-31T23:58:46.7156189-08:00",
"lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
}
],
"enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
"operatingSystem": "Operating System value",
"complianceState": "compliant",
"jailBroken": "Jail Broken value",
"managementAgent": "mdm",
"osVersion": "Os Version value",
"easActivated": true,
"easDeviceId": "Eas Device Id value",
"easActivationDateTime": "2016-12-31T23:59:43.4878784-08:00",
"azureADRegistered": true,
"deviceEnrollmentType": "userEnrollment",
"activationLockBypassCode": "Activation Lock Bypass Code value",
"emailAddress": "Email Address value",
"azureADDeviceId": "Azure ADDevice Id value",
"deviceRegistrationState": "registered",
"deviceCategoryDisplayName": "Device Category Display Name value",
"isSupervised": true,
"exchangeLastSuccessfulSyncDateTime": "2017-01-01T00:00:45.8803083-08:00",
"exchangeAccessState": "unknown",
"exchangeAccessStateReason": "unknown",
"remoteAssistanceSessionUrl": "https://example.com/remoteAssistanceSessionUrl/",
"remoteAssistanceSessionErrorDetails": "Remote Assistance Session Error Details value",
"isEncrypted": true,
"userPrincipalName": "User Principal Name value",
"model": "Model value",
"manufacturer": "Manufacturer value",
"imei": "Imei value",
"complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00",
"serialNumber": "Serial Number value",
"phoneNumber": "Phone Number value",
"androidSecurityPatchLevel": "Android Security Patch Level value",
"userDisplayName": "User Display Name value",
"configurationManagerClientEnabledFeatures": {
"@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
"inventory": true,
"modernApps": true,
"resourceAccess": true,
"deviceConfiguration": true,
"compliancePolicy": true,
"windowsUpdateForBusiness": true
},
"wiFiMacAddress": "Wi Fi Mac Address value",
"deviceHealthAttestationState": {
"@odata.type": "microsoft.graph.deviceHealthAttestationState",
"lastUpdateDateTime": "Last Update Date Time value",
"contentNamespaceUrl": "https://example.com/contentNamespaceUrl/",
"deviceHealthAttestationStatus": "Device Health Attestation Status value",
"contentVersion": "Content Version value",
"issuedDateTime": "2016-12-31T23:58:22.1231038-08:00",
"attestationIdentityKey": "Attestation Identity Key value",
"resetCount": 10,
"restartCount": 12,
"dataExcutionPolicy": "Data Excution Policy value",
"bitLockerStatus": "Bit Locker Status value",
"bootManagerVersion": "Boot Manager Version value",
"codeIntegrityCheckVersion": "Code Integrity Check Version value",
"secureBoot": "Secure Boot value",
"bootDebugging": "Boot Debugging value",
"operatingSystemKernelDebugging": "Operating System Kernel Debugging value",
"codeIntegrity": "Code Integrity value",
"testSigning": "Test Signing value",
"safeMode": "Safe Mode value",
"windowsPE": "Windows PE value",
"earlyLaunchAntiMalwareDriverProtection": "Early Launch Anti Malware Driver Protection value",
"virtualSecureMode": "Virtual Secure Mode value",
"pcrHashAlgorithm": "Pcr Hash Algorithm value",
"bootAppSecurityVersion": "Boot App Security Version value",
"bootManagerSecurityVersion": "Boot Manager Security Version value",
"tpmVersion": "Tpm Version value",
"pcr0": "Pcr0 value",
"secureBootConfigurationPolicyFingerPrint": "Secure Boot Configuration Policy Finger Print value",
"codeIntegrityPolicy": "Code Integrity Policy value",
"bootRevisionListInfo": "Boot Revision List Info value",
"operatingSystemRevListInfo": "Operating System Rev List Info value",
"healthStatusMismatchInfo": "Health Status Mismatch Info value",
"healthAttestationSupportedStatus": "Health Attestation Supported Status value"
},
"subscriberCarrier": "Subscriber Carrier value",
"meid": "Meid value",
"totalStorageSpaceInBytes": 8,
"freeStorageSpaceInBytes": 7,
"managedDeviceName": "Managed Device Name value",
"partnerReportedThreatState": "activated",
"iccid": "Iccid value",
"udid": "Udid value",
"notes": "Notes value",
"ethernetMacAddress": "Ethernet Mac Address value",
"physicalMemoryInBytes": 5
}
Feedback
Feedback senden und anzeigen für