Remove-CsRgsQueue
Última modificación del tema: 2012-03-23
Elimina 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
Remove-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 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 un periodo de tiempo especificado.
Además de crear colas, también se pueden quitar colas existentes; para eso se usa el cmdlet Remove-CsRgsQueue. De manera predeterminada, se mostrará un mensaje de advertencia si intenta quitar una cola asignada actualmente a un flujo de trabajo activo; deberá verificar que quiere eliminar la cola y Windows PowerShell quedará en pausa (no se eliminará la cola) hasta que responda a la advertencia. Para anular el mensaje de advertencia y eliminar las colas en uso por un flujo de trabajo activo, agregue el parámetro Force. Por ejemplo:
Get-CsRgsQueue –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsQueue –Force
Remove-CsRgsQueue comprueba siempre si la cola está siendo usada por un flujo de trabajo activo antes de eliminarla. Sin embargo, el cmdlet no verifica si la cola está siendo usada o no por otra cola, como la cola de tiempo de espera o de desbordamiento. Esto significa que es posible eliminar una cola que necesita otra cola. Debido a esto, puede usar el cmdlet Get-CsRgsQueue para comprobar las propiedades OverflowAction y TimeoutAction del resto de colas de Grupo de respuesta antes de ejecutar Remove-CsRgsQueue para eliminar una cola.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-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 "Remove-CsRgsQueue"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Instance |
Requerido |
Objeto de cola |
Referencia a objeto que apunta a la cola que se eliminará. Al transferir objetos de flujo de trabajo a Remove-CsRgsQueue se puede dejar en blanco el parámetro Instance. Para usar el parámetro Instance, use comandos similares a lo siguiente: $x = Get-CsRgsQueue –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsQueue –Instance $x Tenga en cuenta que solo puede eliminar una única cola cada vez al usar el parámetro de Instance. Es decir, la referencia a objeto ($x) no puede contener varios objetos de cola. |
Force |
Opcional |
Parámetro modificador |
Fuerza la eliminación de una cola de Grupo de respuesta. Si el parámetro está presente, la cola se eliminará sin mostrar ningún mensaje de advertencia, incluso si está asignada a un flujo de trabajo activo. Si el parámetro no está presente, se le pedirá confirmación para eliminar cualquier cola que se encuentre actualmente en uso por un flujo de trabajo activo. |
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. Remove-CsRgsQueue acepta instancias transferidas del objeto de cola de Grupo de respuesta.
Tipos de valores devueltos
Remove-CsRgsQueue elimina instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsQueue
El comando del Ejemplo 1 elimina todas las colas de Grupo de respuesta del servicio ApplicationServer:atl-cs-001.litwareinc.com. Para ello, el comando primero usa Get-CsRgsQueue para devolver una colección de todas las colas de ApplicationServer:atl-cs-001.litwareinc.com. A continuación, la colección se transfiere a Remove-CsRgsQueue, que elimina todas las colas.
-------------------------- Ejemplo 2 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Queue" | Remove-CsRgsQueue
En el Ejemplo 2 se elimina una única cola de Grupo de respuesta: la cola llamada "Help Desk Queue" del servicio ApplicationServer:atl-cs-001.litwareinc.com. Para eliminar esta cola, se llama a Get-CsRgsQueue con los parámetros Identity y Name; la única cola que devuelve esta llamada se transfiere a Remove-CsRgsQueue, que la elimina.
-------------------------- Ejemplo 3 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.OverflowCandidate -eq "NewestCall"} | Remove-CsRgsQueue
El comando anterior elimina todas las colas de Grupo de respuesta del servicio ApplicationServer:atl-cs-001.litwareinc.com, siempre y cuando dichas colas tengan la propiedad OverflowCandidate establecida en NewestCall. Para ello, primero se llama a Get-CsRgsQueue para devolver una colección de todas las colas de Grupo de respuesta de ApplicationServer:atl-cs-001.litwareinc.com. Esta colección se transfiere al cmdlet Where-Object, que selecciona solo las colas en las que la propiedad OverflowCandidate sea igual a "NewestCall". A continuación, la colección filtrada se transfiere a Remove-CsRgsQueue, que elimina todas las colas de la colección.