Merge pull request MicrosoftDocs#8660 from MicrosoftDocs/ExOv3-chrisda

EOv3-chrisda to Master

Author: chrisda

exchange/docs-conceptual/exchange-online-powershell-v2.md

@@ -96,6 +96,21 @@ Miscellaneous Exchange Online cmdlets that happen to be in the EXO V2 module are
 |[Set-VivaInsightsSettings](/powershell/module/exchange/set-vivainsightssettings)|Available in v2.0.5-Preview2 or later.|
 |
 
+### Updates for version 2.0.6
+
+Version 2.0.6-Preview3 of the EXO V2 module is now available. This Preview version improves upon the historical capabilities of the module with the following features:
+
+- 250 additional remote PowerShell cmdlets that are backed by the REST API. These REST API cmdlets don't rely on the remote PowerShell session, so PowerShell on your client computer doesn't need [Basic authentication in WinRM](#prerequisites-for-the-exo-v2-module). These REST API cmdlets also work just like their old remote PowerShell equivalent cmdlets, so you don't need to update any of your scripts.
+- The new _RPSSession_ switch in **Connect-ExchangeOnline** grants access to all existing remote PowerShell cmdlets. The _RPSSession_ switch requires [Basic authentication in WinRM](#prerequisites-for-the-exo-v2-module) on your client computer.
+- A small number of existing mailbox remote PowerShell cmdlets have been updated with a new, experimental _UseCustomRoutingSwitch_ parameter. Using this switch routes the command directly to the required Mailbox server, and might improve overall performance.
+  - When you use the _UseCustomRoutingSwitch_, you need to use the following values for identity of the mailbox:
+    - User principal name (UPN)
+    - Email address
+    - Mailbox GUID
+  - Initially, the _UseCustomRoutingSwitch_ is available on the following cmdlets: **Remove-CalendarEvents**, **Get-Clutter**, **Set-Clutter**, **Get-FocusedInbox**, **Set-FocusedInbox**, **Get-InboxRule**, **Get-MailboxAutoReplyConfiguration**, **Get-MailboxCalendarFolder**, **Get-MailboxFolderPermission**, **Get-MailboxFolderStatistics**, **Get-MailboxMessageConfiguration**, **Get-MailboxPermission**, **Get-MailboxRegionalConfiguration**, **Set-MailboxRegionalConfiguration**, **Get-MailboxStatistics**, **Get-MobileDeviceStatistics**, **Get-UserPhoto**, and **Set-UserPhoto**.
+
+    Use this parameter experimentally and [report any issues](#report-bugs-and-issues-for-the-exo-v2-module) that you encounter.
+
 ## Install and maintain the EXO V2 module
 
 You can download the EXO V2 module from the PowerShell gallery at <https://www.powershellgallery.com/packages/ExchangeOnlineManagement/>.

exchange/exchange-ps/exchange/Connect-ExchangeOnline.md

@@ -52,6 +52,7 @@ Connect-ExchangeOnline
  [-TrackPerformance <Boolean>]
  [-UseMultithreading <Boolean>]
  [-UserPrincipalName <String>]
+ [-UseRPSSession]
  [<CommonParameters>]
 ```
 
@@ -64,26 +65,17 @@ For details about the current and past public versions of the EXO V2 module, see
 
 ### Example 1
 ```powershell
-$UserCredential = Get-Credential
-Connect-ExchangeOnline -Credential $UserCredential
+Connect-ExchangeOnline -UserPrincipalName [email protected]
 ```
 
-This example connects to Exchange Online PowerShell using modern authentication for an account that doesn't use multi-factor authentication (MFA).
-
-The first command gets the username and password and stores them in the $UserCredential variable.
-
-The second command connects the current PowerShell session using the credentials in $UserCredential.
-
-After the Connect-ExchangeOnline command is complete, the password key in the $UserCredential variable is emptied, and you can run Exchange Online PowerShell cmdlets.
+This example connects to Exchange Online PowerShell using modern authentication, with or without multi-factor authentication (MFA). We aren't using the UseRPSSession parameter, so the connection uses REST and doesn't require Basic authentication to be enabled in WinROM on the local computer. But, only the subset of frequently used REST API parameters are available.
 
 ### Example 2
 ```powershell
-Connect-ExchangeOnline -UserPrincipalName [email protected]
+Connect-ExchangeOnline -UserPrincipalName [email protected] -UseRPSSession
 ```
 
-This example connects to Exchange Online PowerShell using modern authentication for the account [email protected], which uses MFA.
-
-After the command is successful, you can run ExO V2 module cmdlets and older remote PowerShell cmdlets.
+This example connects to Exchange Online PowerShell using modern authentication, with or without MFA. We're using the UseRPSSession parameter, so the connection requires Basic authentication to be enabled in WinRM on the local computer. But, all Exchange Online PowerShell cmdlets are available using traditional remote PowerShell access.
 
 ### Example 3
 ```powershell
@@ -640,6 +632,28 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -UseRPSSession
+This parameter is available in version 2.0.6-Preview3 or later of the Exchange Online V2 module.
+
+The UseRPSSession switch allows you to connect to Exchange Online PowerShell using traditional remote PowerShell access to all cmdlets. You don't need to specify a value with this switch.
+
+This switch requires that Basic authentication is enabled in WinRM on the local computer. For more information, see [Prerequisites in the EXO V2 module](https://docs.microsoft.com/powershell/exchange/exchange-online-powershell-v2#prerequisites-for-the-exo-v2-module).
+
+If you don't use this parameter, Basic authentication in WinRM is not required, but only the subset of frequently used REST API cmdlets are available.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+Applicable: Exchange Online
+
+Required: False
+Position: Named
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### CommonParameters
 This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/p/?LinkID=113216).