Get-CsRgsQueue

Get-CsRgsQueue
    [[-Identity] <RgsIdentity>]
    [-Name <String>]
    [-Owner <RgsIdentity>]
    [-ShowAll]
    [<CommonParameters>]

When someone calls a phone number associated with the Response Group application, one of two things typically happens: either the call is transferred to a question that the caller must answer in order to continue (for example, "Press 1 for hardware support; press 2 for software support") or the call is placed in a queue until a Response Group agent is available to answer the call.

Instead of having a single queue for all phone calls, the Response Group application enables you to create multiple queues that can be associated with different workflows and different Response Group agent groups. In turn, this means queues can respond differently to events such as a designated number of calls being simultaneously held in the queue, or to callers that have been on hold for a specified number of seconds.

The Get-CsRgsQueue cmdlet provides a way for you to return information about the Response Group queues configured for use in your organization.

Get-CsRgsQueue

The command shown in Example 1 returns information about all the Response Group queues configured for use in the organization. This is done by calling Get-CsRgsQueue without any parameters.

Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com

The command shown in Example 2 returns information about all the Response Group queues located on the service ApplicationServer:atl-cs-001.litwareinc.com.

Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"

In Example 3, information is returned for a single Response Group queue: the queue named "Help Desk" located on the service ApplicationServer:atl-cs-001.litwareinc.com.

Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty TimeoutAction

The command shown in Example 4 displays detailed information about the TimeoutAction property for each Response Group queue found on the service ApplicationServer:atl-cs-001.litwareinc.com. To carry out this task, Get-CsRgsQueue is first used to return information about all the queues found on ApplicationServer:atl-cs-001.litwareinc.com. This information is then passed to the Select-Object cmdlet, which "expands" the value stored in the TimeoutAction property. When you expand the TimeoutAction property, you see the individual properties of the embedded object that make up the property value: Prompt; TargetQuestion; Target; TargetQueueID; and TargetUri.

Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.OverflowCandidate -eq "NewestCall"}

Example 5 returns information about all the Response Group queues on ApplicationServer:atl-cs-001.litwareinc.com where the OverflowCandidate property is set to NewestCall. To accomplish this task, the command first uses Get-CsRgsQueue to return a collection of all the Response Group queues found on the specified service. That collection is then piped to the Where-Object cmdlet, which selects only those queues where the OverflowCandidate property is equal to "NewestCall".

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.

A string value representing the Identity of the Response Group queue.