Merge branch 'master' into patch-1

Author: chrisda

exchange/exchange-ps/exchange/Disable-Mailbox.md

@@ -283,7 +283,10 @@ This parameter is available only in the cloud-based service.
 
 The PermanentlyDisable switch specifies whether to permanently disable the mailbox. You don't need to specify a value with this switch.
 
-You can only use this switch on user mailboxes that aren't licensed and aren't on hold.
+Notes:
+
+- You can only use this switch on user mailboxes that aren't licensed and aren't on hold.
+- When the Exchange Online license is removed from a mailbox without following other deprovisioning steps, this may leave the mailbox in a hard-deleted state. In this case, this parameter is not useful. You can use it, for example, in hybrid Exchange environments.
 
 ```yaml
 Type: SwitchParameter

exchange/exchange-ps/exchange/New-HostedOutboundSpamFilterPolicy.md

@@ -117,9 +117,9 @@ Accept wildcard characters: False
 
 The AutoForwardingMode specifies how the policy controls automatic email forwarding to outbound recipients. Valid values are:
 
-- Automatic: Allows outbound spam filtering to control automatic external email forwarding. This is the default value.
-- On: Automatic external email forwarding is not disabled by the policy.
-- Off: All automatic external email forwarding is disabled by the policy.
+- Automatic: Automatic external email forwarding is blocked by the system. This is the default value.
+- On: Automatic external email forwarding is not restricted.
+- Off: Automatic external email forwarding is disabled and will result in a non-delivery report (also known as an NDR or bounce message) to the sender.
 
 This setting applies only to cloud-based mailboxes, and automatic forwarding to internal recipients is not affected by this setting.
 

exchange/exchange-ps/exchange/New-LabelPolicy.md

@@ -139,22 +139,13 @@ Accept wildcard characters: False
 ```
 
 ### -ExchangeLocation
-The ExchangeLocation parameter specifies the mailboxes to include in the policy. Valid values are:
+The ExchangeLocation parameter specifies the mailboxes to include in the policy. A valid value is a mailbox.
 
-- A mailbox
-
-- A distribution group or mail-enabled security group (all mailboxes that are currently members of the group).
-
-- The value All for all mailboxes. You can only use this value by itself.
-
-To specify a mailbox or distribution group, you can use any value that uniquely identifies it. For example:
+To specify the mailbox, you can use any value that uniquely identifies it. For example:
 
 - Name
-
 - Distinguished name (DN)
-
 - Email address
-
 - GUID
 
 To enter multiple values, use the following syntax: \<value1\>,\<value2\>,...\<valueX\>. If the values contain spaces or otherwise require quotation marks, use the following syntax: "\<value1\>","\<value2\>",..."\<valueX\>".
@@ -173,20 +164,13 @@ Accept wildcard characters: False
 ```
 
 ### -ExchangeLocationException
-The ExchangeLocationException parameter specifies the mailboxes to exclude when you use the value All for the ExchangeLocation parameter. Valid values are:
+The ExchangeLocationException parameter specifies the mailboxes to exclude when you use the value All for the ExchangeLocation parameter. A valid value is a mailbox.
 
-- A mailbox
-
-- A distribution group or mail-enabled security group
-
-To specify a mailbox or distribution group, you can use any value that uniquely identifies it. For example:
+To specify the mailbox, you can use any value that uniquely identifies it. For example:
 
 - Name
-
 - Distinguished name (DN)
-
 - Email address
-
 - GUID
 
 To enter multiple values, use the following syntax: \<value1\>,\<value2\>,...\<valueX\>. If the values contain spaces or otherwise require quotation marks, use the following syntax: "\<value1\>","\<value2\>",..."\<valueX\>".

exchange/exchange-ps/exchange/Set-HostedOutboundSpamFilterPolicy.md

@@ -122,9 +122,9 @@ Accept wildcard characters: False
 
 The AutoForwardingMode specifies how the policy controls automatic email forwarding to outbound recipients. Valid values are:
 
-- Automatic: Allows outbound spam filtering to control automatic external email forwarding. This is the default value.
-- On: Automatic external email forwarding is not disabled by the policy.
-- Off: All automatic external email forwarding is disabled by the policy.
+- Automatic: Automatic external email forwarding is blocked by the system. This is the default value.
+- On: Automatic external email forwarding is not restricted.
+- Off: Automatic external email forwarding is disabled and will result in a non-delivery report (also known as an NDR or bounce message) to the sender.
 
 This setting applies only to cloud-based mailboxes, and automatic forwarding to internal recipients is not affected by this setting.
 

exchange/exchange-ps/exchange/Set-LabelPolicy.md

@@ -108,20 +108,13 @@ Accept wildcard characters: False
 ```
 
 ### -AddExchangeLocation
-The AddExchangeLocation parameter specifies the mailboxes to add to the list of included mailboxes when you aren't using the value All for the ExchangeLocation parameter. Valid values are:
+The AddExchangeLocation parameter specifies the mailboxes to add to the list of included mailboxes when you aren't using the value All for the ExchangeLocation parameter. A valid value is a mailbox.
 
-- A mailbox
-
-- A distribution group or mail-enabled security group (all mailboxes that are currently members of the group).
-
-To specify a mailbox or distribution group, you can use any value that uniquely identifies it. For example:
+To specify the mailbox, you can use any value that uniquely identifies it. For example:
 
 - Name
-
 - Distinguished name (DN)
-
 - Email address
-
 - GUID
 
 To enter multiple values, use the following syntax: \<value1\>,\<value2\>,...\<valueX\>. If the values contain spaces or otherwise require quotation marks, use the following syntax: "\<value1\>","\<value2\>",..."\<valueX\>".
@@ -140,22 +133,17 @@ Accept wildcard characters: False
 ```
 
 ### -AddExchangeLocationException
-The AddExchangeLocationException parameter specifies the mailboxes to add to the list of excluded mailboxes when you use the value All for the ExchangeLocation parameter. Valid values are:
+The AddExchangeLocationException parameter specifies the mailboxes to add to the list of excluded mailboxes when you use the value All for the ExchangeLocation parameter. A valid value is a mailbox.
 
-- A mailbox
-
-- A distribution group or mail-enabled security group
-
-To specify a mailbox or distribution group, you can use any value that uniquely identifies it. For example:
+To specify the mailbox, you can use any value that uniquely identifies it. For example:
 
 - Name
-
 - Distinguished name (DN)
-
 - Email address
-
 - GUID
 
+To enter multiple values, use the following syntax: \<value1\>,\<value2\>,...\<valueX\>. If the values contain spaces or otherwise require quotation marks, use the following syntax: "\<value1\>","\<value2\>",..."\<valueX\>".
+
 ```yaml
 Type: MultiValuedProperty
 Parameter Sets: Identity

sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenantSyncClientRestriction.md

@@ -264,6 +264,9 @@ Accept wildcard characters: False
 Controls whether or not a tenant's users can sync OneDrive for Business libraries with the old OneDrive for Business sync client.
 The valid values are **OptOut, HardOptin, and SoftOptin**.
 
+> [!NOTE]
+> GrooveBlockOptions is planned to be deprecated. Please refrain from using the parameter.
+
 ```yaml
 Type: String
 Parameter Sets: GrooveBlockOptions