deviceManagement の更新
名前空間: microsoft.graph
大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
deviceManagement オブジェクトのプロパティを更新します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All |
HTTP 要求
PATCH /deviceManagement
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
| 承諾 | application/json |
要求本文
要求本文で、deviceManagement オブジェクトの JSON 表記を指定します。
次の表に、deviceManagement の作成時に必要なプロパティを示します。
| プロパティ | 型 | 説明 |
|---|---|---|
| id | String | デバイスの一意識別子 |
| subscriptionState | deviceManagementSubscriptionState | テナントのモバイル デバイス管理のサブスクリプション状態。 可能な値は、pending、active、warning、disabled、deleted、blocked、lockedOut です。 |
| subscriptions | deviceManagementSubscriptions | テナントのサブスクリプション。 使用可能な値: none、intune、office365、intunePremium、intune_EDU、intune_SMB。 |
| managedDeviceCleanupSettings | managedDeviceCleanupSettings | デバイスクリーンアップルール |
| adminConsent | adminConsent | 同意情報を管理します。 |
| deviceProtectionOverview | deviceProtectionOverview | デバイス保護の概要。 |
| windowsMalwareOverview | windowsMalwareOverview | Windows デバイスのマルウェアの概要。 |
| accountMoveCompletionDateTime | DateTimeOffset | テナント データが scaleunit 間で移動した日時 & 日付。 |
| userExperienceAnalyticsSettings | userExperienceAnalyticsSettings | ユーザー エクスペリエンス分析デバイスの設定 |
| dataProcessorServiceForWindowsFeaturesOnboarding | dataProcessorServiceForWindowsFeaturesOnboarding | Windows 用データ プロセッサ サービス (DPSW) データを利用する MEM 機能の構成エンティティ。 |
| userExperienceAnalyticsAnomalySeverityOverview | userExperienceAnalyticsAnomalySeverityOverview | ユーザー エクスペリエンス分析の異常重大度の概要エンティティには、異常の重大度ごとのカウント情報が含まれています。 |
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文で更新された deviceManagement オブジェクトを返します。
例
要求
以下は、要求の例です。
PATCH https://graph.microsoft.com/beta/deviceManagement
Content-type: application/json
Content-length: 3833
{
"@odata.type": "#microsoft.graph.deviceManagement",
"subscriptionState": "active",
"subscriptions": "intune",
"managedDeviceCleanupSettings": {
"@odata.type": "microsoft.graph.managedDeviceCleanupSettings",
"deviceInactivityBeforeRetirementInDays": "Device Inactivity Before Retirement In Days value"
},
"adminConsent": {
"@odata.type": "microsoft.graph.adminConsent",
"shareAPNSData": "granted",
"shareUserExperienceAnalyticsData": "granted"
},
"deviceProtectionOverview": {
"@odata.type": "microsoft.graph.deviceProtectionOverview",
"totalReportedDeviceCount": 8,
"inactiveThreatAgentDeviceCount": 14,
"unknownStateThreatAgentDeviceCount": 2,
"pendingSignatureUpdateDeviceCount": 1,
"cleanDeviceCount": 0,
"pendingFullScanDeviceCount": 10,
"pendingRestartDeviceCount": 9,
"pendingManualStepsDeviceCount": 13,
"pendingOfflineScanDeviceCount": 13,
"criticalFailuresDeviceCount": 11,
"pendingQuickScanDeviceCount": 11
},
"windowsMalwareOverview": {
"@odata.type": "microsoft.graph.windowsMalwareOverview",
"malwareDetectedDeviceCount": 10,
"totalMalwareCount": 1,
"totalDistinctMalwareCount": 9,
"malwareStateSummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareStateCount",
"state": "actionFailed",
"deviceCount": 11,
"malwareDetectionCount": 5,
"distinctMalwareCount": 4,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"malwareSeveritySummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareSeverityCount",
"severity": "low",
"malwareDetectionCount": 5,
"distinctMalwareCount": 4,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"malwareExecutionStateSummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareExecutionStateCount",
"executionState": "blocked",
"deviceCount": 11,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"malwareCategorySummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareCategoryCount",
"category": "adware",
"deviceCount": 11,
"activeMalwareDetectionCount": 11,
"distinctActiveMalwareCount": 10,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"malwareNameSummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareNameCount",
"malwareIdentifier": "Malware Identifier value",
"name": "Name value",
"deviceCount": 11,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"osVersionsSummary": [
{
"@odata.type": "microsoft.graph.osVersionCount",
"osVersion": "Os Version value",
"deviceCount": 11,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
]
},
"accountMoveCompletionDateTime": "2017-01-01T00:01:17.9006709-08:00",
"userExperienceAnalyticsSettings": {
"@odata.type": "microsoft.graph.userExperienceAnalyticsSettings",
"configurationManagerDataConnectorConfigured": true
},
"dataProcessorServiceForWindowsFeaturesOnboarding": {
"@odata.type": "microsoft.graph.dataProcessorServiceForWindowsFeaturesOnboarding",
"hasValidWindowsLicense": true,
"areDataProcessorServiceForWindowsFeaturesEnabled": true
},
"userExperienceAnalyticsAnomalySeverityOverview": {
"@odata.type": "microsoft.graph.userExperienceAnalyticsAnomalySeverityOverview",
"lowSeverityAnomalyCount": 7,
"mediumSeverityAnomalyCount": 10,
"highSeverityAnomalyCount": 8,
"informationalSeverityAnomalyCount": 1
}
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 3882
{
"@odata.type": "#microsoft.graph.deviceManagement",
"id": "0b283420-3420-0b28-2034-280b2034280b",
"subscriptionState": "active",
"subscriptions": "intune",
"managedDeviceCleanupSettings": {
"@odata.type": "microsoft.graph.managedDeviceCleanupSettings",
"deviceInactivityBeforeRetirementInDays": "Device Inactivity Before Retirement In Days value"
},
"adminConsent": {
"@odata.type": "microsoft.graph.adminConsent",
"shareAPNSData": "granted",
"shareUserExperienceAnalyticsData": "granted"
},
"deviceProtectionOverview": {
"@odata.type": "microsoft.graph.deviceProtectionOverview",
"totalReportedDeviceCount": 8,
"inactiveThreatAgentDeviceCount": 14,
"unknownStateThreatAgentDeviceCount": 2,
"pendingSignatureUpdateDeviceCount": 1,
"cleanDeviceCount": 0,
"pendingFullScanDeviceCount": 10,
"pendingRestartDeviceCount": 9,
"pendingManualStepsDeviceCount": 13,
"pendingOfflineScanDeviceCount": 13,
"criticalFailuresDeviceCount": 11,
"pendingQuickScanDeviceCount": 11
},
"windowsMalwareOverview": {
"@odata.type": "microsoft.graph.windowsMalwareOverview",
"malwareDetectedDeviceCount": 10,
"totalMalwareCount": 1,
"totalDistinctMalwareCount": 9,
"malwareStateSummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareStateCount",
"state": "actionFailed",
"deviceCount": 11,
"malwareDetectionCount": 5,
"distinctMalwareCount": 4,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"malwareSeveritySummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareSeverityCount",
"severity": "low",
"malwareDetectionCount": 5,
"distinctMalwareCount": 4,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"malwareExecutionStateSummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareExecutionStateCount",
"executionState": "blocked",
"deviceCount": 11,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"malwareCategorySummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareCategoryCount",
"category": "adware",
"deviceCount": 11,
"activeMalwareDetectionCount": 11,
"distinctActiveMalwareCount": 10,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"malwareNameSummary": [
{
"@odata.type": "microsoft.graph.windowsMalwareNameCount",
"malwareIdentifier": "Malware Identifier value",
"name": "Name value",
"deviceCount": 11,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
],
"osVersionsSummary": [
{
"@odata.type": "microsoft.graph.osVersionCount",
"osVersion": "Os Version value",
"deviceCount": 11,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00"
}
]
},
"accountMoveCompletionDateTime": "2017-01-01T00:01:17.9006709-08:00",
"userExperienceAnalyticsSettings": {
"@odata.type": "microsoft.graph.userExperienceAnalyticsSettings",
"configurationManagerDataConnectorConfigured": true
},
"dataProcessorServiceForWindowsFeaturesOnboarding": {
"@odata.type": "microsoft.graph.dataProcessorServiceForWindowsFeaturesOnboarding",
"hasValidWindowsLicense": true,
"areDataProcessorServiceForWindowsFeaturesEnabled": true
},
"userExperienceAnalyticsAnomalySeverityOverview": {
"@odata.type": "microsoft.graph.userExperienceAnalyticsAnomalySeverityOverview",
"lowSeverityAnomalyCount": 7,
"mediumSeverityAnomalyCount": 10,
"highSeverityAnomalyCount": 8,
"informationalSeverityAnomalyCount": 1
}
}
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示