Merge branch 'master' into patch-97

chrisda · web-flow · commit 33641f1f64b1 · 2020-02-18T15:35:27.000-08:00
diff --git a/exchange/exchange-ps/exchange/mailboxes/Add-MailboxFolderPermission.md b/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 john@contoso.com:\\Calendar or John:\\Marketing\\Reports.
+Example values for this parameter are `john@contoso.com:\Calendar` or `John:\Inbox\Reports`.
 
 ```yaml
 Type: MailboxFolderIdParameter
diff --git a/exchange/exchange-ps/exchange/mailboxes/Get-MailboxCalendarFolder.md b/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 `john@contoso.com:\Calendar` or `John:\Calendar`.
 
 ```yaml
 Type: MailboxFolderIdParameter
diff --git a/exchange/exchange-ps/exchange/mailboxes/Get-MailboxFolder.md b/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 `john@contoso.com:`, `John:\Inbox`.
 
 ```yaml
 Type: MailboxFolderIdParameter
diff --git a/exchange/exchange-ps/exchange/mailboxes/Get-MailboxFolderPermission.md b/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 john@contoso.com:\\Calendar or John:\\Marketing\\Reports.
+Example values for this parameter are `john@contoso.com:\Calendar` or `John:\Inbox\Reports`.
 
 ```yaml
 Type: MailboxFolderIdParameter
diff --git a/exchange/exchange-ps/exchange/mailboxes/New-InboxRule.md b/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 `john@contoso.com:\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 `john@contoso.com:\Marketing` or `John:\Inbox\Reports`.
 
 ```yaml
 Type: MailboxFolderIdParameter
diff --git a/exchange/exchange-ps/exchange/mailboxes/New-MailboxFolder.md b/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 `john@contoso.com:`, `John:\Inbox`
 
 ```yaml
 Type: MailboxFolderIdParameter
diff --git a/exchange/exchange-ps/exchange/mailboxes/New-SweepRule.md b/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 `john@contoso.com:\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 `john@contoso.com:\Marketing` or `John:\Inbox\Reports`. The default value is `MailboxID:\Inbox`.
 
 ```yaml
 Type: MailboxFolderIdParameter
diff --git a/exchange/exchange-ps/exchange/mailboxes/Set-InboxRule.md b/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 `john@contoso.com:\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 `john@contoso.com:\Marketing` or `John:\Inbox\Reports`.
 
 ```yaml
 Type: MailboxFolderIdParameter
diff --git a/exchange/exchange-ps/exchange/mailboxes/Set-MailboxCalendarFolder.md b/exchange/exchange-ps/exchange/mailboxes/Set-MailboxCalendarFolder.md
@@ -62,23 +62,31 @@ This example enables the calendar in Kai's mailbox to be searchable on the web.
 ## 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 modify. 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 `john@contoso.com:\Calendar` or `John:\Calendar`
 
 ```yaml
 Type: MailboxFolderIdParameter
diff --git a/exchange/exchange-ps/exchange/mailboxes/Set-MailboxFolderPermission.md b/exchange/exchange-ps/exchange/mailboxes/Set-MailboxFolderPermission.md
@@ -145,7 +145,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
 
@@ -167,7 +169,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 john@contoso.com:\\Calendar or John:\\Marketing\\Reports.
+Example values for this parameter are `john@contoso.com:\Calendar` or `John:\Inbox\Reports`.
 
 ```yaml
 Type: MailboxFolderIdParameter
diff --git a/exchange/exchange-ps/exchange/mailboxes/Set-SweepRule.md b/exchange/exchange-ps/exchange/mailboxes/Set-SweepRule.md
diff --git a/exchange/exchange-ps/exchange/organization/Set-OrganizationConfig.md b/exchange/exchange-ps/exchange/organization/Set-OrganizationConfig.md
diff --git a/exchange/exchange-ps/exchange/policy-and-compliance-dlp/New-DlpComplianceRule.md b/exchange/exchange-ps/exchange/policy-and-compliance-dlp/New-DlpComplianceRule.md
diff --git a/exchange/exchange-ps/exchange/users-and-groups/New-DistributionGroup.md b/exchange/exchange-ps/exchange/users-and-groups/New-DistributionGroup.md
diff --git a/exchange/exchange-ps/exchange/users-and-groups/Set-DistributionGroup.md b/exchange/exchange-ps/exchange/users-and-groups/Set-DistributionGroup.md
