Merge branch 'master' into QT-chrisda

Author: chrisda

exchange/exchange-ps/exchange/New-CaseHoldPolicy.md

@@ -151,7 +151,7 @@ The ExchangeLocation parameter specifies the mailboxes to include in the policy.
 To specify a mailbox or distribution group, you can use the following values:
 
 - Name
-- SMTP address
+- SMTP address. To specify an inactive mailbox, precede the address with a period (.).
 - Azure AD ObjectId (You can use the [Get-AzureADUser](https://docs.microsoft.com/powershell/module/azuread/get-azureaduser) cmdlet to obtain this value.)
 
 You can enter multiple values separated by commas. If the values contain spaces or otherwise require quotation marks, use the following syntax: `"Value1","Value2",..."ValueN"`.

exchange/exchange-ps/exchange/New-MailUser.md

@@ -183,7 +183,7 @@ You need to be assigned permissions before you can run this cmdlet. Although thi
 
 ### Example 1
 ```powershell
-New-MailUser -Name "Ed Meadows" -ExternalEmailAddress [email protected] -MicrosoftOnlineServicesID ed@tailspintoys -Password (ConvertTo-SecureString -String 'P@ssw0rd1' -AsPlainText -Force)
+New-MailUser -Name "Ed Meadows" -ExternalEmailAddress [email protected] -MicrosoftOnlineServicesID ed@contoso.com -Password (ConvertTo-SecureString -String 'P@ssw0rd1' -AsPlainText -Force)
 ```
 
 This example creates a new mail user for Ed Meadows in the contoso.com cloud-based organization. The mail user gives Ed an account and email address in the contoso.com ___domain, but messages sent to Ed are delivered to his tailspintoys.com email address.

exchange/exchange-ps/exchange/New-MobileDeviceMailboxPolicy.md

@@ -87,6 +87,8 @@ Mobile device mailbox policies define settings for mobile devices that are used
 
 Some mobile device mailbox policy settings require the mobile device to have certain built-in features that enforce these security and device management settings. If your organization allows all devices, you need to set the AllowNonProvisionableDevices parameter to $true. This allows devices that can't enforce all policy settings to synchronize with your server.
 
+Some settings in this cmdlet are supported by Outlook for iOS and Android. For more information, see [Leveraging Exchange Online mobile device policies](https://docs.microsoft.com/exchange/clients-and-mobile-in-exchange-online/outlook-for-ios-and-android/secure-outlook-for-ios-and-android#leveraging-exchange-online-mobile-device-policies).
+
 You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
 
 ## EXAMPLES
@@ -155,7 +157,15 @@ Accept wildcard characters: False
 ```
 
 ### -AllowBluetooth
-The AllowBluetooth parameter specifies whether the Bluetooth capabilities of the mobile device are allowed. The available options are Disable, HandsfreeOnly, and Allow. The default value is Allow.
+The AllowBluetooth parameter specifies whether the Bluetooth capabilities are allowed on the mobile device. Valid values are:
+
+- Allow (this is the default value).
+- Disable
+- HandsfreeOnly
+
+The values Allow or HandsfreeOnly allow synchronization between Outlook for Android and the Outlook for Android wearable app for the associated Microsoft account.
+
+The value Disable disables synchronization between Outlook for Android and the Outlook for Android wearable app for the associated Microsoft account. Any previously synchronized data is deleted. This value does not disable Bluetooth on the Android device or the wearable device, nor does it affect other Android wearable apps.
 
 ```yaml
 Type: BluetoothType
@@ -604,6 +614,8 @@ Accept wildcard characters: False
 ```
 
 ### -DeviceEncryptionEnabled
+**Note**: This setting is supported by Outlook for iOS and Android.
+
 The DeviceEncryptionEnabled parameter specifies whether encryption is enabled on the mobile device. Valid input for this parameter is $true or $false. The default value is $false.
 
 When this parameter is set to $true, device encryption is enabled on the mobile device.
@@ -872,6 +884,8 @@ Accept wildcard characters: False
 ```
 
 ### -MinPasswordLength
+**Note**: This setting is supported by Outlook for Android.
+
 The MinPasswordLength parameter specifies the minimum number of characters in the mobile device password.
 
 You can enter any number from 1 through 16 or the value $null. The default value is blank. The maximum password length is 16 characters.

exchange/exchange-ps/exchange/New-MoveRequest.md

@@ -16,7 +16,7 @@ This cmdlet is available in on-premises Exchange and in the cloud-based service.
 
 Use the New-MoveRequest cmdlet to begin the process of an asynchronous mailbox or personal archive move. You can also check mailbox readiness to be moved by using the WhatIf parameter.
 
-**Note**: After April 15, 2020, you can't use this cmdlet to manually move mailboxes within an Exchange Online organization. You can only use this cmdlet for migrating to and from Exchange Online.
+**Note**: After April 15, 2020, you shouldn't use this cmdlet to manually move mailboxes within an Exchange Online organization. You can only use this cmdlet for migrating to and from Exchange Online. If you have issues with a mailbox and want to fix it by moving the mailbox within your Exchange Online organization, please open a Microsoft Support request instead.
 
 For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
 

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

@@ -99,8 +99,8 @@ The Applications parameter specifies the target when Microsoft 365 Groups are in
 
 - `Group:Exchange` for the mailbox that's connected to the Microsoft 365 Group.
 - `Group:SharePoint` for the SharePoint site that's connected to the Microsoft 365 Group.
-- `"Group:Exchange","Group:SharePoint"` for both the mailbox and the SharePoint site that are connected to the Microsoft 365 Group.
-- blank (`$null`): This is the default value, and is functionally equivalent to the value `"Group:Exchange","Group:SharePoint"`.
+- `"Group:Exchange,SharePoint"` for both the mailbox and the SharePoint site that are connected to the Microsoft 365 Group.
+- blank (`$null`): This is the default value, and is functionally equivalent to the value `"Group:Exchange,SharePoint"`.
 
 ```yaml
 Type: MultiValuedProperty

exchange/exchange-ps/exchange/New-TransportRule.md

@@ -455,6 +455,8 @@ Accept wildcard characters: False
 ```
 
 ### -AnyOfRecipientAddressContainsWords
+**Note**: In the cloud-based service, this parameter behaves the same as the RecipientAddressContainsWords parameter (other recipients in the message are not affected).
+
 This parameter specifies a condition or part of a condition for the rule. The name of the corresponding exception parameter starts with ExceptIf.
 
 In on-premises Exchange, this condition is available on Mailbox servers and Edge Transport servers.
@@ -479,6 +481,8 @@ Accept wildcard characters: False
 ```
 
 ### -AnyOfRecipientAddressMatchesPatterns
+**Note**: In the cloud-based service, this parameter behaves the same as the RecipientAddressMatchesPatterns parameter (other recipients in the message are not affected).
+
 This parameter specifies a condition or part of a condition for the rule. The name of the corresponding exception parameter starts with ExceptIf.
 
 In on-premises Exchange, this condition is available on Mailbox servers and Edge Transport servers.
@@ -1469,6 +1473,8 @@ Accept wildcard characters: False
 ```
 
 ### -ExceptIfAnyOfRecipientAddressContainsWords
+**Note**: In the cloud-based service, this parameter behaves the same as the ExceptIfRecipientAddressContainsWords parameter (other recipients in the message are not affected).
+
 This parameter specifies an exception or part of an exception for the rule. The name of the corresponding condition doesn't include the ExceptIf prefix.
 
 In on-premises Exchange, this exception is available on Mailbox servers and Edge Transport servers.
@@ -1493,6 +1499,8 @@ Accept wildcard characters: False
 ```
 
 ### -ExceptIfAnyOfRecipientAddressMatchesPatterns
+**Note**: In the cloud-based service, this parameter behaves the same as the ExceptIfRecipientAddressMatchesPatterns parameter (other recipients in the message are not affected).
+
 This parameter specifies an exception or part of an exception for the rule. The name of the corresponding condition doesn't include the ExceptIf prefix.
 
 In on-premises Exchange, this exception is available on Mailbox servers and Edge Transport servers.

exchange/exchange-ps/exchange/Set-CaseHoldPolicy.md

@@ -116,7 +116,7 @@ The AddExchangeLocation parameter specifies the mailboxes to add to the list of
 To specify a mailbox or distribution group, you can use the following values:
 
 - Name
-- SMTP address
+- SMTP address. To specify an inactive mailbox, precede the address with a period (.).
 - Azure AD ObjectId (You can use the [Get-AzureADUser](https://docs.microsoft.com/powershell/module/azuread/get-azureaduser) cmdlet to obtain this value.)
 
 You can enter multiple values separated by commas. If the values contain spaces or otherwise require quotation marks, use the following syntax: `"Value1","Value2",..."ValueN"`.
@@ -249,9 +249,8 @@ The RemoveExchangeLocation parameter specifies the existing mailboxes to remove
 To specify a mailbox or distribution group, you can use any value that uniquely identifies it. For example:
 
 - Name
-- Distinguished name (DN)
-- Email address
-- GUID
+- SMTP address. To specify an inactive mailbox, precede the address with a period (.).
+- Azure AD ObjectId (You can use the [Get-AzureADUser](https://docs.microsoft.com/powershell/module/azuread/get-azureaduser) cmdlet to obtain this value.)
 
 You can enter multiple values separated by commas. If the values contain spaces or otherwise require quotation marks, use the following syntax: `"Value1","Value2",..."ValueN"`.
 

exchange/exchange-ps/exchange/Set-MobileDeviceMailboxPolicy.md

@@ -88,6 +88,8 @@ Mobile device mailbox policies define settings for mobile devices that are used
 
 Some mobile device mailbox policy settings require the mobile device to have specific built-in features that enforce these security and device management settings. If your organization allows all devices, you must set the AllowNonProvisionableDevices parameter to $true. This applies to devices that can't enforce all policy settings.
 
+Some settings in this cmdlet are supported by Outlook for iOS and Android. For more information, see [Leveraging Exchange Online mobile device policies](https://docs.microsoft.com/exchange/clients-and-mobile-in-exchange-online/outlook-for-ios-and-android/secure-outlook-for-ios-and-android#leveraging-exchange-online-mobile-device-policies).
+
 You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
 
 ## EXAMPLES
@@ -156,7 +158,15 @@ Accept wildcard characters: False
 ```
 
 ### -AllowBluetooth
-The AllowBluetooth parameter specifies whether the Bluetooth capabilities are allowed on the mobile device. The available options are Disable, HandsfreeOnly, and Allow. The default value is Allow.
+The AllowBluetooth parameter specifies whether the Bluetooth capabilities are allowed on the mobile device. Valid values are:
+
+- Allow (this is the default value).
+- Disable
+- HandsfreeOnly
+
+The values Allow or HandsfreeOnly allow synchronization between Outlook for Android and the Outlook for Android wearable app for the associated Microsoft account.
+
+The value Disable disables synchronization between Outlook for Android and the Outlook for Android wearable app for the associated Microsoft account. Any previously synchronized data is deleted. This value does not disable Bluetooth on the Android device or the wearable device, nor does it affect other Android wearable apps.
 
 ```yaml
 Type: BluetoothType
@@ -605,6 +615,8 @@ Accept wildcard characters: False
 ```
 
 ### -DeviceEncryptionEnabled
+**Note**: This setting is supported by Outlook for iOS and Android.
+
 The DeviceEncryptionEnabled parameter specifies whether encryption is enabled on the mobile device. Valid input for this parameter is $true or $false. The default value is $false.
 
 When this parameter is set to $true, device encryption is enabled on the mobile device.
@@ -873,6 +885,8 @@ Accept wildcard characters: False
 ```
 
 ### -MinPasswordLength
+**Note**: This setting is supported by Outlook for Android.
+
 The MinPasswordLength parameter specifies the minimum number of characters in the mobile device password.
 
 You can enter any number from 1 through 16 or the value $null. The default value is blank. The maximum password length is 16 characters.

exchange/exchange-ps/exchange/Set-OrganizationConfig.md

@@ -70,6 +70,7 @@ Set-OrganizationConfig -ShortenEventScopeDefault <ShortenEventScopeMode>
  [-DistributionGroupNamingPolicy <DistributionGroupNamingPolicy>]
  [-ElcProcessingDisabled <Boolean>]
  [-EnableForwardingAddressSyncForMailboxes <Boolean>]
+ [-EnableOutlookEvents <Boolean>]
  [-EndUserDLUpgradeFlowsDisabled <Boolean>]
  [-EwsAllowEntourage <Boolean>]
  [-EwsAllowList <MultiValuedProperty>]
@@ -1627,7 +1628,7 @@ Accept wildcard characters: False
 ### -EnableForwardingAddressSyncForMailboxes
 This parameter is available only in the cloud-based service.
 
-{{ Fill EnableForwardingAddressSyncForMailboxes Description }}
+This parameter is reserved for internal Microsoft use.
 
 ```yaml
 Type: Boolean
@@ -1660,6 +1661,27 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -EnableOutlookEvents
+This parameter is available only in the cloud-based service.
+
+The EnableOutlookEvents parameter specifies whether Outlook or Outlook on the web (formerly known as Outlook Web App) automatically discovers events from email messages and adds them to user calendars. Valid values are:
+
+- $true: Discovery of events from email messages is enabled.
+- $false: Discovery of events from email messages is disabled. This is the default value.
+
+```yaml
+Type: Boolean
+Parameter Sets: (All)
+Aliases:
+Applicable: Exchange Online
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -EndUserDLUpgradeFlowsDisabled
 This parameter is available only in the cloud-based service.
 

exchange/exchange-ps/exchange/Set-Place.md

@@ -16,7 +16,7 @@ This cmdlet is available only in the cloud-based service.
 
 Use the Set-Place cmdlet to update room mailboxes with additional metadata, which provides a better search and room suggestion experience.
 
-**Note**: In hybrid environments, this cmdlet doesn't work on the following properties on synchronized room mailboxes: City, CountryOrRegion, GeoCoordinates, Phone, PostalCode, State, and Street. To modify these properties on synchronized room mailboxes, use the Set-User or Set-Mailbox cmdlets in on-premises Exchange.
+**Note**: In hybrid environments, this cmdlet doesn't work on the following properties on synchronized room mailboxes: City, CountryOrRegion, GeoCoordinates, Phone, PostalCode, State, and Street. To modify these properties except GeoCoordinates on synchronized room mailboxes, use the Set-User or Set-Mailbox cmdlets in on-premises Exchange.
 
 **Note**: We recommend that you use the Exchange Online PowerShell V2 module to connect to Exchange Online PowerShell. For instructions, see [Connect to Exchange Online PowerShell](https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).