Merge pull request MicrosoftDocs#2518 from MicrosoftDocs/master

docset/winserver2019-ps/defender/Set-MpPreference.md

Author: garycentric

docset/winserver2019-ps/defender/Set-MpPreference.md

@@ -2,7 +2,7 @@
 description: Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
 external help file: MSFT_MpPreference.cdxml-help.xml
 Module Name: Defender
-ms.date: 06/10/2021
+ms.date: 06/23/2021
 online version: https://docs.microsoft.com/powershell/module/defender/set-mppreference?view=windowsserver2019-ps&wt.mc_id=ps-gethelp
 schema: 2.0.0
 title: Set-MpPreference
@@ -41,7 +41,7 @@ Set-MpPreference [-ExclusionPath <String[]>] [-ExclusionExtension <String[]>] [-
  [-LowThreatDefaultAction <ThreatAction>] [-ModerateThreatDefaultAction <ThreatAction>]
  [-HighThreatDefaultAction <ThreatAction>] [-SevereThreatDefaultAction <ThreatAction>] [-Force]
  [-DisableBlockAtFirstSeen <Boolean>] [-PUAProtection <PUAProtectionType>] [-CimSession <CimSession[]>]
- [-ThrottleLimit <Int32>] [-AsJob]  [<CommonParameters>]
+ [-ThrottleLimit <Int32>] [-AsJob]  [<CommonParameters>]  [-DisableGradualRelease <Boolean>] [-SignaturesUpdatesChannel <UpdatesChannelType>] [-EngineUpdatesChannel <UpdatesChannelType>] [-PlatformUpdatesChannel <UpdatesChannelType>]
 ```
 
 ## DESCRIPTION
@@ -267,6 +267,28 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -DisableGradualRelease
+
+Enable this policy to disable gradual rollout of monthly and daily Defender updates. 
+
+Devices will be offered all Defender updates after the gradual release cycle completes. Best for datacenter machines that only receive limited updates. 
+
+Note: This setting applies to both monthly as well as daily Defender updates and will override any previously configured channel selections for platform and engine updates. 
+
+If you disable or do not configure this policy, the device will remain in Current Channel (Default) unless specified otherwise in specific channels for platform and engine updates. Stay up to date automatically during the gradual release cycle. Suitable for most devices. 
+
+Supported OS versions: Windows 10 
+
+Note: This policy is available starting with platform version 4.18.2106.5 and later
+
+```yaml
+Type: Boolean
+Aliases: dgr
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
 
 ### -DisableIOAVProtection
 Indicates whether Windows Defender scans all downloaded files and attachments.
@@ -412,6 +434,33 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -EngineUpdatesChannel 
+
+Enable this policy to specify when devices receive Microsoft Defender engine updates during the monthly gradual rollout. 
+
+Beta Channel: Devices set to this channel will be the first to receive new updates. Select Beta Channel to participate in identifying and reporting issues to Microsoft. Devices in the Windows Insider Program are subscribed to this channel by default. For use in (manual) test environments only and a limited number of devices. 
+
+Current Channel (Preview): Devices set to this channel will be offered updates earliest during the monthly gradual release cycle. Suggested for pre-production/validation environments. 
+
+Current Channel (Staged): Devices will be offered updates after the monthly gradual release cycle. Suggested to apply to a small, representative part of your production population (~10%). 
+
+Current Channel (Broad): Devices will be offered updates only after the gradual release cycle completes. Suggested to apply to a broad set of devices in your production population (~10-100%). 
+
+If you disable or do not configure this policy, the device will stay up to date automatically during the gradual release cycle. Suitable for most devices. 
+
+Supported OS versions: Windows 10 
+Note: This policy is available starting with platform version 4.18.2106.5 and later
+
+```yaml
+Type: UpdatesChannelType
+Aliases: euc
+Accepted values:Beta|Preview|Staged|Broad|NotConfigured 
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -ExclusionExtension
 Specifies an array of file name extensions, such as obj or lib, to exclude from scheduled, custom, and real-time scanning.
 
@@ -587,6 +636,34 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -PlatformUpdatesChannel 
+
+Enable this policy to specify when devices receive Microsoft Defender platform updates during the monthly gradual rollout.
+
+Beta Channel: Devices set to this channel will be the first to receive new updates. Select Beta Channel to participate in identifying and reporting issues to Microsoft. Devices in the Windows Insider Program are subscribed to this channel by default. For use in (manual) test environments only and a limited number of devices. 
+
+Current Channel (Preview): Devices set to this channel will be offered updates earliest during the monthly gradual release cycle. Suggested for pre-production/validation environments. 
+
+Current Channel (Staged): Devices will be offered updates after the monthly gradual release cycle. Suggested to apply to a small, representative part of your production population (~10%). 
+
+Current Channel (Broad): Devices will be offered updates only after the gradual release cycle completes. Suggested to apply to a broad set of devices in your production population (~10-100%). 
+
+If you disable or do not configure this policy, the device will stay up to date automatically during the gradual release cycle. Suitable for most devices. 
+
+Supported OS versions: Windows 10 
+
+Note: This policy is available starting with platform version 4.18.2106.5 and later
+
+```yaml
+Type: UpdatesChannelType
+Aliases: puc
+Accepted values: Beta|Preview|Staged|Broad|NotConfigured 
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -QuarantinePurgeItemsAfterDelay
 Specifies the number of days to keep items in the Quarantine folder.
 If you specify a value of zero or do not specify a value for this parameter, items stay in the Quarantine folder indefinitely.
@@ -1066,6 +1143,29 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -SignaturesUpdatesChannel
+Enable this policy to specify when devices receive daily Microsoft Defender definition updates during the daily gradual rollout. 
+
+Current Channel (Staged): Devices will be offered updates after the release cycle. Suggested to apply to a small, representative part of production population (~10%).
+
+Current Channel (Broad): Devices will be offered updates only after the gradual release cycle completes. Suggested to apply to a broad set of devices in your production population (~10-100%). 
+
+If you disable or do not configure this policy, the device will stay up to date automatically during the daily release cycle. Suitable for most devices. 
+
+Supported OS versions: Windows 10 
+
+Note: This policy is available starting with platform version 4.18.2106.5 and later
+
+```yaml
+Type: UpdatesChannelType
+Aliases: suc
+Accepted values: Staged|Broad|Not Configured
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -SignatureUpdateInterval
 Specifies the interval, in hours, at which to check for definition updates.
 The acceptable values for this parameter are: integers from 1 through 24.