Set-CsRgsQueue
Última modificación del tema: 2012-03-23
Modifica 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
Set-CsRgsQueue -Instance <Queue> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 X número de llamadas en la cola al mismo tiempo, o cuando los autores de llamadas han estado en espera durante X número de segundos.
El cmdlet Set-CsRgsQueue permite modificar una cola de Grupo de respuesta. Set-CsRgsQueue no permite modificar directamente la cola; el cmdlet no incluye parámetros para cambiar el umbral de desbordamiento o la acción de desbordamiento, por ejemplo. Para modificar una cola, primero deberá crear una referencia a objeto a dicha cola usando Get-CsRgsQueue para recuperar la cola correspondiente, y después almacenarla en una variable. Las modificaciones se realizarán en la memoria, asignando nuevos valores a las propiedades de la cola. Una vez realizadas todas las modificaciones, se llama a Set-CsRgsQueue para escribir los cambios en la cola de Grupo de respuesta real. Si no llama a Set-CsRgsQueue, los cambios solo se aplicarán en la memoria, y desaparecerán al cerrar Windows PowerShell o eliminar la variable de referencia a objeto.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-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 (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 "Set-CsRgsQueue"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Instance |
Requerido |
Objeto Queue |
Referencia a objeto a la cola de Grupo de respuesta que se modificará. Para recuperar una referencia a objeto se usa el cmdlet Get-CsRgsQueue y se asigna el valor devuelto a una variable; por ejemplo, este comando devuelve una referencia a objeto a la cola Help Desk y almacena la referencia a objeto en una variable llamada $x: $x = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" |
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. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Queue. Set-CsRgsQueue acepta instancias transferidas del objeto de cola de Grupo de respuesta.
Tipos de valores devueltos
Set-CsRgsQueue no devuelve objetos ni valores. Este cmdlet se usa para modificar instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
$x = Get-CsRgsQueue -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.OverflowCandidate = "NewestCall"
Set-CsRgsQueue -Instance $x
En el Ejemplo 1, se modifica la propiedad OverflowCandidate de la cola Help Desk de Grupo de respuesta del servicio ApplicationServer:atl-cs-001.litwareinc.com. Para ello, el primer comando del ejemplo usa Get-CsRgsQueue para recuperar la cola especificada (-Name "Help Desk") de ApplicationServer:atl-cs-001.litwareinc.com. La cola recuperada se almacenan en una variable llamada $x.
Una vez recuperada la cola, el segundo comando del ejemplo establece el valor de la propiedad OverflowCandidate de la cola virtual en NewestCall. Una vez completado este comando, el último comando del ejemplo usa Set-CsRgsQueue para escribir estos cambios en la cola Help Desk real. Tenga en cuenta que, hasta este punto, los cambios se han realizado solo en la memoria. La cola de Grupo de respuesta real de ApplicationServer:atl-cs-001.litwareinc.com no se modificará hasta que llame a Set-CsRgsQueue.
-------------------------- Ejemplo 2 ------------------------
$x = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Overflow Queue"
$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToQueue -QueueID $x.Identity
$z = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$z.OverflowAction = $y
Set-CsRgsQueue -Instance $z
Los comandos del Ejemplo 2 muestran cómo crear una acción de llamada de grupo de respuesta y asignarla a una cola de grupo de respuesta existente. Para ello, el primer paso es usar Get-CsRgsQueue para recuperar la cola de Grupo de respuesta Help Desk Overflow Queue de ApplicationServer:atl-cs-001.litwareinc.com. La información de esta cola se almacena en una variable llamada $x.
Después de recuperar la cola se usa el cmdlet New-CsRgsPrompt para crear una indicación de texto a voz que se almacena en una variable llamada $w. A continuación, se usa el cmdlet New-CsRgsCallAction para crear una nueva acción de llamada. Se asignan tres parámetros a esta acción de llamada: Prompt (la indicación que usará la acción de llamada); Action (indica qué pasará si se desencadena la nueva acción de llamada; el valor del parámetro TransferToQueue significa que la llamada se transferirá a otra cola de Grupo de respuesta); y QueueID, la cola alternativa a la que se transferirá la llamada ($x.Identity, que representa la identidad de la cola Help Desk Overflow Queue). Esta nueva acción de llamada se crea en la memoria y se almacena en una variable llamada $y.
El siguiente comando recupera la cola que se modificará; en este ejemplo, es la cola Help Desk de ApplicationServer:atl-cs-001.litwareinc.com. Una vez que Get-CsRgsQueue ha devuelto esta cola, el objeto de cola se almacena en una variable llamada $z.
A continuación podrá asignar la nueva acción de llamada a la cola Help Desk; para ello, debe definirse el valor de la propiedad OverflowAction como $y, la variable que contiene la acción de llamada recién creada.
Una vez asignada la acción de llamada, el último comando del ejemplo llama a Set-CsRgsQueue para escribir los cambios en la instancia real de la cola Help Desk en ApplicationServer:atl-cs-001.litwareinc.com.