Compartir a través de

  • Artículo

New-CsRoutingConfiguration

 

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

Este cmdlet puede devolver un objeto que contenga los valores predeterminados de un objeto de configuración de enrutamiento.

Sintaxis

New-CsRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Una configuración de enrutamiento es un contenedor para todas las rutas de voz definidas en una instalación de Microsoft Lync Server 2010. Para crear una ruta de voz, se usa el cmdlet New-CsVoiceRoute.

Las rutas de configuración sólo se pueden definir en el nivel global. Además, no pueden haber configuraciones de enrutamiento denominadas de forma individual; sólo existe una lista de rutas de voz para toda la instalación de Lync Server 2010. En la implementación Lync Server 2010 de Windows PowerShell, si intenta crear un objeto que ya exista llamando a un cmdlet que empiece por el verbo New, recibirá un mensaje de error. Todas las instalaciones de Lync Server 2010 incluyen un objeto de una configuración de enrutamiento predeterminada con una identidad Global. Esto significa que la única lista de rutas de voz que se podría crear ya existe. Por lo tanto, una llamada a New-CsRoutingConfiguration siempre devolverá un mensaje de error y no creará ninguna configuración de enrutamiento.

La única excepción se produce si especifica el parámetro InMemory en la llamada al cmdlet. Este comando creará un objeto presente sólo en la memoria con una lista de rutas de voz predeterminada.

Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet New-CsRoutingConfiguration localmente los miembros de los siguientes grupos: 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 de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRoutingConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

El ámbito de la configuración de enrutamiento. Este valor debe ser Global.

Route

Opcional

Modificador de lista PS

Una lista de todas las rutas de voz (objetos Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route) definidas para la implementación de Lync Server 2010.

Puede crear objetos de rutas de voz usando el cmdlet New-CsVoiceRoute. Es el método recomendado para agregar rutas de voz a la lista.

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

Puede crear un objeto en memoria de tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings.

Ejemplo

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

$x = New-CsRoutingConfiguration -Identity global -InMemory

Este comando crea un objeto que contiene los valores de la configuración de enrutamiento predeterminada y asigna dicho objeto a la variable $x. Cualquier otro uso de este cmdlet devolverá un error.