Compartir a través de

  • Artículo

New-CsCpsConfiguration

 

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

Crea una nueva colección de valores de configuración de servicio de estacionamiento de llamadas. El estacionamiento de llamadas es un servicio que permite a un usuario "estacionar" una llamada de teléfono entrante. Al estacionar una llamada, ésta se transfiere a un número dentro de un intervalo u órbita especificados e, inmediatamente, la llamada se pone en espera. Cualquiera (no solo la persona que respondió a la llamada originalmente) puede continuar con la conversación desde cualquier teléfono marcando el número correcto.

Sintaxis

New-CsCpsConfiguration -Identity <XdsIdentity> [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Este cmdlet se usa para crear una nueva configuración del servicio de estacionamiento de llamadas. Cuando se instala el servicio de estacionamiento de llamadas, la configuración global es la predeterminada y se puede actualizar, pero no quitar. (Al "quitar" la configuración global se restablecen los valores predeterminados.) Por lo tanto, este cmdlet sólo se usa para crear configuraciones específicas de sitios.

Una configuración del servicio de estacionamiento de llamadas especifica qué sucede con una llamada cuando se ha estacionado. Por ejemplo, si no se responde a una llamada estacionada en un periodo de tiempo, puede desviarse automáticamente a otra persona, como un administrador, o a un grupo de respuesta. Pueden configurarse las llamadas para que suene el teléfono pasado un periodo de tiempo para garantizar que no se olvidan. Además, el servicio de estacionamiento de llamadas se puede configurar para que la persona que está en espera escuche música mientras la llamada está estacionada.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

El sitio al que se aplican las configuraciones. Debe especificarse con el formato site:<nombre_sitio>, como site:Redmond. Siempre debe haber una configuración en el ámbito global y no se puede quitar, de modo que la configuración global no se puede volver a crear con este cmdlet.

CallPickupTimeoutThreshold

Opcional

TimeSpan

El tiempo que pasará después de estacionar la llamada hasta que vuelva a sonar en el teléfono en el que se respondió.

Debe especificarse con formato hh:mm:ss (hh = horas, mm = minutos, ss = segundos)

Valor predeterminado: 00:01:30 (90 segundos); Valor mínimo: 10 segundos (00:00:10); Valor máximo: 10 minutos (00:10:00)

EnableMusicOnHold

Opcional

Booleano

Determina si la persona que llama escuchará música mientras la llamada está estacionada.

Microsoft Lync Server 2010 incluye una música predeterminada en el archivo Hold. Puede modificar este archivo, para cambiar la música que oirá la persona que llama mientras la llamada está estacionada, con el cmdlet Set-CsCallParkServiceMusicOnHoldFile.

Valor predeterminado: True

MaxCallPickupAttempts

Opcional

Int32

El número de veces que una llamada estacionada volverá a sonar en el teléfono en que se respondió antes de desviarse a un URI de reserva. El URI de reserva se define con el parámetro OnTimeoutURI.

Valor predeterminado: 1; Valor mínimo: 1; Valor máximo: 10

OnTimeoutURI

Opcional

Cadena de caracteres

La dirección SIP del usuario o grupo de respuesta al que se enrutarán las llamadas estacionadas que no se respondan. La llamada estacionada se enrutará cuando haya sonado tantas veces como se haya establecido en el parámetro MaxCallPickupAttempts. Si este parámetro está definido en Null, OnTimeoutURI se omitirá y la llamada estacionada se desconectará tras oír varios tonos sin obtener respuesta.

Los valores deben ser identificadores URI de SIP, que comienzan por sip:. Por ejemplo, sip:rgs1@litwareinc.com.

Force

Opcional

Parámetro modificador

Suprime los mensajes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios.

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.

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

Ninguno.

Tipos de valores devueltos

Este cmdlet crea un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings.

Ejemplo

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

New-CsCpsConfiguration -Identity site:Redmond1 -EnableMusicOnHold $False

El comando mostrado en el Ejemplo 1 usa el cmdlet New-CsCpsConfiguration para crear una configuración de servicio de estacionamiento de llamadas para el sitio Redmond1. Esta configuración se crea con valores predeterminados con la excepción de EnableMusicOnHold. Este comando establece la propiedad en False, lo que quiere decir que el individuo cuya llamada se haya estacionado no escuchará nada mientras se mantenga a la espera. (EnableMusicOnHold está definida en True de forma predeterminada, suponiendo que el servicio de estacionamiento de llamadas se haya implementado.)

-------------------------- Ejemplo 2 --------------------------

New-CsCpsConfiguration -Identity site:Redmond1 -OnTimeoutURI sip:kenmyer@litwareinc.com

El comando mostrado en el Ejemplo 2 usa el cmdlet New-CsCpsConfiguration para crear una configuración de servicio de estacionamiento de llamadas para el sitio Redmond1. De forma predeterminada no se proporciona ningún valor de OnTimeoutURI, por lo que en este ejemplo se agrega un valor para el parámetro. En este caso, OnTimeoutURI está definido en sip:kenmyer@litwareinc.com. El valor enviado a este parámetro debe comenzar por la cadena de caracteres "sip:" y debe señalar a un usuario o a un grupo de respuesta que recibirá las llamadas estacionadas que no se respondan tras un número determinado de intentos.

-------------------------- Ejemplo 3 --------------------------

New-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2

Este comando usa el cmdlet New-CsCpsConfiguration para crear una configuración del servicio de estacionamiento de llamadas para el sitio Redmond1. Para este sitio, la propiedad MaxCallPickupAttempts se ha establecido en 2, de modo que la llamada sonará hasta dos veces.