Schedule antivirus scans using Windows Management Instrumentation (WMI)
Applies to:
- Microsoft Defender XDR
- Microsoft Defender for Endpoint Plan 2
- [Microsoft Defender for Business
- Microsoft Defender for Endpoint Plan 1
- Microsoft Defender Antivirus
Platforms
- Windows
- Windows Server
This article describes how to configure scheduled scans using WMI. To learn more about scheduling scans and about scan types, see Configure scheduled quick or full Microsoft Defender Antivirus scans.
Use Windows Management Instruction (WMI) to schedule scans
Use the Set method of the MSFT_MpPreference class for the following properties:
ScanParameters
ScanScheduleDay
ScanScheduleTime
RandomizeScheduleTaskTimes
For more information and allowed parameters, see Windows Defender WMIv2 APIs
WMI for scheduling scans when an endpoint is not in use
Use the Set method of the MSFT_MpPreference class for the following properties:
ScanOnlyIfIdleEnabled
For more information about APIs and allowed parameters, see Windows Defender WMIv2 APIs.
Note
When you schedule scans for times when endpoints are not in use, scans do not honor the CPU throttling configuration and will take full advantage of the resources available to complete the scan as fast as possible.
WMI for scheduling scans to complete remediation
Use the Set method of the MSFT_MpPreference class for the following properties:
RemediationScheduleDay
RemediationScheduleTime
For more information and allowed parameters, see Windows Defender WMIv2 APIs.
WMI for scheduling daily scans
Use the Set method of the MSFT_MpPreference class for the following properties:
ScanScheduleQuickScanTime
For more information and allowed parameters, see Windows Defender WMIv2 APIs.
Tip
If you're looking for Antivirus related information for other platforms, see:
- Set preferences for Microsoft Defender for Endpoint on macOS
- Microsoft Defender for Endpoint on Mac
- macOS Antivirus policy settings for Microsoft Defender Antivirus for Intune
- Set preferences for Microsoft Defender for Endpoint on Linux
- Microsoft Defender for Endpoint on Linux
- Configure Defender for Endpoint on Android features
- Configure Microsoft Defender for Endpoint on iOS features
Tip
Do you want to learn more? Engage with the Microsoft Security community in our Tech Community: Microsoft Defender for Endpoint Tech Community.
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기