Remove-CsVoiceRoute
Última modificación del tema: 2012-03-25
Quita 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
Remove-CsVoiceRoute -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Use este cmdlet para quitar una ruta de voz. Las rutas de voz están asociadas a directivas de voz mediante usos de RTC; de modo que, al quitar una ruta de voz, no se cambia ningún valor relacionado con una directiva de voz, sino que se cambia solamente el enrutamiento de los números que coinciden con el patrón de la ruta de voz eliminada.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsVoiceRoute localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsVoiceRoute"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
XdsGlobalRelativeIdentity |
Cadena de caracteres que identifica de manera única la ruta de voz que quiere quitar. (Si el nombre de la ruta contiene un espacio, como Test Route, deberá delimitar la cadena de caracteres completa entre comillas dobles.) |
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.Management.WritableConfig.Policy.Voice.Route. Acepta la entrada transferida de objetos de ruta de voz.
Tipos de valores devueltos
Quita un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Remove-CsVoiceRoute -Identity Route1
Quita la configuración de la ruta de voz con el valor de Identity Route1.
-------------------------- Ejemplo 2 --------------------------
Get-CsVoiceRoute | Remove-CsVoiceRoute
Este comando quita todas las rutas de voz de la organización. En primer lugar, se recuperan todas las rutas de voz con el cmdlet Get-CsVoiceRoute. A continuación, se transfieren las rutas a Remove-CsVoiceRoute, que las quita todas.
-------------------------- Ejemplo 3 --------------------------
Get-CsVoiceRoute -Filter *Redmond* | Remove-CsVoiceRoute
Este comando quita todas las rutas de voz con un valor de Identity que incluya la cadena de caracteres "Redmond." En primer lugar, se llama al cmdlet Get-CsVoiceRoute con el parámetro Filter. El valor del parámetro Filter es la cadena de caracteres "Redmond" entre asteriscos (*), que indican que la cadena puede encontrase en cualquier lugar dentro del valor de Identity. Una vez recuperadas todas las rutas de voz con identidades que incluyen la cadena "Redmond", se transfieren a Remove-CsVoiceRoute, que las elimina.