Compartir a través de

  • Artículo

Set-CsCallParkServiceMusicOnHoldFile

 

Última modificación del tema: 2012-03-26

Cambia el archivo de audio que escucharán los autores de llamadas que estén en espera en una llamada estacionada.

Sintaxis

Set-CsCallParkServiceMusicOnHoldFile -Service <String> -Content <Byte[]> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

El estacionamiento de llamadas es un servicio que permite a un usuario "estacionar" una llamada de teléfono entrante. Al estacionar una llamada se transfiere a un número en un intervalo específico y se pone inmediatamente en espera. Según las opciones de configuración del servicio Estacionamiento de llamadas, la música en espera se puede reproducir mientras la llamada está estacionada. Use este cmdlet para cambiar el archivo de audio (música en espera) que se reproduce cuando el autor de una llamada estacionada está en espera.

La música en espera solo se reproduce si la propiedad EnableMusicOnHold del servicio Estacionamiento de llamadas se ha definido en True. Puede comprobar esta propiedad llamando a Get-CsCpsConfiguration. Puede definir la propiedad al crear la configuración de Estacionamiento de llamadas con New-CsCpsConfiguration o, una vez creada la configuración de Estacionamiento de llamadas, llamando a Set-CsCpsConfiguration. Esta propiedad está definida en True de forma predeterminada.

Microsoft Lync Server 2010 incluye un archivo predeterminado del servicio Estacionamiento de llamadas para la música en espera. Si no asigna ningún archivo de audio, se usará el archivo predeterminado.

Los archivos de audio deben estar en el formato siguiente: Windows Media Audio 9, 44 kHz, 16 bits, Mono, CBR o 32 kbps.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsCallParkServiceMusicOnHoldFile 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-CsCallParkServiceMusicOnHoldFile"}

Parámetros

Parámetro Requerido Tipo Descripción

Service

Requerido

ServiceId

El ID del servicio en el que reside el servicio Estacionamiento de llamadas; por ejemplo, ApplicationServer:pool0.litwareinc.com.

Content

Requerido

Byte[]

El contenido del archivo de audio en formato de bytes.

Use el cmdlet Get-Content para recuperar el contenido del archivo de audio en formato de bytes. (Para obtener más información, vea la sección de ejemplos de este tema.)

Force

Opcional

Parámetro modificador

Suprime las preguntas de confirmación que aparecerían antes de realizar cambios.

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

Byte[]. Acepta la entrada trasmitida de una matriz de bytes que contiene el archivo de música en espera.

Tipos de valores devueltos

Este cmdlet no devuelve un valor.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

$a = Get-Content -ReadCount 0 -Encoding byte "C:\MoHFiles\soothingmusic.wma"
Set-CsCallParkServiceMusicOnHoldFile -Service ApplicationServer:pool0.litwareinc.com -Content $a

En este ejemplo se establece el archivo SoothingMusic.wma como el archivo de audio que se reproduce para los autores de llamadas que están estacionadas. La primera línea de este ejemplo es una llamada al cmdlet Get-Content integrado en Windows PowerShell. Este cmdlet lee el contenido de un archivo y lo asigna, en este caso, a la variable $a. Se pasa el valor 0 al parámetro ReadCount para que Get-Content lea todo el archivo de una vez (en lugar de intentar leerlo línea por línea; esto no se aplica a un archivo de audio). El parámetro Encoding se define en byte. Dicho parámetro indica a Get-Content que el contenido que queremos leer en la variable $a es una matriz de bytes en lugar de un archivo de audio en formato .wma.

En este ejemplo, es en la línea 2 donde realmente se asigna el archivo de audio. Se llama a Set-CsCallParkServiceMusicOnHoldFile y se especifica el ID de servicio donde se ejecuta el servicio Estacionamiento de llamadas. A continuación, se envía el contenido del archivo de audio leído en la variable $a al parámetro Content. (Recuerde que el contenido debe estar en formato de bytes.)