Compartir a través de

  • Artículo

Set-CsRoutingConfiguration

 

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

Modifica una lista de rutas de voz.

Sintaxis

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

Set-CsRoutingConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

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. Con este cmdlet puede modificar la configuración de cualquier ruta de voz que esté definida en una instalación de Lync Server 2010.

No se recomienda el uso de este cmdlet. Para modificar las configuraciones de enrutamiento, modifique las rutas de voz por separado llamando al cmdlet Set-CsVoiceRoute.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

El ámbito de la configuración de enrutamiento. Debe ser Global.

Instance

Opcional

PstnRoutingSettings

Objeto de una configuración de enrutamiento (Microsoft.Rtc.Management.WritablConfig.Policy.Voice.PstnRoutingSettings). Un objeto de este tipo puede recuperarse llamando a Get-CsRoutingConfiguration.

Route

Opcional

Ruta

Una lista de todos los enrutamientos de voz (Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route objects) definidos para la instalación de Lync Server.

Para modificar los objetos de rutas de voz uno a uno, use el cmdlet Set-CsVoiceRoute. Se trata del método recomendado para modificar rutas de esta lista.

Force

Opcional

Parámetro modificador

Suprime las preguntas de confirmación que aparecerí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.WritableConfig.Management.Policy.Voice.PSTNRoutingSettings. Acepta la entrada transferida de un objeto de configuración de enrutamiento.

Tipos de valores devueltos

Set-CsRoutingConfiguration no devuelve un valor u objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings.

Ejemplo

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

$a = Get-CsRoutingConfiguration
$b = $a.Route | Where-Object {$_.Name -match "LocalRoute"}
$b.SuppressCallerId = $False
Set-CsRoutingConfiguration -Instance $a

Para modificar una ruta de voz en una configuración de enrutamiento, se deben seguir varios pasos. En este ejemplo, se empieza recuperando el objeto de configuración de enrutamiento llamando a Get-CsRoutingConfiguration. A continuación, se asigna el objeto recuperado (sólo habrá uno) a la variable $a.

En la línea 2 de este ejemplo, se recupera el contenido de la propiedad Route de la variable $a, que es una colección de objetos de rutas de voz. A continuación, la colección se transfiere al cmdlet Where-Object, donde se buscan todos los objetos de rutas de voz cuyo valor de Name coincida con la cadena de caracteres LocalRoute. El objeto se asigna a la variable $b.

A continuación, se modifica el objeto de ruta de voz LocalRoute asignando el valor $False a la propiedad SuppressCallerId. Al actualizar el objeto, también se actualiza el objeto que se encuentra en la variable $a. Sin embargo, dicho objeto sigue estando únicamente en la memoria. El último paso consiste en guardar los cambios enviando la variable $a al parámetro Instance de Set-CsRoutingConfiguration.

Éste no es el método recomendado para modificar una configuración de enrutamiento. Para modificar una configuración de enrutamiento, modifique cada una de las rutas de voz por separado mediante la propiedad Set-CsVoiceRoute, como se muestra a continuación:

Set-CsVoiceRoute -Identity LocalRoute -SuppressCallerId $False

Esta línea llevará a cabo la misma acción que se ha explicado en el Ejemplo 1.