Create managedDevice
名前空間: microsoft.graph
注: Intune 用 Microsoft Graph API には、テナントの 有効な Intune ライセンスが必要です。
新しい managedDevice オブジェクトを作成します。
前提条件
この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | DeviceManagementManagedDevices.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | DeviceManagementManagedDevices.ReadWrite.All |
HTTP 要求
POST /users/{usersId}/managedDevices
POST /deviceManagement/managedDevices
POST /deviceManagement/detectedApps/{detectedAppId}/managedDevices
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー <トークン> が必要です。 |
| 承諾 | application/json |
要求本文
要求本文で、managedDevice オブジェクトの JSON 表記を指定します。
次の表に、managedDevice の作成時に必要なプロパティを示します。
| プロパティ | 型 | 説明 |
|---|---|---|
| id | String | デバイスの一意識別子。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| userId | String | デバイスに関連付けられているユーザーの一意識別子。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| deviceName | String | デバイスの名前。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| managedDeviceOwnerType | managedDeviceOwnerType | デバイスの所有権。 'company' または 'personal' を指定できます。 可能な値は unknown、company、personal です。 |
| deviceActionResults | deviceActionResult コレクション | ComplexType deviceActionResult オブジェクトのリスト。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| enrolledDateTime | DateTimeOffset | デバイスの登録時刻。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| lastSyncDateTime | DateTimeOffset | デバイスが Intune との正常な同期を最終的に完了した日時。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| operatingSystem | String | デバイスのオペレーティング システム。 Windows、iOS などこのプロパティは読み取り専用です。 |
| complianceState | complianceState | デバイスのコンプライアンス状態。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 可能な値は、unknown、compliant、noncompliant、conflict、error、inGracePeriod、configManager です。 |
| jailBroken | String | デバイスが脱獄またはルート化されているかどうかを示します。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| managementAgent | managementAgentType | デバイスの管理チャネル。 Intune、EAS などこのプロパティは読み取り専用です。 使用可能な値は、eas、mdm、easMdm、intuneClient、easIntuneClient、configurationManagerClient、configurationManagerClientMdm、configurationManagerClientMdmEas、unknown、jamf、googleCloudDevicePolicyController です。 |
| osVersion | String | デバイスのオペレーティング システムのバージョン。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| easActivated | Boolean | Exchange ActiveSync がアクティブになっているデバイスかどうかを示します。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| easDeviceId | String | デバイスの Exchange ActiveSync の ID。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| easActivationDateTime | DateTimeOffset | デバイスの Exchange ActivationSync のアクティブ化の時刻。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| azureADRegistered | Boolean | Azure Active Directory が登録されているデバイスかどうかを示します。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| deviceEnrollmentType | deviceEnrollmentType | デバイスの登録の種類。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 可能な値は、unknown、userEnrollment、deviceEnrollmentManager、appleBulkWithUser、appleBulkWithoutUser、windowsAzureADJoin、windowsBulkUserless、windowsAutoEnrollment、windowsBulkAzureDomainJoin、windowsCoManagement、windowsAzureADJoinUsingDeviceAuth、appleUserEnrollment、appleUserEnrollmentWithServiceAccount です。 |
| activationLockBypassCode | String | デバイスのアクティベーション ロックをバイパスするためのコード。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| emailAddress | String | デバイスに関連付けられているユーザーの電子メール。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| azureADDeviceId | String | Azure Active Directory デバイスの一意識別子。 読み取り専用です。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| deviceRegistrationState | deviceRegistrationState | デバイスの登録状態。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 可能な値は、notRegistered、registered、revoked、keyConflict、approvalPending、certificateReset、notRegisteredPendingEnrollment、unknown です。 |
| deviceCategoryDisplayName | String | デバイス カテゴリの表示名。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| isSupervised | Boolean | デバイス監視状態。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| exchangeLastSuccessfulSyncDateTime | DateTimeOffset | 最後にデバイスが Exchange に接続した時刻。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| exchangeAccessState | deviceManagementExchangeAccessState | Exchange でのデバイスのアクセスの状態。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 可能な値は、none、unknown、allowed、blocked、quarantined です。 |
| exchangeAccessStateReason | deviceManagementExchangeAccessStateReason | Exchange でのデバイスのアクセス状態の理由。 |
このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 可能な値は、none、unknown、exchangeGlobalRule、exchangeIndividualRule、exchangeDeviceRule、exchangeUpgrade、exchangeMailboxPolicy、other、compliant、notCompliant、notEnrolled、unknownLocation、mfaRequired、azureADBlockDueToAccessPolicy、compromisedPassword、deviceNotKnownWithManagedApp です。 |
||
| remoteAssistanceSessionUrl | String | デバイスとのリモート アシスタンス セッションを確立できるようにする URL。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| remoteAssistanceSessionErrorDetails | String | リモート アシスタンス セッション オブジェクトの作成時に問題を識別するエラー文字列。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| isEncrypted | Boolean | デバイス暗号化の状態。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| userPrincipalName | String | デバイス ユーザー プリンシパル名。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| model | String | デバイスのモデル。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| manufacturer | String | デバイスの製造元。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| imei | String | IMEI。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| complianceGracePeriodExpirationDateTime | DateTimeOffset | デバイス コンプライアンスの猶予期間が切れる DateTime。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| シリアル番号 | String | SerialNumber。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| phoneNumber | String | デバイスの電話番号。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| androidSecurityPatchLevel | String | Android セキュリティ パッチ レベル。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| userDisplayName | String | ユーザーの表示名。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| configurationManagerClientEnabledFeatures | configurationManagerClientEnabledFeatures | ConfigrMgr クライアントが有効な機能。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| wiFiMacAddress | String | MAC をWi-Fiします。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| deviceHealthAttestationState | deviceHealthAttestationState | デバイスの正常性構成証明の状態。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| subscriberCarrier | String | サブスクライバーキャリア。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| meid | String | MEID. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| totalStorageSpaceInBytes | Int64 | 合計記憶域 (バイト単位)。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| freeStorageSpaceInBytes | Int64 | 空きストレージ (バイト単位)。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| managedDeviceName | String | デバイスを識別する名前が自動的に生成されます。 ユーザー フレンドリ名に上書きできます。 |
| partnerReportedThreatState | managedDevicePartnerReportedHealthState | Mobile Threat Defense パートナーがアカウントおよびデバイスで使用されている場合の、デバイスの脅威の状態を示します。 読み取り専用です。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 可能な値は、unknown、activated、deactivated、secured、lowSeverity、mediumSeverity、highSeverity、unresponsive、compromised、misconfigured です。 |
| iccid | String | IC カード識別子。SIM カードの一意の識別番号です。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| Udid | String | iOS デバイスと macOS デバイスの一意のデバイス識別子。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| notes | String | IT 管理によって作成されたデバイスに関する注意事項 |
| ethernetMacAddress | String | イーサネット MAC。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
| physicalMemoryInBytes | Int64 | 合計メモリ (バイト単位)。 このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。 |
応答
成功した場合、このメソッドは 201 Created 応答コードと、応答本文で managedDevice オブジェクトを返します。
例
要求
以下は、要求の例です。
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
}
応答
以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。
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
}
フィードバック
フィードバックの送信と表示