Skip to content

Commit e9ada4d

Browse files
Ruchika-mittal01Ruchika-mittal01
authored
Merge branch 'main' into main
2 parents 1bea652 + 4989932 commit e9ada4d

File tree

8 files changed

+303
-4
lines changed

8 files changed

+303
-4
lines changed

‎.github/workflows/AutoPublish.yml‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,8 @@ permissions:
77

88
on:
99
schedule:
10-
- cron: "25 2,5,8,11,14,17,20,22 * * *" # Times are UTC based on Daylight Saving Time. Need to be adjusted for Standard Time. Scheduling at :25 to account for queuing lag.
10+
# - cron: "25 2,5,8,11,14,17,20,22 * * *" # Times are UTC based on Daylight Saving Time (~Mar-Nov). Scheduling at :25 to account for queuing lag.
11+
- cron: "25 3,6,9,12,15,18,21,23 * * *" # Times are UTC based on Standard Time (~Nov-Mar). Scheduling at :25 to account for queuing lag.
1112

1213
workflow_dispatch:
1314

‎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-CsAiAgents.md‎

Lines changed: 111 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,111 @@
1+
---
2+
applicable: Microsoft Teams
3+
author: radubulboaca
4+
external help file: Microsoft.Rtc.Management.dll-Help.xml
5+
Locale: en-US
6+
manager: gauravpa
7+
Module Name: MicrosoftTeams
8+
ms.author: radubulboaca
9+
online version: https://learn.microsoft.com/powershell/module/microsoftteams/get-csaiagents
10+
schema: 2.0.0
11+
title: Get-CsAiAgents
12+
---
13+
# Get-CsAiAgents
14+
15+
## SYNOPSIS
16+
17+
Retrieves the AI Agents in the tenant that match with the ProviderId.
18+
19+
## SYNTAX
20+
21+
```
22+
Get-CsAiAgents -ProviderId <string> [-IsTeamsIvrEnabled]
23+
```
24+
25+
## DESCRIPTION
26+
27+
> [!NOTE]
28+
> This cmdlet will only work for customers that are participating in the Voice Applications private preview for these features. General Availability for this functionality has not been determined at this time.
29+
30+
The Get-CsAiAgents cmdlet returns a list of all AI Agents in the tenant.
31+
32+
## EXAMPLES
33+
34+
### Example 1 - Get AI agents from a provider
35+
36+
This example gets the AI Agents from ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa" that are compatible with Teams Interactive Voice Response (IVR). The output of the Get-CsAiAgents cmdlet is a list of AI Agents, with parameters such as `BotHandle`, `MsaAppId`, `MsaAppTenantId` and more.
37+
38+
```powershell
39+
Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa"
40+
```
41+
42+
```Output
43+
BotHandle CallingApiVersion Channel Cid IsTeamsIvrEnabled IsTeamsVoiceEnabled MessagingApiVersion MsaAppId MsaAppTenantId ProviderId PublishState
44+
--------- ----------------- ------- --- ----------------- ------------------- ------------------- -------- -------------- ---------- ------------
45+
8a1b2c33-4d55-4f1e-9a2b-7f4b3a2b1c7e {msteams} 0 True True 3 c91e0a62-8d9e-4d6d-9e55-2a0b7b9f3d64 1bdf0cd6-a880-43c0-adde-ebf94070c03d 9d8f559b-5de4-46a4-902a-ad4271e83efa Preview
46+
e5f7a913-0c2f-4f3a-8f69-9d1b40e2a3f1 {msteams} 0 True True 3 6b4a3fb2-0df5-47a8-8a77-4f1d8f6e2a39 1bdf0cd6-a880-43c0-adde-ebf94070c03d 9d8f559b-5de4-46a4-902a-ad4271e83efa Preview
47+
1a2b3c4d-5e6f-4711-8a2b-9c0d1e2f3a4b {msteams} 0 True True 3 4f0c1a2e-7b9d-4c1e-9123-6a7b8c9d0e1f 1bdf0cd6-a880-43c0-adde-ebf94070c03d 9d8f559b-5de4-46a4-902a-ad4271e83efa Preview
48+
9f8e7d6c-5b4a-4312-9a0b-d1c2e3f4a5b6 {msteams} 0 True True 3 a7c8d9e0-1f2a-4b3c-9d0e-1a2b3c4d5e6f 1bdf0cd6-a880-43c0-adde-ebf94070c03d 9d8f559b-5de4-46a4-902a-ad4271e83efa Preview
49+
0a9b8c7d-6e5f-4d3c-8b7a-6c5d4e3f2a1b {msteams} 0 True True 3 d2e3f4a5-b6c7-4819-9f0e-a1b2c3d4e5f6 1bdf0cd6-a880-43c0-adde-ebf94070c03d 9d8f559b-5de4-46a4-902a-ad4271e83efa Preview
50+
3b2c1d0e-9f8a-47b6-9123-4a5b6c7d8e9f {msteams} 0 True True 3 12ab34cd-56ef-4789-90ab-cdef12345678 1bdf0cd6-a880-43c0-adde-ebf94070c03d 9d8f559b-5de4-46a4-902a-ad4271e83efa Preview
51+
7c6d5e4f-3a2b-41c0-9f8e-7d6c5b4a3f2e {msteams} 0 True True 3 f0e1d2c3-b4a5-4698-8f7e-6d5c4b3a2f1e 1bdf0cd6-a880-43c0-adde-ebf94070c03d 9d8f559b-5de4-46a4-902a-ad4271e83efa Preview
52+
```
53+
54+
### Example 2 - Get AI agents from multiple providers
55+
56+
This example gets the AI Agents from multiple ProviderIds that are compatible with Teams Interactive Voice Response (IVR).
57+
58+
```powershell
59+
Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa,905de543-6cf8-44a4-ab05-83bcd500f39e"
60+
```
61+
62+
## PARAMETERS
63+
64+
### -ProviderId
65+
66+
A filter for ProviderId
67+
68+
```yaml
69+
Type: System.String
70+
Parameter Sets: (All)
71+
Aliases:
72+
73+
Required: False
74+
Position: 0
75+
Default value: None
76+
Accept pipeline input: False
77+
Accept wildcard characters: False
78+
```
79+
80+
### -IsTeamsIvrEnabled
81+
82+
Optional parameter. If specified, it filters the returned results to AI Agents that are compatible with Teams Interactive Voice Response (IVR).
83+
84+
```yaml
85+
Type: SwitchParameter
86+
Parameter Sets: (All)
87+
Aliases:
88+
89+
Required: False
90+
Position: Named
91+
Default value: None
92+
Accept pipeline input: False
93+
Accept wildcard characters: False
94+
```
95+
96+
### CommonParameters
97+
98+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
99+
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
100+
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
101+
[about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
102+
103+
## INPUTS
104+
105+
## OUTPUTS
106+
107+
### Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.IAiAgentQueryResult
108+
109+
## NOTES
110+
111+
## RELATED LINKS

‎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: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,9 @@ This cmdlet returns all Microsoft Teams apps in the app catalog, including Micro
6565
### [Get-AssociatedTeam](Get-AssociatedTeam.md)
6666
This cmdlet supports retrieving all teams associated with a user, including teams which host shared channels.
6767

68+
### [Get-CsAiAgents](Get-CsAiAgents.md)
69+
Retrieves the AI Agents in the tenant.
70+
6871
### [Get-CsApplicationAccessPolicy](Get-CsApplicationAccessPolicy.md)
6972
Retrieves information about the application access policy configured for use in the tenant.
7073

@@ -893,6 +896,9 @@ Creates a new online voice route.
893896
### [New-CsOnlineVoiceRoutingPolicy](New-CsOnlineVoiceRoutingPolicy.md)
894897
Creates a new online voice routing policy. Online voice routing policies manage online PSTN usages for Phone System users.
895898

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

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

Lines changed: 151 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,151 @@
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+
149+
[Set-CsPhoneNumberTag](https://learn.microsoft.com/powershell/module/microsoftteams/Set-CsPhoneNumberTag)
150+
[Get-CsPhoneNumberTag](https://learn.microsoft.com/powershell/module/microsoftteams/Get-CsPhoneNumberTag)
151+
[Remove-CsPhoneNumberTag](https://learn.microsoft.com/powershell/module/microsoftteams/Remove-CsPhoneNumberTag)

‎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)