Remove-CsRgsAgentGroup
Última modificación del tema: 2012-05-21
Quita un grupo de agentes de 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
Remove-CsRgsAgentGroup -Instance <AgentGroup> [-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, el servicio 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 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.
Para crear grupos de agentes nuevos se usa el cmdlet New-CsRgsAgentGroup. Para eliminar un grupo de agentes, es necesario llamar al cmdlet Remove-CsRgsAgentGroup. Tenga en cuenta que este cmdlet elimina el grupo completo y todos los agentes que contenga. Si solo quiere quitar un agente de un grupo, use en su lugar el cmdlet Set-CsRgsAgentGroup.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-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 (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 "Remove-CsRgsAgentGroup"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Instance |
Requerido |
Objeto AgentGroup |
Referencia a objeto que apunta al grupo de agente que se eliminará. Al transferir objetos de flujo de trabajo a Remove-CsRgsAgentGroup se puede dejar en blanco el parámetro de Instance. Para usar el parámetro de Instance, use comandos similares a lo siguiente: $x = Get-CsRgsAgentGroup –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsAgentGroup –Instance $x Tenga en cuenta que solo puede eliminar un único grupo de agente cada vez al usar el parámetro de Instance. Es decir, la referencia a objeto ($x) no puede contener varios objetos de grupo de agente. |
Force |
Opcional |
Parámetro modificador |
Fuerza la eliminación del grupo de agentes. Si el parámetro está presente, el grupo de agentes se eliminará sin mostrar ningún mensaje de advertencia, incluso si un flujo de trabajo activo lo está usando. Si el parámetro no está presente, se le pedirá confirmación para eliminar cualquier grupo de agentes 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.AgentGroup. Remove-CsRgsAgentGroup acepta instancias transferidas del objeto del grupo de agentes de Grupo de respuesta.
Tipos de valores devueltos
Remove-CsRgsAgentGroup elimina instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsAgentGroup
El comando anterior elimina todos los grupos de agentes de Grupo de respuesta configurados en el servicio ApplicationServer:atl-cs-001.litwareinc.com. Para ello, el comando primero usa Get-CsRgsAgentGroup para devolver todos los grupos de agentes de ApplicationServer:atl-cs-001.litwareinc.com. A continuación, estos grupos se transfieren al cmdlet Remove-CsRgsAgentGroup, que los elimina.
-------------------------- Ejemplo 2 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" | Remove-CsRgsAgentGroup
En el Ejemplo 2 se elimina un único grupo de agentes de Grupo de respuesta: el grupo llamado Help Desk. Para ello, se usa en primer lugar Get-CsRgsAgentGroup para devolver el grupo de agentes Help Desk (-Name "Help Desk") de ApplicationServer:atl-cs-001.litwareinc.com. A continuación, este grupo se transfiere a Remove-CsRgsAgentGroup, que lo elimina del servicio.
-------------------------- Ejemplo 3 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"} | Remove-CsRgsAgentGroup
El Ejemplo 3 elimina todos los grupos de agentes de Grupo de respuesta de ApplicationServer:atl-cs-001.litwareinc.com que no usen el método de enrutamiento de operación por turnos (RoundRobin). Para ello, primero se llama a Get-CsRgsAgentGroup para devolver una colección de todos los grupos de agentes del servicio 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 es igual a (-ne) RoundRobin. A continuación, la colección filtrada se transfiere a Remove-CsRgsAgentGroup, que elimina todos los elementos de la colección.