Merge branch 'master' into patch-339

Author: Kateyanne

exchange/exchange-ps/exchange/Add-ADPermission.md

@@ -133,9 +133,26 @@ Accept wildcard characters: False
 ```
 
 ### -Owner
-The Owner parameter specifies the owner of the Active Directory object. If the name of the owner contains spaces, enclose the name in quotation marks (").
+The Owner parameter specifies the owner of the Active Directory object. You can specify the following types of users or groups (security principals) for this parameter:
 
-The Owner parameter can only be used with the Identity parameter and no other parameters.
+- Mailbox users
+- Mail users
+- Security groups
+
+You can use any value that uniquely identifies the user or group. For example:
+
+- Name
+- Alias
+- Distinguished name (DN)
+- Canonical DN
+- Domain\\Username
+- Email address
+- GUID
+- LegacyExchangeDN
+- SamAccountName
+- User ID or user principal name (UPN)
+
+You can't use this parameter with the AccessRights or User parameters.
 
 ```yaml
 Type: SecurityPrincipalIdParameter
@@ -151,7 +168,26 @@ Accept wildcard characters: False
 ```
 
 ### -User
-The User parameter specifies the user that the permissions are being granted to on the object. If the name contains spaces, enclose the name in quotation marks (").
+The User parameter specifies who gets the permissions on the Active Directory object. You can specify the following types of users or groups (security principals) for this parameter:
+
+- Mailbox users
+- Mail users
+- Security groups
+
+You can use any value that uniquely identifies the user or group. For example:
+
+- Name
+- Alias
+- Distinguished name (DN)
+- Canonical DN
+- Domain\\Username
+- Email address
+- GUID
+- LegacyExchangeDN
+- SamAccountName
+- User ID or user principal name (UPN)
+
+You can't use this parameter with the Owner parameter.
 
 ```yaml
 Type: SecurityPrincipalIdParameter
@@ -180,7 +216,7 @@ Accept wildcard characters: False
 ```
 
 ### -AccessRights
-The AccessRights parameter specifies the rights needed to perform the operation. Valid values include:
+The AccessRights parameter specifies the rights that you want to add for the user on the Active Directory object. Valid values include:
 
 - AccessSystemSecurity
 - CreateChild
@@ -202,6 +238,10 @@ The AccessRights parameter specifies the rights needed to perform the operation.
 - GenericAll
 - Synchronize
 
+You can specify multiple values separated by commas.
+
+You can't use this parameter with the Owner parameter.
+
 ```yaml
 Type: ActiveDirectoryRights[]
 Parameter Sets: AccessRights, Instance

exchange/exchange-ps/exchange/Add-MailboxPermission.md

@@ -139,7 +139,7 @@ Accept wildcard characters: False
 ```
 
 ### -AccessRights
-The AccessRights parameter specifies the permission that you want to assign to the user on the mailbox. Valid values are:
+The AccessRights parameter specifies the permission that you want to add for the user on the mailbox. Valid values are:
 
 - ChangeOwner
 - ChangePermission
@@ -150,6 +150,8 @@ The AccessRights parameter specifies the permission that you want to assign to t
 
 You can specify multiple values separated by commas.
 
+You can't use this parameter with the Owner parameter.
+
 ```yaml
 Type: MailboxRights[]
 Parameter Sets: AccessRights
@@ -195,14 +197,28 @@ Accept wildcard characters: False
 ```
 
 ### -Owner
-The Owner parameter specifies the owner of the mailbox object. The default mailbox owner is NT AUTHORITY\\SELF.
+The Owner parameter specifies the owner of the mailbox object. You can specify the following types of users or groups (security principals) for this parameter:
+
+- Mailbox users
+- Mail users
+- Security groups
 
-The owner that you specify for this parameter must be a user or security group (a security principal that can have permissions assigned). You can use any value that uniquely identifies the owner. For example: For example:
+You can use any value that uniquely identifies the user or group. For example:
 
 - Name
+- Alias
 - Distinguished name (DN)
 - Canonical DN
+- Domain\\Username
+- Email address
 - GUID
+- LegacyExchangeDN
+- SamAccountName
+- User ID or user principal name (UPN)
+
+The default mailbox owner is NT AUTHORITY\\SELF.
+
+You can't use this parameter with the AccessRights or User parameters.
 
 ```yaml
 Type: SecurityPrincipalIdParameter
