Merge branch 'master' into patch-98

Author: chrisda

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

@@ -282,14 +282,30 @@ Get-EXOMailbox -ResultSize 10 -PropertySets All
 
 ## Release notes
 
-### Current release (version 0.3555.1)
+### Current release ( Version 0.3582.0 )
+- Support for prefix during session creation
+    > You can create only 1 session at a time which can have prefixed cmdlets.
+    > Note that the EXO V2 cmdlets will not be prefixed as they already have a prefix EXO and hence please refrain from using EXO as a prefix during session creation.
 
-- Fixed a bug where piped cmdlets were failing with the following error due to an authentication issue:
+- Use EXO V2 cmdlets even if WinRM Basic Auth is disabled on client machine
+    > Please note that Remote PowerShell cmdlets require WinRM Basic Auth to be enabled and they won't be available if it is disabled.
+
+-  Identity parameter for V2 cmdlets now supports name and alias as well
+    > Please note that using alias or name slows down the performance of V2 cmdlets and hence it is not recommended to use this option
+
+- Fixed issue where data-type of attributes returned by V2 cmdlet was different from Remote PowerShell cmdlets. We still have few attributes which have differing data-type and we plan to handle them in coming months.
+
+- Fixed bug - Frequent sessions reconnects issue when Connect-ExchangeOnline was invoked with Credentials or UserPrincipalName
 
-  > Cannot invoke the pipeline because the runspace is not in the Opened state. Current state of the runspace is 'Closed'.
 
 ### Previous releases
 
+#### Version 0.3555.1
+
+- Fixed a bug where piped cmdlets were failing with the following error due to an authentication issue:
+
+  > Cannot invoke the pipeline because the runspace is not in the Opened state. Current state of the runspace is 'Closed'.
+
 #### Version 0.3527.4
 
 - Updated Get-Help content.

exchange/docs-conceptual/exchange-server/recipient-filters/filter-properties.md

@@ -102,6 +102,7 @@ The properties that have been _confirmed_ to work with the _Filter_ parameter in
 |_AssistantName_|_msExchAssistantName_|**Get-Contact** <br/> **Get-LinkedUser** <br/> **Get-User**|String (wildcards accepted) or `$null`|For example, `Get-User -Filter "AssistantName -like 'Julia*'"`.|
 |_AuditEnabled_|_msExchMailboxAuditEnable_|**Get-Mailbox**|Boolean (`$true` or `$false`)|For example, `Get-Mailbox -Filter 'AuditEnabled -eq $true'`.|
 |_AuditLogAgeLimit_|_msExchMailboxAuditLogAgeLimit_|**Get-Mailbox** <br/> **Get-UnifiedGroup**|A time span value: _dd.hh:mm:ss_ where _dd_ = days, _hh_ = hours, _mm_ = minutes, and _ss_ = seconds.|You can't use the _Filter_ parameter to look for time span values for this property. Instead, use this syntax: `Get-Mailbox | where "$_.AuditLogAgeLimit -<Operator> '<TimeSpan>'"`. For example, `Get-Mailbox | where "$_.AuditLogAgeLimit -gt '60.00:00:00'"`.|
+|_AuthenticationPolicy_|_msExchAuthPolicyLink_|**Get-User**|String (wildcards accepted) or `$null`|For example, `Get-User -Filter "AuthenticationPolicy -eq 'CN=Block Basic Auth,CN=Auth Policies,CN=Configuration,CN=contoso.onmicrosoft.com,CN=ConfigurationUnits,DC=NAMPR11B009,DC=PROD,DC=OUTLOOK,DC=COM'"`.|
 |_BlockedSendersHash_|_msExchBlockedSendersHash_|**Get-Recipient**|Blank ( `$null`) or a hashed value.|Realistically, you can only use this value to filter on blank or non-blank values. For example, `Get-Recipient -Filter 'BlockedSendersHash -ne $null'.`|
 |_c_|_c_|**Get-Contact** <br/> **Get-LinkedUser** <br/> **Get-Recipient** <br/> **Get-SecurityPrincipal** <br/> **Get-User**|String (wildcards accepted) or `$null`|This filter requires the ISO 3166-1 two-letter country code for the user (for example, `S` for the United States). This property is used together with the _co_ and _countryCode_ properties to define the user's country in Active Directory. <br/> For example, `Get-User -Filter "c -eq 'US'"`.|
 |_CalendarLoggingQuota_|_msExchCalendarLoggingQuota_|**Get-Mailbox**|A byte quantified size value (for example, `300MB` or `1.5GB`), or `Unlimited`. Unqualified values are treated as bytes.|You can only use the _Filter_ parameter to look for the value `Unlimited` for this property. For example, `Get-Mailbox -Filter "CalendarLoggingQuota -eq 'Unlimited'"` or `Get-Mailbox -Filter "CalendarLoggingQuota -ne 'Unlimited'"`. <br/> You can't use the _Filter_ parameter to look for size values of this property. Instead, use this syntax: `Get-Mailbox | where "$_.CalendarLoggingQuota -<Operator> '<Size>'"`. For example, `Get-Mailbox | where "$_.CalendarLoggingQuota -gt '10GB'"`.|

