From 1263d958a180535b2f86e41a019f2dc1fb60fb43 Mon Sep 17 00:00:00 2001 From: Radu Bulboaca Date: Mon, 3 Nov 2025 11:51:20 -0700 Subject: [PATCH 01/11] Add get-csaiagents --- .../teams-ps/MicrosoftTeams/Get-CsAiAgents.md | 106 ++++++++++++++++++ 1 file changed, 106 insertions(+) create mode 100644 teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md new file mode 100644 index 0000000000..9051c0083f --- /dev/null +++ b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md @@ -0,0 +1,106 @@ +--- +applicable: Microsoft Teams +author: radubulboaca +external help file: Microsoft.Rtc.Management.dll-Help.xml +Locale: en-US +manager: gauravpa +Module Name: MicrosoftTeams +ms.author: radubulboaca +online version: https://learn.microsoft.com/powershell/module/microsoftteams/get-csaiagents +schema: 2.0.0 +title: Get-CsAiAgents +--- +# Get-CsAiAgents + +## SYNOPSIS + +Retrieves the AI Agents in the tenant. + +## SYNTAX + +> [!CAUTION] +> 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. + +``` +Get-CsAiAgents -ProviderId [-IsTeamsIvrEnabled] +``` + +## DESCRIPTION + +The Get-CsAiAgents cmdlet returns a list of all AI Agents in the tenant. + +## EXAMPLES + +``` +Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "905a9543-6cf8-44a4-ab05-83b8b500f39e" +``` + +This example gets the AI Agents from ProviderId "905a9543-6cf8-44a4-ab05-83b8b500f39e" that are compatible with Teams Interactive Voice Response (IVR). + +## PARAMETERS + +### -ProviderId + +A filter for ProviderId + +```yaml +Type: System.String +DefaultValue: '' +SupportsWildcards: false +Aliases: [] +ParameterSets: +- Name: (All) + Position: Named + IsRequired: true + ValueFromPipeline: false + ValueFromPipelineByPropertyName: false + ValueFromRemainingArguments: false +DontShow: false +AcceptedValues: [] +HelpMessage: '' +``` + +### -IsTeamsIvrEnabled + +Optional parameter. If specified, it filters the returned results to AI Agents that are compatible with Teams Interactive Voice Response (IVR). + +```yaml +Type: System.Management.Automation.SwitchParameter +DefaultValue: '' +SupportsWildcards: false +Aliases: [] +ParameterSets: +- Name: (All) + Position: Named + IsRequired: false + ValueFromPipeline: false + ValueFromPipelineByPropertyName: false + ValueFromRemainingArguments: false +DontShow: false +AcceptedValues: [] +HelpMessage: '' +``` + +### CommonParameters + +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). + +## OUTPUTS + +The output of the Get-CsAiAgents cmdlet is a list of AI Agents, with parameters such as `BotHandle`, `MsaAppId`, `MsaAppTenantId` and more. + +``` +BotHandle CallingApiVersion Channel Cid IsTeamsIvrEnabled IsTeamsVoiceEnabled MessagingApiVersion MsaAppId MsaAppTenantId ProviderId PublishState +--------- ----------------- ------- --- ----------------- ------------------- ------------------- -------- -------------- ---------- ------------ +8a1b2c33-4d55-4f1e-9a2b-7f4b3a2b1c7e {msteams} 0 True True 3 c91e0a62-8d9e-4d6d-9e55-2a0b7b9f3d64 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview +e5f7a913-0c2f-4f3a-8f69-9d1b40e2a3f1 {msteams} 0 True True 3 6b4a3fb2-0df5-47a8-8a77-4f1d8f6e2a39 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview +1a2b3c4d-5e6f-4711-8a2b-9c0d1e2f3a4b {msteams} 0 True True 3 4f0c1a2e-7b9d-4c1e-9123-6a7b8c9d0e1f 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview +9f8e7d6c-5b4a-4312-9a0b-d1c2e3f4a5b6 {msteams} 0 True True 3 a7c8d9e0-1f2a-4b3c-9d0e-1a2b3c4d5e6f 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview +0a9b8c7d-6e5f-4d3c-8b7a-6c5d4e3f2a1b {msteams} 0 True True 3 d2e3f4a5-b6c7-4819-9f0e-a1b2c3d4e5f6 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview +3b2c1d0e-9f8a-47b6-9123-4a5b6c7d8e9f {msteams} 0 True True 3 12ab34cd-56ef-4789-90ab-cdef12345678 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview +7c6d5e4f-3a2b-41c0-9f8e-7d6c5b4a3f2e {msteams} 0 True True 3 f0e1d2c3-b4a5-4698-8f7e-6d5c4b3a2f1e 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview +``` + From 3eb4e8a3484323c07c4cd18a4a14c18506bcbf00 Mon Sep 17 00:00:00 2001 From: Radu Bulboaca Date: Mon, 3 Nov 2025 12:00:49 -0700 Subject: [PATCH 02/11] add to teams commandlets --- teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md index df9481a55a..9aa8b08b36 100644 --- a/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md +++ b/teams/teams-ps/MicrosoftTeams/MicrosoftTeams.md @@ -65,6 +65,9 @@ This cmdlet returns all Microsoft Teams apps in the app catalog, including Micro ### [Get-AssociatedTeam](Get-AssociatedTeam.md) This cmdlet supports retrieving all teams associated with a user, including teams which host shared channels. +### [Get-CsAiAgents](Get-CsAiAgents.md) +Retrieves the AI Agents in the tenant. + ### [Get-CsApplicationAccessPolicy](Get-CsApplicationAccessPolicy.md) Retrieves information about the application access policy configured for use in the tenant. From 285833d6ee995021a77744dd7a5545e46b91117e Mon Sep 17 00:00:00 2001 From: Radu Bulboaca Date: Mon, 3 Nov 2025 12:02:40 -0700 Subject: [PATCH 03/11] update example --- teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md index 9051c0083f..bcc9b53393 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md @@ -32,10 +32,10 @@ The Get-CsAiAgents cmdlet returns a list of all AI Agents in the tenant. ## EXAMPLES ``` -Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "905a9543-6cf8-44a4-ab05-83b8b500f39e" +Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "9d8f559b-5984-46a4-902a-ad4271e83efa" ``` -This example gets the AI Agents from ProviderId "905a9543-6cf8-44a4-ab05-83b8b500f39e" that are compatible with Teams Interactive Voice Response (IVR). +This example gets the AI Agents from ProviderId "9d8f559b-5984-46a4-902a-ad4271e83efa" that are compatible with Teams Interactive Voice Response (IVR). ## PARAMETERS From 8c384b35851869050657ee0e1b04298eb99918f5 Mon Sep 17 00:00:00 2001 From: Radu Bulboaca Date: Mon, 3 Nov 2025 13:41:43 -0700 Subject: [PATCH 04/11] update --- .../teams-ps/MicrosoftTeams/Get-CsAiAgents.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md index bcc9b53393..cd4a58552f 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md @@ -14,7 +14,7 @@ title: Get-CsAiAgents ## SYNOPSIS -Retrieves the AI Agents in the tenant. +Retrieves the AI Agents in the tenant that match with the ProviderId. ## SYNTAX @@ -32,10 +32,10 @@ The Get-CsAiAgents cmdlet returns a list of all AI Agents in the tenant. ## EXAMPLES ``` -Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "9d8f559b-5984-46a4-902a-ad4271e83efa" +Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa" ``` -This example gets the AI Agents from ProviderId "9d8f559b-5984-46a4-902a-ad4271e83efa" that are compatible with Teams Interactive Voice Response (IVR). +This example gets the AI Agents from ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa" that are compatible with Teams Interactive Voice Response (IVR). ## PARAMETERS @@ -95,12 +95,12 @@ The output of the Get-CsAiAgents cmdlet is a list of AI Agents, with parameters ``` BotHandle CallingApiVersion Channel Cid IsTeamsIvrEnabled IsTeamsVoiceEnabled MessagingApiVersion MsaAppId MsaAppTenantId ProviderId PublishState --------- ----------------- ------- --- ----------------- ------------------- ------------------- -------- -------------- ---------- ------------ -8a1b2c33-4d55-4f1e-9a2b-7f4b3a2b1c7e {msteams} 0 True True 3 c91e0a62-8d9e-4d6d-9e55-2a0b7b9f3d64 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview -e5f7a913-0c2f-4f3a-8f69-9d1b40e2a3f1 {msteams} 0 True True 3 6b4a3fb2-0df5-47a8-8a77-4f1d8f6e2a39 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview -1a2b3c4d-5e6f-4711-8a2b-9c0d1e2f3a4b {msteams} 0 True True 3 4f0c1a2e-7b9d-4c1e-9123-6a7b8c9d0e1f 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview -9f8e7d6c-5b4a-4312-9a0b-d1c2e3f4a5b6 {msteams} 0 True True 3 a7c8d9e0-1f2a-4b3c-9d0e-1a2b3c4d5e6f 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview -0a9b8c7d-6e5f-4d3c-8b7a-6c5d4e3f2a1b {msteams} 0 True True 3 d2e3f4a5-b6c7-4819-9f0e-a1b2c3d4e5f6 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview -3b2c1d0e-9f8a-47b6-9123-4a5b6c7d8e9f {msteams} 0 True True 3 12ab34cd-56ef-4789-90ab-cdef12345678 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview -7c6d5e4f-3a2b-41c0-9f8e-7d6c5b4a3f2e {msteams} 0 True True 3 f0e1d2c3-b4a5-4698-8f7e-6d5c4b3a2f1e 1bdf06d6-a880-43c0-adde-ebf94070c03d 9d8f559b-5984-46a4-902a-ad4271e83efa Preview +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 +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 +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 +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 +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 +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 +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 ``` From dc853782affd2e829e03bbec13caf1ab4558eb03 Mon Sep 17 00:00:00 2001 From: Radu Bulboaca Date: Mon, 3 Nov 2025 14:49:50 -0700 Subject: [PATCH 05/11] update --- teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md index cd4a58552f..811ec73fa8 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md @@ -37,6 +37,13 @@ Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83 This example gets the AI Agents from ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa" that are compatible with Teams Interactive Voice Response (IVR). + +``` +Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa,905de543-6cf8-44a4-ab05-83bcd500f39e" +``` + +This example gets the AI Agents from multiple ProviderIds that are compatible with Teams Interactive Voice Response (IVR). + ## PARAMETERS ### -ProviderId From b5200f9b2990637687fa4b2b1cc033afd812d66a Mon Sep 17 00:00:00 2001 From: Radu Bulboaca Date: Wed, 5 Nov 2025 16:01:16 -0700 Subject: [PATCH 06/11] re-formatted --- .../teams-ps/MicrosoftTeams/Get-CsAiAgents.md | 40 +++++++++++-------- 1 file changed, 24 insertions(+), 16 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md index 811ec73fa8..86c9f7f4fa 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md @@ -18,25 +18,40 @@ Retrieves the AI Agents in the tenant that match with the ProviderId. ## SYNTAX -> [!CAUTION] -> 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. - ``` Get-CsAiAgents -ProviderId [-IsTeamsIvrEnabled] ``` ## DESCRIPTION +> [!CAUTION] +> 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. + The Get-CsAiAgents cmdlet returns a list of all AI Agents in the tenant. ## EXAMPLES +### Example 1 - Get AI agents from a provider + ``` Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa" ``` -This example gets the AI Agents from ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa" that are compatible with Teams Interactive Voice Response (IVR). +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. +``` +BotHandle CallingApiVersion Channel Cid IsTeamsIvrEnabled IsTeamsVoiceEnabled MessagingApiVersion MsaAppId MsaAppTenantId ProviderId PublishState +--------- ----------------- ------- --- ----------------- ------------------- ------------------- -------- -------------- ---------- ------------ +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 +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 +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 +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 +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 +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 +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 +``` + +### Example 2 - Get AI agents from mulitple providers ``` Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa,905de543-6cf8-44a4-ab05-83bcd500f39e" @@ -95,19 +110,12 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). +## INPUTS + ## OUTPUTS -The output of the Get-CsAiAgents cmdlet is a list of AI Agents, with parameters such as `BotHandle`, `MsaAppId`, `MsaAppTenantId` and more. +### Microsoft.Teams.ConfigAPI.Cmdlets.Generated.Models.IAiAgentQueryResult -``` -BotHandle CallingApiVersion Channel Cid IsTeamsIvrEnabled IsTeamsVoiceEnabled MessagingApiVersion MsaAppId MsaAppTenantId ProviderId PublishState ---------- ----------------- ------- --- ----------------- ------------------- ------------------- -------- -------------- ---------- ------------ -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 -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 -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 -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 -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 -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 -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 -``` +## NOTES +## RELATED LINKS From c17a710701de08ab003d64ae1bb804a0469e2766 Mon Sep 17 00:00:00 2001 From: Radu Bulboaca Date: Wed, 5 Nov 2025 17:01:49 -0700 Subject: [PATCH 07/11] upcate parameters --- .../teams-ps/MicrosoftTeams/Get-CsAiAgents.md | 44 +++++++------------ 1 file changed, 17 insertions(+), 27 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md index 86c9f7f4fa..42c25641f2 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md @@ -67,19 +67,14 @@ A filter for ProviderId ```yaml Type: System.String -DefaultValue: '' -SupportsWildcards: false -Aliases: [] -ParameterSets: -- Name: (All) - Position: Named - IsRequired: true - ValueFromPipeline: false - ValueFromPipelineByPropertyName: false - ValueFromRemainingArguments: false -DontShow: false -AcceptedValues: [] -HelpMessage: '' +Parameter Sets: (All) +Aliases: + +Required: False +Position: 0 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False ``` ### -IsTeamsIvrEnabled @@ -87,20 +82,15 @@ HelpMessage: '' Optional parameter. If specified, it filters the returned results to AI Agents that are compatible with Teams Interactive Voice Response (IVR). ```yaml -Type: System.Management.Automation.SwitchParameter -DefaultValue: '' -SupportsWildcards: false -Aliases: [] -ParameterSets: -- Name: (All) - Position: Named - IsRequired: false - ValueFromPipeline: false - ValueFromPipelineByPropertyName: false - ValueFromRemainingArguments: false -DontShow: false -AcceptedValues: [] -HelpMessage: '' +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False ``` ### CommonParameters From 300193ffe40e5238ae45466cec06d9ee8103fd8a Mon Sep 17 00:00:00 2001 From: Radu Bulboaca Date: Wed, 5 Nov 2025 17:08:25 -0700 Subject: [PATCH 08/11] code review changes --- teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md index 42c25641f2..f9741f4366 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md @@ -24,7 +24,7 @@ Get-CsAiAgents -ProviderId [-IsTeamsIvrEnabled] ## DESCRIPTION -> [!CAUTION] +> [!NOTE] > 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. The Get-CsAiAgents cmdlet returns a list of all AI Agents in the tenant. @@ -33,13 +33,13 @@ The Get-CsAiAgents cmdlet returns a list of all AI Agents in the tenant. ### Example 1 - Get AI agents from a provider -``` -Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa" -``` - 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. +```powershell +Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa" ``` + +```Output BotHandle CallingApiVersion Channel Cid IsTeamsIvrEnabled IsTeamsVoiceEnabled MessagingApiVersion MsaAppId MsaAppTenantId ProviderId PublishState --------- ----------------- ------- --- ----------------- ------------------- ------------------- -------- -------------- ---------- ------------ 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 @@ -53,12 +53,12 @@ e5f7a913-0c2f-4f3a-8f69-9d1b40e2a3f1 {msteams} 0 True ### Example 2 - Get AI agents from mulitple providers -``` +This example gets the AI Agents from multiple ProviderIds that are compatible with Teams Interactive Voice Response (IVR). + +```powershell Get-CsAiAgents -IsTeamsIvrEnabled -ProviderId "9d8f559b-5de4-46a4-902a-ad4271e83efa,905de543-6cf8-44a4-ab05-83bcd500f39e" ``` -This example gets the AI Agents from multiple ProviderIds that are compatible with Teams Interactive Voice Response (IVR). - ## PARAMETERS ### -ProviderId From e382f34046b9859f7d7395ed78bd313ba9aa43bc Mon Sep 17 00:00:00 2001 From: Pr1yanka Date: Thu, 6 Nov 2025 16:40:32 +0530 Subject: [PATCH 09/11] Update New-CsPhoneNumberBulkUpdateTagsOrder.md --- .../MicrosoftTeams/New-CsPhoneNumberBulkUpdateTagsOrder.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberBulkUpdateTagsOrder.md b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberBulkUpdateTagsOrder.md index 18b55139cc..12bce22af4 100644 --- a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberBulkUpdateTagsOrder.md +++ b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberBulkUpdateTagsOrder.md @@ -145,6 +145,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable The cmdlet is available in Teams PowerShell module 7.7.0 or later. ## RELATED LINKS -- [Set-CsPhoneNumberTag](./Set-CsPhoneNumberTag.md) -- [Get-CsPhoneNumberTag](./Get-CsPhoneNumberTag.md) -- [Remove-CsPhoneNumberTag](./Remove-CsPhoneNumberTag.md) \ No newline at end of file + +[Set-CsPhoneNumberTag](https://learn.microsoft.com/en-us/powershell/module/microsoftteams/Set-CsPhoneNumberTag) +[Get-CsPhoneNumberTag](https://learn.microsoft.com/en-us/powershell/module/microsoftteams/Get-CsPhoneNumberTag) +[Remove-CsPhoneNumberTag](https://learn.microsoft.com/en-us/powershell/module/microsoftteams/Remove-CsPhoneNumberTag) From 36ab68c8ef9655065557f543916ce29588b873e0 Mon Sep 17 00:00:00 2001 From: Pr1yanka Date: Thu, 6 Nov 2025 21:44:15 +0530 Subject: [PATCH 10/11] Update New-CsPhoneNumberBulkUpdateTagsOrder.md --- .../MicrosoftTeams/New-CsPhoneNumberBulkUpdateTagsOrder.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberBulkUpdateTagsOrder.md b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberBulkUpdateTagsOrder.md index 12bce22af4..ef8c57af3c 100644 --- a/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberBulkUpdateTagsOrder.md +++ b/teams/teams-ps/MicrosoftTeams/New-CsPhoneNumberBulkUpdateTagsOrder.md @@ -146,6 +146,6 @@ The cmdlet is available in Teams PowerShell module 7.7.0 or later. ## RELATED LINKS -[Set-CsPhoneNumberTag](https://learn.microsoft.com/en-us/powershell/module/microsoftteams/Set-CsPhoneNumberTag) -[Get-CsPhoneNumberTag](https://learn.microsoft.com/en-us/powershell/module/microsoftteams/Get-CsPhoneNumberTag) -[Remove-CsPhoneNumberTag](https://learn.microsoft.com/en-us/powershell/module/microsoftteams/Remove-CsPhoneNumberTag) +[Set-CsPhoneNumberTag](https://learn.microsoft.com/powershell/module/microsoftteams/Set-CsPhoneNumberTag) +[Get-CsPhoneNumberTag](https://learn.microsoft.com/powershell/module/microsoftteams/Get-CsPhoneNumberTag) +[Remove-CsPhoneNumberTag](https://learn.microsoft.com/powershell/module/microsoftteams/Remove-CsPhoneNumberTag) From 432242ae5f46a1d58aa66c445259a031cbc2c199 Mon Sep 17 00:00:00 2001 From: Ruchika Mittal Date: Thu, 6 Nov 2025 22:30:13 +0530 Subject: [PATCH 11/11] typo fix --- teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md index f9741f4366..c6b66b1147 100644 --- a/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md +++ b/teams/teams-ps/MicrosoftTeams/Get-CsAiAgents.md @@ -51,7 +51,7 @@ e5f7a913-0c2f-4f3a-8f69-9d1b40e2a3f1 {msteams} 0 True 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 ``` -### Example 2 - Get AI agents from mulitple providers +### Example 2 - Get AI agents from multiple providers This example gets the AI Agents from multiple ProviderIds that are compatible with Teams Interactive Voice Response (IVR).