Set-CsRgsConfiguration
Última modificación del tema: 2012-03-23
Modifica las opciones de configuración de la Aplicación de grupo de respuesta.
Sintaxis
Set-CsRgsConfiguration -Identity <RgsIdentity> [-AgentRingbackGracePeriod <Int16>] [-Confirm [<SwitchParameter>]] [-DefaultMusicOnHoldFile <AudioFile>] [-DisableCallContext <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsRgsConfiguration -Instance <ServiceSettings> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
La Aplicación de grupo de respuesta permite enrutar automáticamente las llamadas telefónicas a entidades, como una línea de asistencia técnica o atención al cliente. Cuando alguien llama a un número telefónico específico, la llamada puede enrutarse automáticamente al conjunto correspondiente de agentes de Grupo de respuesta. La llamada también puede enrutarse a una cola de respuesta de voz interactiva (IVR). En dicha cola, el autor de la llamada deberá responder a una serie de preguntas, como "¿Está llamando en relación a un pedido realizado?", y, a continuación, según las respuestas especificadas, se le suministrará la información necesaria o se enrutará la llamada a un agente de Grupo de respuesta.
El cmdlet Set-CsRgsConfiguration permite modificar las propiedades de una instancia de la Aplicación de grupo de respuesta.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsRgsConfiguration 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 "Set-CsRgsConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Rgs |
Nombre del servicio en que se hospeda la configuración de Grupo de respuesta. Por ejemplo: -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com." |
Instance |
Opcional |
Objeto ServiceSettings |
Referencia a objeto a la configuración de Grupo de respuesta que se modificará. Para recuperar una referencia a objeto, se usa el cmdlet Get-CsRgsConfiguration y se asigna el valor devuelto a una variable; por ejemplo, este comando devuelve una referencia a objeto a la configuración del servicio ApplicationServer:atl-cs-001.litwareinc.com y la almacena en una variable llamada $x: $x = Get-CsRgsConfiguration -Identity service:ApplicationServer:atl-cs-001.litwareinc.com |
AgentRingbackGracePeriod |
Opcional |
Entero |
Si un agente rechaza una llamada, AgentRingbackGracePeriod representa la cantidad de tiempo (en segundos) que puede pasar hasta que la llamada vuelva al mismo agente. El periodo puede establecerse en cualquier valor entero entre 30 y 600 segundos (10 minutos), ambos valores incluidos. El valor predeterminado es 60 segundos. |
DefaultMusicOnHoldFile |
Opcional |
Objeto AudioFile |
Representa la música predeterminada que se reproducirá al poner en espera una llamada. La música predeterminada se reproducirá solamente si no se ha definido una música personalizada para la espera en un flujo de trabajo de Grupo de respuesta. La propiedad DefaultMusicOnHoldFile debe configurarse con una referencia a objeto creada con el cmdlet Import-CsRgsAudioFile. Si DefaultMusicOnHold es igual a un valor nulo (valor predeterminado) y si no se ha definido una música personalizada para la espera en un flujo de trabajo, cada vez que se ponga en espera al autor de una llamada se reproducirá la música predeterminada para la espera que se configura automáticamente al instalar Lync Server. |
DisableCallContext |
Opcional |
Parámetro modificador |
Si está definido como False (valor predeterminado) los agentes podrán ver el contexto de la llamada (datos como el tiempo de espera del autor de la llamada o las preguntas y respuestas del flujo de trabajo) al recibir una llamada. (Esta información se visualiza en Microsoft Lync 2010). Si está definido como True, la información de contexto de llamada no se mostrará a los agentes al recibir una llamada. Tenga en cuenta que el contexto de llamada solo se usa con colas IVR. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves que se produzcan al ejecutar el comando. |
WhatIf |
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.ServiceSettings. Set-CsRgsConfiguration acepta instancias transferidas del objeto de configuración de la Aplicación de grupo de respuesta.
Tipos de valores devueltos
Set-CsRgsConfiguration no devuelve valores ni objetos. Este cmdlet se usa para configurar instancias del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.ServiceSettings.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Set-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -AgentRingbackGracePeriod 30
El comando del Ejemplo 1 modifica la propiedad AgentRingbackGracePeriod de la configuración de la Aplicación de grupo de respuesta del servicio ApplicationServer:atl-cs-001.litwareinc.com. En este ejemplo, AgentRingbackGracePeriod se establece en 30 segundos.
-------------------------- Ejemplo 2 ------------------------
Get-CsService -ApplicationServer | Where-Object {$_.Applications -contains "urn:application:RGS"} | ForEach-Object {Set-CsRgsConfiguration -Identity $_.Identity -AgentRingbackGracePeriod 30}
En el Ejemplo 2 se modifica AgentRingbackGracePeriod en todas las opciones de configuración de Grupo de respuesta de la organización. Para realizar esto, el comando primero usa el cmdlet Get-CsService y el parámetro ApplicationServer para devolver información sobre todos los equipos de la organización que ejecutan el Servicio de aplicaciones. La colección devuelta se transfiere al cmdlet Where-Object, que únicamente selecciona los equipos cuya propiedad Applications contiene la aplicación "urn:application:RGS"; este valor indica que la Aplicación de grupo de respuesta se está ejecutando en el servidor.
A su vez, estos equipos se transfieren al cmdlet ForEach-Object. ForEach-Object toma cada equipo de la colección y usa Set-CsRgsConfiguration para establecer el valor de AgentRingbackGracePeriod de la configuración de Grupo de respuesta del equipo en 30 segundos.
-------------------------- Ejemplo 3 ------------------------
$x = Import-CsRgsAudioFile -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -FileName "WhileYouWait.wav" -Content (Get-Content C:\Media\WhileYouWait.wav -Encoding byte -ReadCount 0)
Set-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -DefaultMusicOnHoldFile $x
Los comandos del Ejemplo 3 importan un archivo de audio (C:\Media\WhileYouWait.wav) y lo asignan a la propiedad DefaultMusicOnHoldFile. Para ello, el comando primero usa Import-CsRgsAudioFile para importar el archivo de audio en la Aplicación de grupo de respuesta de ApplicationServer:atl-cs-001.litwareinc.com. Además del parámetro Identity (que especifica la ubicación del servicio), se usa el parámetro FileName para especificar el nombre del archivo que se importará.
También se usa el parámetro Content para importar el archivo de audio. La importación se lleva a cabo llamando al cmdlet Get-Content seguido de la ruta del archivo que se importará. Get-Content también requiere que se establezca el tipo de codificación en byte y el valor de ReadCount en 0 (al definir el valor de ReadCount en 0 se garantiza que el archivo completo se leerá en una única operación). El archivo importado se almacena en una variable llamada $x.
Después de importar el archivo, se llama a Set-CsRgsConfiguration para establecer la propiedad DefaultMusicOnHold en el archivo de audio almacenado en $x.