Commands › Microsoft Teams

New-CsAutoAttendantMenuOption

Microsoft Teams MicrosoftTeams New-*

Create a new menu option.

Quick start script

# New-CsAutoAttendantMenuOption — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsAutoAttendantMenuOption
$before | Format-List

# 3. Make the change
New-CsAutoAttendantMenuOption -Action <Object> -MainlineAttendantTarget <String>

# 4. Verify and diff
$after = Get-CsAutoAttendantMenuOption
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

New-CsAutoAttendantMenuOption -Action <List> [-DtmfResponse <List>] [-VoiceResponses <List>] [-CallTarget <Object>] [-Prompt <Object>] [-MainlineAttendantTarget <String>] [-Description <String>] [-AgentTargetType <List>] [-AgentTarget <String>] [-AgentTargetTagTemplateId <String>] [-Tenant <Guid>] [<CommonParameters>]

Parameters (11)

Parameter	Type	Required	What it controls
-Action	Object	yes	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:
-CallTarget	Object		The CallTarget parameter represents the target for call transfer after the menu option is selected.
-Description	String		A description/set of keywords for the option.
-DtmfResponse	Object		The DtmfResponse parameter indicates the key on the telephone keypad to be pressed to activate the menu option. The DtmfResponse must be set to one of the following values:
-MainlineAttendantTarget	String	yes	The Mainline Attendant call flow target identifier.
-Prompt	Prompt		The Prompt parameter reflects the prompts to play when the menu option is activated.
-AgentTargetType	Object		The AgentTargetType parameter indicates if a Copilot Studio or IVR application is invoked. The AgentTargetType must be set to one of the following values:
-AgentTarget	String		The AgentTarget parameter is the GUID of the target Copilot or a 3rd party IVR agent.
-AgentTargetTagTemplateId	String		The AgentTargetTagTemplateId parameter is the GUID of the Tag template to assign.
-Tenant	Guid		This parameter is reserved for Microsoft internal use only.
-VoiceResponses	List		The VoiceResponses parameter represents the voice responses to select a menu option when Voice Responses are enabled for the auto attendant.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.