Merge branch 'main' into Viva-chrisda

Author: chrisda

.openpublishing.build.ps1

@@ -0,0 +1,77 @@
+---
+external help file: Microsoft.Exchange.RolesAndAccess-Help.xml
+online version: https://learn.microsoft.com/powershell/module/exchange/expedite-delicensing
+applicable: Exchange Online
+title: Expedite-Delicensing
+schema: 2.0.0
+author: chrisda
+ms.author: chrisda
+ms.reviewer:
+---
+
+# Expedite-Delicensing
+
+## SYNOPSIS
+This cmdlet is available only in the cloud-based service.
+
+Use the Expedite-Delicensing cmdlet to end the delay for removing mailbox licenses from users. After you remove the delay, the licenses are removed from mailboxes within 24 hours. You configure delayed mailbox license removal using the DelayedDelicensingEnabled parameter on the Set-OrganizationConfig cmdlet.
+
+For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
+
+## SYNTAX
+
+```
+Expedite-Delicensing [-Identity] <RecipientIdParameter>
+ [<CommonParameters>]
+```
+
+## DESCRIPTION
+You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://learn.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
+
+## EXAMPLES
+
+### Example 1
+```powershell
+Expedite-Delicensing -Identity [email protected]
+```
+
+This example ends the delay for the mailbox license removal request on the specified mailbox. Typically, the mailbox license is removed from the mailbox within 30 minutes after running the command, but it might take up to 24 hours.
+
+## PARAMETERS
+
+### -Identity
+The Identity parameter specifies the mailbox with a pending mailbox license removal request.
+
+You can use any value that uniquely identifies the mailbox. For example:
+
+- Name
+- Alias
+- Distinguished name (DN)
+- Email address
+- GUID
+- LegacyExchangeDN
+- User ID or user principal name (UPN)
+
+```yaml
+Type: RecipientIdParameter
+Parameter Sets: (All)
+Aliases:
+Applicable: Exchange Online
+
+Required: True
+Position: 1
+Default value: None
+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).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+
+## RELATED LINKS

exchange/exchange-ps/exchange/Expedite-Delicensing.md

@@ -109,6 +109,8 @@ The Mailbox parameter specifies the identity of the mailbox where the apps are i
 
 You can't use this parameter with the Identity parameter.
 
+Note: This parameter only returns user installed and default add-ins. It doesn't return add-ins installed by admins from Integrated Apps. For more information, see [Deploy and manage Office Add-ins](https://learn.microsoft.com/microsoft-365/admin/manage/office-addins).
+
 ```yaml
 Type: MailboxIdParameter
 Parameter Sets: (All)

exchange/exchange-ps/exchange/Get-App.md

@@ -61,7 +61,7 @@ This example retrieves the minimum set of properties and the specified propertie
 ## PARAMETERS
 
 ### -Archive
-The Archive switch parameter specifies whether to return mailbox statistics for the archive mailbox associated with the specified mailbox. You don't need to specify a value with this switch.
+The Archive switch specifies whether to return mailbox statistics for the archive mailbox associated with the specified mailbox. You don't need to specify a value with this switch.
 
 ```yaml
 Type: SwitchParameter

exchange/exchange-ps/exchange/Get-EXOMailboxStatistics.md

@@ -35,9 +35,16 @@ If IPv6 is enabled for an accepted domain in Exchange Online, IPv4 and IPv6 addr
 You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://learn.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
 
 > [!NOTE]
-> When you use the Enable-IPv6ForAcceptedDomain or Disable-IPv6ForAcceptedDomain cmdlets to update the IPv6 setting for an accepted domain, the updated status can take up to an hour to be visible using Get-IPv6StatusForAcceptedDomain due to caching.
 >
-> For example, Get-IPv6StatusForAcceptedDomain shows the status value Enabled for a domain. You run Disable-IPv6ForAcceptedDomain to disable IPv6 for the domain, you immediately run Get-IPv6StatusForAcceptedDomain to check the staus of the domain, and the command erroneously returns the value Enabled. It might take up to an hour before Get-IPv6StatusForAcceptedDomain shows the correct value Disabled for the domain.
+> - When you use the Enable-IPv6ForAcceptedDomain or Disable-IPv6ForAcceptedDomain cmdlets to update the IPv6 setting for an accepted domain, the updated status can take up to an hour to be visible using Get-IPv6StatusForAcceptedDomain due to caching.
+>
+>   For example, Get-IPv6StatusForAcceptedDomain shows the status value Enabled for a domain. You run Disable-IPv6ForAcceptedDomain to disable IPv6 for the domain, you immediately run Get-IPv6StatusForAcceptedDomain to check the status of the domain, and the command erroneously returns the value Enabled. It might take up to an hour before Get-IPv6StatusForAcceptedDomain shows the correct value Disabled for the domain.
+>
+> - If you receive the following error when running Get-Ipv6StatusForAcceptedDomain:
+>
+>   WARNING: DNS record has unexpected value…..
+>
+>   Explicitly enable or disable IPv6 using the Enable-Ipv6ForAcceptedDomain or Disable-Ipv6ForAcceptedDomain cmdlets.
 
 ## EXAMPLES
 
@@ -101,7 +108,10 @@ 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).
 
+## INPUTS
 
+## OUTPUTS
 
+## NOTES
 
-
+## RELATED LINKS

exchange/exchange-ps/exchange/Get-IPv6StatusForAcceptedDomain.md

@@ -52,9 +52,9 @@ Get-MailUser [[-Identity] <MailUserIdParameter>]
  [<CommonParameters>]
 ```
 
