Get-CsRgsQueue
Última modificación del tema: 2012-03-23
Recupera información sobre las colas de Grupo de respuesta en uso en la organización. Con la Aplicación de grupo de respuesta, las llamadas telefónicas se ponen en una cola y quedan en espera hasta que un agente de Grupo de respuesta esté disponible para responder a la llamada.
Sintaxis
Get-CsRgsQueue [-Identity <RgsIdentity>] [-Name <String>]
Descripción detallada
Cuando alguien llama a un número de teléfono asociado con la Aplicación de grupo de respuesta, puede llevarse a cabo una de estas dos acciones: la llamada se transfiere a una pregunta que el autor de la llamada debe responder para continuar (por ejemplo, "Pulse 1 si necesita asistencia para hardware; pulse 2 si necesita asistencia para software"), o la llamada se coloca en una cola hasta que haya un agente de Grupo de respuesta disponible para responder.
En lugar de usar una única cola para todas las llamadas, la Aplicación de grupo de respuesta permite crear varias colas que pueden asociarse con diferentes flujos de trabajo y grupos de agentes de Grupo de respuesta. Además, las colas pueden configurarse para actuar de modo diferente en determinados casos, por ejemplo, cuando hay varias llamadas en la cola al mismo tiempo, o cuando los autores de llamadas han estado en espera durante el número de segundos especificado.
El cmdlet Get-CsRgsQueue permite recuperar información sobre las colas de Grupo de respuesta configuradas en la organización.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsRgsQueue de forma local: RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluidos los roles RBAC personalizados que haya creado usted mismo), ejecute el siguiente comando desde el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRgsQueue"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Rgs |
Representa la identidad del servicio en el que se hospeda la cola de Grupo de respuesta, o la identidad completa de la propia cola. Si especifica la identidad del servicio, por ejemplo, service:ApplicationServer:atl-cs-001.litwareinc.com, se devolverán todas las colas de Grupo de respuesta hospedadas en dicho servicio. Si especifica la identidad de la cola, solo se devolverá la cola de Grupo de respuesta especificada. La identidad de una cola consiste en el valor de identidad del servicio seguido de un identificador único global (GUID); por ejemplo: service:ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83. También puede recuperar una única cola de Grupo de respuesta si especifica la identidad del servicio y, a continuación, incluye el parámetro de nombre y el nombre de la cola. De este modo, es posible recuperar una cola de Grupo de respuesta específica sin necesidad de saber cuál es el identificador GUID que tiene asignado. Si se llama a Get-CsRgsQueue sin definir ningún parámetro, se devolverán todas las colas de Grupo de respuesta configuradas en la organización. |
Name |
Opcional |
Cadena de caracteres |
Nombre único asignado a la cola de Grupo de respuesta al crearla. |
Tipos de entrada
Cadena de caracteres. Get-CsRgsQueue acepta un valor de cadena que representa la identidad de la cola de Grupo de respuesta.
Tipos de valores devueltos
Get-CsRgsQueue devuelve instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
El comando anterior devuelve información sobre todas las colas de Grupo de respuesta configuradas para su uso en la organización. Para ello, se llama a Get-CsRgsQueue sin parámetros.
-------------------------- Ejemplo 2 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
El comando del Ejemplo 2 devuelve información sobre todas las colas de Grupo de respuesta del servicio ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 3 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
En el Ejemplo 3 se devuelve información de una única cola de Grupo de respuesta: la cola llamada "Help Desk" del servicio ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 4 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty TimeoutAction
El comando del Ejemplo 4 muestra información detallada sobre la propiedad TimeoutAction de cada cola de Grupo de respuesta del servicio ApplicationServer:atl-cs-001.litwareinc.com. Para ello, primero se usa Get-CsRgsQueue para devolver información sobre todas las colas de ApplicationServer:atl-cs-001.litwareinc.com. A continuación, esta información se transfiere al cmdlet Select-Object, que "amplía" el valor almacenado en la propiedad TimeoutAction. Al expandir la propiedad TimeoutAction, pueden verse las propiedades individuales del objeto incrustado que conforma el valor de la propiedad: Prompt; TargetQuestion; Target; TargetQueueID; y TargetUri.
-------------------------- Ejemplo 5 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.OverflowCandidate -eq "NewestCall"}
El comando anterior devuelve información sobre todas las colas de Grupo de respuesta de ApplicationServer:atl-cs-001.litwareinc.com cuya propiedad OverflowCandidate está establecida en NewestCall. Para ello, el comando primero usa Get-CsRgsQueue para devolver una colección de todas las colas de Grupo de respuesta del servicio especificado. Esta colección se transfiere al cmdlet Where-Object, que selecciona solo las colas en las que la propiedad OverflowCandidate es igual a "NewestCall".