@@ -218,14 +234,26 @@ Accept wildcard characters: False
 ```
 
 ### -User
-The User parameter specifies the user that you're assigning the permission to.
+The User parameter specifies who gets the permissions on the mailbox. You can specify the following types of users or groups (security principals) for this parameter:
+
+- Mailbox users
+- Mail users
+- Security groups
 
-The user that you specify for this parameter must be a user or security group (a security principal that can have permissions assigned). You can use any value that uniquely identifies the user. For example: For example:
+You can use any value that uniquely identifies the user or group. For example:
 
 - Name
+- Alias
 - Distinguished name (DN)
 - Canonical DN
+- Domain\\Username
+- Email address
 - GUID
+- LegacyExchangeDN
+- SamAccountName
+- User ID or user principal name (UPN)
+
+You can't use this parameter with the Owner parameter.
 
 ```yaml
 Type: SecurityPrincipalIdParameter
@@ -330,7 +358,7 @@ Accept wildcard characters: False
 ### -GroupMailbox
 This parameter is available only in the cloud-based service.
 
-The GroupMailbox switch is required to modify Group Mailboxes in Exchange Online. You don't need to specify a value with this switch.
+The GroupMailbox switch is required to add permissions to a Microsoft 365 Group mailbox. You don't need to specify a value with this switch.
 
 ```yaml
 Type: SwitchParameter

exchange/exchange-ps/exchange/Add-PublicFolderAdministrativePermission.md

@@ -109,7 +109,7 @@ Accept wildcard characters: False
 ```
 
 ### -AccessRights
-The AccessRights parameter specifies the rights that are being added. Valid values include:
+The AccessRights parameter specifies the rights that you want to add for the administrator on the public folder. Valid values include:
 
 - None The administrator has no rights to modify public folder attributes.
 - ModifyPublicFolderACL The administrator has the right to modify client access permissions for the specified folder.
@@ -122,6 +122,10 @@ The AccessRights parameter specifies the rights that are being added. Valid valu
 - ViewInformationStore The administrator has the right to view public folder properties.
 - AllExtendedRights The administrator has the right to modify all public folder properties.
 
+You can specify multiple values separated by commas.
+
+You can't use this parameter with the Owner parameter.
+
 ```yaml
 Type: MultiValuedProperty
 Parameter Sets: Identity
@@ -165,7 +169,26 @@ Accept wildcard characters: False
 ```
 
 ### -Owner
-The Owner parameter specifies the NT Owner access control list (ACL) on the object. Valid values are the user principal name (UPN), domain\\user, or alias.
+The Owner parameter specifies the owner of the public folder object. You can specify the following types of users or groups (security principals) for this parameter:
+
+- Mailbox users
+- Mail users
+- Security groups
+
+You can use any value that uniquely identifies the user or group. For example:
+
+- Name
+- Alias
+- Distinguished name (DN)
+- Canonical DN
+- Domain\\Username
+- Email address
+- GUID
+- LegacyExchangeDN
+- SamAccountName
+- User ID or user principal name (UPN)
+
+You can't use this parameter with the AccessRights or User parameters.
 
 ```yaml
 Type: SecurityPrincipalIdParameter
@@ -181,7 +204,26 @@ Accept wildcard characters: False
 ```
 
 ### -User
-The User parameter specifies the UPN, domain\\user, or alias of the user for whom rights are being added.
+The User parameter specifies who gets the admin permissions on the public folder. You can specify the following types of users or groups:
+
+- Mailbox users
+- Mail users
+- Security groups
+
+You can use any value that uniquely identifies the user or group. For example:
+
+- Name
+- Alias
+- Distinguished name (DN)
+- Canonical DN
+- Domain\\Username
+- Email address
+- GUID
+- LegacyExchangeDN
+- SamAccountName
+- User ID or user principal name (UPN)
+
+You can't use this parameter with the Owner parameter.
 
 ```yaml
 Type: SecurityPrincipalIdParameter

exchange/exchange-ps/exchange/Add-PublicFolderClientPermission.md

@@ -69,7 +69,11 @@ Accept wildcard characters: False
 ```
 
 ### -AccessRights
-The AccessRights parameter specifies the rights being added. This parameter accepts the following values:
+The AccessRights parameter specifies the rights that you want to add for the user on the public folder.
+
+You can specify individual folder permissions or roles, which are combinations of permissions. You can specify multiple permissions and roles separated by commas.
+
+The following individual permissions are available:
 
 - ReadItems: The user has the right to read items within the specified public folder.
 - CreateItems: The user has the right to create items within the specified public folder.

