Test-CsVoiceUser
Última modificación del tema: 2012-03-26
Identifica la ruta que una llamada de un usuario determinado usaría para completarse, según las reglas de voz, rutas y directivas.
Sintaxis
Test-CsVoiceUser -DialedNumber <PhoneNumber> -SipUri <UserIdParameter> [-Force <SwitchParameter>]
Descripción detallada
Cuando un usuario hace una llamada telefónica, la ruta que usará la llamada para llegar al destino depende de las directivas y planes de marcado asignados al usuario. Al especificar la dirección SIP y el número de teléfono de un usuario, este cmdlet devuelve el número traducido a formato E.164 (según el plan de marcado del usuario), la regla de normalización que ha suministrado la traducción, la primera ruta (basada en el valor Priority de ruta) con un modelo de número que coincida con ese número de teléfono, y el uso de teléfono que vincularía la directiva de voz del usuario con la ruta de voz.
Este cmdlet puede usarse para determinar si un número de teléfono específico se enrutará y traducirá del modo esperado según la configuración del usuario, y puede facilitar la solución de problemas de usuarios individuales.
Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Test-CsVoiceUser 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 "Test-CsVoiceUser"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
DialedNumber |
Requerido |
Número de teléfono |
El número de teléfono que se probará. Tipo de datos completo: Microsoft.Rtc.Management.Voice.PhoneNumber |
SipUri |
Requerido |
Cadena de caracteres |
El URI de SIP del usuario con el que se realiza la prueba. Es el valor Identity del usuario tal y como se usa en los cmdlets CsUser. Puede especificar la identidad de un usuario mediante uno de estos cuatro formatos: 1) la dirección SIP del usuario; 2) el nombre principal del usuario (UPN); 3) el nombre del dominio y el nombre de inicio de sesión del usuario, con formato dominio\nombre (por ejemplo, litwareinc\kenmyer), y 4) el nombre para mostrar de Active Directory del usuario (por ejemplo, Ken Myer). Tenga en cuenta que SAMAccountName no se puede utilizar como identidad. |
Force |
Opcional |
Parámetro modificador |
Suprime cualquier aviso de confirmación o mensaje de error leve que se pueda producir al ejecutar el cmdlet. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Devuelve un objeto de tipo Microsoft.Rtc.Management.Voice.OcsVoiceUserTestResult.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsVoiceUser -DialedNumber "+14255559999" -SipUri "sip:kmyer@litwareinc.com" -Verbose
Este ejemplo ejecuta una prueba de usuario de voz con el usuario que tiene la dirección SIP sip:kmyer@litwareinc.com. La prueba se realiza con el número de teléfono especificado en el parámetro DialedNumber ("+14255559999"). Si no se identifican reglas o rutas que coincidan con los parámetros, el cmdlet devuelve un valor nulo. Fíjese en que también se ha incluido el parámetro Verbose. Verbose es un parámetro común de Windows PowerShell que muestra información adicional mientras se realiza la prueba, como qué plan de marcado y directiva de voz se usan en la prueba.
-------------------------- Ejemplo 2 --------------------------
Get-CsUser | ForEach-Object {$_.DisplayName; Test-CsVoiceUser -DialedNumber "+14255559999" -SipUri $_.SipAddress} | Format-List
Este ejemplo realiza una prueba de enrutamiento de voz con todos los usuarios habilitados para Lync Server 2010 o Office Communications Server. El comando comienza llamando a Get-CsUser, que devuelve una recopilación de todos los usuarios habilitados para Lync Server 2010 o Office Communications Server. A continuación, dicha recopilación de usuarios se transfiere al cmdlet ForEach-Object. Este cmdlet examinará cada objeto de usuario y realizará las acciones especificadas entre llaves ({}).
La primera acción es suministrar el nombre para mostrar del usuario actual. (El usuario actual está representado por los caracteres $_; por lo tanto, el nombre para mostrar es el especificado en la propiedad DisplayName de $_.) De este modo es posible ver qué cuenta de usuario se está probando. A continuación se llama al cmdlet Test-CsVoiceUser especificando el valor DialedNumber ("+14255559999") y el SipUri del usuario actual. En este ejemplo se usa la dirección SIP del usuario ($_.SipAddress).
Finalmente, como el resultado se muestra de manera predeterminada en formato de tabla y los datos pueden quedar cortados, se transfieren los resultados de la prueba al cmdlet Format-List, para poder ver el nombre para mostrar de cada usuario seguido de una línea por cada campo.