Merge pull request #3584 from YongRhee-MSFT/docs-editor/schedule-antivirus-scans-power-1745624973

Update schedule-antivirus-scans-powershell.md

Author: aditisrivastava07

defender-endpoint/schedule-antivirus-scans-powershell.md

@@ -6,7 +6,7 @@ ms.localizationpriority: medium
 author: emmwalshh
 ms.author: ewalsh
 ms.custom: nextgen
-ms.date: 04/23/2025
+ms.date: 04/29/2025
 ms.reviewer: pauhijbr, ksarens
 manager: deniseb
 ms.subservice: ngp
@@ -30,7 +30,7 @@ search.appverid: met150
 - Windows
 - Windows Server
 
-This article describes how to configure scheduled scans using PowerShell cmdlets. To learn more about scheduling scans and about scan types, see [Configure scheduled quick or full Microsoft Defender Antivirus scans](schedule-antivirus-scans.md). 
+This article describes how to configure scheduled scans using PowerShell cmdlets. To learn more about scheduling scans and about scan types, see [Configure scheduled quick or full Microsoft Defender Antivirus scans](schedule-antivirus-scans.md).
 
 ## Use PowerShell cmdlets for scheduling daily quick scans
 
@@ -46,7 +46,6 @@ Set-MpPreference -ScanScheduleQuickScanTime
 
 For example, to set a daily quick scan run on the Windows clients at 12:00 PM. (720). In this example, we use lunch time, since many devices nowadays are turned off after-hours (For example, laptops and/or tablets).
 
-
 ```powershell
 Set-MpPreference -ScanScheduleQuickScanTime 720
 ```
@@ -58,9 +57,12 @@ Use the following cmdlets:
 ```PowerShell
 Set-MpPreference -ScanParameters
 Set-MpPreference -ScanScheduleDay
-Set-MpPreference -ScanScheduleTime
+Set-MpPreference -ScanScheduleOffset
 ```
 
+> [!TIP]
+> We recommend using the ScanScheduleOffset instead of ScanScheduleTime.
+
 -ScanParameters,  specifies the scan type to use during a scheduled scan. The acceptable values for this parameter are:
 
 1: Quick scan
@@ -91,17 +93,16 @@ Specifies the day of the week on which to perform a scheduled scan. Alternativel
 
 The default value is 8, never. If you specify a value of 8 or don't specify a value, Windows Defender doesn't perform scheduled scans.
 
--ScanScheduleTime
+-ScanScheduleOffset
 
-Specifies the time of day to run a scheduled scan. The time refers to the local time on the computer. Specify the number of minutes after midnight (for example, enter 60 for AM). This parameter has a default time of two hours after midnight (2 AM).
+This setting allows you to configure the number of minutes after midnight to perform a scheduled scan. The local time on the endpoint is used to determine when the scan occurs. If you enable this setting, the scheduled scan runs at the specified time. If you disable or don't enable this setting, the scheduled scan will default to running two hours (120 minutes) after midnight.
 
 For example, setting the weekly scheduled scan for a quick scan, that runs every Wednesday at 12:00 PM (lunch time)
 
-
 ```powershell
 Set-MpPreference -ScanParameters 1
 Set-MpPreference -ScanScheduleDay 4
-Set-MpPreference -ScanScheduleTime 720
+Set-MpPreference -ScanScheduleOffset 720
 ```
 
 > [!TIP]
@@ -124,8 +125,6 @@ Set-MpPreference -ScanScheduleTime 720
 
 For more information, see [Use PowerShell cmdlets to configure and run Microsoft Defender Antivirus](/editor/MicrosoftDocs/defender-docs-pr/defender-endpoint%2Fschedule-antivirus-scans-powershell.md/main/bcb7536e-34b9-8af7-5381-96c46d108a91/use-powershell-cmdlets-microsoft-defender-antivirus.md) and [Defender Antivirus cmdlets](/powershell/module/defender/).
 
-
-
 ## PowerShell cmdlets for scheduling scans to complete remediation
 
 Use the following cmdlets: