New-CsRgsWorkflow
Última modificación del tema: 2012-03-23
Crea un flujo de trabajo para 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
New-CsRgsWorkflow -Parent <RgsIdentity> -Name <String> -PrimaryUri <Uri> [-Active <$true | $false>] [-Anonymous <$true | $false>] [-BusinessHoursID <Nullable>] [-Confirm [<SwitchParameter>]] [-CustomMusicOnHoldFile <AudioFile>] [-DefaultAction <CallAction>] [-Description <String>] [-DisplayNumber <String>] [-EnabledForFederation <$true | $false>] [-Force <SwitchParameter>] [-HolidayAction <CallAction>] [-HolidaySetIDList <Collection>] [-InMemory <SwitchParameter>] [-Language <String>] [-LineUri <Uri>] [-NonBusinessHoursAction <CallAction>] [-TimeZone <String>] [-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 también los festivos (días en los que no hay agentes disponibles para responder a llamadas).
Los flujos de trabajo se crean con el cmdlet New-CsRgsWorkflow.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-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 "New-CsRgsWorkflow"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Name |
Requerido |
Cadena de caracteres |
Nombre único que se asigna al flujo de trabajo. El par de propiedades Parent y Name permite identificar de manera única los flujos de trabajo sin necesidad de recurrir al identificador único global (GUID) del flujo de trabajo. |
Parent |
Requerido |
Identidad Rgs |
Servicio en el que se hospeda el flujo de trabajo. Por ejemplo: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com". |
PrimaryUri |
Requerido |
Dirección SIP |
Dirección SIP del flujo de trabajo. Por ejemplo: -PrimaryUri "sip:helpdesk@litwareinc.com". El valor PrimaryUri debe comenzar por el prefijo "sip:". |
Active |
Opcional |
Booleano |
Si está definido como True, el flujo de trabajo está activo y disponible para recibir llamadas. Si está definido como False (valor predeterminado), el flujo de trabajo no está disponible para recibir llamadas. Cuando la propiedad Active está definida como True, se validará el flujo de trabajo antes de crearlo. Por ejemplo, el flujo de trabajo no se creará si no se ha especificado un parámetro DefaultAction. Si Active está definida como False (o no está configurada) no se realizará ninguna validación y se creará el flujo de trabajo aunque no se haya especificado un parámetro DefaultAction. |
Anonymous |
Opcional |
Booleano |
Si está definido como True, las identidades de los agentes de Grupo de respuesta se ocultarán cuando respondan a una llamada. Si está definido como False (el valor predeterminado), los autores de llamadas podrán ver las identidades de los agentes. |
BusinessHoursID |
Opcional |
Objeto BusinessHours |
Días de la semana y horas del día en que los agentes del flujo de trabajo están disponibles para responder a llamadas. Las identidades de los horarios de trabajo pueden recuperarse mediante el cmdlet Get-CsRgsHoursOfBusiness. |
CustomMusicOnHoldFile |
Opcional |
Objeto AudioFile |
Representa la música personalizada que se oirá mientras el autor de la llamada está en espera. (Si no se define, los autores de llamadas oirán la música predeterminada al estar en espera.) La música personalizada debe importarse mediante el cmdlet Import-CsRgsAudioFile. |
DefaultAction |
Requerido |
Objeto CallAction |
Indica la acción que se llevará a cabo si un flujo de trabajo se abre durante el horario laboral. DefaultAction debe definirse mediante el cmdlet New-CsRgsCallAction y debe dirigir la llamada a una cola o a una pregunta. El parámetro DefaultAction es obligatorio si el flujo de trabajo está activo, pero se puede omitir si el flujo de trabajo está inactivo. |
Description |
Opcional |
Cadena de caracteres |
Permite a los administradores agregar información adicional sobre el flujo de trabajo de Grupo de respuesta. Por ejemplo, la descripción puede incluir la información de contacto del propietario del flujo de trabajo. Esta descripción se muestra en la tarjeta de contacto de Microsoft Lync 2010 del flujo de trabajo. |
DisplayNumber |
Opcional |
Cadena de caracteres |
Número de teléfono del flujo de trabajo que se muestra en Lync 2010. El valor DisplayNumber puede tener el formato que prefiera el usuario, por ejemplo: -DisplayNumber "555-1219" -DisplayNumber "1-(425)-555-1219" -DisplayNumber "1.425.555.1219" |
EnabledForFederation |
Opcional |
Booleano |
Indica si el flujo de trabajo está disponible para usuarios de un dominio federado. Si está definido como False, sólo los usuarios internos de la organización podrán tener acceso al flujo de trabajo. |
HolidayAction |
Opcional |
Objeto CallAction |
Acción que se llevará a cabo si se recibe una llamada un día festivo. HolidayAction debe definirse mediante el cmdlet New-CsRgsCallAction. |
HolidaySetIdList |
Opcional |
Objeto HolidaySet |
Representa días en que los agentes del flujo de trabajo no están disponibles para responder a llamadas. Las identidades del conjunto de días festivos pueden recuperarse con el cmdlet Get-CsRgsHolidaySet. |
Language |
Opcional |
Cadena de caracteres |
Idioma en el que se leen las indicaciones de texto a voz del flujo de trabajo. El parámetro Language es opcional si el sistema operativo usa uno de los idiomas admitidos que se muestran en la siguiente lista. (Tenga en cuenta que los idiomas de voz admitidos son un subconjunto de los idiomas que se pueden usar en el sistema operativo.) Si el sistema operativo no está usando un idioma admitido, el parámetro Language será obligatorio y deberá especificar el código de idioma de un idioma admitido. Si su sistema operativo usa un idioma no admitido en el sistema operativo y ejecuta New-CsRgsWorkflow sin incluir el parámetro Language, se producirá un error en el comando. Por ejemplo, supongamos que su sistema operativo se ejecuta con el idioma feroés. El sistema operativo Windows admite este idioma, pero Aplicación de grupo de respuesta no. Por lo tanto, deberá incluir el parámetro Language y un idioma admitido cuando cree un nuevo flujo de trabajo. Esto es necesario porque, si no se especifica ningún idioma, el flujo de trabajo usa el idioma del sistema operativo. Sin embargo, solo se podrá usar ese idioma en un flujo de trabajo si es uno de los idiomas admitidos por la Aplicación de grupo de respuesta. El idioma debe especificarse con uno de los siguientes códigos de idioma: ca-ES – Catalán (España) da-DK – Danés (Dinamarca) de-DE – Alemán (Alemania) en-AU – Inglés (Australia) en-CA – Inglés (Canadá) en-GB – Inglés (Reino Unido) en-IN – Inglés (India) en-US – Inglés (Estados Unidos) es-ES – Español (España) es-MX – Español (México) fi-FI – Finlandés (Finlandia) fr-CA – Francés (Canadá) fr-FR – Francés (Francia) it-IT – Italiano (Italia) ja-JP – Japonés (Japón) ko-KR – Coreano (Corea) nb-NO – Noruego, Bokmaal (Noruega) nl-NL – Neerlandés(Países Bajos) pl-PL – Polaco (Polonia) pt-BR – Portugués (Brasil) pt-PT – Portugués (Portugal) ru-RU – Ruso (Rusia) sv-SE – Sueco (Suecia) zh-CN – Chino (República Popular China) zh-HK – Chino (Hong Kong RAE) zh-TW – Chino (Taiwán) Por ejemplo: -Language "nl-NL". |
LineUri |
Opcional |
Cadena de caracteres |
Número de teléfono del flujo de trabajo. El URI (Uniform Resource Identifier) de línea debe especificarse con el siguiente formato: prefijo TEL: seguido de un signo más, el código telefónico de país/región, el código de área y el número de teléfono (solo con dígitos: sin espacios en blanco, puntos ni guiones). Por ejemplo: -LineUri "TEL:+14255551219" |
NonBusinessHoursAction |
Opcional |
Objeto CallAction |
Acción que se llevará a cabo si se recibe una llamada fuera del horario laboral del flujo de trabajo. NonBusinessHoursAction debe definirse mediante el cmdlet New-CsRgsCallAction. |
TimeZone |
Opcional |
Cadena de caracteres |
Información de zona horaria que se usa para determinar los festivos y el horario laboral. Por ejemplo: -TimeZone "Pacific Standard Time" |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir al ejecutar el comando. |
InMemory |
Opcional |
Parámetro modificador |
Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet. |
Tipos de entrada
Ninguno. New-CsRgsWorkflow no acepta la entrada transferida.
Tipos de valores devueltos
New-CsRgsWorkflow crea nuevas instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
New-CsRgsWorkflow -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -PrimaryUri "sip:helpdesk@litwareinc.com"
El comando anterior crea un flujo de trabajo en el servicio ApplicationServer:atl-cs-001.litwareinc.com. Se le asigna el nombre Help Desk y una URI primaria de sip:helpdesk@litwareinc.com.
-------------------------- Ejemplo 2 ------------------------Añadir ejemplo de código
$prompt = New-CsRgsPrompt -TextToSpeechPrompt "Welcome to the help desk."
$queue = (Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk").Identity
$callAction = New-CsRgsCallAction -Prompt $prompt -Action TransferToQueue -QueueId $queue
New-CsRgsWorkflow -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -PrimaryUri "sip:helpdesk@litwareinc.com" -DefaultAction $callAction
Los comandos del Ejemplo 2 muestran cómo crear una nueva indicación y una acción de llamada de flujo de trabajo y las asigna a un flujo de trabajo de Grupo de respuesta nuevo. En el primer comando se usa el cmdlet New-CsRgsPrompt para crear una indicación de texto a voz de "Welcome to the help desk". Esta nueva indicación se almacena en una variable llamada $prompt.
El segundo comando usa el cmdlet Get-CsRgsQueue para recuperar la identidad de una cola de Grupo de respuesta existente llamada Help Desk; la identidad devuelta se almacena en una variable llamada $queue.
A continuación, el comando 3 crea una acción de llamada (almacenada en una variable llamada $callAction) que hace referencia a la nueva indicación ($prompt) y a la cola recuperada ($queue). Finalmente, el último comando del ejemplo crea un nuevo flujo de trabajo llamado Help Desk. Este comando define PrimaryUri como sip:helpdesk@litwareinc.com y define el valor de la propiedad DefaultAction como la acción de llamada creada en el paso anterior.