Skip to content

Update New-CsAutoAttendant.md #12904

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 18 commits into from
Jul 21, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
124 changes: 124 additions & 0 deletions teams/teams-ps/teams/Get-CsMainlineAttendantFlow.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,124 @@
---
external help file: Microsoft.Rtc.Management.dll-Help.xml
online version: https://learn.microsoft.com/powershell/module/teams/get-csmainlineattendantflow
applicable: Microsoft Teams
title: Get-CsMainlineAttendantFlow
author: tomkau
ms.author: tomkau
manager: bulenteg
ms.reviewer:
schema: 2.0.0
---

# Get-CsMainlineAttendantFlow

## SYNOPSIS
Creates new Call Queue in your Skype for Business Online organization.

## SYNTAX

```
Get-CsMainlineAttendantFlow [-MaConfigId <String>] [-Type <String>] [-FlowId <String>] [-Tenant <Guid>] [<CommonParameters>]
```

## DESCRIPTION
The Get-CsMainlineAttendantFlow cmdlet returns information about the Mainline Attendant flows configured in your organization.

> [!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.

## EXAMPLES

### Example 1
```
Get-CsMainlineAttendantFlow
```

This example will list all the Mainline Attendant flows in the tenant.

### Example 2
```
Get-CsMainlineAttendantFlow -MaConfig 0b31bbe5-e2a0-4117-9b6f-956bca6023f8
```

This example will list all the Mainline Attendant flows associated with the specific configuration id.

### Example 3
```
Get-CsMainlineAttendantFlow -Type Type 1 | Type 2
```

This example will list all the Mainline Attendant flows with the specified type.

### Example 4
```
Get-CsMainlineAttendantFlow -FlowId 956bca6-e2a0-4117-9b6f-023f80b31bbe5
```

This example will list the Mainline Attendant flow with the specified flow id.

## PARAMETERS

### -MaConfigId
The Mainline Attendant configuration Id

```yaml
Type: String
Parameter Sets: (All)
Aliases:
applicable: Microsoft Teams

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Type
The Mainline Attendant flow type

PARAMVALUE: Type 1 | Type 2

```yaml
Type: String
Parameter Sets: (All)
Aliases:
applicable: Microsoft Teams

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -FlowId
The Mainline Attendant flow id

```yaml
Type: String
Parameter Sets: (All)
Aliases:
applicable: Microsoft Teams

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](https://go.microsoft.com/fwlink/?LinkID=113216).

## INPUTS

## OUTPUTS

### Microsoft.Rtc.Management.Hosted.CallQueue.Models.CallQueue

## NOTES

## RELATED LINKS

32 changes: 31 additions & 1 deletion teams/teams-ps/teams/New-CsAutoAttendant.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Use the New-CsAutoAttendant cmdlet to create a new Auto Attendant (AA).
## SYNTAX

```powershell
New-CsAutoAttendant -Name <String> -LanguageId <String> -TimeZoneId <String> -DefaultCallFlow <Object> [-CallFlows <Object>] [-CallHandlingAssociations <Object>] [-Operator <Object>] [-VoiceId <String>] [-EnableVoiceResponse] [-InclusionScope <Object>] [-ExclusionScope <Object>] [-AuthorizedUsers <List>] [-HideAuthorizedUsers <List>] [-UserNameExtension <String>] [-Tenant <Guid>] [<CommonParameters>]
New-CsAutoAttendant -Name <String> -LanguageId <String> -TimeZoneId <String> -DefaultCallFlow <Object> [-CallFlows <Object>] [-CallHandlingAssociations <Object>] [-Operator <Object>] [-VoiceId <String>] [-EnableVoiceResponse] [-EnableMainlineAttendant] [-InclusionScope <Object>] [-ExclusionScope <Object>] [-AuthorizedUsers <List>] [-HideAuthorizedUsers <List>] [-UserNameExtension <String>] [-Tenant <Guid>] [<CommonParameters>]
```

## DESCRIPTION
Expand All @@ -32,6 +32,10 @@ You can create new AAs by using the New-CsAutoAttendant cmdlet; each newly creat
>
> - -HideAuthorizedUsers
> - -UserNameExtension
>
> The following configuration parameters 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.
>
> - -EnableMainLineAttendant

**NOTES**:

Expand Down Expand Up @@ -428,6 +432,32 @@ Accept pipeline input: False
Accept wildcard characters: False
```

### -EnableMainlineAttendant
_Voice applications private preview customers only._

_Saving an auto attendant configuration through Teams admin center will remove this setting._

The EnableMainlineAttendant parameter enables Mainline Attendant features for this Auto attendant.

> [!NOTE]
> 1. The Auto attendant must have a Resource account assigned
> 1. `-LanguageId` options are limited when Mainline Attendant is enabled - see [put link here]()
> 1. `-VoiceId` choices are limited when Mainline Attendate is enabled - see [put link here]()
> 1. `-EnableVoice` will be enabled automatically

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
applicable: Microsoft Teams

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -InclusionScope
Specifies the users to which call transfers are allowed through directory lookup feature.
If not specified, all users in the organization can be reached through directory lookup.
Expand Down
15 changes: 11 additions & 4 deletions teams/teams-ps/teams/New-CsAutoAttendantCallFlow.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,6 +91,13 @@ If present, the prompts specified by the Greetings parameter (either TTS or Audi

You can create prompts by using the [`New-CsAutoAttendantPrompt`](https://learn.microsoft.com/powershell/module/teams/new-csautoattendantprompt) cmdlet.

> [!NOTE]
> If Mainline Attendant is enabled, only TTS prompts are supported.
>
> If Mainline Attendant is enabled and no greeting text is provided, the following default prompt will be played:
>
> {insert text here}

```yaml
Type: System.Collections.Generic.List
Parameter Sets: (All)
Expand Down Expand Up @@ -138,14 +145,14 @@ Accept wildcard characters: False

### -RingResourceAccountDelegates

If enabled for this call flow, Auto Attendant will first ring the delegates assigned to the resource account the call is on. If none of the delegates answer, the call is returned to the Auto Attendant for standard processing.

If there are no delegates assigned to the resource account the call is on then the Auto Attendant will process the call normally.

_Voice applications private preview customers only._

_Saving an auto attendant configuration through Teams admin center will remove this setting._

If enabled for this call flow, Auto Attendant will first ring the delegates assigned to the resource account the call is on. If none of the delegates answer, the call is returned to the Auto Attendant for standard processing.

If there are no delegates assigned to the resource account the call is on then the Auto Attendant will process the call normally.

```yaml
Type: Boolean
Parameter Sets: (All)
Expand Down
5 changes: 4 additions & 1 deletion teams/teams-ps/teams/New-CsAutoAttendantMenu.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,10 @@ Accept wildcard characters: False
### -Prompts
The Prompts parameter reflects the prompts to play when the menu is activated.

You can create new prompts by using the New-CsAutoAttendantPrompt cmdlet.
You can create prompts by using the [`New-CsAutoAttendantPrompt`](https://learn.microsoft.com/powershell/module/teams/new-csautoattendantprompt) cmdlet.

> [!NOTE]
> If Mainline Attendant is enabled, only TTS prompts are supported.

```yaml
Type: Object
Expand Down
54 changes: 53 additions & 1 deletion teams/teams-ps/teams/New-CsAutoAttendantMenuOption.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,12 +18,19 @@ Use the New-CsAutoAttendantMenuOption cmdlet to create a new menu option.
## SYNTAX

```
New-CsAutoAttendantMenuOption -Action <DisconnectCall | TransferCallToOperator | TransferCallToTarget> -DtmfResponse <Tone0 | Tone1 | Tone2 | Tone3 | Tone4 | Tone5 | Tone6 | Tone7 | Tone8 | Tone9 | Automatic> [-VoiceResponses <List>] [-CallTarget <Object>] [-Prompt <Object>] [-Tenant <Guid>] [<CommonParameters>]
New-CsAutoAttendantMenuOption -Action <MainlineAttendantFlow | DisconnectCall | TransferCallToOperator | TransferCallToTarget> -DtmfResponse <Tone0 | Tone1 | Tone2 | Tone3 | Tone4 | Tone5 | Tone6 | Tone7 | Tone8 | Tone9 | Automatic> [-VoiceResponses <List>] [-CallTarget <Object>] [-Prompt <Object>] [-MainlineAttendantTarget <String>] [-Description <String>] [-Tenant <Guid>] [<CommonParameters>]
```

## DESCRIPTION
The New-CsAutoAttendantMenuOption cmdlet creates a new menu option for the Auto Attendant (AA) service. The AA service uses the menu options to respond to a caller with the appropriate action.

> [!CAUTION]
> The following configuration parameters 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.
>
> - -Description
> - -Action MainLineAttendantFlow
> - -MainlineAttendantTarget

## EXAMPLES

### -------------------------- Example 1 --------------------------
Expand Down Expand Up @@ -52,6 +59,7 @@ This example creates a menu option to play an announcement for the defined promp

## PARAMETERS


### -Action
The Action parameter represents the action to be taken when the menu option is activated. The Action must be set to one of the following values:

Expand Down Expand Up @@ -152,6 +160,50 @@ Accept pipeline input: False
Accept wildcard characters: False
```

### -Description
_Voice applications private preview customers only._

_Saving an auto attendant configuration through Teams admin center will remove this setting._

A description/set of keywords for the option.

Used by Mainline Attendant only.

Limit: 500 characters

```yaml
Type: System.String
Parameter Sets: (All)
Aliases:
applicable: Microsoft Teams

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -MainlineAttendantTarget
_Voice applications private preview customers only._

_Saving an auto attendant configuration through Teams admin center will remove this setting._

The Mainline Attendant call flow target identifier.

```yaml
Type: System.String
Parameter Sets: (All)
Aliases:
applicable: Microsoft Teams

Required: True if -Action = MainlineAttendantFlow
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Tenant

```yaml
Expand Down
Loading