exchange/exchange-ps/exchange/mailboxes/Add-MailboxFolderPermission.md

@@ -123,7 +123,9 @@ Accept wildcard characters: False
 ```
 
 ### -Identity
-The Identity parameter specifies the target mailbox and folder. The syntax is \<Mailbox\>:\\\<Folder\>. For the value of \<Mailbox\>, you can use any value that uniquely identifies the mailbox. For example:
+The Identity parameter specifies the target mailbox and folder. The syntax is `MailboxID:\ParentFolder[\SubFolder]`.
+
+For the value of `MailboxID`, you can use any value that uniquely identifies the mailbox. For example:
 
 - Name
 
@@ -145,7 +147,7 @@ The Identity parameter specifies the target mailbox and folder. The syntax is \<
 
 - User ID or user principal name (UPN)
 
-Example values for the Identity parameter are [email protected]:\\Calendar or John:\\Marketing\\Reports.
+Example values for this parameter are `[email protected]:\Calendar` or `John:\Inbox\Reports`.
 
 ```yaml
 Type: MailboxFolderIdParameter

exchange/exchange-ps/exchange/mailboxes/Get-MailboxCalendarFolder.md

@@ -57,23 +57,31 @@ This example returns all provided publishing information for the specified calen
 ## PARAMETERS
 
 ### -Identity
-The Identity parameter specifies the mailbox and folder path or folder name to the calendar folder that has the publishing settings configured. You can use the following values:
+The Identity parameter specifies the calendar folder that you want to view. The syntax is `MailboxID:\ParentFolder[\SubFolder]`.
 
-- GUID
+For the value of `MailboxID`, you can use any value that uniquely identifies the mailbox. For example:
+
+- Name
 
-- ADObjectID
+- Alias
 
 - Distinguished name (DN)
 
-- Domain\\Account
+- Canonical DN
+
+- \<domain name\>\\\<account name\>
 
-- User principal name (UPN)
+- Email address
+
+- GUID
 
 - LegacyExchangeDN
 
-- SmtpAddress
+- SamAccountName
 
-- Alias
+- User ID or user principal name (UPN)
+
+Example values for this parameter are `[email protected]:\Calendar` or `John:\Calendar`.
 
 ```yaml
 Type: MailboxFolderIdParameter

exchange/exchange-ps/exchange/mailboxes/Get-MailboxFolder.md

@@ -136,9 +136,9 @@ Accept wildcard characters: False
 ```
 
 ### -Identity
-The Identity parameter specifies the mailbox and the folder that you want to view. If you don't specify the folder, the command returns information about folders in the root hierarchy of the specified mailbox. You specify values for this parameter by using the syntax: \<Mailbox Identity\>:\<Parent\>.
+The Identity parameter specifies the mailbox folder that you want to view. The syntax is `MailboxID:\ParentFolder[\SubFolder]`.
 
-Valid values for \<Mailbox Identity\> are unique identifiers for the mailbox. For example:
+For the value of `MailboxID`, you can use any value that uniquely identifies the mailbox. For example:
 
 - Name
 
@@ -160,7 +160,9 @@ Valid values for \<Mailbox Identity\> are unique identifiers for the mailbox. Fo
 
 - User ID or user principal name (UPN)
 
