Merge branch 'master' into chrisda

Author: chrisda

exchange/docs-conceptual/exchange-online/exchange-online-powershell-v2/app-only-auth-powershell-v2.md

@@ -31,13 +31,14 @@ The following examples show how to use the Exchange Online PowerShell V2 module
 - Connect using a local certificate:
 
   ```powershell
-  Connect-ExchangeOnline -CertificateFilePath "C:\Users\johndoe\Desktop\automation-cert.pfx" -AppID "alpha-beta-gamma-123456" -TenantID "contosoelectronics.onmicrosoft.com"
+  Connect-ExchangeOnline -CertificateFilePath "C:\Users\johndoe\Desktop\automation-cert.pfx" -AppID "alpha-beta-gamma-123456" -TenantID "contosoelectronics.onmicrosoft.com" -RoutingHintUPN "[email protected]"
   ```
+  The _RoutingHintUPN_ value is an admin email address in the tenant, and is used for efficient routing of requests. The email address of any admin in the organization works for app-only authentication scenarios.
 
 - Connect using a certificate thumbprint:
 
   ```powershell
-  Connect-ExchangeOnline -CertificateThumbPrint "012THISISADEMOTHUMBPRINT" -AppID "alpha-beta-gamma-123456" -TenantID "contosoelectronics.onmicrosoft.com"
+  Connect-ExchangeOnline -CertificateThumbPrint "012THISISADEMOTHUMBPRINT" -AppID "alpha-beta-gamma-123456" -TenantID "contosoelectronics.onmicrosoft.com" -RoutingHintUPN "[email protected]"
   ```
 
 - Connect using an existing service principal and client-secret:
@@ -100,11 +101,11 @@ The following list describes other items that we're working on:
 - Support for more built-in RBAC roles (Exchange Service Admin, Global Reader, Recipient Admin)
 - Custom RBAC and mailbox scoping using Azure AD administrative units.
 - Delegation support in app-only scenarios
-- Support for Security & Compliance Center PowerShell cmdlets.
+
 
 ## Appendix
 
