Skip to content

Commit 8235aca

Browse files
radubulboacaradubulboaca
authored
Merge branch 'MicrosoftDocs:main' into main
2 parents b5200f9 + 94b66e0 commit 8235aca

File tree

6 files changed

+186
-3
lines changed

6 files changed

+186
-3
lines changed

‎exchange/exchange-ps/ExchangePowerShell/Get-EXORecipient.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ This example returns the first 100 recipient objects in name sorted order.
6868

6969
### Example 2
7070
```powershell
71-
Get-EXORecipient -Identity john@contosot.com
71+
Get-EXORecipient -Identity john@contoso.com
7272
```
7373

7474
This example returns the recipient attribute details for the user [email protected]

‎teams/teams-ps/MicrosoftTeams/Get-CsOnlineTelephoneNumberOrder.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -160,6 +160,35 @@ SuccessPhoneNumbers {+99999980}
160160

161161
This example returns the status of a successful upload order for a Direct Routing phone number.
162162

163+
### Example 6
164+
```powershell
165+
PS C:\> $results = Get-CsOnlineTelephoneNumberOrder -OrderId acf9d459-083b-4f8e-b365-c0a07817b879 -OrderType NumberUpdate
166+
167+
Key Value
168+
--- -----
169+
OrderId 4b9cbc43-5bd5-4740-9e76-9a5762380f9d
170+
CreatedAt 2025-10-30T00:22:59.4989508+00:00
171+
Status PartialSuccess
172+
TotalCount 4
173+
SuccessCount 3
174+
FailureCount 1
175+
WarningCount 0
176+
SuccessPhoneNumbers {+12345678910, +1253489001, +14579824781}
177+
FailedPhoneNumbers {+100001}
178+
WarningPhoneNumbers {}
179+
AdditionalDetails {System.Collections.Generic.Dictionary`2[System.String,System.Object]}
180+
181+
PS C:\> $results.AdditionalDetails
182+
183+
Key Value
184+
--- -----
185+
TelephoneNumber +100001
186+
Status Error
187+
Message The Number is not found.
188+
```
189+
190+
This example returns the status of a partially successful NumberUpdate order for a telephone number tags.
191+
163192
## PARAMETERS
164193

165194
### -OrderId

‎teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -896,6 +896,9 @@ Creates a new online voice route.
896896
### [New-CsOnlineVoiceRoutingPolicy](New-CsOnlineVoiceRoutingPolicy.md)
897897
Creates a new online voice routing policy. Online voice routing policies manage online PSTN usages for Phone System users.
898898

899+
### [New-CsPhoneNumberBulkUpdateTagsOrder](New-CsPhoneNumberBulkUpdateTagsOrder.md)
900+
Creates a new bulk update order for phone number tags.
901+
899902
### [New-CsTeamsRemoteLogCollectionDevice](New-CsTeamsRemoteLogCollectionDevice.md)
900903
This cmdlet creates a request for remote log collection for a device.
901904

‎teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberBulkUpdateTagsOrder.md‎

Lines changed: 150 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,150 @@
1+
---
2+
applicable: Microsoft Teams
3+
author: pavellatif
4+
external help file: Microsoft.Teams.ConfigAPI.Cmdlets-help.xml
5+
Locale: en-US
6+
manager: roykuntz
7+
Module Name: MicrosoftTeams
8+
ms.author: pavellatif
9+
ms.reviewer: pavellatif
10+
online version: https://learn.microsoft.com/powershell/module/teams/new-phonenumberbulkupdatetagsorder
11+
schema: 2.0.0
12+
title: New-CsPhoneNumberBulkUpdateTagsOrder
13+
---
14+
15+
# New-CsPhoneNumberBulkUpdateTagsOrder
16+
17+
## SYNOPSIS
18+
19+
This cmdlet allows the admin to add/remove one or multiple telephone number tags to a number of telephone numbers at once.
20+
21+
## SYNTAX
22+
23+
```
24+
New-CsPhoneNumberBulkUpdateTagsOrder [-TagsToAdd <string>] [-TagsToRemove <string>]
25+
[-PhoneNumbers <string>] [<CommonParameters>]
26+
```
27+
28+
## DESCRIPTION
29+
30+
Creates a bulk update order that adds or removes one or more tags from multiple telephone numbers in a single operation. This cmdlet is designed for administrators who need to efficiently manage telephone numbers at scale, reducing manual effort and ensuring consistency across large sets of telephone numbers. The cmdlet allows maximum 1000 telephone numbers to be updated at a time. Any limitation for [Set-CsPhoneNumberTag](./Set-CsPhoneNumberTag.md) will also apply to this bulk update order.
31+
32+
## EXAMPLES
33+
34+
### Example 1
35+
36+
```powershell
37+
PS C:\> New-CsPhoneNumberBulkUpdateTagsOrder -PhoneNumbers "17032511428,17032511429,17032511430" -TagsToAdd "HR"
38+
```
39+
```output
40+
Id OrderType
41+
-- ---------
42+
0e923e2c-ab0e-6h8c-be5a-a6gh3rf NumberUpdate
43+
```
44+
Above example shows how to set a "HR" and "NewYork" tags to multiple telephone numbers. There can be maximum 1000 telephone numbers in one order.
45+
46+
### Example 2
47+
48+
```powershell
49+
PS C:\> New-CsPhoneNumberBulkUpdateTagsOrder -PhoneNumbers "17032511428,17032511429,17032511430" -TagsToRemove "HR"
50+
```
51+
```output
52+
Id OrderType
53+
-- ---------
54+
0e923e2c-ab0e-6h8c-be5a-wre45fd NumberUpdate
55+
```
56+
Above example shows how to remove "HR" tag from multiple telephone numbers. There can be maximum 1000 telephone numbers in one order.
57+
58+
### Example 3
59+
60+
```powershell
61+
PS C:\> New-CsPhoneNumberBulkUpdateTagsOrder -PhoneNumbers "17032511428,17032511429,17032511430" -TagsToAdd "DevOps,London,City Center"
62+
```
63+
```output
64+
Id OrderType
65+
-- ---------
66+
0e923e2c-ab0e-6h8c-be5a-90fac6c NumberUpdate
67+
```
68+
Above example shows how to add multiple tags to multiple telephone numbers at the same time. There can be maximum 1000 telephone numbers and 10 tags in one order. Any restrictions on number of tags per number and number of characters per tag will be enforced.
69+
70+
### Example 4
71+
72+
```powershell
73+
PS C:\> New-CsPhoneNumberBulkUpdateTagsOrder -PhoneNumbers "17032511428,17032511429,17032511430" -TagsToRemove "DevOps,London,City Center"
74+
```
75+
```output
76+
Id OrderType
77+
-- ---------
78+
0e923e2c-ab0e-6h8c-be5a-906be8c NumberUpdate
79+
```
80+
Above example shows how to remove multiple tags from multiple telephone numbers at the same time. There can be maximum 1000 telephone numbers and 10 tags in one order.
81+
82+
## PARAMETERS
83+
84+
### -TagsToAdd
85+
86+
These are the tags to be added to telephone numbers.
87+
88+
```yaml
89+
Type: System.String
90+
Parameter Sets: (All)
91+
Aliases:
92+
93+
Required: False
94+
Position: Named
95+
Default value: None
96+
Accept pipeline input: False
97+
Accept wildcard characters: False
98+
```
99+
100+
### -TagsToRemove
101+
102+
These are the tags to be removed from telephone numbers.
103+
104+
105+
```yaml
106+
Type: System.String
107+
Parameter Sets: (All)
108+
Aliases:
109+
110+
Required: False
111+
Position: Named
112+
Default value: None
113+
Accept pipeline input: False
114+
Accept wildcard characters: False
115+
```
116+
117+
### -PhoneNumbers
118+
119+
These are the list of telephone numbers on which bulk update operation will be performed.
120+
121+
122+
```yaml
123+
Type: System.String
124+
Parameter Sets: (All)
125+
Aliases:
126+
127+
Required: True
128+
Position: Named
129+
Default value: None
130+
Accept pipeline input: False
131+
Accept wildcard characters: False
132+
```
133+
134+
135+
### CommonParameters
136+
137+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
138+
139+
## INPUTS
140+
141+
## OUTPUTS
142+
143+
## NOTES
144+
145+
The cmdlet is available in Teams PowerShell module 7.7.0 or later.
146+
147+
## RELATED LINKS
148+
- [Set-CsPhoneNumberTag](./Set-CsPhoneNumberTag.md)
149+
- [Get-CsPhoneNumberTag](./Get-CsPhoneNumberTag.md)
150+
- [Remove-CsPhoneNumberTag](./Remove-CsPhoneNumberTag.md)

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,5 +65,5 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
6565
### None
6666
6767
## NOTES
68-
68+
This cmdlet is available in Teams PowerShell module 7.5.0 or later.
6969
## RELATED LINKS

‎teams/teams-ps/MicrosoftTeams/Set-CsPhoneNumberAssignmentBlock.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ This cmdlet allows the teams phone administrators to create and assign a tempora
2828
1. Assignment is blocked until cleared. This can be set by -AssignmentBlockedForever parameter. Once set, the telephone number will remain unassignable until the block is cleared by an admin.
2929
2. Assignment is blocked for a set number of days. This can be achieved by setting -AssignmentBlockedDays parameter (this value must be a valid integer between 1 and 365 days). Once set, the telephone number will remain unassignable until the time runs out or the block is cleared by an admin. ***The -AssignmentBlockedDays parameter is currently not available***.
3030

31-
The admin **cannot** set both -AssignmentBlockedForever and -AssignmentBlockedDays for the same number. If there is an existing assignment block on the number, the admin must remove the existing block using [Remove-CsPhoneNumberAssignmentBlock](https://learn.microsoft.com/powershell/module/teams/remove-csphonenumberassignmentblock) before proceeding with setting the new assignment block.
31+
The admin **cannot** set both -AssignmentBlockedForever and -AssignmentBlockedDays for the same number. If there is an existing assignment block on the number, the admin must remove the existing block using [Remove-CsPhoneNumberAssignmentBlock](./remove-csphonenumberassignmentblock.md) before proceeding with setting the new assignment block.
3232

3333
## EXAMPLES
3434

@@ -106,5 +106,6 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
106106
### None
107107
108108
## NOTES
109+
This cmdlet is available in Teams PowerShell module 7.5.0 or later.
109110
110111
## RELATED LINKS

0 commit comments

Comments
 (0)