-Values for \<Parent\> can be both the store object ID and a path string such as \\Inbox\\Personal.
+If you don't specify the folder, the command returns information about folders in the root hierarchy of the specified mailbox.
+
+Example values for this parameter are `[email protected]:`, `John:\Inbox`.
 
 ```yaml
 Type: MailboxFolderIdParameter

exchange/exchange-ps/exchange/mailboxes/Get-MailboxFolderPermission.md

@@ -55,7 +55,9 @@ This example returns the permissions for the Calendar folder in John's mailbox,
 ## PARAMETERS
 
 ### -Identity
-The Identity parameter specifies the mailbox folder that you want to view. This parameter uses the syntax: \<Mailbox\>:\\\<Folder\>. For the value of \<Mailbox\>, you can use any value that uniquely identifies the mailbox. For example:
+The Identity parameter specifies the mailbox folder that you want to view. The syntax is `MailboxID:\ParentFolder[\SubFolder]`.
+
+For the value of `MailboxID`, you can use any value that uniquely identifies the mailbox. For example:
 
 - Name
 
@@ -77,7 +79,7 @@ The Identity parameter specifies the mailbox folder that you want to view. This
 
 - User ID or user principal name (UPN)
 
-Example values for this parameter are [email protected]:\\Calendar or John:\\Marketing\\Reports.
+Example values for this parameter are `[email protected]:\Calendar` or `John:\Inbox\Reports`.
 
 ```yaml
 Type: MailboxFolderIdParameter

exchange/exchange-ps/exchange/mailboxes/New-InboxRule.md

@@ -331,7 +331,31 @@ Accept wildcard characters: False
 ```
 
 ### -CopyToFolder
-The CopyToFolder parameter specifies an action for the Inbox rule that copies messages to the specified mailbox folder. You can specify the existing folder by name, or by the store object ID and a path string (for example, \\Inbox\\Personal).
+The CopyToFolder parameter specifies an action for the Inbox rule that copies messages to the specified mailbox folder. The syntax is `MailboxID:\ParentFolder[\SubFolder]`.
+
+For the value of `MailboxID`, you can use any value that uniquely identifies the mailbox. For example:
+
+- Name
+
+- Alias
+
+- Distinguished name (DN)
+
+- Canonical DN
+
+- \<domain name\>\\\<account name\>
+
+- Email address
+
+- GUID
+
+- LegacyExchangeDN
+
+- SamAccountName
+
+- User ID or user principal name (UPN)
+
+Example values for this parameter are `[email protected]:\Marketing` or `John:\Inbox\Reports`.
 
 ```yaml
 Type: MailboxFolderIdParameter
@@ -1409,7 +1433,31 @@ Accept wildcard characters: False
 ```
 
 ### -MoveToFolder
-The MoveToFolder parameter specifies an action for the Inbox rule that moves messages to the specified mailbox folder. You can specify the existing folder by name, or by the store object ID and a path string (for example, \\Inbox\\Personal).
+The MoveToFolder parameter specifies an action for the Inbox rule that moves messages to the specified mailbox folder. The syntax is `MailboxID:\ParentFolder[\SubFolder]`.
+
+For the value of `MailboxID`, you can use any value that uniquely identifies the mailbox. For example:
+
+- Name
+
+- Alias
+
+- Distinguished name (DN)
+
+- Canonical DN
+
+- \<domain name\>\\\<account name\>
+
+- Email address
+
+- GUID
+
+- LegacyExchangeDN
+
+- SamAccountName
+
+- User ID or user principal name (UPN)
+
+Example values for this parameter are `[email protected]:\Marketing` or `John:\Inbox\Reports`.
 
 ```yaml
 Type: MailboxFolderIdParameter

exchange/exchange-ps/exchange/mailboxes/New-MailboxFolder.md

@@ -73,9 +73,9 @@ Accept wildcard characters: False
 ```
 
 ### -Parent
-The Parent parameter specifies values of the mailbox identity and the parent folder under which the new folder is to be created. If the parent folder isn't specified, the cmdlet creates the folder in the root folder hierarchy of the specified mailbox. You specify values for this parameter by using the syntax: \<Mailbox Identity\>:\<Parent\>
+The Parent parameter specifies where to create the new mailbox folder. The syntax is `MailboxID:\ParentFolder[\SubFolder]`.
 
-Valid values for \<Mailbox Identity\> are unique identifiers for the mailbox. For example:
+For the value of `MailboxID`, you can use any value that uniquely identifies the mailbox. For example:
 
 - Name
 
@@ -97,7 +97,9 @@ Valid values for \<Mailbox Identity\> are unique identifiers for the mailbox. Fo
 
 - User ID or user principal name (UPN)
 
-Values for \<Parent\> can be both the store object ID and a path string such as "\\Inbox\\Personal".
+If you don't specify the parent folder, the command creates the folder in the root folder hierarchy of the specified mailbox.
+
+Example values for this parameter are `[email protected]:`, `John:\Inbox`
 
 ```yaml
 Type: MailboxFolderIdParameter