-### Step 1: Application registration in Azure AD
+## Step 1: Application registration in Azure AD
 
 If you encounter problems, check the [required permssions](https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal#required-permissions) to verify that your account can create the identity.
 
@@ -154,7 +155,7 @@ You need to assign the API permission `Exchange.ManageAsApp` so the application
 
 7. Close the flyout when you're finished.
 
-### Step 3: Generate a self-signed certificate
+## Step 3: Generate a self-signed certificate
 
 Create a self-signed x.509 certificate using one of the following methods:
 
@@ -166,7 +167,7 @@ Create a self-signed x.509 certificate using one of the following methods:
 
 - Use the **makecert.exe** tool from the Windows SDK.
 
-### Step 4: Attach the certificate to the Azure AD application
+## Step 4: Attach the certificate to the Azure AD application
 
 After you register the certificate with your application, you can use the public key (.pfx file) or the thumbprint for authentication.
 
@@ -184,7 +185,7 @@ After you register the certificate with your application, you can use the public
 
 6. In the dialog that appears, browse to the self-signed certificate you created in the previous Step, and then click **Add**.
 
-### Step 5: Assign a role to the application
+## Step 5: Assign a role to the application
 
 Azure AD has more than 50 admin roles available. For app-only authentication in Exchange Online, we currently support the previously mentioned roles:
 

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

@@ -282,7 +282,25 @@ Get-EXOMailbox -ResultSize 10 -PropertySets All
 
 ## Release notes
 
-### Current release: Version 0.4368.1
+### Current release: Version 0.4578.0
+
+- Added support for configuring the Briefing Email for your organization at the user level with **Set-UserBriefingConfig** and **Get-UserBriefingConfig** cmdlets.
+
+- Support for session cleanup using **Disconnect-ExchangeOnline** cmdlet. This cmdlet is the V2 equivalent of `Get-PSSession | Remove-PSSession`. In addition to cleaning up session object and local files, it also removes the access token from cache, which is used for authenticating against V2 cmdlets.
+
+- You can now use `FolderId` as an identity parameter in **Get-EXOMailboxFolderPermission**. You can get the `FolderId` value using **Get-MailboxFolder**. For example:
+
+  `Get-MailboxFolderPermission -Identity <UPN>:<Folder-Path>`
+  
+  `Get-MailboxFolderPermission -Identity <UPN>:\<Folder-Id>`
+
+- Improved reliability of **Get-EXOMailboxStatistics** as certain request routing errors which led to failures have been resolved.
+
+- Optimized memory usage when a session is created by re-using any existing module with a new session instead of creating a new one every time session is imported.
+
+### Previous releases
+
+#### Version 0.4368.1
 
 - Added support for Office 365 Security & Compliance Center PowerShell cmdlets using the **Connect-IPPSSession** cmdlet.
 
@@ -296,8 +314,6 @@ Get-EXOMailbox -ResultSize 10 -PropertySets All
 
 - Remote PowerShell contained various complex data types which were intentionally not supported in EXO cmdlets to improve performance. Differences in non-complex data types between remote PowerShell cmdlets and V2 cmdlets have been resolved to allow seamless migration of management scripts.
 
-### Previous releases
-
 #### Version 0.3582.0
 
 - Support for prefix during session creation.

exchange/exchange-ps/exchange/mail-flow/Get-MessageTrackingReport.md

@@ -1,13 +1,13 @@
 ---
 external help file: Microsoft.Exchange.TransportMailflow-Help.xml
 online version: https://docs.microsoft.com/powershell/module/exchange/mail-flow/get-messagetrackingreport
-applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
+applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
 title: Get-MessageTrackingReport
 schema: 2.0.0
 author: chrisda
 ms.author: chrisda
 ms.reviewer:
-monikerRange: "exchserver-ps-2010 || exchserver-ps-2013 || exchserver-ps-2016 || exchserver-ps-2019 || exchonline-ps"
+monikerRange: "exchserver-ps-2010 || exchserver-ps-2013 || exchserver-ps-2016 || exchserver-ps-2019"
 ---
 
 # Get-MessageTrackingReport
@@ -65,7 +65,7 @@ You need to run the Search-MessageTrackingReport cmdlet to find the message trac
 Type: MessageTrackingReportId
 Parameter Sets: (All)
 Aliases:
-Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
+Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
 
 Required: True
 Position: 1
@@ -83,7 +83,7 @@ By default, each user can only see the message tracking reports for messages tha
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:
-Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
+Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
 
 Required: False
 Position: Named
@@ -103,7 +103,7 @@ The DetailLevel parameter specifies the amount of detail to return in the result
 Type: MessageTrackingDetailLevel
 Parameter Sets: (All)
 Aliases:
-Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
+Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
 
 Required: False
 Position: Named
@@ -139,7 +139,7 @@ Using this switch improves performance, but the lack of display names might make
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases:
-Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
+Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
 
 Required: False
 Position: Named
@@ -155,7 +155,7 @@ The RecipientPathFilter parameter specifies the email address of the recipient w
 Type: SmtpAddress
 Parameter Sets: (All)
 Aliases:
-Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
+Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
 
 Required: False
 Position: Named
@@ -171,7 +171,7 @@ The Recipients parameter specifies the email addresses of the recipients when yo
 Type: String[]
 Parameter Sets: (All)
 Aliases:
-Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
+Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
 
 Required: False
 Position: Named
@@ -191,7 +191,7 @@ The ReportTemplate parameter specifies a predefined format for the output. Valid
 Type: ReportTemplate
 Parameter Sets: (All)
 Aliases:
-Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
+Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
 
 Required: False
 Position: Named
@@ -207,7 +207,7 @@ The ResultSize parameter specifies the maximum number of results to return. If y
 Type: Unlimited
 Parameter Sets: (All)
 Aliases:
-Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
+Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
 
 Required: False
 Position: Named
@@ -233,7 +233,7 @@ The Status parameter filters the results by the specified delivery status codes.
 Type: _DeliveryStatus
 Parameter Sets: (All)
 Aliases:
-Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
+Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
 
 Required: False
 Position: Named
@@ -257,7 +257,7 @@ You only need to use this parameter for troubleshooting message tracking issues.
 Type: TraceLevel
 Parameter Sets: (All)
 Aliases:
-Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
+Applicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
 
 Required: False
 Position: Named

exchange/exchange-ps/exchange/mail-flow/Set-ReceiveConnector.md

@@ -1171,6 +1171,8 @@ This parameter uses the following syntax:
 
 The available \<capability\> values are:
 
+- AcceptCloudServicesMail (Exchange 2013 or later)
+
 - AcceptOorgProtocol
 
 - AcceptOorgHeader

exchange/exchange-ps/exchange/mail-flow/Set-TransportConfig.md

@@ -830,7 +830,7 @@ Accept wildcard characters: False
 ### -MaxRecipientEnvelopeLimit
 This parameter is available only in on-premises Exchange.
 
-The MaxRecipientEnvelopeLimit parameter specifies the maximum number of recipients in a message. The default value is 5000. The valid input range for this parameter is from 0 through 2147483647. If you enter a value of Unlimited, no limit is imposed on the number of recipients in a message. Exchange treats an unexpanded distribution group as one recipient.
+The MaxRecipientEnvelopeLimit parameter specifies the maximum number of recipients in a message. The default value is 500. The valid input range for this parameter is from 0 through 2147483647. If you enter a value of Unlimited, no limit is imposed on the number of recipients in a message. Exchange treats an unexpanded distribution group as one recipient.
 
 ```yaml
 Type: Unlimited

exchange/exchange-ps/exchange/policy-and-compliance-audit/Get-UnifiedAuditLogRetentionPolicy.md

@@ -131,7 +131,7 @@ The RecordType parameter filters the results by the record types that are define
 
 - Kaizala
 
-- LabelExplorer
+- LabelContentExplorer
 
 - MIPLabel
 

exchange/exchange-ps/exchange/policy-and-compliance-audit/New-UnifiedAuditLogRetentionPolicy.md

@@ -234,7 +234,7 @@ The RecordTypes parameter specifies the audit logs of a specific record type tha
 
 - Kaizala
 
-- LabelExplorer
+- LabelContentExplorer
 
 - MIPLabel
 

exchange/exchange-ps/exchange/policy-and-compliance-audit/Search-UnifiedAuditLog.md

@@ -291,7 +291,7 @@ The RecordType parameter filters the log entries by record type. Valid values ar
 
 - Kaizala
 
-- LabelExplorer
+- LabelContentExplorer
 
 - MailSubmission
 

exchange/exchange-ps/exchange/policy-and-compliance-audit/Set-UnifiedAuditLogRetentionPolicy.md

@@ -240,7 +240,7 @@ The RecordTypes parameter specifies the audit logs of a specific record type tha
 
 - Kaizala
 
-- LabelExplorer
+- LabelContentExplorer
 
 - MIPLabel
 

exchange/exchange-ps/exchange/sharing-and-collaboration/Get-PublicFolderItemStatistics.md

@@ -15,7 +15,7 @@ monikerRange: "exchserver-ps-2010 || exchserver-ps-2013 || exchserver-ps-2016 ||
 ## SYNOPSIS
 This cmdlet is available in on-premises Exchange and in the cloud-based service. Some parameters and settings may be exclusive to one environment or the other.
 
-Use the Get-PublicFolderItemStatistics cmdlet to view information about items within a specified public folder. Information returned includes subject, last modification time, last accessed time (on-premises Exchange only), creation time, attachments, message size, and the type of item. You can use this raw information to better understand the distribution of items and item characteristics across public folders.
+Use the Get-PublicFolderItemStatistics cmdlet to view information about items within a specified public folder. Information returned includes subject, last modification time, creation time, attachments, message size, and the type of item. You can use this raw information to better understand the distribution of items and item characteristics across public folders.
 
 For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://docs.microsoft.com/powershell/exchange/exchange-server/exchange-cmdlet-syntax).