Simulation mode

Author: chrisda

exchange/exchange-ps/exchange/Get-RetentionCompliancePolicy.md

@@ -25,6 +25,7 @@ Get-RetentionCompliancePolicy [[-Identity] <PolicyIdParameter>]
  [-DistributionDetail]
  [-ErrorPolicyOnly] 
  [-ExcludeTeamsPolicy]
+ [-IncludeTestModeResults]
  [-RetentionRuleTypes]
  [-TeamsPolicyOnly]
  [<CommonParameters>]
@@ -128,6 +129,24 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -IncludeTestModeResults
+The IncludeTestModeResults switch specifies whether to include simulation policy results. You don't need to specify a value with this switch.
+
+For more information about simulation mode, see [Learn about simulation mode](https://learn.microsoft.com/microsoft-365/compliance/apply-retention-labels-automatically#learn-about-simulation-mode).
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+Applicable: Security & Compliance
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -RetentionRuleTypes
 The RetentionRuleTypes switch specifies whether to return the value of the RetentionRuleTypes property in the results. You don't need to specify a value with this switch.
 

exchange/exchange-ps/exchange/New-RetentionCompliancePolicy.md

@@ -30,6 +30,7 @@ New-RetentionCompliancePolicy [-Name] <String>
  [-ExchangeLocation <MultiValuedProperty>]
  [-ExchangeLocationException <MultiValuedProperty>]
  [-Force]
+ [-IsSimulation]
  [-ModernGroupLocation <MultiValuedProperty>]
  [-ModernGroupLocationException <MultiValuedProperty>]
  [-OneDriveLocation <MultiValuedProperty>]
@@ -53,6 +54,7 @@ New-RetentionCompliancePolicy [-Name] <String>
  [-Confirm]
  [-Enabled <Boolean>]
  [-Force]
+ [-IsSimulation]
  [-RestrictiveRetention <Boolean>]
  [-RetainCloudAttachment <Boolean>]
  [-TeamsChannelLocation <MultiValuedProperty>]
@@ -70,6 +72,7 @@ New-RetentionCompliancePolicy [-Name] <String> -AdaptiveScopeLocation <MultiValu
  [-Confirm]
  [-Enabled <Boolean>]
  [-Force]
+ [-IsSimulation]
  [-RestrictiveRetention <Boolean>]
  [-RetainCloudAttachment <Boolean>]
  [-WhatIf]
@@ -101,7 +104,6 @@ This example creates a new auto-apply label policy targeted to cloud attachments
 
 The next step is to use the New-RetentionComplianceRule cmdlet to add a retention label to the retention label policy.
 
-
 ## PARAMETERS
 
 ### -Name
@@ -292,6 +294,24 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -IsSimulation
+The IsSimulation switch specifies the retention policy is a DLM simulation. You don't need to specify a value with this switch.
+
+For more information about simulation mode, see [Learn about simulation mode](https://learn.microsoft.com/microsoft-365/compliance/apply-retention-labels-automatically#learn-about-simulation-mode).
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+Applicable: Security & Compliance
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -ModernGroupLocation
 The ModernGroupLocation parameter specifies the Microsoft 365 Groups to include in the policy. Valid values are:
 

exchange/exchange-ps/exchange/Set-RetentionCompliancePolicy.md

@@ -24,9 +24,10 @@ For information about the parameter sets in the Syntax section below, see [Excha
 
 ### RetryDistribution
 ```
-Set-RetentionCompliancePolicy [-Identity] <PolicyIdParameter>
- [-RetryDistribution]
+Set-RetentionCompliancePolicy [-Identity] <PolicyIdParameter> [-RetryDistribution]
  [-Confirm]
+ [-EnforceSimulationPolicy <Boolean>]
+ [-StartSimulation <Boolean>]
  [-WhatIf]
  [<CommonParameters>]
 ```
@@ -49,6 +50,7 @@ Set-RetentionCompliancePolicy [-Identity] <PolicyIdParameter>
  [-Comment <String>]
  [-Confirm]
  [-Enabled <Boolean>]
+ [-EnforceSimulationPolicy <Boolean>]
  [-Force]
  [-PolicyTemplateInfo <PswsHashtable>]
  [-RemoveExchangeLocation <MultiValuedProperty>]
@@ -63,20 +65,22 @@ Set-RetentionCompliancePolicy [-Identity] <PolicyIdParameter>
  [-RemoveSkypeLocation <MultiValuedProperty>]
  [-RemoveSkypeLocationException <MultiValuedProperty>]
  [-RestrictiveRetention <Boolean>]
+ [-StartSimulation <Boolean>]
  [-WhatIf]
  [<CommonParameters>]
 ```
 
 ### AdaptiveScopeLocation
 ```
-Set-RetentionCompliancePolicy [-Identity] <PolicyIdParameter>
- [-AddAdaptiveScopeLocation <MultiValuedProperty>]
+Set-RetentionCompliancePolicy [-Identity] <PolicyIdParameter> [-AddAdaptiveScopeLocation <MultiValuedProperty>]
  [-Applications <MultiValuedProperty>]
  [-Comment <String>]
  [-Confirm]
  [-Enabled <Boolean>]
+ [-EnforceSimulationPolicy <Boolean>]
  [-Force]
  [-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
+ [-StartSimulation <Boolean>]
  [-WhatIf]
  [<CommonParameters>]
 ```
@@ -91,11 +95,13 @@ Set-RetentionCompliancePolicy [-Identity] <PolicyIdParameter>
  [-Comment <String>]
  [-Confirm]
  [-Enabled <Boolean>]
+ [-EnforceSimulationPolicy <Boolean>]
  [-Force]
  [-RemoveTeamsChannelLocation <MultiValuedProperty>]
  [-RemoveTeamsChannelLocationException <MultiValuedProperty>]
  [-RemoveTeamsChatLocation <MultiValuedProperty>]
  [-RemoveTeamsChatLocationException <MultiValuedProperty>]
+ [-StartSimulation <Boolean>]
  [-WhatIf]
  [<CommonParameters>]
 ```
@@ -586,6 +592,25 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -EnforceSimulationPolicy
+Use the EnforceSimulationPolicy parameter to promote a simulation policy to a regular auto-labeling policy. Valid values are:
+
+- $true: Promote the simulation policy to a regular auto-labeling policy.
+- $false: Don't promote the simulation policy. This is the default value.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+Applicable: Security & Compliance
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Force
 The Force switch hides warning or confirmation messages. You don't need to specify a value with this switch.
 
@@ -993,6 +1018,27 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -StartSimulation
+The StartSimulation parameter specifies whether to start a simulation job. Valid values are:
+
+- $true: Start the simulation job.
+- $false: Don't start the simulation job. This is the default value.
+
+For more information about simulation mode, see [Learn about simulation mode](https://learn.microsoft.com/microsoft-365/compliance/apply-retention-labels-automatically#learn-about-simulation-mode).
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+Applicable: Security & Compliance
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -WhatIf
 The WhatIf switch doesn't work in Security & Compliance PowerShell.