New-CsCallQueue

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

Syntax

New-CsCallQueue
   -Name <String>
   [-AgentAlertTime <Int16>]
   [-AllowOptOut <Boolean>]
   [-DistributionLists <List>]
   [-Tenant <Guid>]
   [-UseDefaultMusicOnHold <Boolean>]
   [-WelcomeMusicAudioFileId <Guid>]
   [-MusicOnHoldAudioFileId <Guid>]
   [-OverflowAction <Object>]
   [-OverflowActionTarget <Guid>]
   [-OverflowThreshold <Int16>]
   [-TimeoutAction <Object>]
   [-TimeoutActionTarget <Guid>]
   [-TimeoutThreshold <Int16>]
   [-RoutingMethod <Object>]
   [<CommonParameters>]

Description

The New-CsCallQueue cmdlet creates a new Call Queue.

Examples

-------------------------- Example 1 --------------------------

New-CsCallQueue -Name "Help Desk" -UseDefaultMusicOnHold $true

This example creates a Call Queue for the organization named "Help Desk" using default music on hold.

-------------------------- Example 2 --------------------------

New-CsCallQueue -Name "Help desk" -RoutingMethod Attendant -DistributionLists @("8521b0e3-51bd-4a4b-a8d6-b219a77a0a6a", "868dccd8-d723-4b4f-8d74-ab59e207c357") -AllowOptOut $false -AgentAlertTime 30 -OverflowThreshold 15 -OverflowAction Forward -OverflowActionTarget 7fd04db1-1c8e-4fdf-9af5-031514ba1358 -TimeoutThreshold 30 -TimeoutAction Disconnect -MusicOnHoldAudioFileId 1e81adaf-7c3e-4db1-9d61-5d135abb1bcc -WelcomeMusicAudioFileId 0b31bbe5-e2a0-4117-9b6f-956bca6023f8

This example creates a Call Queue for the organization named "Help Desk" and uses default music on hold files

Parameters

-AgentAlertTime

The AgentAlertTime parameter represents the time (in seconds) that a call can remain unanswered before it is automatically routed to the next agent. The AgentAlertTime can be set to any integer value between 30 and 180 seconds (3 minutes), inclusive. The default value is 30 seconds.

Type:Int16
Position:Named
Default value:30
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-AllowOptOut

The AllowOptOut parameter indicates whether or not agents can opt in or opt out from taking calls from a Call Queue.

Type:Boolean
Position:Named
Default value:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-DistributionLists

The DistributionLists parameter lets you add all the members of the distribution lists to the Call Queue. This is a list of distribution list GUIDs. A service wide configurable maximum number of DLs per Call Queue are allowed. Only the first N (service wide configurable) agents from all distribution lists combined are considered for accepting the call. Nested DLs are supported. O365 Groups can also be used to add members to the Call Queue.

Type:List
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-MusicOnHoldAudioFileId

The MusicOnHoldFileContent parameter represents music to play when callers are placed on hold. This is the unique identifier of the audio file. This parameter is required if the UseDefaultMusicOnHold parameter is not specified.

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Name

The Name parameter specifies a unique name for the Call Queue.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-OverflowAction

The OverflowAction parameter designates the action to take if the overflow threshold is reached. The OverflowAction property must be set to one of the following three values: DisconnectWithBusy, Forward, and Voicemail.

PARAMVALUE: DisconnectWithBusy | Forward | Voicemail

Type:Object
Position:Named
Default value:DisconnectWithBusy
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-OverflowActionTarget

The OverflowActionTarget parameter represents the target of the overflow action. If the OverFlowAction is set to Forward, this parameter must be set to a Guid. Otherwise, this parameter is optional.

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-OverflowThreshold

The OverflowThreshold parameter defines the number of calls that can be in the queue at any one time before the overflow action is triggered. The OverflowThreshold can be any integer value between 0 and 200, inclusive. A value of 0 causes calls not to reach agents and the overflow action to be taken immediately

Type:Int16
Position:Named
Default value:50
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-RoutingMethod

The RoutingMethod defines how agents will be called in a Call Queue. If the routing method is set to Serial, then agents will be called one at a time. If the routing method is set to Attendant, then agents will be called in parallel.

PARAMVALUE: Attendant | Serial | RoundRobin

Type:Object
Position:Named
Default value:Attendant
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Tenant

This parameter is reserved for Microsoft internal use only.

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-TimeoutAction

The TimeoutAction parameter defines the action to take if the timeout threshold is reached. The TimeoutAction property must be set to one of the following three values: Disconnect, Forward, and Voicemail. The default value is Disconnect.

PARAMVALUE: Disconnect | Forward | Voicemail

Type:Object
Position:Named
Default value:Disconnect
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-TimeoutActionTarget

The TimeoutActionTarget represents the target of the timeout action. If the TimeoutAction is set to Forward, this parameter must be set to a Guid. Otherwise, this field is optional.

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-TimeoutThreshold

The TimeoutThreshold parameter defines the time (in seconds) that a call can be in the queue before that call times out. At that point, the system will take the action specified by the TimeoutAction parameter. The TimeoutThreshold can be any integer value between 0 and 2700 seconds (inclusive), and is rounded to the nearest 15th interval. For example, if set to 47 seconds, then it is rounded down to 45. If set to 0, welcome music is played, and then the timeout action will be taken.

Type:Int16
Position:Named
Default value:1200
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-UseDefaultMusicOnHold

The UseDefaultMusicOnHold parameter indicates that this Call Queue uses the default music on hold. This parameter cannot be specified together with MusicOnHoldAudioFileId.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-WelcomeMusicAudioFileId

The WelcomeMusicAudioFileId parameter represents the audio file to play when callers are connected with the Call Queue. This is the unique identifier of the audio file.

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online

Outputs

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