-### LOBAppAccount
+### HVEAccount
 ```
-Get-MailUser [-LOBAppAccount]
+Get-MailUser [-HVEAccount]
  [-Filter <String>]
  [-OrganizationalUnit <OrganizationalUnitIdParameter>]
  [-ResultSize <Unlimited>]
@@ -216,20 +216,20 @@ Accept pipeline input: false
 Accept wildcard characters: False
 ```
 
-### -LOBAppAccount
+### -HVEAccount
 This parameter is available only in the cloud-based service.
 
-{{ Fill LOBAppAccount Description }}
+The HVEAccount switch specifies that this mail user account is specifically used for the [High volume email service](https://learn.microsoft.com/exchange/mail-flow-best-practices/high-volume-mails-m365). You don't need to specify a value with this switch.
 
 ```yaml
 Type: SwitchParameter
 Parameter Sets: LOBAppAccount
 Aliases:
 Applicable: Exchange Online, Exchange Online Protection
 
-Required: False
 Position: Named
 Default value: None
+Required: False
 Accept pipeline input: False
 Accept wildcard characters: False
 ```

exchange/exchange-ps/exchange/Get-MailUser.md

@@ -0,0 +1,135 @@
+---
+external help file: Microsoft.Exchange.RolesAndAccess-Help.xml
+online version: https://learn.microsoft.com/powershell/module/exchange/get-pendingdelicenseuser
+applicable: Exchange Online
+title: Get-PendingDelicenseUser
+schema: 2.0.0
+author: chrisda
+ms.author: chrisda
+ms.reviewer:
+---
+
+
+# Get-PendingDelicenseUser
+
+## SYNOPSIS
+This cmdlet is available only in the cloud-based service.
+
+Use the Get-PendingDelicenseUser cmdlet to view information about mailboxes that have delayed mailbox license removal requests. You configure delayed mailbox license removal using the DelayedDelicensingEnabled parameter on the Set-OrganizationConfig cmdlet.
+
+For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
+
+## SYNTAX
+
+### Identity (Default)
+```
+Get-PendingDelicenseUser [[-Identity] <RecipientIdParameter>]
+ [<CommonParameters>]
+```
+
+### TenantLevelParameterSet
+```
+Get-PendingDelicenseUser [-ResultSize <Unlimited>] [-ShowDueObjectsOnly]
+ [<CommonParameters>]
+```
+
+## DESCRIPTION
+You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see [Find the permissions required to run any Exchange cmdlet](https://learn.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
+
+## EXAMPLES
+
+### Example 1
+```powershell
+Get-PendingDelicenseUser | Format-Table DisplayName,UserPrincipalName,WhenDueForDelicensingUTC
+```
+
+This example returns a summary list of all mailboxes that have pending mailbox license removal requests.
+
+### Example 2
+```powershell
+Get-PendingDelicenseUser -Identity [email protected]
+```
+
+This example returns detailed information about the pending mailbox license removal request for the specified mailbox.
+
+### Example 3
+```powershell
+Get-PendingDelicenseUser -ShowDueObjectsOnly | Format-Table DisplayName,UserPrincipalName,WhenDueForDelicensingUTC
+```
+
+This example returns a summary list of all mailboxes where the 30 day delay for mailbox license removal requests has ended, so the licenses can be removed from the mailboxes at any time. 
+
+## PARAMETERS
+
+### -Identity
+The Identity parameter specifies the mailbox with a pending mailbox license removal request.
+
+You can use any value that uniquely identifies the mailbox. For example:
+
+- Name
+- Alias
+- Distinguished name (DN)
+- Email address
+- GUID
+- LegacyExchangeDN
+- User ID or user principal name (UPN)
+
+You can't use this parameter with the ShowDueObjectsOnly switch.
+
+```yaml
+Type: RecipientIdParameter
+Parameter Sets: Identity
+Aliases:
+Applicable: Exchange Online
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ResultSize
+The ResultSize parameter specifies the maximum number of results to return. If you want to return all requests that match the query, use unlimited for the value of this parameter. The default value is 1000.
+
+```yaml
+Type: Unlimited
+Parameter Sets: TenantLevelParameterSet
+Aliases:
+Applicable: Exchange Online
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ShowDueObjectsOnly
+The ShowDueObjectsOnly switch filters the results by mailboxes where the 30 day delay for removing the license has ended, and the license can be removed from the mailbox at any time. You don't need to specify a value with this switch.
+
+You can't use this switch with the Identity parameter.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: TenantLevelParameterSet
+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).
+
+## INPUTS
+
+## OUTPUTS
+
+## NOTES
+
+## RELATED LINKS

exchange/exchange-ps/exchange/Get-PendingDelicenseUser.md

@@ -123,7 +123,7 @@ Accept wildcard characters: False
 ```
 
 ### -PolicyScopeGroupID
-The PolicyScopeGroupID parameter specifies the recipient to define in the policy. Valid recipient types are security principals in Exchange Online (users or groups that can have permissions assigned to them). For example:
+The PolicyScopeGroupID parameter specifies the recipient to define in the policy. Valid recipient types are security principals in Exchange Online (users or groups, including nested groups, that can have permissions assigned to them). For example:
 
 - Mailboxes with associated user accounts (UserMailbox)
 - Mail users, also known as mail-enabled users (MailUser)

exchange/exchange-ps/exchange/New-ApplicationAccessPolicy.md

@@ -451,6 +451,9 @@ Accept wildcard characters: False
 The Purge switch specifies the action for the content search is to remove items that match the search criteria. You don't need to specify a value with this switch.
 
 - A maximum of 10 items per mailbox can be removed at one time. Because the capability to search for and remove messages is intended to be an incident-response tool, this limit helps ensure that messages are quickly removed from mailboxes. This action isn't intended to clean up user mailboxes.
+
+  **Tip**: To purge more than 10 items, refer to [ediscoverySearch: purgeData](https://learn.microsoft.com/graph/api/security-ediscoverysearch-purgedata) in the Microsoft Graph API, which allows purging a maximum of 100 items per location.
+
 - You can remove items from a maximum of 50,000 mailboxes using a single content search. To remove items from more than 50,000 mailboxes, you'll have to create separate content searches. For more information, see [Search for and delete email messages in your Microsoft 365 organization](https://learn.microsoft.com/purview/ediscovery-search-for-and-delete-email-messages).
 - Unindexed items aren't removed from mailboxes when you use this switch.
 - The value of the PurgeType parameter controls how the items are removed.

exchange/exchange-ps/exchange/New-ComplianceSearchAction.md

@@ -127,7 +127,7 @@ New-MailUser [-Name] <String> -FederatedIdentity <String>
 
 ### LOBAppAccount
 ```
-New-MailUser [-Name] <String> -Password <SecureString> [-LOBAppAccount]
+New-MailUser [-Name] <String> -Password <SecureString> [-HVEAccount]
  [-Alias <String>]
  [-Confirm]
  [-DisplayName <String>]
@@ -531,20 +531,20 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -LOBAppAccount
+### -HVEAccount
 This parameter is available only in the cloud-based service.
 
-{{ Fill LOBAppAccount Description }}
+The HVEAccount switch specifies that this mail user account is specifically used for the [High volume email service](https://learn.microsoft.com/exchange/mail-flow-best-practices/high-volume-mails-m365). You don't need to specify a value with this switch.
 
 ```yaml
 Type: SwitchParameter
-Parameter Sets: LOBAppAccount
+Parameter Sets: HVEAccount
 Aliases:
 Applicable: Exchange Online, Exchange Online Protection
 
-Required: False
 Position: Named
 Default value: None
+Required: False
 Accept pipeline input: False
 Accept wildcard characters: False
 ```