New-CsRgsQueue
Última modificación del tema: 2012-03-23
Crea una cola de Grupo de respuesta. Con la Aplicación de grupo de respuesta, las llamadas telefónicas se ponen en una cola y los autores de llamada quedan en espera hasta que un agente de Grupo de respuesta esté disponible para responder a la llamada.
Sintaxis
New-CsRgsQueue -Parent <RgsIdentity> -Name <String> [-AgentGroupIDList <Collection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-OverflowAction <CallAction>] [-OverflowCandidate <NewestCall | OldestCall>] [-OverflowThreshold <Nullable>] [-TimeoutAction <CallAction>] [-TimeoutThreshold <Nullable>] [-WhatIf [<SwitchParameter>]]
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 se 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 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 un periodo de tiempo especificado.
El cmdlet New-CsRgsQueue permite a los administradores crear colas de Grupo de respuesta con facilidad.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsRgsQueue 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-CsRgsQueue"}
Parámetros
Parámetro | Requerido | Tipo | Descripción |
---|---|---|---|
Parent |
Requerido |
Identidad Rgs |
Servicio en el que se hospedará la cola. Por ejemplo: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com". |
Name |
Requerido |
Cadena de caracteres |
Nombre único que se asigna a la cola. El par de propiedades Parent y Name permite identificar de manera única las colas de Grupo de respuesta sin necesidad de recurrir al identificador único global (GUID) de la cola. |
AgentGroupIdList |
Opcional |
Colección AgentGroup |
Identidad de los grupos de agentes de Grupo de respuesta que se agregarán a la cola. Las identidades del grupo de agentes pueden recuperarse con el cmdlet Get-CsRgsAgentGroup. Para obtener más información, vea la sección de ejemplos de este tema. Si una llamada se enruta a una cola que no tiene asignado ningún grupo de agentes (o tiene asignados únicamente grupos de agentes que no tienen ningún agente), se desconectará automáticamente. |
Description |
Opcional |
Cadena de caracteres |
Permite a los administradores especificar información adicional sobre la cola de Grupo de respuesta. |
OverflowAction |
Opcional |
Objeto CallAction |
Acción que se llevará a cabo si se alcanza el umbral de desbordamiento. El parámetro OverflowAction debe crearse con el cmdlet New-CsRgsCallAction. |
OverflowCandidate |
Opcional |
Modificador de lista PS |
Indica con qué llamada se realizará la acción si se alcanza el umbral de desbordamiento. La propiedad OverflowCandidate debe definirse en uno de estos dos valores: NewestCall OldestCall El valor predeterminado es NewestCall. |
OverflowThreshold |
Opcional |
Entero |
Número de llamadas que pueden estar en la cola simultáneamente antes de que se active la acción de desbordamiento. OverflowThreshold puede definirse en cualquier valor entero entre 0 y 1000, ambos incluidos. El valor predeterminado es nulo (Null), es decir, puede haber un número ilimitado de llamadas en la cola al mismo tiempo. |
TimeoutAction |
Opcional |
Objeto CallAction |
Acción que se llevará a cabo si se alcanza el umbral de tiempo de espera. El parámetro TimeoutAction debe crearse con el cmdlet New-CsRgsCallAction. |
TimeoutThreshold |
Opcional |
Entero |
Cantidad de tiempo (en segundos) que una llamada puede estar en la cola hasta que se agote el tiempo de espera. Cuando se agote el tiempo, el sistema llevará a cabo la acción especificada por el parámetro TimeoutAction. El umbral de tiempo de espera puede ser cualquier valor entero entre 10 y 65535 segundos (aproximadamente 18 horas), ambos incluidos; el valor predeterminado es nulo, es decir, nunca se agotará el tiempo de espera en cola. |
Force |
Opcional |
Parámetro modificador |
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-CsRgsQueue no acepta la entrada transferida.
Tipos de valores devueltos
New-CsRgsQueue crea instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
$x = New-CsRgsCallAction -Action TransferToVoicemailUri -Uri "sip:+14255551298@litwareinc.com"
New-CsRgsQueue -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -OverflowCandidate "OldestCall" -OverflowAction $x -OverflowThreshold 25
En el Ejemplo 1 se crea un cola de Grupo de respuesta para el servicio ApplicationServer:atl-cs-001.litwareinc.com. El primer comando del ejemplo usa el cmdlet New-CsRgsCallAction para crear una acción de llamada para la cola; en este ejemplo, si se supera el umbral de desbordamiento, las llamadas se transfieren automáticamente al correo de voz. Esta configuración se realiza estableciendo el parámetro Action en TransferToVoicemailUri y la propiedad URI en el URI del SIP del correo de voz "sip:+14255551298@litwareinc.com".
Después de configurar la acción de llamada (y de almacenarla en la variable $x), se usa New-CsRgsQueue para crear una nueva cola llamada Help Desk. Además de especificar el parámetro OverflowAction, este comando también configura los valores de las propiedades OverflowCandidate y OverflowThreshold.