WindowsProtectionState を更新する
名前空間: microsoft.graph
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
windowsProtectionState オブジェクトのプロパティを更新します。
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | DeviceManagementManagedDevices.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | DeviceManagementManagedDevices.ReadWrite.All |
HTTP 要求
PATCH /deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/windowsProtectionState
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
| 承諾 | application/json |
要求本文
要求本文で、 windowsProtectionState オブジェクトの JSON 表現を指定します。
次の表は、 windowsProtectionState を作成するときに必要なプロパティを示しています。
| プロパティ | 型 | 説明 |
|---|---|---|
| id | String | デバイス保護状態オブジェクトの一意の識別子。 これはデバイスのデバイス ID です |
| malwareProtectionEnabled | ブール型 | FALSE がマルウェア対策が有効になっていない場合、TRUE がマルウェア対策が有効であることを示す場合。 |
| deviceState | windowsDeviceHealthState | デバイスの正常性状態を示します。 使用可能な値は、クリーン、fullScanPending、rebootPending、manualStepsPending、offlineScanPending、critical です。 使用可能な値: clean、fullScanPending、rebootPending、manualStepsPending、offlineScanPending、critical。 |
| realTimeProtectionEnabled | ブール型 | TRUE がリアルタイム保護が有効であることを示す場合、FALSE がリアルタイム保護が有効になっていない場合。 クライアント デバイスでの設定を既定値にします。 |
| networkInspectionSystemEnabled | ブール型 | TRUE がネットワーク検査システムが有効であることを示す場合、FALSE の場合はネットワーク検査システムが有効になっていないことが示されます。 クライアント デバイスでの設定を既定値にします。 |
| quickScanOverdue | ブール型 | TRUE がクイック スキャンが期限切れであることを示す場合、FALSE はクイック スキャンが期限切れではないことを示します。 クライアント デバイスでの設定を既定値にします。 |
| fullScanOverdue | ブール型 | TRUE が完全スキャンが期限切れであることを示す場合、FALSE は完全スキャンが期限切れではないことを示します。 クライアント デバイスでの設定を既定値にします。 |
| signatureUpdateOverdue | ブール型 | TRUE が署名が古くなっている場合、FALSE が署名が古いではないことを示す場合。 クライアント デバイスでの設定を既定値にします。 |
| rebootRequired | ブール型 | TRUE が再起動が必要であることを示す場合、FALSE は再起動が必要ないことを示す TRUE を示します。 クライアント デバイスでの設定を既定値にします。 |
| fullScanRequired | ブール型 | TRUE がフル スキャンが必要であることを示す場合、FALSE はフル スキャンが必要ないことを示します。 クライアント デバイスでの設定を既定値にします。 |
| engineVersion | String | 現在のエンドポイント保護エンジンのバージョン |
| signatureVersion | String | 現在のマルウェア定義のバージョン |
| antiMalwareVersion | String | 現在のマルウェア対策バージョン |
| lastQuickScanDateTime | DateTimeOffset | 前回のクイック スキャン日時 |
| lastFullScanDateTime | DateTimeOffset | 前回のクイック スキャン日時 |
| lastQuickScanSignatureVersion | String | 前回のクイック スキャン署名バージョン |
| lastFullScanSignatureVersion | String | 最終フル スキャン署名バージョン |
| lastReportedDateTime | DateTimeOffset | 前回デバイスの正常性状態が報告された時刻 |
| productStatus | windowsDefenderProductStatus | Windows Defender ウイルス対策の製品の状態。 指定できる値は、noStatus、serviceNotRunning、serviceStartedWithoutMalwareProtection、pendingFullScanDueToThreatAction、pendingRebootDueToThreatAction、 pendingManualStepsDueToThreatAction, avSignaturesOutOfDate, asSignaturesOutOfDate, noQuickScanHappenedForSpecifiedPeriod, noFullScanHappenedForSpecifiedPeriod, systemInitiatedScanInProgress, systemInitiatedCleanInProgress, samplesPendingSubmission, productRunningInEvaluationMode, productRunningInEvaluationMode, productRunningInEvaluationMode, productRunningInNonGenuineMode、productExpired、offlineScanRequired、serviceShutdownAsPartOfSystemShutdown、threatRemediationFailedCritically、threatRemediationFailedNonCritically、noStatusFlagsSet、platformOutOfDate、platformUpdateInProgress、platformAboutToBeOutdated、signatureOrPlatformEndOfLifeIsPastOrIsImpending、windowsSModeSignaturesInUseOnWin10SInstall。 使用可能な値: noStatus、 serviceNotRunning、 serviceStartedWithoutMalwareProtection、 pendingFullScanDueToThreatAction、 pendingRebootDueToThreatAction、 pendingManualStepsDueToThreatAction、 avSignaturesOutOfDate、 asSignaturesOutOfDate、 noQuickScanHappenedForSpecifiedPeriod、 noFullScanHappenedForSpecifiedPeriod、 systemInitiatedScanInProgress、 systemInitiatedCleanInProgress、 samplesPendingSubmissionproductRunningInEvaluationMode、 productRunningInNonGenuineMode、 productExpired、 offlineScanRequired、 serviceShutdownAsPartOfSystemShutdown、 threatRemediationFailedCritically、 threatRemediationFailedNonCritically、 noStatusFlagsSet、 platformOutOfDate、 platformUpdateInProgress、 platformAboutToBeOutdated、 signatureOrPlatformEndOfLifeIsPastOrIsImpending、 windowsSModeSignaturesInUseOnNonWin10SInstall。 |
| isVirtualMachine | ブール型 | TRUE がデバイスが仮想マシンであることを示す場合、FALSE はデバイスが仮想マシンではないことを示します。 クライアント デバイスでの設定を既定値にします。 |
| tamperProtectionEnabled | ブール型 | TRUE の場合、Windows Defender 改ざん防止機能が有効になっていることを示し、FALSE の場合は Windows Defender 改ざん防止機能が有効になっていないことが示されます。 クライアント デバイスでの設定を既定値にします。 |
応答
成功した場合、このメソッドは応答コード 200 OK と、応答本文で更新された windowsProtectionState オブジェクトを返します。
例
要求
以下は、要求の例です。
PATCH https://graph.microsoft.com/v1.0/deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/windowsProtectionState
Content-type: application/json
Content-length: 971
{
"@odata.type": "#microsoft.graph.windowsProtectionState",
"malwareProtectionEnabled": true,
"deviceState": "fullScanPending",
"realTimeProtectionEnabled": true,
"networkInspectionSystemEnabled": true,
"quickScanOverdue": true,
"fullScanOverdue": true,
"signatureUpdateOverdue": true,
"rebootRequired": true,
"fullScanRequired": true,
"engineVersion": "Engine Version value",
"signatureVersion": "Signature Version value",
"antiMalwareVersion": "Anti Malware Version value",
"lastQuickScanDateTime": "2016-12-31T23:58:27.5900669-08:00",
"lastFullScanDateTime": "2017-01-01T00:01:44.9405639-08:00",
"lastQuickScanSignatureVersion": "Last Quick Scan Signature Version value",
"lastFullScanSignatureVersion": "Last Full Scan Signature Version value",
"lastReportedDateTime": "2017-01-01T00:00:17.7769392-08:00",
"productStatus": "serviceNotRunning",
"isVirtualMachine": true,
"tamperProtectionEnabled": true
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1020
{
"@odata.type": "#microsoft.graph.windowsProtectionState",
"id": "1ac6ea5a-ea5a-1ac6-5aea-c61a5aeac61a",
"malwareProtectionEnabled": true,
"deviceState": "fullScanPending",
"realTimeProtectionEnabled": true,
"networkInspectionSystemEnabled": true,
"quickScanOverdue": true,
"fullScanOverdue": true,
"signatureUpdateOverdue": true,
"rebootRequired": true,
"fullScanRequired": true,
"engineVersion": "Engine Version value",
"signatureVersion": "Signature Version value",
"antiMalwareVersion": "Anti Malware Version value",
"lastQuickScanDateTime": "2016-12-31T23:58:27.5900669-08:00",
"lastFullScanDateTime": "2017-01-01T00:01:44.9405639-08:00",
"lastQuickScanSignatureVersion": "Last Quick Scan Signature Version value",
"lastFullScanSignatureVersion": "Last Full Scan Signature Version value",
"lastReportedDateTime": "2017-01-01T00:00:17.7769392-08:00",
"productStatus": "serviceNotRunning",
"isVirtualMachine": true,
"tamperProtectionEnabled": true
}