Get-CsRgsWorkflow
Última modificación del tema: 2012-03-23
Devuelve información sobre flujos 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
Get-CsRgsWorkflow [-Identity <RgsIdentity>] [-Name <String>]
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).
El cmdlet Get-CsRgsWorkflow permite recuperar información sobre los flujos de trabajo configurados en la organización.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-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 (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRgsWorkflow"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Rgs |
Representa la identidad del servicio en el que se hospeda el flujo de trabajo de Grupo de respuesta, o la identidad completa del propio flujo de trabajo. Si especifica la identidad del servicio (por ejemplo, service: ApplicationServer:atl-cs-001.litwareinc.com), se devolverán todos los flujos de trabajo de Grupo de respuesta hospedados en dicho servicio. Si especifica la identidad del flujo de trabajo, solo se devolverá dicho flujo de trabajo de Grupo de respuesta. La identidad de un flujo de trabajo consiste en el valor Identity del servicio seguido de un identificador único global (GUID); por ejemplo: service:ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83. También puede recuperar un único flujo de trabajo de Grupo de respuesta si especifica la identidad del servicio y, a continuación, incluye el parámetro Name y el nombre del flujo de trabajo. De este modo, es posible recuperar un flujo de trabajo sin necesidad de saber cuál es el identificador GUID que tiene asignado. Si se llama a Get-CsRgsWorkflow sin definir ningún parámetro, se devolverá una colección de todos los flujos de trabajo configurados en la organización. |
Name |
Opcional |
Cadena de caracteres |
Nombre único asignado al flujo de trabajo de Grupo de respuesta al crearlo. |
Tipos de entrada
Ninguno. Get-CsRgsWorkflow no acepta la entrada transferida.
Tipos de valores devueltos
Get-CsRgsWorkflow devuelve instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsRgsWorkflow
En el ejemplo anterior se devuelve información acerca de todos los flujos de trabajo configurados en la organización. Para hacerlo, se llama a Get-CsRgsWorkflow sin ningún parámetro.
-------------------------- Ejemplo 2 ------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
El Ejemplo 2 devuelve información sobre todos los flujos de trabajo de la Aplicación de grupo de respuesta encontrados en el servicio ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 3 ------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty DefaultAction
El comando del Ejemplo 3 muestra información detallada sobre la propiedad DefaultAction de cada flujo de trabajo de Grupo de respuesta encontrado en el servicio ApplicationServer:atl-cs-001.litwareinc.com. Para ello, primero se usa Get-CsRgsWorkflow para devolver información sobre todos los flujos de trabajo de ApplicationServer:atl-cs-001.litwareinc.com. A continuación, esta información se transfiere al cmdlet Select-Object, que "amplía" el valor almacenado en la propiedad DefaultAction. Al expandir el valor de DefaultAction, pueden verse las propiedades individuales del objeto incrustado almacenado en la propiedad DefaultAction.
-------------------------- Ejemplo 4 ------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "European Sales Support"
El Ejemplo 4 devuelve información sobre un único flujo de trabajo de Grupo de respuesta: el flujo de trabajo European Sales Support de ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 5 ------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.Language -eq "en-Us"}
El comando del Ejemplo 5 devuelve información sobre todos los flujos de trabajo de Grupo de respuesta que tienen inglés americano como idioma principal. Para ello, el comando primero llama a Get-CsRgsWorkflow para devolver una colección de todos los flujos de trabajo del servicio 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 la propiedad Language es igual a inglés americano (en-US).
-------------------------- Ejemplo 6 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.CustomMusicOnHold -eq $Null}
El comando anterior devuelve todos los flujos de trabajo de ApplicationServer:atl-cs-001.litwareinc.com en los que la propiedad CustomMusicOnHold está definida en un valor nulo. (Es decir, el comando devuelve información sobre los flujos de trabajo que no tienen asignada una música personalizada.) Para ello, el comando primero usa Get-CsRgsWorkflow para devolver una colección de todos los flujos de trabajo del servicio ApplicationServer:atl-cs-001.litwareinc.com. Los datos devueltos se transfieren a Where-Object, que selecciona solo los elementos en los que la propiedad CustomMusicOnHold es igual a un valor nulo.