Test-UMConnectivity
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2008-01-30
El cmdlet Test-UMConnectivity se puede usar para probar el funcionamiento de un equipo que tenga instalada la función del servidor Mensajería unificada.
Sintaxis
test-UMConnectivity [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Fax <$true | $false>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]
test-UMConnectivity -TUILogonAll <$true | $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]
test-UMConnectivity -ResetPIN <$true | $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]
test-UMConnectivity -Phone <String> -UMIPGateway <UMIPGatewayIdParameter> [-Confirm [<SwitchParameter>]] [-DiagDtmfDurationInMilisecs <Int32>] [-DiagDtmfSequence <String>] [-DiagInitialSilenceInMilisecs <Int32>] [-DiagInterDtmfDiffGapInMilisecs <String>] [-DiagInterDtmfGapInMilisecs <Int32>] [-DomainController <Fqdn>] [-Fax <$true | $false>] [-From <String>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]
test-UMConnectivity -Phone <String> -PIN <String> -TUILogon <$true | $false> -UMDialPlan <UMDialPlanIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Las dos pruebas de diagnóstico están diseñadas para comprobar el funcionamiento del software de servidor de mensajería unificada (modo 1) de Microsoft Exchange Server 2007 y el funcionamiento de todo el sistema, incluidos los componentes telefónicos conectados (modo 2).
El cmdlet Test-UMConnectivity se puede utilizar para comprobar el funcionamiento de un servidor de mensajería unificada (UM) y los correspondientes equipos de telefonía conectados. Cuando un administrador ejecuta este cmdlet e incluye el parámetro UMIPGateway, el servidor de mensajería unificada comprueba el funcionamiento completo de un extremo a otro del sistema de MU. Esto incluye los componentes de telefonía conectados al servidor de mensajería unificada, tales como las puertas de enlace de IP, las centrales de conmutación (PBX) y el cableado. Si no se especifica el parámetro IPGateway, el servidor de mensajería unificada comprobará sólo el funcionamiento de los componentes de mensajería unificada que están instalados y configurados en el servidor.
Para ejecutar el cmdlet Test-UMConnectivity, la cuenta que se use debe tener delegada la función Administrador de Exchange Server y el grupo Administradores local en el servidor de destino.
Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
Phone |
Necesario |
System.String |
Este parámetro especifica el número de teléfono o el URI de SIP que se usará cuando se redirija la llamada de prueba. El número de extensión se debe configurar en la PBX para reenviar llamadas al grupo de extensiones de mensajería unificada. |
PIN |
Necesario |
System.String |
Este parámetro permite especificar el NIP asociado al buzón habilitado para mensajería unificada. |
ResetPIN |
Necesario |
System.Boolean |
Este parámetro especifica si sebe generar o regenerar un nuevo NIP para todos los buzones de prueba del sitio actual. |
TUILogon |
Necesario |
System.Boolean |
Este parámetro especifica si desea que el cmdlet intente iniciar sesión en uno o más buzones habilitados para mensajería unificada. Los buzones deben estar habilitados para mensajería unificada y asociados al plan de marcado de mensajería unificada al que pertenece el servidor de mensajería unificada. El valor predeterminado es falso. |
TUILogonAll |
Necesario |
System.Boolean |
Este parámetro especifica si se deben comprobar todos los buzones del sitio de Active Directory actual y, a continuación, se debe comprobar la conectividad con cada buzón habilitado para mensajería unificada. El valor predeterminado es falso. |
UMDialPlan |
Necesario |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
Este parámetro especifica el plan de marcado de mensajería unificada que se comprobará. Debe utilizarse con el parámetro TUILogin. |
UMIPGateway |
Necesario |
Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter |
Este parámetro especifica el nombre de la puerta de enlace IP de mensajería unificada o IP PBX para utilizarlo para las llamadas externas de prueba. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
Este parámetro hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. El valor predeterminado es $true. |
DiagDtmfDurationInMilisecs |
Opcional |
System.Int32 |
Este parámetro especifica la duración de cada dígito que se envía. |
DiagDtmfSequence |
Opcional |
System.String |
Este parámetro especifica la secuencia de dígitos que se envía. |
DiagInitialSilenceInMilisecs |
Opcional |
System.Int32 |
Este parámetro especifica el período de tiempo (en milisegundos) que el cmdlet se detendrá antes de enviar la secuencia de dígitos. |
DiagInterDtmfDiffGapInMilisecs |
Opcional |
System.String |
Este parámetro se utiliza para personalizar el tiempo entre dígitos en la secuencia de diagnóstico. Se trata de una lista delimitada por comas que puede aceptar entradas nulas. Debería incluir varios valores. |
DiagInterDtmfGapInMilisecs |
Opcional |
System.Int32 |
Este parámetro especifica el tiempo en milisegundos entre cada dígito que se envía en la secuencia de dígitos. Se trata de un valor único. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Este parámetro especifica el nombre de dominio completo del controlador (FQDN) de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory. |
Fax |
Opcional |
System.Boolean |
Este parámetro especifica que la llamada de prueba es una llamada de fax. El valor predeterminado es |
From |
Opcional |
System.String |
Este parámetro especifica el URI de SIP o dirección SIP desde la que se originó la llamada. Sólo se usa cuando se utiliza el parámetro -Phone. El valor predeterminado es el URI del SIP especificado al usar el parámetro -Phone. |
ListenPort |
Opcional |
System.Int32 |
Este parámetro especifica el número de puerto IP sobre el que se va a escuchar. Si no se especifica, se utilizará el puerto IP 9000. |
MediaSecured |
Opcional |
System.Boolean |
Este parámetro especifica si hay que utilizar el modo Secure RTP o el modo inseguro. |
MonitoringContext |
Opcional |
System.Boolean |
Este parámetro especifica si el cmdlet se ejecutará en una línea de comandos o si el objeto de salida se transmitirá a Microsoft Operations Manager. De forma predeterminada, el cmdlet se ejecutará desde la línea de comandos. |
RemotePort |
Opcional |
System.Int32 |
Este parámetro especifica el puerto que se usará para la llamada. Si no se especifica, los puertos predeterminados son 5060 para TCP y 5061 para MTLS. |
Secured |
Opcional |
System.Boolean |
Este parámetro especifica si la prueba se realizará en el modo seguro. |
Timeout |
Opcional |
System.Int32 |
Este parámetro especifica la cantidad de tiempo que hay que esperar para que se complete la operación de prueba (en segundos). El valor predeterminado es 180 segundos. Puede establecer este parámetro con un valor menor de 5 segundos. Sin embargo, es recomendable que siempre configure este parámetro con un valor de 5 segundos o más. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
Este parámetro indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. El valor predeterminado es $true. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
|
Ejemplo
En el primer ejemplo se realizan las pruebas de conectividad y funcionalidad en el servidor de mensajería unificada local y, a continuación, se muestra la información de conectividad de voz sobre IP (VoIP).
En el segundo ejemplo se comprueba la capacidad del servidor de mensajería unificada local de usar una conexión de protocolo de control de transmisión (TCP) no segura en lugar de una conexión de Seguridad del nivel de transporte mutua (MTLS) segura para realizar una llamada a través de la puerta de enlace IP de mensajería unificada denominada MyUMIPGateway con el número de teléfono 56780.
En el tercer ejemplo e comprueba el número de acceso de suscriptor en un plan de marcado mediante un URI de SIP. Este ejemplo se puede usar en un entorno que incluya Microsoft Office Communications Server 2007.
En el cuarto ejemplo se comprueba un operador automático con un URI de SIP. Esto se usa en un entorno que contenga Communications Server 2007.
Test-UMConnectivity
Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false
Test-UMConnectivity -UMIPGateway OCSGateway1 -Phone "sip:SIPdialplan.contoso.com@contoso.com"
Test-UMConnectivity -UMIPGateway OCSGateway1 -Phone "sip:SIPAutoAttendant.SIPDialPlan.contoso.com@contoso.com"