Get-CsRgsAgentGroup
Última modificación del tema: 2012-03-23
Devuelve información sobre los grupos de agentes de Grupo de respuesta configurados en la organización. Un grupo de agentes es una colección de agentes asignada a una cola de Grupo de respuesta. Los agentes son usuarios asignados para responder llamadas dirigidas a una cola.
Sintaxis
Get-CsRgsAgentGroup [-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, la aplicación determina en primer lugar qué flujo de trabajo corresponde al número llamado. Según la configuración del flujo de trabajo, la llamada puede enrutarse a una serie de preguntas de repuesta de voz interactiva (IVR), en las que el autor de la llamada debe responder a una o varias preguntas del tipo "¿Tiene una consulta relacionada con el hardware o con el software?". También se puede colocar la llamada en una cola de Grupo de respuesta, en la que el autor de la llamada estará en espera hasta que haya una persona designada disponible para atender la llamada. Las personas designadas para responder a llamadas se llaman agentes, y un conjunto de agentes se conoce como grupo de agentes de Grupo de respuesta. Los grupos de agentes están asociados con flujos de trabajo y pueden asociarse de manera más específica con tareas similares. Por ejemplo, el personal de asistencia técnica puede agruparse en el grupo de agentes Help Desk, mientras que los agentes de atención al cliente pueden agruparse en el grupo de agentes Customer Support.
El cmdlet Get-CsRgsAgentGroup permite devolver información sobre los grupos de agentes de Grupo de respuesta que están activos en la organización, incluyendo información sobre los usuarios asignados a cada grupo de agentes.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsRgsAgentGroup 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 (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRgsAgentGroup"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Rgs |
Representa la identidad del servicio en el que se hospeda el grupo de agentes de Grupo de respuesta o la identidad completa del propio grupo de agentes. Si especifica la identidad del servicio, por ejemplo, service:ApplicationServer:atl-cs-001.litwareinc.com, se devolverán todos los grupos de agentes hospedados en dicho servicio. Si especifica la identidad del grupo, sólo se devolverá el grupo de agentes especificado. La identidad de un grupo de agentes consiste en el valor Identity 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 un único grupo si especifica la identidad del servicio y, a continuación, incluye el parámetro Name y el nombre del grupo de agentes. De este modo, es posible recuperar un grupo de agentes específico sin necesidad de saber cuál es el identificador GUID que tiene asignado. Si se llama a Get-CsRgsAgentGroup sin definir ningún parámetro, se devolverá una colección de todos los grupos de agentes configurados en la organización. |
Name |
Opcional |
Cadena de caracteres |
Nombre único asignado al grupo de agentes al crearlo. |
Tipos de entrada
Cadena de caracteres. Get-CsRgsAgentGroup acepta un valor de cadena de caracteres que representa la identidad del grupo de agentes de Grupo de respuesta.
Tipos de valores devueltos
Get-CsRgsAgentGroup devuelve instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsRgsAgentGroup
El Ejemplo 1 devuelve todos los grupos de agentes de Grupo de respuesta configurados en la organización. Para ello, se llama a Get-CsRgsAgentGroup sin parámetros.
-------------------------- Ejemplo 2 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
El comando anterior devuelve todos los grupos de agentes de Grupo de respuesta configurados en el servicio ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 3 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
El comando del Ejemplo 3 devuelve un único grupo de agentes de Grupo de respuesta: el grupo llamado Help Desk encontrado en el servicio ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 4 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -eq "RoundRobin"}
En el Ejemplo 4 se devuelve información de todos los grupos de agentes de Grupo de respuesta del servicio ApplicationServer:atl-cs-001.litwareinc.com, siempre y cuando dichos grupos usen el método de enrutamiento de operación por turnos (RoundRobin). Para ello, el comando primero usa Get-CsRgsAgentGroup para devolver una colección de todos los grupos de agentes de ApplicationServer:atl-cs-001.litwareinc.com. Esta colección se transfiere al cmdlet Where-Object, que selecciona solo los grupos en los que la propiedad RoutingMethod sea igual a "RoundRobin".
-------------------------- Ejemplo 5 ------------------------
Get-CsRgsAgentGroup -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"}
El comando del Ejemplo 5 es una variación del usado en el Ejemplo 4, pero, en este caso, se devuelve información de todos los grupos de agentes de Grupo de respuesta del servicio ApplicationServer:atl-cs-001.litwareinc.com que no usan el método de enrutamiento de operación por turnos (RoundRobin). Para ello, el comando primero llama a Get-CsRgsAgentGroup para devolver una colección de todos los grupos de agentes de ApplicationServer:atl-cs-001.litwareinc.com. Esta colección se transfiere al cmdlet Where-Object, que selecciona solo los grupos en los que la propiedad RoutingMethod no sea igual a "RoundRobin".