Compartir a través de

  • Artículo

Set-CsCpsConfiguration

 

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

Modifica una recopilación existente de configuraciones del 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, esta se transfiere a un número en un intervalo especificado u órbita y, a continuación, de inmediato se coloca la llamada de espera. Cualquiera (no solo la persona que respondió a la llamada originalmente) puede continuar con la conversación desde cualquier teléfono simplemente al marcar el número correcto.

Sintaxis

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

Set-CsCpsConfiguration [-CallPickupTimeoutThreshold <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnableMusicOnHold <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCallPickupAttempts <Int32>] [-OnTimeoutURI <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Este cmdlet se usa para modificar una configuración existente del servicio de estacionamiento de llamadas. 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, puede configurar el servicio de Estacionamiento de llamadas para que la persona que está en espera escuche música mientras la llamada está estacionada.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Set-CsCpsConfiguration de forma local: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsCpsConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Un identificador único de la configuración que se quiere modificar. La propiedad Identity especifica el ámbito al que se aplica la configuración: Global o un sitio específico (con el formato site:<nombre_sitio>, por ejemplo, site:Redmond).

Instance

Opcional

CallParkServiceSettings

Referencia a un objeto de configuración del servicio de Estacionamiento de llamadas, del tipo Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings. Este objeto puede recuperarse llamado al cmdlet Get-CsCpsConfiguration. A continuación, puede cambiarse el objeto y guardar los cambios enviado el objeto de nuevo a Set-CsCpsConfiguration en este parámetro.

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 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.

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 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 ese parámetro se configura en Null, se ignorará OnTimeoutURI y la llamada en estacionamiento se desconectará después de realizar sin éxito los intentos de devolución de llamadas.

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

Force

Opcional

Parámetro modificador

Suprime las solicitudes de confirmación que, de lo contrario, se mostrarí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

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings. Acepta entradas canalizadas de los objetos de la configuración del servicio de Estacionamiento de llamadas

Tipos de valores devueltos

Modifica un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.CallParkServiceSettings.CallParkServiceSettings.

Ejemplo

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

Set-CsCpsConfiguration -Identity site:Redmond1 -MaxCallPickupAttempts 2

El comando del Ejemplo 1 modifica la configuración del servicio de Estacionamiento de llamadas con la identidad site:Redmond1 al establecer en 2 el número de veces que una llamada estacionada volverá a sonar en el teléfono en que se respondió. Para ello, se incluye el parámetro MaxCallPickupAttempts y se establece el valor del parámetro en 2.

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

Get-CsCpsConfiguration | Set-CsCpsConfiguration -MaxCallPickupAttempts 2

El Ejemplo 2 es una variante del comando del Ejemplo 1; aunque en este caso, se establece en 2 la propiedad MaxCallPickupAttempts de todas (no solo una) las configuraciones del servicio de Estacionamiento de llamadas Para ello, se usa Get-CsCpsConfiguration para recuperar una recopilación de todas las configuraciones del servicio de Estacionamiento de llamadas que se usan en la organización. A continuación, esta recopilación se transfiere al cmdlet Set-CsCpsConfiguration, que establece el valor de la propiedad MaxCallPickupAttempts en 2 para todos los elementos de la recopilación.

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

Set-CsCpsConfiguration -Identity site:Redmond1 -CallPickupTimeoutThreshold 00:00:45

En este ejemplo, se modifica la configuración del estacionamiento de llamadas del sitio Redmond1, estableciendo la cantidad de tiempo que pasará antes de que una llamada estacionada vuelva a sonar en 45 segundos (este valor se encuentra en la propiedad CallPickupTimeoutThreshold).