Remove-CsRgsWorkflow
Última modificación del tema: 2012-03-23
Elimina un flujo de trabajo de Grupo de respuesta. Los flujos de trabajo determinan las acciones que se llevan a cabo cuando la Aplicación de grupo de respuesta recibe una llamada telefónica.
Sintaxis
Remove-CsRgsWorkflow -Instance <Workflow> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Los flujos de trabajo son un elemento clave de la Aplicación de grupo de respuesta. Cada flujo de trabajo está asociado con un único número de teléfono; cuando alguien llama a dicho número, el flujo de trabajo determina cómo se administrará la llamada. Por ejemplo, la llamada puede enrutarse a través de una serie de preguntas de respuesta de voz interactiva (IVR) que indican al autor de la llamada que debe especificar información adicional ("Pulse 1 si necesita asistencia para hardware. Pulse 2 si necesita asistencia para software"). También se puede colocar la llamada en una cola y poner al autor de la llamada en espera hasta que haya un agente disponible para atender la llamada. La disponibilidad de los agentes para responder a llamadas también está determinada por el flujo de trabajo: los flujos de trabajo se usan para configurar el horario laboral (días de la semana y horas del día en que los agentes están disponibles para responder a llamadas) y los festivos (días en los que no hay agentes disponibles para responder a llamadas).
Los flujos de trabajo nuevos se crean con el cmdlet New-CsRgsWorkflow. Los flujos de trabajo creados pueden eliminarse usando Remove-CsRgsWorkflow. Tenga en cuenta que, al eliminar un flujo de trabajo, éste se suprime totalmente de la Aplicación de grupo de respuesta. Si quiere deshabilitar temporalmente un flujo de trabajo, no use Remove-CsRgsWorkflow; use en su lugar el cmdlet Set-CsRgsWorkflow para deshabilitar (y después volver a habilitar) el flujo de trabajo.
Al intentar eliminar un flujo de trabajo activo, Remove-CsRgsWorkflow mostrará un mensaje de confirmación para que verifique que desea eliminarlo; Remove-CsRgsWorkflow no realizará ninguna acción hasta que responda al mensaje de confirmación. Para anular este mensaje y eliminar un flujo de trabajo activo sin confirmación, use el parámetro Force. Por ejemplo:
Get-CsRgsWorkflow –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com " | Remove-CsRgsWorkflow –Force
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-CsRgsWorkflow 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-CsRgsWorkflow"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Instance |
Opcional |
Objeto del flujo de trabajo |
Referencia a objeto que apunta al flujo de trabajo que se eliminará. Al transferir objetos de flujo de trabajo a Remove-CsRgsWorkflow 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-CsRgsWorkflow –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsWorkflow –Instance $x Tenga en cuenta que solo puede eliminar un único flujo de trabajo cada vez al usar el parámetro de Instance. Es decir, la referencia a objeto ($x) no puede contener varios objetos de flujo de trabajo. |
Force |
Opcional |
Parámetro modificador |
Fuerza la eliminación del flujo de trabajo. Si el parámetro está presente, el flujo de trabajo se eliminará sin mostrar ningún mensaje de advertencia, incluso si está activo. Si el parámetro no está presente, se le pedirá confirmación para eliminar cualquier 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.Workflow. Remove-CsRgsWorkflow acepta instancias transferidas del objeto de flujo de trabajo de Grupo de respuesta.
Tipos de valores devueltos
Remove-CsRgsWorkflow elimina instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsRgsWorkflow -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsWorkflow
En el Ejemplo 1 se quitan todos los flujos de trabajo de Grupo de respuesta del servicio ApplicationServer:atl-cs-001.litwareinc.com. Para ello, el comando primero llama a Get-CsRgsWorkflow para devolver una colección de todos los flujos de trabajo de ApplicationServer:atl-cs-001.litwareinc.com. A continuación, la colección se transfiere a Remove-CsRgsWorkflow, que elimina todos los flujos de trabajo.
-------------------------- Ejemplo 2 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Workflow" | Remove-CsRgsWorkflow
El comando del Ejemplo 2 elimina un único flujo de trabajo de Grupo de respuesta: el flujo de trabajo llamado "Help Desk Workflow" del servicio ApplicationServer:atl-cs-001.litwareinc.com. Para ello, se usa en primer lugar Get-CsRgsWorkflow para devolver el flujo de trabajo llamado Help Desk Workflow del servicio ApplicationServer:atl-cs-001.litwareinc.com. A continuación, este flujo de trabajo se transfiere a Remove-CsRgsWorkflow, que lo elimina.
-------------------------- Ejemplo 3 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.Language -eq "en-us"} | Remove-CsRgsWorkflow
El comando anterior elimina todos los flujos de trabajo con idioma inglés americano (EE.UU.) del servicio ApplicationServer:atl-cs-001.litwareinc.com. Para ello, primero se usa Get-CsRgsWorkflow para recuperar todos los flujos de trabajo de ApplicationServer:atl-cs-001.litwareinc.com. Esta colección se transfiere al cmdlet Where-Object, que selecciona solo los flujos de trabajo en los que el idioma es igual a inglés americano (en-us). A continuación, la colección filtrada se transfiere al cmdlet Remove-CsRgsWorkflow, que elimina todos los elementos de la colección.
-------------------------- Ejemplo 4 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.CustomMusicOnHoldFile -ne $Null} | Remove-CsRgsWorkflow
El comando del Ejemplo 4 elimina todos los flujos de trabajo de Grupo de respuesta del servicio ApplicationServer:atl-cs-001.litwareinc.com que tengan un valor configurado para la propiedad CustomMusicOnHoldFile. Para ello, el comando primero usa Get-CsRgsWorkflow para devolver una colección de todos los flujos de trabajo de ApplicationServer:atl-cs-001.litwareinc.com. Dicha colección se transfiere al cmdlet Where-Object, que selecciona solo los flujos de trabajo cuya propiedad CustomMusicOnHoldFile no sea igual a un valor nulo. (Si la propiedad no es igual a un valor nulo se ha definido música personalizada para el flujo de trabajo.) A continuación, la colección filtrada se transfiere a Remove-CsRgsWorkflow, que quita todos los elementos de la colección.