managedDevice の更新
名前空間: microsoft.graph
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
managedDevice オブジェクトのプロパティを更新します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | DeviceManagementManagedDevices.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | DeviceManagementManagedDevices.ReadWrite.All |
HTTP 要求
PATCH /deviceManagement/managedDevices/{managedDeviceId}
PATCH /deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}
PATCH /deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/users/{userId}/managedDevices/{managedDeviceId}
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
| 承諾 | application/json |
要求本文
要求本文で、managedDevice オブジェクトの JSON 表記を指定します。
次の表に、managedDevice の作成時に必要なプロパティを示します。
| プロパティ | 型 | 説明 |
|---|---|---|
| id | String | デバイスの一意識別子。 このプロパティは読み取り専用です。 |
| userId | String | デバイスに関連付けられているユーザーの一意識別子。 このプロパティは読み取り専用です。 |
| deviceName | String | デバイスの名前。 このプロパティは読み取り専用です。 |
| managedDeviceOwnerType | managedDeviceOwnerType | デバイスの所有権。 "会社" または "個人用" にすることができます。 可能な値は unknown、company、personal です。 |
| deviceActionResults | deviceActionResult コレクション | ComplexType deviceActionResult オブジェクトのリスト。 このプロパティは読み取り専用です。 |
| enrolledDateTime | DateTimeOffset | デバイスの登録時刻。 $filter演算子 'lt' と 'gt' をサポートします。 このプロパティは読み取り専用です。 |
| lastSyncDateTime | DateTimeOffset | デバイスが Intune との正常な同期を最終的に完了した日時。 $filter演算子 'lt' と 'gt' をサポートします。 このプロパティは読み取り専用です。 |
| operatingSystem | String | デバイスのオペレーティング システム。 Windows、iOS などこのプロパティは読み取り専用です。 |
| complianceState | complianceState | デバイスのコンプライアンス状態。 例: 準拠、競合、エラーなど既定値は不明です。 $filter演算子 'eq' と 'or' をサポートします。 このプロパティは読み取り専用です。 可能な値は、unknown、compliant、noncompliant、conflict、error、inGracePeriod、configManager です。 |
| jailBroken | String | デバイスが脱獄されているか、ルート化されているか。 既定値は空の文字列です。 $filter演算子 'eq' と 'or' をサポートします。 このプロパティは読み取り専用です。 |
| managementAgent | managementAgentType | デバイスの管理チャネル。 例: Intune、EAS など。既定値は不明です。 $filter演算子 'eq' と 'or' をサポートします。 このプロパティは読み取り専用です。 使用可能な値は、eas、mdm、easMdm、intuneClient、easIntuneClient、configurationManagerClient、configurationManagerClientMdm、configurationManagerClientMdmEas、unknown、jamf、googleCloudDevicePolicyController です。 |
| osVersion | String | デバイスのオペレーティング システムのバージョン。 このプロパティは読み取り専用です。 |
| easActivated | Boolean | Exchange ActiveSync がアクティブになっているデバイスかどうかを示します。 このプロパティは読み取り専用です。 |
| easDeviceId | String | デバイスの Exchange ActiveSync の ID。 このプロパティは読み取り専用です。 |
| easActivationDateTime | DateTimeOffset | デバイスの Exchange ActivationSync のアクティブ化の時刻。 このプロパティは読み取り専用です。 |
| azureADRegistered | Boolean | Azure Active Directory が登録されているデバイスかどうかを示します。 このプロパティは読み取り専用です。 |
| deviceEnrollmentType | deviceEnrollmentType | デバイスの登録の種類。 このプロパティは読み取り専用です。 可能な値は、unknown、userEnrollment、deviceEnrollmentManager、appleBulkWithUser、appleBulkWithoutUser、windowsAzureADJoin、windowsBulkUserless、windowsAutoEnrollment、windowsBulkAzureDomainJoin、windowsCoManagement、windowsAzureADJoinUsingDeviceAuth、appleUserEnrollment、appleUserEnrollmentWithServiceAccount です。 |
| activationLockBypassCode | String | マネージド デバイスのアクティブ化ロックをバイパスできるようにするコード。 LIST 呼び出しで managedDevice エンティティの一部として返される場合、このプロパティの既定値は Null (既定値以外のプロパティ) です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 サポート: $select。 $Searchはサポートされていません。 読み取り専用です。 このプロパティは読み取り専用です。 |
| emailAddress | String | デバイスに関連付けられているユーザーのEmail。 このプロパティは読み取り専用です。 |
| azureADDeviceId | String | Azure Active Directory デバイスの一意識別子。 読み取り専用です。 このプロパティは読み取り専用です。 |
| deviceRegistrationState | deviceRegistrationState | デバイスの登録状態。 このプロパティは読み取り専用です。 可能な値は、notRegistered、registered、revoked、keyConflict、approvalPending、certificateReset、notRegisteredPendingEnrollment、unknown です。 |
| deviceCategoryDisplayName | String | デバイス カテゴリの表示名。 既定値は空の文字列です。 $filter演算子 'eq' と 'or' をサポートします。 このプロパティは読み取り専用です。 |
| isSupervised | ブール型 | デバイス監視状態。 このプロパティは読み取り専用です。 |
| exchangeLastSuccessfulSyncDateTime | DateTimeOffset | 最後にデバイスが Exchange に接続した時刻。 このプロパティは読み取り専用です。 |
| exchangeAccessState | deviceManagementExchangeAccessState | Exchange でのデバイスのアクセスの状態。 このプロパティは読み取り専用です。 可能な値は、none、unknown、allowed、blocked、quarantined です。 |
| exchangeAccessStateReason | deviceManagementExchangeAccessStateReason | Exchange でのデバイスのアクセス状態の理由。
このプロパティは読み取り専用です。 可能な値は、none、unknown、exchangeGlobalRule、exchangeIndividualRule、exchangeDeviceRule、exchangeUpgrade、exchangeMailboxPolicy、other、compliant、notCompliant、notEnrolled、unknownLocation、mfaRequired、azureADBlockDueToAccessPolicy、compromisedPassword、deviceNotKnownWithManagedApp です。 |
| remoteAssistanceSessionUrl | String | デバイスとのリモート アシスタンス セッションを確立できるようにする URL。 既定値は空の文字列です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 このプロパティは読み取り専用です。 |
| remoteAssistanceSessionErrorDetails | String | リモート アシスタンス セッション オブジェクトの作成時に問題を識別するエラー文字列。 このプロパティは読み取り専用です。 |
| isEncrypted | ブール型 | デバイス暗号化の状態。 このプロパティは読み取り専用です。 |
| userPrincipalName | String | デバイス ユーザー プリンシパル名。 このプロパティは読み取り専用です。 |
| model | String | デバイスのモデル。 このプロパティは読み取り専用です。 |
| manufacturer | String | デバイスの製造元。 このプロパティは読み取り専用です。 |
| imei | String | IMEI。 このプロパティは読み取り専用です。 |
| complianceGracePeriodExpirationDateTime | DateTimeOffset | デバイス コンプライアンスの猶予期間の有効期限が切れる DateTime。 このプロパティは読み取り専用です。 |
| シリアル番号 | String | SerialNumber。 このプロパティは読み取り専用です。 |
| phoneNumber | String | デバイスの電話番号。 このプロパティは読み取り専用です。 |
| androidSecurityPatchLevel | String | Android セキュリティ パッチ レベル。 このプロパティは読み取り専用です。 |
| userDisplayName | String | ユーザー表示名。 このプロパティは読み取り専用です。 |
| configurationManagerClientEnabledFeatures | configurationManagerClientEnabledFeatures | ConfigrMgr クライアントが有効な機能。 このプロパティは読み取り専用です。 |
| wiFiMacAddress | String | MAC を Wi-Fi します。 このプロパティは読み取り専用です。 |
| deviceHealthAttestationState | deviceHealthAttestationState | デバイスの正常性構成証明の状態。 このプロパティは読み取り専用です。 |
| subscriberCarrier | String | サブスクライバーの通信事業者。 このプロパティは読み取り専用です。 |
| meid | String | MEID。 このプロパティは読み取り専用です。 |
| totalStorageSpaceInBytes | Int64 | ストレージの合計 (バイト単位)。 このプロパティは読み取り専用です。 |
| freeStorageSpaceInBytes | Int64 | Free Storage (バイト単位)。 既定値は 0 です。 読み取り専用です。 このプロパティは読み取り専用です。 |
| managedDeviceName | String | デバイスを識別する名前が自動的に生成されます。 ユーザー フレンドリ名に上書きできます。 |
| partnerReportedThreatState | managedDevicePartnerReportedHealthState | Mobile Threat Defense パートナーがアカウントおよびデバイスで使用されている場合の、デバイスの脅威の状態を示します。 読み取り専用です。 このプロパティは読み取り専用です。 可能な値は、unknown、activated、deactivated、secured、lowSeverity、mediumSeverity、highSeverity、unresponsive、compromised、misconfigured です。 |
| requireUserEnrollmentApproval | ブール型 | 管理対象の iOS デバイスがユーザー承認登録であるかどうかを報告します。 このプロパティは読み取り専用です。 |
| managementCertificateExpirationDate | DateTimeOffset | デバイス管理証明書の有効期限を報告します。 このプロパティは読み取り専用です。 |
| iccid | String | 集積回路カード識別子は、SIM カードの一意の識別番号です。 既定値は空の文字列です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 サポート: $select。 $Searchはサポートされていません。 読み取り専用です。 このプロパティは読み取り専用です。 |
| udid | String | iOS デバイスと macOS デバイスの一意のデバイス識別子。 既定値は空の文字列です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 サポート: $select。 $Searchはサポートされていません。 読み取り専用です。 このプロパティは読み取り専用です。 |
| notes | String | IT 管理によって作成されたデバイスに関するメモ。既定値は null です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 サポート: $select。 $Searchはサポートされていません。 |
| ethernetMacAddress | String | デバイスのイーサネット MAC アドレスを示します。 managedDevice エンティティの一部として返される場合、このプロパティの既定値は Null (既定値以外のプロパティ) です。 実際の値を取得するには、選択クエリ オプションを使用した個別の get 呼び出しが必要です。 例: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select。 $Searchはサポートされていません。 読み取り専用です。 このプロパティは読み取り専用です。 |
| physicalMemoryInBytes | Int64 | 合計メモリ (バイト単位)。 既定値は 0 です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 サポート: $select。 読み取り専用です。 このプロパティは読み取り専用です。 |
| enrollmentProfileName | String | デバイスに割り当てられた登録プロファイルの名前。 既定値は空の文字列で、登録プロファイルが assgined でないことを示します。 このプロパティは読み取り専用です。 |
応答
成功した場合、このメソッドは 200 OK 応答コードと、更新された managedDevice オブジェクトを応答本文で返します。
例
要求
以下は、要求の例です。
PATCH https://graph.microsoft.com/v1.0/deviceManagement/managedDevices/{managedDeviceId}
Content-type: application/json
Content-length: 5058
{
"@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",
"requireUserEnrollmentApproval": true,
"managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
"iccid": "Iccid value",
"udid": "Udid value",
"notes": "Notes value",
"ethernetMacAddress": "Ethernet Mac Address value",
"physicalMemoryInBytes": 5,
"enrollmentProfileName": "Enrollment Profile Name value"
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 5107
{
"@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",
"requireUserEnrollmentApproval": true,
"managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
"iccid": "Iccid value",
"udid": "Udid value",
"notes": "Notes value",
"ethernetMacAddress": "Ethernet Mac Address value",
"physicalMemoryInBytes": 5,
"enrollmentProfileName": "Enrollment Profile Name value"
}