New-CsRgsAgentGroup
Última modificación del tema: 2012-03-23
Crea un grupo de agentes para Grupo de respuesta. 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 específica.
Sintaxis
New-CsRgsAgentGroup -Parent <RgsIdentity> -Name <String> [-AgentAlertTime <Int16>] [-AgentsByUri <Collection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DistributionGroupAddress <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-ParticipationPolicy <Informal | Formal>] [-RoutingMethod <LongestIdle | Serial | Parallel | RoundRobin | Attendant>] [-WhatIf [<SwitchParameter>]]
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 colas 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 Asistencia técnica, mientras que los agentes de atención al cliente pueden agruparse en el grupo de agentes Atención al cliente.
Si hay varios grupos asignados a una cola, en primer lugar la Aplicación de grupo de respuesta llamará a todos los agentes disponibles del primer grupo asignado a esa cola. Si no responde ninguno de esos agentes, la aplicación empezará a llamar a todos los agentes disponibles del siguiente grupo asignado a esa cola.
Para crear grupos de agentes nuevos se usa el cmdlet New-CsRgsAgentGroup.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsRgsAgentGroup de forma local: RTCUniversalServerAdmins. 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 "New-CsRgsAgentGroup"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Name |
Requerido |
Cadena de caracteres |
Nombre único que se asigna al grupo de agentes. El par de propiedades Parent y Name permite identificar de manera única los grupos de agentes sin necesidad de hacer referencia al identificador único global (GUID) del grupo. |
Parent |
Requerido |
Identidad Rgs |
Servicio en el que se hospeda el nuevo grupo de agentes. Por ejemplo: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com". |
AgentAlertTime |
Opcional |
Entero |
Representa la cantidad de tiempo (en segundos) que una llamada puede permanecer sin respuesta hasta que se enrute automáticamente al siguiente agente. AgentAlertTime puede establecerse en cualquier valor entero entre 10 y 600 segundos (10 minutos), ambos valores incluidos. El valor predeterminado es 20 segundos. Nota: La configuración de hora de la alerta Agente no puede ser superior a 180 segundos. Si es superior a 180 segundos, la aplicación cliente rechazará la llamada debido a que el temporizador de la transacción SIP habrá superado el tiempo de espera máximo. Para evitarlo, establezca el Tiempo de alerta en un valor inferior a 180 segundos. |
AgentsByUri |
Opcional |
Colección de agentes |
Permite agregar agentes de manera individual a un grupo de agentes. Los nuevos agentes se identifican con su dirección SIP. |
Description |
Opcional |
Cadena de caracteres |
Permite a los administradores especificar información explicativa adicional sobre el grupo de agentes. Por ejemplo, la descripción puede contener información sobre con quién ponerse en contacto si el grupo no recibe las llamadas telefónicas correspondientes. |
DistributionGroupAddress |
Opcional |
Cadena de caracteres |
Permite agregar todos los miembros de un grupo de distribución a un grupo de agentes. |
ParticipationPolicy |
Opcional |
Modificador de lista PS |
Indica si los agentes necesitan iniciar una sesión en el sistema para recibir llamadas telefónicas dirigidas al grupo. Si ParticipationPolicy está establecido en Informal (valor predeterminado), no es necesario iniciar sesión. Si ParticipationPolicy está establecido en Formal, es necesario iniciar sesión. |
RoutingMethod |
Opcional |
Modificador de lista PS |
Especifica el método usado para enrutar llamadas nuevas a los agentes. El parámetro RoutingMethod debe definirse en uno de estos valores: LongestIdle – Las llamadas se enrutan al agente que haya estado inactivo, es decir, no involucrado en una actividad de Microsoft Lync 2010, durante el periodo de tiempo más largo. RoundRobin – Las llamadas se enrutan al siguiente agente de la lista. Serial – Las llamadas siempre se enrutan al primer agente de la lista y solo se enrutan a otros agentes si esta persona no está disponible o no responde en el tiempo asignado. Parallel – Las llamadas se enrutan a todos los agentes al mismo tiempo, excepto aquellos cuyo estado de presencia indique que están en una llamada o no disponibles por otro motivo. Attendant – Las llamadas se enrutan a todos los agentes al mismo tiempo, incluso a aquellos cuyo estado de presencia indique que están en una llamada o no disponibles por otro motivo. La única excepción se produce cuando un agente define su presencia como Do Not Disturb. El método de enrutamiento predeterminado es Parallel. |
Force |
Opcional |
Identificador único global |
Suprime la visualización de los mensajes de error que no sean graves que se produzcan al ejecutar el comando. |
InMemory |
Opcional |
Parámetro modificador |
Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet. |
Tipos de entrada
Ninguno. New-CsRgsAgentGroup no acepta la entrada transferida.
Tipos de valores devueltos
New-CsRgsAgentGroup crea instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
New-CsRgsAgentGroup -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Group"
El comando del Ejemplo 1 crea un grupo de agentes de Grupo de respuesta llamado Help Desk Group en ApplicationServer:atl-cs-001.litwareinc.com. Para crear el grupo, el comando llama a New-CsRgsAgentGroup con los parámetros Parent y Name. En este ejemplo no se especifica ningún otro parámetro de grupo, por lo tanto, se usarán los valores predeterminados. Dado que no se ha asignado ningún agente a este grupo, se desconectarán automáticamente las llamadas enrutadas al nuevo grupo de agentes.
-------------------------- Ejemplo 2 ------------------------
New-CsRgsAgentGroup -Parent service: ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Group" -AgentsByUri "sip:kenmyer@litwareinc.com","sip:pilarackerman@litwareinc.com"
En el Ejemplo 2 se crea un grupo de agentes de Grupo de respuesta y se le asignan dos agentes. Para ello, el comando llama a New-CsRgsAgentGroup con los parámetros Parent y Name. Además, este ejemplo también incluye el parámetro AgentsByUri con el valor "sip:kenmyer@litwareinc.com","sip:pilarackerman@litwareinc.com". Este valor es una lista de las direcciones SIP que se agregarán al grupo de agentes separadas por comas.