managedDevice リソース タイプ
名前空間: microsoft.graph
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
Intune 経由で管理または事前登録されるデバイス
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| List managedDevices | managedDevice コレクション | managedDevice オブジェクトのプロパティとリレーションシップをリストします。 |
| Get managedDevice | managedDevice | managedDevice オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Create managedDevice | managedDevice | 新しい managedDevice オブジェクトを作成します。 |
| Delete managedDevice | なし | managedDevice を削除します。 |
| Update managedDevice | managedDevice | managedDevice オブジェクトのプロパティを更新します。 |
| 廃止アクション|なし|デバイスの廃止| |ワイプ アクション|なし|デバイスをワイプする| |resetPasscode アクション|なし|パスコードのリセット| |remoteLock アクション|なし|リモート ロック| |requestRemoteAssistance アクション|なし|リモート アシスタンスを要求する| |disableLostMode アクション|なし|紛失モードを無効にする| |locateDevice アクション|なし|デバイスの検索| |bypassActivationLock アクション|なし|アクティブ化ロックをバイパスする| |rebootNow アクション|なし|デバイスの再起動| |shutDown アクション|なし|デバイスのシャットダウン| |recoverPasscode アクション|なし|パスコードの回復| |cleanWindowsDevice アクション|なし|Windows デバイスのクリーンアップ| |logoutSharedAppleDeviceActiveUser アクション|なし|共有 Apple デバイスのアクティブ ユーザーをログアウトする| |deleteUserFromSharedAppleDevice アクション|なし|共有 Apple デバイスからユーザーを削除する| |syncDevice アクション|None|||windowsDefenderScan アクション|None|||windowsDefenderUpdateSignatures アクション|None|||updateWindowsDeviceAccount アクション|None||
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| 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 でないことを示します。 このプロパティは読み取り専用です。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| deviceCategory | deviceCategory | デバイス カテゴリ |
| windowsProtectionState | windowsProtectionState | デバイス保護の状態。 このプロパティは読み取り専用です。 |
| users | user コレクション | マネージド デバイスに関連付けられているプライマリ ユーザー。 |
| logCollectionRequests | deviceLogCollectionResponse コレクション | ログ収集要求の一覧 |
JSON 表記
以下は、リソースの JSON 表記です。
{
"@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"
}