Get-CsVoiceRoute
Última modificación del tema: 2012-03-23
Devuelve información sobre las rutas de voz configuradas en una organización.
Sintaxis
Get-CsVoiceRoute [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsVoiceRoute [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
Use este cmdlet para recuperar una o varias rutas de voz configuradas. Las rutas de voz contienen instrucciones que indican a Microsoft Lync Server 2010 cómo enrutar las llamadas de usuarios de Enterprise Voice a números de teléfono de la Red Telefónica Conmutada (RTC) o una central de conmutación PBX.
Este cmdlet se puede usar para recuperar información acerca de las rutas de voz, como con qué puertas de enlace RTC está asociada la ruta (si las hay), qué usos de RTC están relacionados con la ruta, el patrón (en forma de expresión regular) que identifica los números de teléfono a los que se aplica la ruta y la configuración del identificador del autor de llamada. El uso de RTC asocia la ruta de voz con una directiva de voz.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsVoiceRoute localmente: RTCUniversalUserAdmins, 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 "Get-CsVoiceRoute"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
Cadena de caracteres que identifica de manera única la ruta de voz. Si no se especifica una identidad, se devolverán todas las rutas de voz de la organización. |
Filter |
Opcional |
Cadena de caracteres |
Este parámetro filtra los resultados de la operación Get según el valor de comodín enviado al parámetro. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera la ruta de voz a partir de una réplica local de Almacén de administración central en lugar de hacerlo directamente desde Almacén de administración central. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Este cmdlet devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsVoiceRoute
Recupera las propiedades de todas las rutas de voz definidas en la organización.
-------------------------- Ejemplo 2 --------------------------
Get-CsVoiceRoute -Identity Route1
Recupera las propiedades de la ruta de voz Route1.
-------------------------- Ejemplo 3 --------------------------
Get-CsVoiceRoute -Filter *test*
Este comando muestra las configuraciones de ruta de voz en las que la propiedad Identity contiene la cadena de caracteres "test" en cualquier ubicación dentro del valor. Para buscar el texto "test" solamente al final de la propiedad Identity, use el valor *test. Para buscar el texto "test" solamente cuando aparece al principio de la propiedad Identity, especifique el valor test*.
-------------------------- Ejemplo 4 --------------------------
Get-CsVoiceRoute | Where-Object {$_.PstnGatewayList.Count -eq 0}
Este comando recupera todas las rutas de voz que no tienen puertas de enlace RTC asignadas. En primer lugar, se recuperan todas las rutas de voz con el cmdlet Get-CsVoiceRoute. A continuación, estas rutas de voz se transfieren al cmdlet Where-Object. Where-Object restringe los resultados de la operación Get. En este caso, se examina cada ruta de voz (es lo que representa $_) y se comprueba la propiedad Count de PstnGatewayList. Si el número de puertas de enlace RTC es 0, la lista está vacía y no se han definido puertas de enlace para la ruta.