Merge branch 'main' into patch-1

Author: LutingZhao

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

@@ -105,6 +105,11 @@ In Microsoft 365, the account that you use to run this cmdlet must have a valid
 
 To use this cmdlet in Security & Compliance PowerShell, you need to be assigned permissions. For more information, see [Permissions in the Microsoft Purview compliance portal](https://learn.microsoft.com/purview/microsoft-365-compliance-center-permissions).
 
+To use this cmdlet for Purge actions in Security & Compliance PowerShell, you need to meet the following requirements:
+
+- Use the Exchange Online PowerShell version 3.9.0 or later (August 2025). For more information, see [What's new in the Exchange Online PowerShell module](https://learn.microsoft.com/powershell/exchange/whats-new-in-the-exo-module). Installing this version of the module might require you to unisntall previous versions of the module.
+- Run the **Connect-IPPSSession** command with the [EnableSearchOnlySession](https://learn.microsoft.com/powershell/module/exchangepowershell/connect-ippssession#-enablesearchonlysession) switch.
+
 ## EXAMPLES
 
 ### Example 1

teams/teams-ps/MicrosoftTeams/Get-CsExportAcquiredPhoneNumberStatus.md

@@ -101,7 +101,5 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ## NOTES
 The cmdlet is available in Teams PowerShell module 6.1.0 or later.
 
-The cmdlet is only available in commercial and GCC cloud instances.
-
 ## RELATED LINKS
 [Get-CsExportAcquiredPhoneNumberStatus](https://learn.microsoft.com/powershell/module/microsoftteams/get-csexportacquiredphonenumberstatus)

teams/teams-ps/MicrosoftTeams/Get-CsPhoneNumberAssignment.md

@@ -85,6 +85,8 @@ PstnPartnerName         : Microsoft
 NumberSource            : Online
 ReverseNumberLookup		: {}
 Tag						: {}
+AssignmentBlockedState  :
+AssignmentBlockedUntil  :
 ```
 This example displays information about the Microsoft Calling Plan subscriber phone number +1 (402) 555-1234. You can see that it is assigned to a user.
 
@@ -114,6 +116,8 @@ PstnPartnerName         :
 NumberSource            : OnPremises
 ReverseNumberLookup		: {}
 Tag						: {}
+AssignmentBlockedState  :
+AssignmentBlockedUntil  :
 ```
 This example displays information about the Direct Routing phone number +1 (206) 555-1000;ext=524. You can see that it is assigned to a user.
 
@@ -186,6 +190,8 @@ PstnPartnerName         :
 NumberSource            : OnPremises
 ReverseNumberLookup		: {SkipInternalVoip}
 Tag						: {}
+AssignmentBlockedState  :
+AssignmentBlockedUntil  :
 ```
 This example displays when SkipInternalVoip option is turned on for a number.
 
@@ -215,6 +221,8 @@ PstnPartnerName         :
 NumberSource            : OnPremises
 ReverseNumberLookup		: {}
 Tag						: {}
+AssignmentBlockedState  :
+AssignmentBlockedUntil  :
 ```
 This example shows a way to use -Filter parameter to display information of a specific number.
 
@@ -244,6 +252,8 @@ PstnPartnerName         :
 NumberSource            : OnPremises
 ReverseNumberLookup		: {}
 Tag						: {}
+AssignmentBlockedState  :
+AssignmentBlockedUntil  :
 ```
 This example shows a way to get filtered results using multiple Filter parameters.
 
@@ -273,6 +283,8 @@ PstnPartnerName         :
 NumberSource            : OnPremises
 ReverseNumberLookup		: {}
 Tag						: {Engineering}
+AssignmentBlockedState  :
+AssignmentBlockedUntil  :
 ```
 This example shows a way to get filtered results using tags. Tags are not case sensitive.
 
@@ -710,6 +722,12 @@ The activation state of the telephone number.
 ### AssignedPstnTargetId
 The ID of the object the phone number is assigned to, either the ObjectId of a user or resource account or the policy instance ID of a Teams shared calling routing policy instance.
 
+### AssignmentBlockedState
+The state of the number in terms of blocked assignment: NotBlocked if there is no assignment block on the number, BlockedForever if assignment is blocked indefinitely for the number, BlockedUntil if assignment is blocked for a specific amount of days (limited time assignment block currently not available).
+
+### AssignmentBlockedUntil
+The date until which assignment is blocked for the phone number. Null if the number is blocked for assignment indefinitely.
+
 ### AssignmentCategory
 Contains the assignment category such as Primary or Private.
 

teams/teams-ps/MicrosoftTeams/Get-TenantPrivateChannelMigrationStatus.md

@@ -17,7 +17,7 @@ You use the `Get-TenantPrivateChannelMigrationStatus` cmdlet to check the status
 
 ## SYNTAX
 
-```
+```powershell
 Get-TenantPrivateChannelMigrationStatus [<CommonParameters>]
 ```
 
@@ -29,23 +29,22 @@ The `Get-TenantPrivateChannelMigrationStatus` cmdlet allows tenant administrator
 ## EXAMPLES
 
 ### Example 1
-```
+This example retrieves the private channel migration status for the current tenant.
+
+```powershell
 Get-TenantPrivateChannelMigrationStatus
-```
-Example output:
-```
+
+
 TenantId                     : 12345678-1234-1234-1234-123456789abc
 MigrationStatus              : Completed
 MigrationStartTimeStamp      : 2025-10-09T10:15:00.456Z
 MigrationCompletionTimeStamp : 2025-10-09T12:45:00.789Z
 ```
 
-This example retrieves the private channel migration status for the current tenant.
-
 ## PARAMETERS
 
 ### 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/?LinkID=113216).
+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/?LinkID=113216).
 
 ## INPUTS
 
@@ -84,4 +83,5 @@ Common migration status values include:
 
 [Get-Team](https://learn.microsoft.com/powershell/module/microsoftteams/get-team)
 
-[Get-TeamChannel](https://learn.microsoft.com/powershell/module/microsoftteams/get-teamchannel)
+
+[Get-TeamChannel](https://learn.microsoft.com/powershell/module/microsoftteams/get-teamchannel)

teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md

@@ -1178,6 +1178,9 @@ Deletes an existing online voice routing policy. Online voice routing policies m
 ### [Remove-CsPhoneNumberAssignment](Remove-CsPhoneNumberAssignment.md)
 This cmdlet will remove/unassign a phone number from a user or a resource account (online application instance).
 
+### [Remove-CsPhoneNumberAssignmentBlock](Remove-CsPhoneNumberAssignmentBlock.md)
+This cmdlet allows the admin to remove an assignment block on a telephone number.
+
 ### [Remove-CsPhoneNumberTag](Remove-CsPhoneNumberTag.md)
 This cmdlet allows admin to remove a tag from phone number.
 
@@ -1490,6 +1493,9 @@ Use the `Set-CsOnlineVoiceUser` cmdlet to set the PSTN specific parameters (like
 ### [Set-CsPhoneNumberAssignment](Set-CsPhoneNumberAssignment.md)
 This cmdlet will assign a phone number to a user or a resource account (online application instance).
 
+### [Set-CsPhoneNumberAssignmentBlock](Set-CsPhoneNumberAssignmentBlock.md)
+This cmdlet allows the admin to create and assign a temporary block on telephone number assignment to selected telephone number.
+
 ### [Set-CsPhoneNumberPolicyAssignment](Set-CsPhoneNumberPolicyAssignment.md)
 This cmdlet assigns a policy to a specific telephone number in Microsoft Teams.
 

teams/teams-ps/MicrosoftTeams/New-CsOnlineDirectRoutingTelephoneNumberUploadOrder.md

@@ -139,8 +139,6 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ## NOTES
 The cmdlet is available in Teams PowerShell module 6.7.1 or later.
 
-The cmdlet is only available in commercial and GCC cloud instances.
-
 ## RELATED LINKS
 [Get-CsOnlineTelephoneNumberOrder](./get-csonlinetelephonenumberorder.md)
 [New-CsOnlineTelephoneNumberReleaseOrder](./new-csonlinetelephonenumberreleaseorder.md)

teams/teams-ps/MicrosoftTeams/New-CsOnlineTelephoneNumberReleaseOrder.md

@@ -170,8 +170,6 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 The cmdlet is available in Teams PowerShell module 6.7.1 or later.
 
-The cmdlet is only available in commercial and GCC cloud instances.
-
 ## RELATED LINKS
 
 [Get-CsOnlineTelephoneNumberOrder](get-csonlinetelephonenumberorder.md)

teams/teams-ps/MicrosoftTeams/Remove-CsPhoneNumberAssignment.md

@@ -20,7 +20,7 @@ This cmdlet will remove/unassign a phone number from a user or a resource accoun
 ### RemoveSome (Default)
 ```
 Remove-CsPhoneNumberAssignment -Identity <String> -PhoneNumber <String> -PhoneNumberType <String>
- [-HttpPipelinePrepend <SendAsyncStep[]>] [-Notify] [<CommonParameters>]
+ [-HttpPipelinePrepend <SendAsyncStep[]>] [-Notify] [-AssignmentBlockedForever] [-AssignmentBlockedDays <Integer>] [<CommonParameters>]
 ```
 
 ### RemoveAll
@@ -68,6 +68,18 @@ Remove-CsPhoneNumberAssignment -Identity [email protected] -RemoveAll -Notify
 ```
 This example removes/unassigns all the telephone number from [email protected] and also sends an email notification to the user about the change.
 
+### Example 5
+```powershell
+Remove-CsPhoneNumberAssignment -Identity [email protected] -PhoneNumber +12065551234 -AssignmentBlockedForever
+```
+This example removes a telephone number assignment from [email protected] and also sets an assignment block on the unassigned number for an indefinite duration.
+
+### Example 6
+```powershell
+Remove-CsPhoneNumberAssignment -Identity [email protected] -PhoneNumber +12065551234 -AssignmentBlockedDays 30
+```
+This example removes a telephone number assignment from [email protected] and also sets an assignment block on the unassigned number for 30 days. Which means the telephone number will not be available for new assignment for 30 days or until the block is removed manually. The telephone number will automatically become available for assignment for 30 days period is over. ***This feature is currently not available.***
+
 ## PARAMETERS
 
 ### -HttpPipelinePrepend
@@ -161,6 +173,37 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -AssignmentBlockedForever
+Sets an indefinite block on assignment for the telephone number.
+
+```yaml
+Type: System.Management.Automation.SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -AssignmentBlockedDays
+Sets a duration based assignment block on the telephone number. The value must be a valid integer between 1 and 365. ***This feature is currently not available.*** 
+
+```yaml
+Type: System.Int32
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+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](http://go.microsoft.com/fwlink/?LinkID=113216).
 
@@ -175,8 +218,6 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ## NOTES
 The cmdlet is available in Teams PowerShell module 3.0.0 or later.
 
-The cmdlet is only available in commercial and GCC cloud instances.
-
 ## RELATED LINKS
 [Set-CsPhoneNumberAssignment](https://learn.microsoft.com/powershell/module/microsoftteams/set-csphonenumberassignment)
 

teams/teams-ps/MicrosoftTeams/Remove-CsPhoneNumberAssignmentBlock.md

@@ -0,0 +1,69 @@
+---
+applicable: Microsoft Teams
+author: pavellatif
+external help file: Microsoft.Teams.ConfigAPI.Cmdlets-help.xml
+Locale: en-US
+manager: roykuntz
+Module Name: MicrosoftTeams
+ms.author: pavellatif
+ms.reviewer: pavellatif
+online version: https://learn.microsoft.com/powershell/module/teams/remove-csphonenumberassignmentblock
+schema: 2.0.0
+title: Remove-CsPhoneNumberAssignmentBlock
+---
+
+
+# Remove-CsPhoneNumberAssignmentBlock
+
+## SYNOPSIS
+This cmdlet allows the admin to remove an assignment block on a telephone number.
+
+## SYNTAX
+```
+Remove-CsPhoneNumberAssignmentBlock -TelephoneNumber <String> [<CommonParameters>]
+```
+
+## DESCRIPTION
+This cmdlet allows telephone number administrators to remove an existing assignment block on a telephone number.
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> Remove-CsPhoneNumberAssignmentBlock -TelephoneNumber +123456789
+```
+
+The above example shows how to remove the assignment block on a +123456789 number.
+
+## PARAMETERS
+
+### -TelephoneNumber
+Indicates the phone number for the assignment block be removed from.
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: Named
+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](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### None
+
+## NOTES
+
+## RELATED LINKS