Compartir a través de

  • Artículo

Set-CsVoiceRoute

 

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

Modifica una ruta de voz. Las rutas de voz contienen instrucciones que indican a Microsoft Lync Server 2010 cómo enrutar las llamadas de usuarios de Enterprise Voice al número de teléfono de la red telefónica conmutada (RTC) o a una central de conmutación PBX.

Sintaxis

Set-CsVoiceRoute [-Identity <XdsGlobalRelativeIdentity>] [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]

Set-CsVoiceRoute [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Use este cmdlet para modificar una ruta de voz existente. Las rutas de voz se asocian con las directivas de voz mediante los usos de red telefónica conmutada (RTC). Una ruta de voz incluye una expresión regular que identifica qué números de teléfono se enrutarán a través de una ruta de voz determinada: los números de teléfono que coincidan con la expresión regular se enrutarán a través de esta ruta.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

La identidad única de la ruta de voz. (Si el nombre de la ruta contiene un espacio, como Test Route, deberá delimitar la cadena de caracteres completa entre paréntesis.)

Instance

Opcional

Ruta

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. Este objeto debe ser de tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route y puede recuperarse llamando a Get-CsVoiceRoute.

AlternateCallerId

Opcional

Cadena de caracteres

Si el parámetro SuppressCallerId se define en True, se mostrará a las partes receptoras el valor del parámetro AlternateCallerId, en lugar del número real del autor de la llamada. Este número debe ser un número válido y se puede usar para representar un departamento de una organización, como Soporte Técnico o Recursos Humanos.

Si el parámetro SuppressCallerId se define en False, se ignorará el parámetro AlternateCallerId.

Este valor debe tener el mismo formato que la expresión regular (\+)?[1-9]\d*(;ext=[1-9]\d*)?. En otras palabras, el valor puede comenzar por un signo más (+), pero no es necesario; puede contener cualquier cantidad de dígitos y puede ir seguido de una extensión que empiece con ;ext=, seguida de un número cualquiera de dígitos. (Tenga en cuenta que si incluye una extensión, la cadena de caracteres debe delimitarse entre comillas dobles.)

Description

Opcional

Cadena de caracteres

Descripción de la utilidad de la ruta de teléfono.

NumberPattern

Opcional

Cadena de caracteres

Una expresión regular que especifica los números de teléfono a los que se aplica este ruta. Los números que coincidan con este patrón se enrutarán de acuerdo con el resto de la configuración de enrutamiento. Por ejemplo, el patrón numérico predeterminado, [0-9]{10}, especifica un número de 10 dígitos que contiene cualquier dígito del 0 al 9.

Priority

Opcional

Int32

Un número podría resultar en varias rutas de voz. La prioridad determina el orden en que se aplicarán las rutas, en caso de que sea posible más de una ruta.

PstnGatewayList

Opcional

Modificador de lista PS

Un servidor de mediación puede asociarse con varias puertas de enlace. Este parámetro contiene una lista de puertas de enlace asociadas a esta ruta de voz. Todos los miembros de la lista deben tener la identidad de servicio de la puerta de enlace RTC o el servidor de mediación. El valor puede hacer referencia a un servidor de mediación solamente si el servidor de mediación está configurado para Microsoft Office Communications Server 2007 o Microsoft Office Communications Server 2007 R2. Para Lync Server 2010, se puede emplear una puerta de enlace RTC. La identidad de servicio es una cadena de caracteres con el formato ServiceRole:FQDN, donde ServiceRole es el nombre del rol de servicio (PSTNGateway) y FQDN es el nombre de dominio completo (FQDN) del grupo de servidores o la dirección IP del servidor. Por ejemplo, PSTNGateway:redmondpool.litwareinc.com. Las identidades de servicio se pueden recuperar llamando al comando Get-CsService | identidad Select-Object.

Si realiza cambios en una ruta de voz y deja vacía la lista PstnGatewayList, o bien si el cambio que realiza quita todos los elementos de la lista, recibirá un mensaje de advertencia conforme que ningún usuario podrá realizar llamadas de RTC.

PstnUsages

Opcional

Una lista de usos de RTC, como Local o Long Distance, que se pueden aplicar a la ruta de voz. El uso de RTC debe ser un uso existente. (Los usos de RTC pueden recuperarse llamando al cmdlet Get-CsPstnUsage.)

Si realiza cambios en una ruta de voz y deja vacía la lista PstnUsages, o bien si el cambio que realiza quita todos los usos de RTC de la lista, recibirá un mensaje de advertencia conforme que ningún usuario podrá realizar llamadas de RTC.

SuppressCallerId

Opcional

Booleano

Determina si el ID del autor de la llamada se mostrará en las llamadas salientes. Si este parámetro se define en True, se suprimirá el ID del autor de la llamada. En lugar del ID real, se mostrará el valor de AlternateCallerId. Si SuppressCallerId se define en True, debe indicarse un valor para AlternateCallerId.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Force

Opcional

Parámetro modificador

Suprime los mensajes 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.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route. Acepta la entrada transferida de objetos de ruta de voz.

Tipos de valores devueltos

Set-CsVoiceRoute no devuelve ni valores ni objetos. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route.

Ejemplo

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

Set-CsVoiceRoute -Identity Route1 -Description "Test Route"

Este comando establece la descripción de la ruta de voz Route1 en "Test Route".

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

Set-CsVoiceRoute -Identity Route1 -PstnUsages @{add="Long Distance"}

El comando de este ejemplo modifica la ruta de voz con la identidad Route1 para agregar el uso de RTC Long Distance a la lista de usos para esta ruta de voz. Long Distance debe estar en la lista de usos de RTC globales (que puede recuperarse llamando a Get-CsPstnUsage).

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

$x = (Get-CsPstnUsage).Usage
Set-CsVoiceRoute -Identity Route1 -PstnUsages @{replace=$x}

En este ejemplo se modifica la ruta de voz denominada Route1 para rellenar la lista de usos de RTC de dicha ruta con todos los usos existentes para la organización. El primer comando de este ejemplo recupera la lista de usos de teléfono RTC globales. Tenga en cuenta que la llamada a Get-CsPstnUsage se encuentra entre paréntesis, lo que significa que primero se recupera un objeto que contiene la información de uso de RTC. (Como solo hay un uso de RTC global, se recuperará un único objeto.) A continuación, el comando recupera la propiedad Usage del objeto. Dicha propiedad, que contiene una lista de usos de RTC, se asigna a la variable $x. En la segunda línea de este ejemplo, se llama a Set-CsVoiceRoute para modificar la ruta de voz con la identidad Route1. Preste atención al valor enviado al parámetro PstnUsages: @{replace=$x}. Este valor indica que se debe reemplazar todo el contenido de la lista PstnUsages de esta ruta por el contenido de $x, que contiene la lista de usos RTC recuperada en la línea 1.

-------------------------- Ejemplo 4 --------------------------

$x = Get-CsVoiceRoute -Identity Route1
$x.Name = "RouteA"
Set-CsVoiceRoute -Instance $x

Este conjunto de comandos cambia la propiedad Name de la ruta de voz de la identidad Route1 a RouteA. Al cambiar la propiedad Name, se cambia automáticamente la propiedad Identity, en este caso a RouteA.

En la primera línea, se llama a Get-CsVoiceRoute para recuperar la ruta de voz con la identidad Route1. El objeto devuelto se almacena en la variable $x. A continuación, la propiedad Name del objeto se asigna a el valor de cadena de caracteres "RouteA". Por último, el objeto (contenido en la variable $x) se envía al parámetro Instance de Set-CsVoiceRoute para realizar el cambio.

-------------------------- Ejemplo 5 --------------------------

$y = Get-CsVoiceRoute -Identity Route1
$y.PstnGatewayList.Add("PstnGateway:192.168.0.100")
Set-CsVoiceRoute -Instance $y

En este ejemplo se modifica la ruta de voz denominada Route1 y se rellena la lista de puertas de enlace RTC (PstnGatewayList) de la ruta con el rol de servidor de la puerta de enlace con la identidad PstnGateway:192.168.0.100. En la primera línea de este ejemplo, se llama a Get-CsVoiceRoute para recuperar la ruta de voz que se desea modificar, en este caso Route1. A continuación, se llama al método Add en la propiedad PstnGatewayList de Route1. Enviamos la identidad del servicio que queremos agregar al método Add. Por último, llamamos a Set-CsVoiceRoute, y enviamos la variable $y al parámetro Instance, con lo que se actualizará la identidad Route1 (almacenada en $y) con la puerta de enlace RTC recién agregada.