managedDevice の更新
名前空間: microsoft.graph
大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
managedDevice オブジェクトのプロパティを更新します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All |
HTTP 要求
PATCH /deviceManagement/managedDevices/{managedDeviceId}
PATCH /deviceManagement/comanagedDevices/{managedDeviceId}
PATCH /deviceManagement/deviceHealthScripts/{deviceHealthScriptId}/deviceRunStates/{deviceHealthScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceComplianceScripts/{deviceComplianceScriptId}/deviceRunStates/{deviceComplianceScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/managedDevices/{managedDeviceId}
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
| 承諾 | application/json |
要求本文
要求本文で、managedDevice オブジェクトの JSON 表記を指定します。
次の表に、managedDevice の作成時に必要なプロパティを示します。
| プロパティ | 型 | 説明 |
|---|---|---|
| id | String | デバイスの一意識別子。 このプロパティは読み取り専用です。 |
| userId | String | デバイスに関連付けられているユーザーの一意識別子。 このプロパティは読み取り専用です。 |
| deviceName | String | デバイスの名前。 このプロパティは読み取り専用です。 |
| hardwareInformation | hardwareInformation | デバイスの難しい詳細。 ストレージ領域、製造元、シリアル番号などの情報が含まれます。既定では、この型のほとんどのプロパティは null/0/false に設定され、列挙型の既定値は関連付けられている型です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 サポート: $select。 $Search はサポートされていません。 読み取り専用です。 このプロパティは読み取り専用です。 |
| ownerType | ownerType | デバイスの所有権。 使用可能な値は、'company' または 'personal' です。 既定値は不明です。 $filter演算子 'eq' と 'or' をサポートします。 可能な値は unknown、company、personal です。 |
| managedDeviceOwnerType | managedDeviceOwnerType | デバイスの所有権。 "会社" または "個人用" にすることができます。 可能な値は unknown、company、personal です。 |
| deviceActionResults | deviceActionResult コレクション | ComplexType deviceActionResult オブジェクトのリスト。 このプロパティは読み取り専用です。 |
| managementState | managementState | デバイスの管理状態。 例: Managed、RetirePending など。既定値はマネージドです。 $filter演算子 'eq' と 'or' をサポートします。 このプロパティは読み取り専用です。 可能な値は、managed、retirePending、retireFailed、wipePending、wipeFailed、unhealthy、deletePending、retireIssued、wipeIssued、wipeCanceled、retireCanceled、discovered です。 |
| enrolledDateTime | DateTimeOffset | デバイスの登録時刻。 $filter演算子 'lt' と 'gt' をサポートします。 このプロパティは読み取り専用です。 |
| lastSyncDateTime | DateTimeOffset | デバイスが Intune との正常な同期を最終的に完了した日時。 $filter演算子 'lt' と 'gt' をサポートします。 このプロパティは読み取り専用です。 |
| chassisType | chassisType | デバイスのシャーシの種類。 このプロパティは読み取り専用です。 可能な値は、unknown、desktop、laptop、worksWorkstation、enterpriseServer、phone、tablet、mobileOther、mobileUnknown です。 |
| operatingSystem | String | デバイスのオペレーティング システム。 Windows、iOS などこのプロパティは読み取り専用です。 |
| deviceType | deviceType | デバイスのプラットフォーム。 例: デスクトップ、WindowsRT など既定値は不明です。 $filter演算子 'eq' と 'or' をサポートします。 このプロパティは読み取り専用です。 使用できる値は、windowsRTdesktop、winMO6、nokia、、windowsPhone、mac、、winCE、、winEmbeddediPhone、iPad、iSocConsumerwindows10xunixmacMDMandroidholoLensiPodsurfaceHubandroidForWorkblackberrylinuxpalmandroidnGMSchromeOSandroidEnterprise、 unknowncloudPCです。 |
| 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、microsoft365ManagedMdm、msSense、intuneAosp、google、unknownFutureValue です。 |
| osVersion | String | デバイスのオペレーティング システムのバージョン。 このプロパティは読み取り専用です。 |
| easActivated | Boolean | Exchange ActiveSync がアクティブになっているデバイスかどうかを示します。 このプロパティは読み取り専用です。 |
| easDeviceId | String | デバイスの Exchange ActiveSync の ID。 このプロパティは読み取り専用です。 |
| easActivationDateTime | DateTimeOffset | デバイスの Exchange ActivationSync のアクティブ化の時刻。 このプロパティは読み取り専用です。 |
| aadRegistered | ブール型 | Azure Active Directory が登録されているデバイスかどうかを示します。 このプロパティは読み取り専用です。 |
| azureADRegistered | Boolean | Azure Active Directory が登録されているデバイスかどうかを示します。 このプロパティは読み取り専用です。 |
| deviceEnrollmentType | deviceEnrollmentType | デバイスの登録の種類。 このプロパティは読み取り専用です。 使用可能な値は、unknownappleBulkWithUseruserEnrollmentdeviceEnrollmentManager、、appleBulkWithoutUser、windowsBulkUserlesswindowsAzureADJoin、、windowsAutoEnrollment、、windowsBulkAzureDomainJoinappleUserEnrollmentappleUserEnrollmentWithServiceAccountwindowsAzureADJoinUsingDeviceAuthazureAdJoinUsingAzureVmExtensionappleACMEBasicBYODandroidEnterpriseFullyManagedandroidEnterpriseDedicatedDevicewindowsCoManagementappleACMEDEPUserlessappleACMEDEPUDACompanyPortalandroidEnterpriseCorporateWorkProfile、 appleACMEDEPUDASetupAsstLegacyです。 appleACMEDEPUDAModernAuth |
| lostModeState | lostModeState | 失われたモードが有効か無効か示します。 このプロパティは読み取り専用です。 可能な値は、disabled、enabled です。 |
| activationLockBypassCode | String | マネージド デバイスのアクティブ化ロックをバイパスできるようにするコード。 LIST 呼び出しで managedDevice エンティティの一部として返される場合、このプロパティの既定値は Null (既定値以外のプロパティ) です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 サポート: $select。 $Search はサポートされていません。 読み取り専用です。 このプロパティは読み取り専用です。 |
| emailAddress | String | デバイスに関連付けられているユーザーのEmail。 このプロパティは読み取り専用です。 |
| azureActiveDirectoryDeviceId | String | Azure Active Directory デバイスの一意識別子。 読み取り専用です。 このプロパティは読み取り専用です。 |
| 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 です。 |
| retireAfterDateTime | DateTimeOffset | スケジュールされたアクションのためにデバイスが自動廃止される時刻を示します。 このプロパティは読み取り専用です。 |
| usersLoggedOn | loggedOnUser コレクション | デバイスの最後にログオンしたユーザーを示します。 このプロパティは読み取り専用です。 |
| preferMdmOverGroupPolicyAppliedDateTime | DateTimeOffset | preferMdmOverGroupPolicy 設定が設定された DateTime を報告します。 設定すると、Intune MDM 設定は、競合が発生した場合グループ ポリシー設定をオーバーライドします。 読み取り専用です。 このプロパティは読み取り専用です。 |
| autopilotEnrolled | ブール型 | マネージド デバイスが自動パイロット経由で登録されているかどうかを報告します。 このプロパティは読み取り専用です。 |
| requireUserEnrollmentApproval | ブール型 | 管理対象の iOS デバイスがユーザー承認登録であるかどうかを報告します。 このプロパティは読み取り専用です。 |
| managementCertificateExpirationDate | DateTimeOffset | デバイス管理証明書の有効期限を報告します。 このプロパティは読み取り専用です。 |
| iccid | String | 集積回路カード識別子は、SIM カードの一意の識別番号です。 既定値は空の文字列です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 サポート: $select。 $Search はサポートされていません。 読み取り専用です。 このプロパティは読み取り専用です。 |
| Udid | String | iOS デバイスと macOS デバイスの一意のデバイス識別子。 既定値は空の文字列です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 サポート: $select。 $Search はサポートされていません。 読み取り専用です。 このプロパティは読み取り専用です。 |
| roleScopeTagIds | String collection | このデバイス インスタンスのスコープ タグ ID の一覧。 |
| windowsActiveMalwareCount | Int32 | この Windows デバイスのアクティブなマルウェアの数。 既定値は 0 です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 このプロパティは読み取り専用です。 |
| windowsRemediatedMalwareCount | Int32 | この Windows デバイスの修復されたマルウェアの数。 既定値は 0 です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 このプロパティは読み取り専用です。 |
| notes | String | IT 管理によって作成されたデバイスに関するメモ。既定値は null です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 サポート: $select。 $Search はサポートされていません。 |
| configurationManagerClientHealthState | configurationManagerClientHealthState | 構成マネージャー クライアントの正常性状態。MDM/ConfigMgr エージェントによって管理されるデバイスに対してのみ有効です |
| configurationManagerClientInformation | configurationManagerClientInformation | Configuration Manager クライアント情報。ConfigMgr エージェントによって管理、決闘管理、またはトライマネージドのデバイスに対してのみ有効 |
| ethernetMacAddress | String | デバイスのイーサネット MAC アドレスを示します。 managedDevice エンティティの一部として返される場合、このプロパティの既定値は Null (既定値以外のプロパティ) です。 実際の値を取得するには、選択クエリ オプションを使用した個別の get 呼び出しが必要です。 例: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select。 $Search はサポートされていません。 読み取り専用です。 このプロパティは読み取り専用です。 |
| physicalMemoryInBytes | Int64 | 合計メモリ (バイト単位)。 既定値は 0 です。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 サポート: $select。 読み取り専用。 このプロパティは読み取り専用です。 |
| processorArchitecture | managedDeviceArchitecture | プロセッサ アーキテクチャ。 このプロパティは読み取り専用です。 可能な値は、unknown、x86、x64、arm、arM64 です。 |
| specificationVersion | String | 仕様バージョン。 このプロパティは読み取り専用です。 |
| joinType | joinType | デバイス参加の種類。 使用可能な値: unknown、azureADJoined、azureADRegistered、hybridAzureADJoined。 |
| skuFamily | String | デバイス SKU ファミリ |
| securityPatchLevel | String | これは、オペレーティング システムのセキュリティ パッチ レベルを示します。 これらの特別な更新プログラムには、重要なセキュリティ修正プログラムが含まれています。 iOS/MacOS の場合、それらは (a) 形式です。 アンドロイドのために2017-08-07形式で。 このプロパティは読み取り専用です。 |
| skuNumber | Int32 | デバイス SKU 番号については、「」も https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo参照してください。 有効な値 0 ~ 2147483647。 このプロパティは読み取り専用です。 |
| managementFeatures | managedDeviceManagementFeatures | デバイス管理機能。 可能な値は、none、microsoftManagedDesktop です。 |
| chromeOSDeviceInfo | chromeOSDeviceProperty コレクション | ChromeOS デバイスのプロパティの一覧。 既定値は空のリストです。 実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。 |
| enrollmentProfileName | String | デバイスに割り当てられた登録プロファイルの名前。 既定値は空の文字列で、登録プロファイルが assgined でないことを示します。 このプロパティは読み取り専用です。 |
| bootstrapTokenEscrowed | ブール型 | マネージド デバイスにエスクローされたブートストラップ トークンがあるかどうかを報告します。 これは macOS デバイス専用です。 取得するには、select 句に BootstrapTokenEscrowed を含め、デバイス ID を使用してクエリを実行します。FALSE の場合、ブートストラップ トークンはエスクローされません。 TRUE の場合、デバイスは、Intuneを使用してブートストラップ トークンをエスクローしました。 このプロパティは読み取り専用です。 |
| deviceFirmwareConfigurationInterfaceManaged | ブール型 | デバイスが DFCI で管理されているかどうかを示します。 TRUE の場合、デバイスは DFCI で管理されます。 FALSE の場合、デバイスは DFCI 管理されません。 既定値は FALSE です。 |
| deviceIdentityAttestationDetail | deviceIdentityAttestationDetail | マネージド デバイスの構成証明の状態を示します。 そして、どちらの方法で。 既定値: 不明。 |
応答
成功した場合、このメソッドは 200 OK 応答コードと、更新された managedDevice オブジェクトを応答本文で返します。
例
要求
以下は、要求の例です。
PATCH https://graph.microsoft.com/beta/deviceManagement/managedDevices/{managedDeviceId}
Content-type: application/json
Content-length: 9620
{
"@odata.type": "#microsoft.graph.managedDevice",
"userId": "User Id value",
"deviceName": "Device Name value",
"hardwareInformation": {
"@odata.type": "microsoft.graph.hardwareInformation",
"serialNumber": "Serial Number value",
"totalStorageSpace": 1,
"freeStorageSpace": 0,
"imei": "Imei value",
"meid": "Meid value",
"manufacturer": "Manufacturer value",
"model": "Model value",
"phoneNumber": "Phone Number value",
"subscriberCarrier": "Subscriber Carrier value",
"cellularTechnology": "Cellular Technology value",
"wifiMac": "Wifi Mac value",
"operatingSystemLanguage": "Operating System Language value",
"isSupervised": true,
"isEncrypted": true,
"batterySerialNumber": "Battery Serial Number value",
"batteryHealthPercentage": 7,
"batteryChargeCycles": 3,
"isSharedDevice": true,
"sharedDeviceCachedUsers": [
{
"@odata.type": "microsoft.graph.sharedAppleDeviceUser",
"userPrincipalName": "User Principal Name value",
"dataToSync": true,
"dataQuota": 9,
"dataUsed": 8
}
],
"tpmSpecificationVersion": "Tpm Specification Version value",
"operatingSystemEdition": "Operating System Edition value",
"deviceFullQualifiedDomainName": "Device Full Qualified Domain Name value",
"deviceGuardVirtualizationBasedSecurityHardwareRequirementState": "secureBootRequired",
"deviceGuardVirtualizationBasedSecurityState": "rebootRequired",
"deviceGuardLocalSystemAuthorityCredentialGuardState": "rebootRequired",
"osBuildNumber": "Os Build Number value",
"operatingSystemProductType": 10,
"ipAddressV4": "Ip Address V4 value",
"subnetAddress": "Subnet Address value",
"esimIdentifier": "Esim Identifier value",
"systemManagementBIOSVersion": "System Management BIOSVersion value",
"tpmManufacturer": "Tpm Manufacturer value",
"tpmVersion": "Tpm Version value",
"wiredIPv4Addresses": [
"Wired IPv4Addresses value"
],
"batteryLevelPercentage": 7.333333333333333,
"residentUsersCount": 2,
"productName": "Product Name value",
"deviceLicensingStatus": "licenseRefreshPending",
"deviceLicensingLastErrorCode": 12,
"deviceLicensingLastErrorDescription": "Device Licensing Last Error Description value"
},
"ownerType": "company",
"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"
}
],
"managementState": "retirePending",
"enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
"chassisType": "desktop",
"operatingSystem": "Operating System value",
"deviceType": "windowsRT",
"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",
"aadRegistered": true,
"azureADRegistered": true,
"deviceEnrollmentType": "userEnrollment",
"lostModeState": "enabled",
"activationLockBypassCode": "Activation Lock Bypass Code value",
"emailAddress": "Email Address value",
"azureActiveDirectoryDeviceId": "Azure Active Directory Device Id 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,
"endpointProtection": true,
"officeApps": 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",
"memoryIntegrityProtection": "enabled",
"memoryAccessProtection": "enabled",
"virtualizationBasedSecurity": "enabled",
"firmwareProtection": "systemGuardSecureLaunch",
"systemManagementMode": "level1",
"securedCorePC": "enabled"
},
"subscriberCarrier": "Subscriber Carrier value",
"meid": "Meid value",
"totalStorageSpaceInBytes": 8,
"freeStorageSpaceInBytes": 7,
"managedDeviceName": "Managed Device Name value",
"partnerReportedThreatState": "activated",
"retireAfterDateTime": "2016-12-31T23:57:37.576134-08:00",
"usersLoggedOn": [
{
"@odata.type": "microsoft.graph.loggedOnUser",
"userId": "User Id value",
"lastLogOnDateTime": "2016-12-31T23:58:37.4262708-08:00"
}
],
"preferMdmOverGroupPolicyAppliedDateTime": "2016-12-31T23:57:34.4649887-08:00",
"autopilotEnrolled": true,
"requireUserEnrollmentApproval": true,
"managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
"iccid": "Iccid value",
"udid": "Udid value",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"windowsActiveMalwareCount": 9,
"windowsRemediatedMalwareCount": 13,
"notes": "Notes value",
"configurationManagerClientHealthState": {
"@odata.type": "microsoft.graph.configurationManagerClientHealthState",
"state": "installed",
"errorCode": 9,
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00"
},
"configurationManagerClientInformation": {
"@odata.type": "microsoft.graph.configurationManagerClientInformation",
"clientIdentifier": "Client Identifier value",
"isBlocked": true,
"clientVersion": "Client Version value"
},
"ethernetMacAddress": "Ethernet Mac Address value",
"physicalMemoryInBytes": 5,
"processorArchitecture": "x86",
"specificationVersion": "Specification Version value",
"joinType": "azureADJoined",
"skuFamily": "Sku Family value",
"securityPatchLevel": "Security Patch Level value",
"skuNumber": 9,
"managementFeatures": "microsoftManagedDesktop",
"chromeOSDeviceInfo": [
{
"@odata.type": "microsoft.graph.chromeOSDeviceProperty",
"name": "Name value",
"value": "Value value",
"valueType": "Value Type value",
"updatable": true
}
],
"enrollmentProfileName": "Enrollment Profile Name value",
"bootstrapTokenEscrowed": true,
"deviceFirmwareConfigurationInterfaceManaged": true,
"deviceIdentityAttestationDetail": {
"@odata.type": "microsoft.graph.deviceIdentityAttestationDetail",
"deviceIdentityAttestationStatus": "trusted"
}
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 9669
{
"@odata.type": "#microsoft.graph.managedDevice",
"id": "705c034c-034c-705c-4c03-5c704c035c70",
"userId": "User Id value",
"deviceName": "Device Name value",
"hardwareInformation": {
"@odata.type": "microsoft.graph.hardwareInformation",
"serialNumber": "Serial Number value",
"totalStorageSpace": 1,
"freeStorageSpace": 0,
"imei": "Imei value",
"meid": "Meid value",
"manufacturer": "Manufacturer value",
"model": "Model value",
"phoneNumber": "Phone Number value",
"subscriberCarrier": "Subscriber Carrier value",
"cellularTechnology": "Cellular Technology value",
"wifiMac": "Wifi Mac value",
"operatingSystemLanguage": "Operating System Language value",
"isSupervised": true,
"isEncrypted": true,
"batterySerialNumber": "Battery Serial Number value",
"batteryHealthPercentage": 7,
"batteryChargeCycles": 3,
"isSharedDevice": true,
"sharedDeviceCachedUsers": [
{
"@odata.type": "microsoft.graph.sharedAppleDeviceUser",
"userPrincipalName": "User Principal Name value",
"dataToSync": true,
"dataQuota": 9,
"dataUsed": 8
}
],
"tpmSpecificationVersion": "Tpm Specification Version value",
"operatingSystemEdition": "Operating System Edition value",
"deviceFullQualifiedDomainName": "Device Full Qualified Domain Name value",
"deviceGuardVirtualizationBasedSecurityHardwareRequirementState": "secureBootRequired",
"deviceGuardVirtualizationBasedSecurityState": "rebootRequired",
"deviceGuardLocalSystemAuthorityCredentialGuardState": "rebootRequired",
"osBuildNumber": "Os Build Number value",
"operatingSystemProductType": 10,
"ipAddressV4": "Ip Address V4 value",
"subnetAddress": "Subnet Address value",
"esimIdentifier": "Esim Identifier value",
"systemManagementBIOSVersion": "System Management BIOSVersion value",
"tpmManufacturer": "Tpm Manufacturer value",
"tpmVersion": "Tpm Version value",
"wiredIPv4Addresses": [
"Wired IPv4Addresses value"
],
"batteryLevelPercentage": 7.333333333333333,
"residentUsersCount": 2,
"productName": "Product Name value",
"deviceLicensingStatus": "licenseRefreshPending",
"deviceLicensingLastErrorCode": 12,
"deviceLicensingLastErrorDescription": "Device Licensing Last Error Description value"
},
"ownerType": "company",
"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"
}
],
"managementState": "retirePending",
"enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
"chassisType": "desktop",
"operatingSystem": "Operating System value",
"deviceType": "windowsRT",
"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",
"aadRegistered": true,
"azureADRegistered": true,
"deviceEnrollmentType": "userEnrollment",
"lostModeState": "enabled",
"activationLockBypassCode": "Activation Lock Bypass Code value",
"emailAddress": "Email Address value",
"azureActiveDirectoryDeviceId": "Azure Active Directory Device Id 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,
"endpointProtection": true,
"officeApps": 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",
"memoryIntegrityProtection": "enabled",
"memoryAccessProtection": "enabled",
"virtualizationBasedSecurity": "enabled",
"firmwareProtection": "systemGuardSecureLaunch",
"systemManagementMode": "level1",
"securedCorePC": "enabled"
},
"subscriberCarrier": "Subscriber Carrier value",
"meid": "Meid value",
"totalStorageSpaceInBytes": 8,
"freeStorageSpaceInBytes": 7,
"managedDeviceName": "Managed Device Name value",
"partnerReportedThreatState": "activated",
"retireAfterDateTime": "2016-12-31T23:57:37.576134-08:00",
"usersLoggedOn": [
{
"@odata.type": "microsoft.graph.loggedOnUser",
"userId": "User Id value",
"lastLogOnDateTime": "2016-12-31T23:58:37.4262708-08:00"
}
],
"preferMdmOverGroupPolicyAppliedDateTime": "2016-12-31T23:57:34.4649887-08:00",
"autopilotEnrolled": true,
"requireUserEnrollmentApproval": true,
"managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
"iccid": "Iccid value",
"udid": "Udid value",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"windowsActiveMalwareCount": 9,
"windowsRemediatedMalwareCount": 13,
"notes": "Notes value",
"configurationManagerClientHealthState": {
"@odata.type": "microsoft.graph.configurationManagerClientHealthState",
"state": "installed",
"errorCode": 9,
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00"
},
"configurationManagerClientInformation": {
"@odata.type": "microsoft.graph.configurationManagerClientInformation",
"clientIdentifier": "Client Identifier value",
"isBlocked": true,
"clientVersion": "Client Version value"
},
"ethernetMacAddress": "Ethernet Mac Address value",
"physicalMemoryInBytes": 5,
"processorArchitecture": "x86",
"specificationVersion": "Specification Version value",
"joinType": "azureADJoined",
"skuFamily": "Sku Family value",
"securityPatchLevel": "Security Patch Level value",
"skuNumber": 9,
"managementFeatures": "microsoftManagedDesktop",
"chromeOSDeviceInfo": [
{
"@odata.type": "microsoft.graph.chromeOSDeviceProperty",
"name": "Name value",
"value": "Value value",
"valueType": "Value Type value",
"updatable": true
}
],
"enrollmentProfileName": "Enrollment Profile Name value",
"bootstrapTokenEscrowed": true,
"deviceFirmwareConfigurationInterfaceManaged": true,
"deviceIdentityAttestationDetail": {
"@odata.type": "microsoft.graph.deviceIdentityAttestationDetail",
"deviceIdentityAttestationStatus": "trusted"
}
}
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示