Import-CsRgsAudioFile
Última modificación del tema: 2012-03-23
Importa un archivo de audio nuevo para su uso en la Aplicación de grupo de respuesta.
Sintaxis
Import-CsRgsAudioFile -Identity <RgsIdentity> -Content <Byte[]> -FileName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
La Aplicación de grupo de respuesta permite usar archivos de audio (solo en formato .WAV o .WMA) de al menos dos modos. En uno de ellos, el servicio puede reproducir música (o información de algún tipo) cada vez que se coloca al autor de una llamada en espera. La Aplicación de grupo de respuesta también puede "hablar" a los autores de llamadas. Por ejemplo, usando respuestas de voz interactiva (IVR), el servicio puede hacer preguntas a los autores de llamadas, por ejemplo: "¿Está llamando en relación a un pedido realizado?" Puede hacer que el servicio lea estas preguntas mediante la tecnología de texto a voz o puede hacer que se reproduzca una grabación de audio de una persona real realizando la pregunta.
Al margen de cómo prefiera usar los archivos de audio, estos archivos deben importarse a la Aplicación de grupo de respuesta con el cmdlet Import-CsRgsAudioFile. Tenga en cuenta que debe ejecutar Import-CsRgsAudioFile cada vez que quiera usar un archivo de audio, incluso si dicho archivo ya está en uso en otra tarea de la Aplicación de grupo de respuesta. Por ejemplo, supongamos el Flujo de trabajo A usa un archivo de audio determinado como música personalizada para las llamadas en espera y que desea usar ese mismo archivo de audio como música personalizada para las llamadas en espera en el Flujo de trabajo B. Aunque el archivo de audio ya está en uso en la aplicación Grupo de respuesta, deberá volver a importarlo para poder usarlo en el Flujo de trabajo B.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Import-CsRgsAudioFile de forma local: RTCUniversalServerAdmins. También es necesario tener acceso de escritura al almacén de archivos del equipo de destino. 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 "Import-CsRgsAudioFile"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Rgs |
Identidad del servicio en el que se importará el archivo de audio. (Debe ser el mismo servicio en el que se hospeda la Aplicación de grupo de respuesta.) Por ejemplo: -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com". |
Content |
Requerido |
Matriz de bytes |
Contenido real del archivo de audio que se importará. La propiedad Content se define llamando al cmdlet Get-Content. Al llamar a Get-Content, establezca el parámetro Encoding en byte y el parámetro ReadCount en 0 (consulte la sección de ejemplos de este tema si necesita más información). |
FileName |
Requerido |
Cadena de caracteres |
Nombre del archivo de audio que se importará. Por ejemplo, el nombre del archivo C:\Media\Welcome.wav es: Welcome.wav. |
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 |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Ninguno. Import-CsRgsAudioFile no acepta la entrada transferida.
Tipos de valores devueltos
Crea instancias nuevas del objeto Microsoft.Rtc.Rgs.Management.WritableSettings.AudioFile.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
$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)
$y = Get-CsRgsWorkflow -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Workflow"
$y.CustomMusicOnHoldFile = $x
Set-CsRgsWorkflow $y
Los comandos del Ejemplo 1 importan un archivo de audio (C:\Media\WhileYouWait.wav) y lo asignan a la propiedad CustomMusicOnHold de un flujo de trabajo. 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á.
Al mismo tiempo, 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.
En el segundo comando se usa Get-CsRgsWorkflow para crear una referencia de objeto ($y) al flujo de trabajo Help Desk Workflow. Una vez creada esta referencia de objeto, el comando 3 establece el valor de la propiedad CustomMusicOnHoldFile en $x, que es la variable que contiene el archivo de audio importado. Finalmente, el último comando del ejemplo usa Set-CsRgsWorkflow para escribir estos cambios en el flujo de trabajo Help Desk Workflow real. Si no llama a Set-CsRgsWorkflow, los cambios solo se aplicarán en la memoria, y desaparecerán al cerrar Windows PowerShell o eliminar las variables $x o $y.