From ffc70f213c521b3ff47a20ca380f3bfdc520e7ec Mon Sep 17 00:00:00 2001 From: Daniel Garcia Date: Wed, 28 Jan 2026 14:17:08 -0800 Subject: [PATCH 01/10] Learn Editor: Update MicrosoftTeams.md --- teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md index 48be3feb00..6d258b447a 100644 --- a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md +++ b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md @@ -16,7 +16,7 @@ The following cmdlet references are for Microsoft Teams. ### [Add-TeamChannelUser](Add-TeamChannelUser.md) Adds an owner or member to the private channel. - +CsOnlineTelephoneNumberReleaseOrder ### [Add-TeamUser](Add-TeamUser.md) The `Add-TeamUser` adds an owner or member to the team, and to the unified group which backs the team. @@ -890,6 +890,9 @@ Use the `New-CsOnlineTelephoneNumberOrder` cmdlet to create a telephone number s ### [New-CsOnlineTelephoneNumberReleaseOrder](New-CsOnlineTelephoneNumberReleaseOrder.md) This cmdlet creates a request to release telephone numbers from Microsoft Teams telephone number management inventory. +### [New-CsPhoneNumberUsageChangeOrder](New-CsPhoneNumberUsageChangeOrder.md) +This cmdlet creates a request to change the TN usage. + ### [New-CsOnlineTimeRange](New-CsOnlineTimeRange.md) The New-CsOnlineTimeRange cmdlet creates a new time range. From 7f9728167fc9887106707c5fddf4638e64fde45d Mon Sep 17 00:00:00 2001 From: Daniel Garcia Date: Wed, 28 Jan 2026 14:22:02 -0800 Subject: [PATCH 02/10] Learn Editor: Update new-csphonenumberusagechangeorder.md --- .../new-csphonenumberusagechangeorder.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md diff --git a/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md b/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md new file mode 100644 index 0000000000..b2aee14e3c --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md @@ -0,0 +1,16 @@ +--- +# Required metadata +# For more information, see https://learn.microsoft.com/en-us/help/platform/learn-editor-add-metadata +# For valid values of ms.service, ms.prod, and ms.topic, see https://learn.microsoft.com/en-us/help/platform/metadata-taxonomies + +title: # Add a title for the browser tab +description: # Add a meaningful description for search results +author: uxDaniel # GitHub alias +ms.author: zlapper # Microsoft alias +ms.service: # Add the ms.service or ms.prod value +# ms.prod: # To use ms.prod, uncomment it and delete ms.service +ms.topic: # Add the ms.topic value +ms.date: 01/28/2026 +--- + +New-CsPhoneNumberUsageChangeOrder \ No newline at end of file From e7def7e1f336389efff74715d2ab0ad0d88b930b Mon Sep 17 00:00:00 2001 From: Daniel Garcia Date: Wed, 28 Jan 2026 14:25:10 -0800 Subject: [PATCH 03/10] Learn Editor: Update new-csphonenumberusagechangeorder.md --- .../MicrosoftTeams/new-csphonenumberusagechangeorder.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md b/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md index b2aee14e3c..936d0e921e 100644 --- a/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md +++ b/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md @@ -13,4 +13,5 @@ ms.topic: # Add the ms.topic value ms.date: 01/28/2026 --- -New-CsPhoneNumberUsageChangeOrder \ No newline at end of file +# New-CsPhoneNumberUsageChangeOrder + From 3b88e76aec16f23bac1e02aca84493020087b12d Mon Sep 17 00:00:00 2001 From: Daniel Garcia Date: Wed, 28 Jan 2026 14:25:15 -0800 Subject: [PATCH 04/10] update Metadata --- .../new-csphonenumberusagechangeorder.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md b/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md index 936d0e921e..32e4540c6d 100644 --- a/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md +++ b/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md @@ -3,14 +3,14 @@ # For more information, see https://learn.microsoft.com/en-us/help/platform/learn-editor-add-metadata # For valid values of ms.service, ms.prod, and ms.topic, see https://learn.microsoft.com/en-us/help/platform/metadata-taxonomies -title: # Add a title for the browser tab -description: # Add a meaningful description for search results -author: uxDaniel # GitHub alias -ms.author: zlapper # Microsoft alias -ms.service: # Add the ms.service or ms.prod value -# ms.prod: # To use ms.prod, uncomment it and delete ms.service -ms.topic: # Add the ms.topic value +title: New-CsPhoneNumberUsageChangeOrder +description: This cmdlet creates a request to to update TN Usage (e.g. from User Type to Service Type). +author: esalazarlugo +ms.author: esalazarlugo +ms.service: powershell +ms.topic: article ms.date: 01/28/2026 +ms.subservice: cmdlets --- # New-CsPhoneNumberUsageChangeOrder From b65c9a18bd24caa0b20139a6bbe305d849c8b946 Mon Sep 17 00:00:00 2001 From: Daniel Garcia Date: Wed, 28 Jan 2026 14:32:18 -0800 Subject: [PATCH 05/10] Enhance documentation for New-CsPhoneNumberUsageChangeOrder Updated metadata and added detailed cmdlet documentation. --- .../New-CsPhoneNumberUsageChangeOrder.md | 96 +++++++++++++++++++ .../new-csphonenumberusagechangeorder.md | 17 ---- 2 files changed, 96 insertions(+), 17 deletions(-) create mode 100644 teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md delete mode 100644 teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md diff --git a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md new file mode 100644 index 0000000000..44a9cd4a08 --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md @@ -0,0 +1,96 @@ +--- +# Required metadata +# For more information, see https://learn.microsoft.com/en-us/help/platform/learn-editor-add-metadata +# For valid values of ms.service, ms.prod, and ms.topic, see https://learn.microsoft.com/en-us/help/platform/metadata-taxonomies + +applicable: Microsoft Teams +author: esalazarlugo +external help file: Microsoft.Teams.ConfigAPI.Cmdlets-help.xml +Locale: en-US +manager: prasen +Module Name: MicrosoftTeams +ms.author: esalazarlugo +ms.reviewer: esalazarlugo +online version: https://learn.microsoft.com/powershell/module/teams/New-CsPhoneNumberUsageChangeOrder +schema: 2.0.0 +title: New-CsPhoneNumberUsageChangeOrder +--- + +# New-CsPhoneNumberUsageChangeOrder + +## SYNOPSIS +This cmdlet creates a request to to update TN Usage (e.g. from User Type to Service Type). + +## SYNTAX +``` +New-CsPhoneNumberUsageChangeOrder -TelephoneNumber -Usage +``` + +## Description +This cmdlet creates a order to update the usage of the given phone numbers (e.g. from User Type to Service Type). + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> New-CsPhoneNumberUsageChangeOrder -TelephoneNumber "+123456789" -Usage ServiceType +cdf3073a-6fbb-4ade-a8af-e8fa1f3b9c13 +``` + +In this example, the telephone number "+123456789" would change to Service Type usage. + +### Example 2 +```powershell +[string[]]$tns="+14255551234","+14255551233" +PS C:\> New-CsPhoneNumberUsageChangeOrder -TelephoneNumber $tns -Usage ServiceType +cdf3073a-6fbb-4ade-a8af-e8fa1f3b9c13 +``` + +In this example, the usage of the given list of telephone numbers is being updated to Service Type. + + +## PARAMETERS + +### -TelephoneNumber +Specifies the telephone number(s) to remove. The format can be with or without the prefixed +, but needs to include country code etc. + +```yaml +Type: String[] +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Usage +Specifies the new usage type for the given telephone numbers. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +## INPUTS +None + +## OUTPUTS + +### System.String + +### None + +## NOTES +This cmdlet is available in Teams PowerShell module 7.5.0 or later. + +## RELATED LINKS diff --git a/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md b/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md deleted file mode 100644 index 32e4540c6d..0000000000 --- a/teams/teams-ps/MicrosoftTeams/new-csphonenumberusagechangeorder.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -# Required metadata -# For more information, see https://learn.microsoft.com/en-us/help/platform/learn-editor-add-metadata -# For valid values of ms.service, ms.prod, and ms.topic, see https://learn.microsoft.com/en-us/help/platform/metadata-taxonomies - -title: New-CsPhoneNumberUsageChangeOrder -description: This cmdlet creates a request to to update TN Usage (e.g. from User Type to Service Type). -author: esalazarlugo -ms.author: esalazarlugo -ms.service: powershell -ms.topic: article -ms.date: 01/28/2026 -ms.subservice: cmdlets ---- - -# New-CsPhoneNumberUsageChangeOrder - From c837d4170091c940004c121aca203a1e04754f7c Mon Sep 17 00:00:00 2001 From: Daniel Garcia Date: Wed, 28 Jan 2026 14:59:56 -0800 Subject: [PATCH 06/10] update Metadata --- .../MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md index 44a9cd4a08..8c1b87dcf4 100644 --- a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md +++ b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md @@ -14,6 +14,8 @@ ms.reviewer: esalazarlugo online version: https://learn.microsoft.com/powershell/module/teams/New-CsPhoneNumberUsageChangeOrder schema: 2.0.0 title: New-CsPhoneNumberUsageChangeOrder +description: This cmdlet creates a request to to update TN Usage (e.g. from User Type to Service Type). +ms.date: 01/27/2026 --- # New-CsPhoneNumberUsageChangeOrder From 08ef9c82235731ad2c8b086289c343446340597e Mon Sep 17 00:00:00 2001 From: Daniel Garcia Date: Thu, 29 Jan 2026 10:44:25 -0800 Subject: [PATCH 07/10] Revise documentation for New-CsPhoneNumberUsageChangeOrder Updated the cmdlet documentation for New-CsPhoneNumberUsageChangeOrder, including changes to parameter types and examples. --- .../New-CsPhoneNumberUsageChangeOrder.md | 38 +++---------------- 1 file changed, 6 insertions(+), 32 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md index 8c1b87dcf4..27fb07d627 100644 --- a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md +++ b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md @@ -1,8 +1,4 @@ --- -# Required metadata -# For more information, see https://learn.microsoft.com/en-us/help/platform/learn-editor-add-metadata -# For valid values of ms.service, ms.prod, and ms.topic, see https://learn.microsoft.com/en-us/help/platform/metadata-taxonomies - applicable: Microsoft Teams author: esalazarlugo external help file: Microsoft.Teams.ConfigAPI.Cmdlets-help.xml @@ -11,11 +7,9 @@ manager: prasen Module Name: MicrosoftTeams ms.author: esalazarlugo ms.reviewer: esalazarlugo -online version: https://learn.microsoft.com/powershell/module/teams/New-CsPhoneNumberUsageChangeOrder +online version: https://learn.microsoft.com/powershell/module/teams/new-csphonenumberusagechangeorder schema: 2.0.0 title: New-CsPhoneNumberUsageChangeOrder -description: This cmdlet creates a request to to update TN Usage (e.g. from User Type to Service Type). -ms.date: 01/27/2026 --- # New-CsPhoneNumberUsageChangeOrder @@ -25,7 +19,7 @@ This cmdlet creates a request to to update TN Usage (e.g. from User Type to Serv ## SYNTAX ``` -New-CsPhoneNumberUsageChangeOrder -TelephoneNumber -Usage +New-CsPhoneNumberUsageChangeOrder -TelephoneNumber -Usage ``` ## Description @@ -36,6 +30,8 @@ This cmdlet creates a order to update the usage of the given phone numbers (e.g. ### Example 1 ```powershell PS C:\> New-CsPhoneNumberUsageChangeOrder -TelephoneNumber "+123456789" -Usage ServiceType +``` +```Output cdf3073a-6fbb-4ade-a8af-e8fa1f3b9c13 ``` @@ -45,6 +41,8 @@ In this example, the telephone number "+123456789" would change to Service Type ```powershell [string[]]$tns="+14255551234","+14255551233" PS C:\> New-CsPhoneNumberUsageChangeOrder -TelephoneNumber $tns -Usage ServiceType +``` +```Output cdf3073a-6fbb-4ade-a8af-e8fa1f3b9c13 ``` @@ -56,33 +54,9 @@ In this example, the usage of the given list of telephone numbers is being updat ### -TelephoneNumber Specifies the telephone number(s) to remove. The format can be with or without the prefixed +, but needs to include country code etc. -```yaml -Type: String[] -Parameter Sets: (All) -Aliases: - -Required: True -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - ### -Usage Specifies the new usage type for the given telephone numbers. -```yaml -Type: String -Parameter Sets: (All) -Aliases: - -Required: True -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - ## INPUTS None From ea48b2ee0a15e691ce897f968dbb052b3a95b316 Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Thu, 29 Jan 2026 16:30:28 -0800 Subject: [PATCH 08/10] Fix formatting in MicrosoftTeams.md --- teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md index 6d258b447a..e51c38a137 100644 --- a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md +++ b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md @@ -16,7 +16,7 @@ The following cmdlet references are for Microsoft Teams. ### [Add-TeamChannelUser](Add-TeamChannelUser.md) Adds an owner or member to the private channel. -CsOnlineTelephoneNumberReleaseOrder + ### [Add-TeamUser](Add-TeamUser.md) The `Add-TeamUser` adds an owner or member to the team, and to the unified group which backs the team. From 37767c7414e99e346fc8680c42ecaa1d54b11f9a Mon Sep 17 00:00:00 2001 From: Daniel Garcia Date: Fri, 30 Jan 2026 10:38:50 -0800 Subject: [PATCH 09/10] Update author and manager information in documentation --- .../New-CsPhoneNumberUsageChangeOrder.md | 45 ++++++++++++++----- 1 file changed, 35 insertions(+), 10 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md index 27fb07d627..4c451dd716 100644 --- a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md +++ b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md @@ -1,12 +1,12 @@ --- applicable: Microsoft Teams -author: esalazarlugo +author: garciadaniel external help file: Microsoft.Teams.ConfigAPI.Cmdlets-help.xml Locale: en-US -manager: prasen +manager: roykuntz Module Name: MicrosoftTeams -ms.author: esalazarlugo -ms.reviewer: esalazarlugo +ms.author: garciadaniel +ms.reviewer: garciadaniel online version: https://learn.microsoft.com/powershell/module/teams/new-csphonenumberusagechangeorder schema: 2.0.0 title: New-CsPhoneNumberUsageChangeOrder @@ -18,11 +18,12 @@ title: New-CsPhoneNumberUsageChangeOrder This cmdlet creates a request to to update TN Usage (e.g. from User Type to Service Type). ## SYNTAX + ``` New-CsPhoneNumberUsageChangeOrder -TelephoneNumber -Usage ``` -## Description +## DESCRIPTION This cmdlet creates a order to update the usage of the given phone numbers (e.g. from User Type to Service Type). ## EXAMPLES @@ -31,7 +32,7 @@ This cmdlet creates a order to update the usage of the given phone numbers (e.g. ```powershell PS C:\> New-CsPhoneNumberUsageChangeOrder -TelephoneNumber "+123456789" -Usage ServiceType ``` -```Output +``` cdf3073a-6fbb-4ade-a8af-e8fa1f3b9c13 ``` @@ -42,27 +43,51 @@ In this example, the telephone number "+123456789" would change to Service Type [string[]]$tns="+14255551234","+14255551233" PS C:\> New-CsPhoneNumberUsageChangeOrder -TelephoneNumber $tns -Usage ServiceType ``` -```Output +``` cdf3073a-6fbb-4ade-a8af-e8fa1f3b9c13 ``` In this example, the usage of the given list of telephone numbers is being updated to Service Type. - ## PARAMETERS ### -TelephoneNumber Specifies the telephone number(s) to remove. The format can be with or without the prefixed +, but needs to include country code etc. +```yaml +Type: System.String[] +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Usage Specifies the new usage type for the given telephone numbers. +```yaml +Type: System.Management.Automation.SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ## INPUTS -None + +### None ## OUTPUTS -### System.String +The order id from the request. ### None From 316e0005c2d5677b8f135a797181589278ddaf1a Mon Sep 17 00:00:00 2001 From: Daniel Garcia Date: Fri, 30 Jan 2026 11:53:35 -0800 Subject: [PATCH 10/10] Add output examples to phone number usage change order Updated examples in New-CsPhoneNumberUsageChangeOrder.md to include output for clarity. --- .../MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md index 4c451dd716..6fddebb2c5 100644 --- a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md +++ b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberUsageChangeOrder.md @@ -32,7 +32,7 @@ This cmdlet creates a order to update the usage of the given phone numbers (e.g. ```powershell PS C:\> New-CsPhoneNumberUsageChangeOrder -TelephoneNumber "+123456789" -Usage ServiceType ``` -``` +```output cdf3073a-6fbb-4ade-a8af-e8fa1f3b9c13 ``` @@ -43,7 +43,7 @@ In this example, the telephone number "+123456789" would change to Service Type [string[]]$tns="+14255551234","+14255551233" PS C:\> New-CsPhoneNumberUsageChangeOrder -TelephoneNumber $tns -Usage ServiceType ``` -``` +```output cdf3073a-6fbb-4ade-a8af-e8fa1f3b9c13 ```