exchange/exchange-ps/exchange/Add-RecipientPermission.md

@@ -82,7 +82,7 @@ Accept wildcard characters: False
 ```
 
 ### -AccessRights
-The AccessRights parameter specifies the permission. The only value for this parameter is SendAs.
+The AccessRights parameter specifies the permission that you want to add for the trustee on the target recipient. The only valid value for this parameter is SendAs.
 
 ```yaml
 Type: MultiValuedProperty
@@ -98,12 +98,10 @@ Accept wildcard characters: False
 ```
 
 ### -Trustee
-The Trustee parameter specifies the user or group that receives SendAs permission on the recipient specified by the Identity parameter.
-
-You can specify the following types of users or groups (security principals) for this parameter:
+The Trustee parameter specifies the user or group that receives SendAs permission on the recipient specified by the Identity parameter. You can specify the following types of users or groups (security principals) for this parameter:
 
 - Mailbox users
-- Mail users with a Microsoft account (formerly known as a Windows Live ID)
+- Mail users with a Microsoft account
 - Security groups
 
 You can use any value that uniquely identifies the user or group. For example:

exchange/exchange-ps/exchange/Add-RoleGroupMember.md

@@ -89,7 +89,24 @@ Accept wildcard characters: False
 ```
 
 ### -Member
-The Member parameter specifies the mailbox, USG, or computer to add to a role group. You can only specify one member at a time. If the member name contains spaces, enclose the name in quotation marks (").
+The Member parameter specifies who you want to add to the role group. You can specify the following types of users or groups (security principals) for this parameter:
+
+- Mailbox users
+- Mail users
+- Security groups
+
+You can use any value that uniquely identifies the user or group. For example:
+
+- Name
+- Alias
+- Distinguished name (DN)
+- Canonical DN
+- Domain\\Username
+- Email address
+- GUID
+- LegacyExchangeDN
+- SamAccountName
+- User ID or user principal name (UPN)
 
 ```yaml
 Type: SecurityPrincipalIdParameter

exchange/exchange-ps/exchange/Disable-App.md

@@ -52,6 +52,13 @@ Disable-App -Identity <GUID for FinanceTestApp> -Mailbox Tony
 
 This example disables the administrator-installed app FinanceTestApp for user Tony.
 
+### Example 3
+```powershell
+Disable-App -Identity 545d8236-721a-468f-85d8-254eca7cb0da -Mailbox Tony
+```
+
+This example disables the Share to Teams app for user Tony.
+
 ## PARAMETERS
 
 ### -Identity

exchange/exchange-ps/exchange/Enable-App.md

@@ -52,6 +52,13 @@ Enable-App -Identity <GUID for FinanceTestApp> -Mailbox Tony
 
 This example enables the administrator-installed app FinanceTestApp for user Tony.
 
+### Example 1
+```powershell
+Enable-App -Identity 545d8236-721a-468f-85d8-254eca7cb0da -Mailbox Tony
+```
+
+This example enables the Share to Teams app for user Tony.
+
 ## PARAMETERS
 
 ### -Identity

exchange/exchange-ps/exchange/Get-ADPermission.md

@@ -94,7 +94,9 @@ Accept wildcard characters: False
 ```
 
 ### -Owner
-The Owner switch specifies that the owner of the object specified in the Identity parameter should be returned. If the Owner switch is used, the User parameter can't be used.
+The Owner switch returns the owner of the Active Directory object. You don't need to specify a value with this switch.
+
+You can't use this switch with the User parameter.
 
 ```yaml
 Type: SwitchParameter
@@ -110,9 +112,26 @@ Accept wildcard characters: False
 ```
 
 ### -User
-The User parameter specifies that only the access control entries (ACEs) granted to the specified user on the object specified in the Identity parameter should be returned. If the User parameter is used, the Owner switch can't be used.
-
-If the name of the user contains spaces, enclose the name in quotation marks (").
+The user parameter filters the results who has permissions on the Active Directory object. You can specify the following types of users or groups (security principals) for this parameter:
+
+- Mailbox users
+- Mail users
+- Security groups
+
+You can use any value that uniquely identifies the user or group. For example:
+
+- Name
+- Alias
+- Distinguished name (DN)
+- Canonical DN
+- Domain\\Username
+- Email address
+- GUID
+- LegacyExchangeDN
+- SamAccountName
+- User ID or user principal name (UPN)
+
+You can't use this parameter with the Owner parameter.
 
 ```yaml
 Type: SecurityPrincipalIdParameter