Compartir a través de

  • Artículo

New-CsVoiceRoute

 

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

Crea 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

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

New-CsVoiceRoute -Name <String> [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Use este cmdlet para crear una ruta de voz. Todas las rutas de voz se crean en el ámbito global. Aunque pueden definirse varias rutas de voz globales. Esto se realiza usando el parámetro Identity, que requiere un nombre de ruta único.

Las rutas de voz se asocian con directivas de voz a través de usos de 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 New-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 (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 "New-CsVoiceRoute"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Nombre que identifica de manera única la ruta de voz. Las rutas de voz sólo se pueden definir en el ámbito global, la identidad es sólo el nombre que quiera dar a la ruta. (El nombre de ruta puede tener espacios, por ejemplo Test Route, pero debe delimitar la cadena de caracteres completa entre comillas dobles en la llamada a New-CsVoiceRoute).

Si se especifica el valor Identity, Name debe dejarse en blanco. El valor Identity se asignará a Name.

Name

Requerido

Cadena de caracteres

El nombre único de la ruta de voz. Si se define este parámetro, el valor se aplicará automáticamente a la propiedad Identity de la ruta de voz. No puede especificarse un valor para Identity y para Name.

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

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.

Valor predeterminado: [0-9]{10}

Priority

Opcional

Int32

Un número podría resolverse 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

En Lync Server 2010 puede asociarse un servidor de mediación con varias puertas de enlace. Este parámetro contiene una lista de puertas de enlace asociadas con 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 solo puede hacer referencia a un servidor de mediación 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 es necesario usar una puerta de enlace PSTN. 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 del grupo o la dirección IP del servidor. Por ejemplo, PSTNGateway:redmondpool.litwareinc.com. Las identidades del servicio se pueden recuperar llamando al comando Get-CsService | Select-Object Identity.

De forma predeterminada, esta lista está vacía. Sin embargo, si deja este parámetro en blanco al crear una ruta de voz nueva, recibirá un mensaje de advertencia.

PstnUsages

Opcional

Modificador de lista PS

Una lista de usos de RTC (como Local, Long Distance, etc.) 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).

De forma predeterminada, esta lista está vacía. Sin embargo, si deja este parámetro en blanco al crear una ruta de voz nueva, recibirá un mensaje de advertencia.

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. Cuando SuppressCallerId está establecido en True, deberá proporcionar un valor para AlternateCallerId.

Force

Opcional

Parámetro modificador

Suprime las preguntas de confirmación que aparecerí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

Cadena de caracteres

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Ninguno.

Tipos de valores devueltos

Crea un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route.

Ejemplo

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

New-CsVoiceRoute -Identity Route1

El comando de este ejemplo crea una ruta de voz con el valor de Identity Route1. El resto de propiedades se establecerán en los valores predeterminados.

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

New-CsVoiceRoute -Identity Route1 -PstnUsages @{add="Long Distance"} -PstnGatewayList @{add="PstnGateway:redmondpool.litwareinc.com"}

El comando de este ejemplo crea una ruta de voz con el valor de Identity Route1. También agrega el uso RTC Long Distance a la lista de usos y el Id. de servicio PstnGateway:redmondpool.litwareinc.com a la lista de puertas de enlace RTC.

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

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

En este ejemplo se crea una ruta de voz denominada Route1 y se rellena su lista de usos con usos de RTC con todos los usos de la organización. El primer comando de este ejemplo recupera la lista de usos de teléfono RTC (PSTN) 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 existe el uso de RTC global, únicamente se recuperará un objeto). A continuación, el comando recupera la propiedad Usage del objeto. Dicha propiedad, que contiene una lista de usos de teléfono, se asigna a la variable $x. En la segunda línea de este ejemplo, se llama a New-CsVoiceRoute para crear una ruta de voz. La identidad de esta ruta de voz será Route1. Preste atención al valor enviado al parámetro PstnUsages: @{add=$x}. Este valor indica que se debe agregar el contenido de $x, que contiene la lista de usos de teléfono recuperada en la línea 1, a la lista de usos de RTC de esta ruta.