WindowsProtectionState を更新する

[アーティクル]
04/17/2024

名前空間: microsoft.graph

大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。

注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。

windowsProtectionState オブジェクトのプロパティを更新します。

この API は、次の国内クラウド展開で使用できます。

グローバルサービス	米国政府機関 L4	米国政府機関 L5 (DOD)	21Vianet が運営する中国
✅	✅	✅	✅

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All

HTTP 要求

PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/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`、、、`serviceStartedWithoutMalwareProtection`、`pendingFullScanDueToThreatAction`、、`pendingRebootDueToThreatAction`、`pendingManualStepsDueToThreatAction`、`avSignaturesOutOfDate`、`asSignaturesOutOfDate`、、`noQuickScanHappenedForSpecifiedPeriod`、`noFullScanHappenedForSpecifiedPeriod`、`productRunningInNonGenuineModeplatformUpdateInProgresssystemInitiatedCleanInProgressproductExpiredsystemInitiatedScanInProgressofflineScanRequiredsamplesPendingSubmissionproductRunningInEvaluationModenoStatusFlagsSetplatformOutOfDateserviceShutdownAsPartOfSystemShutdownthreatRemediationFailedCriticallythreatRemediationFailedNonCriticallyplatformAboutToBeOutdated`、 `windowsSModeSignaturesInUseOnNonWin10SInstallsignatureOrPlatformEndOfLifeIsPastOrIsImpending`です。 `serviceNotRunning`
isVirtualMachine	ブール型	TRUE がデバイスが仮想マシンであることを示す場合、FALSE はデバイスが仮想マシンではないことを示します。クライアントデバイスでの設定を既定値にします。
tamperProtectionEnabled	ブール型	TRUE の場合、Windows Defender改ざん防止機能が有効になっていることを示します。FALSE の場合は、Windows Defender改ざん防止機能が有効になっていないことが示されます。クライアントデバイスでの設定を既定値にします。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で更新された windowsProtectionState オブジェクトを返します。

例

要求

以下は、要求の例です。

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/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
}

次の方法で共有