exchange/exchange-ps/exchange/mailboxes/New-SweepRule.md

@@ -112,9 +112,31 @@ Accept wildcard characters: False
 ```
 
 ### -DestinationFolder
-The DestinationFolder parameter specifies an action for the Sweep rule that moves messages to the specified folder based on the conditions of the rule.
+The DestinationFolder parameter specifies an action for the Sweep rule that moves messages to the specified folder. The syntax is `MailboxID:\ParentFolder[\SubFolder]`.
 
-The default value is Deleted Items.
+For the value of `MailboxID`, you can use any value that uniquely identifies the mailbox. For example:
+
+- Name
+
+- Alias
+
+- Distinguished name (DN)
+
+- Canonical DN
+
+- \<domain name\>\\\<account name\>
+
+- Email address
+
+- GUID
+
+- LegacyExchangeDN
+
+- SamAccountName
+
+- User ID or user principal name (UPN)
+
+Example values for this parameter are `[email protected]:\Unimportant` or `John:\Inbox\Misc`. The default value is `MailboxID:\Deleted Items`.
 
 ```yaml
 Type: MailboxFolderIdParameter
@@ -336,9 +358,31 @@ Accept wildcard characters: False
 ```
 
 ### -SourceFolder
-The SourceFolder parameter specifies a condition for the Sweep rule that looks for messages in the specified folder.
+The SourceFolder parameter specifies a condition for the Sweep rule that looks for messages in the specified folder. The syntax is `MailboxID:\ParentFolder[\SubFolder]`.
+
+For the value of `MailboxID`, you can use any value that uniquely identifies the mailbox. For example:
+
+- Name
+
+- Alias
+
+- Distinguished name (DN)
+
+- Canonical DN
+
+- \<domain name\>\\\<account name\>
+
+- Email address
+
+- GUID
+
+- LegacyExchangeDN
+
+- SamAccountName
+
+- User ID or user principal name (UPN)
 
-The default value is Inbox.
+Example values for this parameter are `[email protected]:\Marketing` or `John:\Inbox\Reports`. The default value is `MailboxID:\Inbox`.
 
 ```yaml
 Type: MailboxFolderIdParameter

exchange/exchange-ps/exchange/mailboxes/Set-InboxRule.md

@@ -283,7 +283,31 @@ Accept wildcard characters: False
 ```
 
 ### -CopyToFolder
-The CopyToFolder parameter specifies an action for the Inbox rule that copies messages to the specified mailbox folder. You can specify the existing folder by name, or by the store object ID and a path string (for example, \\Inbox\\Personal).
+The CopyToFolder parameter specifies an action for the Inbox rule that copies messages to the specified mailbox folder. The syntax is `MailboxID:\ParentFolder[\SubFolder]`.
+
+For the value of `MailboxID`, you can use any value that uniquely identifies the mailbox. For example:
+
+- Name
+
+- Alias
+
+- Distinguished name (DN)
+
+- Canonical DN
+
+- \<domain name\>\\\<account name\>
+
+- Email address
+
+- GUID
+
+- LegacyExchangeDN
+
+- SamAccountName
+
+- User ID or user principal name (UPN)
+
+Example values for this parameter are `[email protected]:\Marketing` or `John:\Inbox\Reports`.
 
 ```yaml
 Type: MailboxFolderIdParameter
@@ -1377,7 +1401,31 @@ Accept wildcard characters: False
 ```
 
 ### -MoveToFolder
-The MoveToFolder parameter specifies an action for the Inbox rule that moves messages to the specified mailbox folder. You can specify the existing folder by name, or by the store object ID and a path string (for example, \\Inbox\\Personal).
+The MoveToFolder parameter specifies an action for the Inbox rule that moves messages to the specified mailbox folder. The syntax is `MailboxID:\ParentFolder[\SubFolder]`.
+
+For the value of `MailboxID`, you can use any value that uniquely identifies the mailbox. For example:
+
+- Name
+
+- Alias
+
+- Distinguished name (DN)
+
+- Canonical DN
+
+- \<domain name\>\\\<account name\>
+
+- Email address
+
+- GUID
+
+- LegacyExchangeDN
+
+- SamAccountName
+
+- User ID or user principal name (UPN)
+
+Example values for this parameter are `[email protected]:\Marketing` or `John:\Inbox\Reports`.
 
 ```yaml
 Type: MailboxFolderIdParameter