Compartilhar via


Test-UMConnectivity

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2008-01-30

O cmdlet Test-UMConnectivity pode ser usado para testar a operação de um computador em que a função de servidor Unificação de Mensagens esteja instalada.

Sintaxe

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>]]

Descrição detalhada

Os dois testes de diagnóstico foram criados para testar a operação do software do servidor de Unificação de Mensagens do Microsoft Exchange Server 2007 (modo 1) e a operação de todo o sistema, o que inclui os componentes de telefonia conectados (modo 2).

O cmdlet Test-UMConnectivity pode ser usado para testar a operação de um servidor do UM (Unificação de Mensagens) e do equipamento de telefonia conectado relacionado. Quando um administrador executa esse cmdlet e inclui o parâmetro UMIPGateway, o servidor de Unificação de Mensagens testa a operação completa do sistema de UM. Isso inclui os componentes de telefonia conectados ao servidor de Unificação de Mensagens, como gateways IP, PBXs e cabeamento. Se o parâmetro IPGateway não for especificado, o servidor de Unificação de Mensagens testará somente a operação dos componentes do UM instalados e configurados no servidor.

Para executar o cmdlet Test-UMConnectivity, você deve usar uma conta à qual esteja delegada a função Administrador do Exchange Server e o grupo Administradores local do servidor de destino.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange 2007, consulte Considerações sobre permissão

Parâmetros

Parâmetro Necessário(s) Tipo Descrição

Phone

Necessário(s)

System.String

Esse parâmetro especifica o número de telefone ou o URI SIP que será usado quando a chamada de teste for redirecionada. O número do ramal deve ser configurado no PBX para encaminhamento de chamadas para o grupo de busca do UM.

PIN

Necessário(s)

System.String

Esse parâmetro permite especificar o PIN que está associado à caixa de correio habilitada para UM.

ResetPIN

Necessário(s)

System.Boolean

Esse parâmetro especifica se deve ser gerado ou gerado novamente um novo PIN para todas as caixas de correio de teste do site atual.

TUILogon

Necessário(s)

System.Boolean

Esse parâmetro especifica se você deseja que o cmdlet tente fazer logon em uma ou mais caixas de correio habilitadas para UM. As caixas de correio devem estar habilitadas para UM e associadas ao plano de discagem do UM ao qual o servidor de Unificação de Mensagens pertence. A configuração padrão é falsa.

TUILogonAll

Necessário(s)

System.Boolean

Esse parâmetro especifica se devem ser testadas todas as caixas de correio do site atual do Active Directory e, em seguida, a conectividade de cada caixa de correio habilitada para UM. A configuração padrão é falsa.

UMDialPlan

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Esse parâmetro especifica o plano de discagem do UM que será testado. Ele deve ser usado com o parâmetro TUILogin.

UMIPGateway

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

Esse parâmetro especifica o nome do PBX IP ou do gateway IP do UM a ser usado para a chamada de teste de saída.

Confirm

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. O valor padrão é $true.

DiagDtmfDurationInMilisecs

Opcional

System.Int32

Este parâmetro especifica a duração de cada dígito enviado.

DiagDtmfSequence

Optional

System.String

Este parâmetro especifica a seqüência de dígitos enviados.

DiagInitialSilenceInMilisecs

Optional

System.Int32

Este parâmetro especifica o período de tempo (milissegundos) em que o cmdlet ficará pausado antes de a seqüência de dígitos ser enviada.

DiagInterDtmfDiffGapInMilisecs

Optional

System.String

Este parâmetro é usado para personalizar o tempo entre os dígitos na seqüência de diagnósticos. Essa é uma lista delimitada por vírgulas que pode aceitar entradas nulas. Ela deve incluir vários valores.

DiagInterDtmfGapInMilisecs

Optional

System.Int32

Este parâmetro especifica o tempo em milissegundos entre cada dígito enviado na seqüência de dígitos. É um valor único.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Esse parâmetro especifica o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no serviço de diretório Active Directory.

Fax

Opcional

System.Boolean

Esse parâmetro especifica que a chamada que está sendo testada é uma chamada de fax. A configuração padrão é $true.

From

Optional

System.String

Este parâmetro especifica o URI SIP ou o endereço SIP do qual a chamada foi originada. Ele só é usado quando você usa o parâmetro -Phone. A configuração padrão é o URI SIP que é especificado quando você usa o parâmetro -Phone.

ListenPort

Opcional

System.Int32

Esse parâmetro especifica o número da porta IP a ser escutada. Se não for especificada, a porta IP 9000 será usada.

MediaSecured

Opcional

System.Boolean

Este parâmetro especifica se deve ser usado o modo RTP seguro ou inseguro.

MonitoringContext

Opcional

System.Boolean

Esse parâmetro especifica se o cmdlet será executado em uma linha de comando ou se o objeto de saída será passado para o Microsoft Operations Manager. Por padrão, o cmdlet é executado a partir da linha de comando.

RemotePort

Optional

System.Int32

Este parâmetro especifica a porta que será usada para a chamada. Se ele não for especificado, o padrão será a porta 5060 para TCP e 5061 para MTLS.

Secured

Opcional

System.Boolean

Esse parâmetro especifica se o teste será executado no modo seguro.

Timeout

Opcional

System.Int32

Esse parâmetro especifica quanto tempo será preciso aguardar até a conclusão da operação de teste (em segundos). O padrão é 180 segundos. Você pode definir esse parâmetro com um valor inferior a 5 segundos. No entanto, recomendamos que você sempre configure esse parâmetro com um valor de 5 segundos ou mais.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

Este parâmetro instrui o comando a simular as ações que ele executaria no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. O valor padrão é $true.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O primeiro exemplo executa testes operacionais e de conectividade no servidor de Unificação de Mensagens local e exibe as informações de conectividade de VoIP (Voice over IP).

O segundo exemplo testa a capacidade do servidor de Unificação de Mensagens de usar uma conexão de protocolo TCP não protegida em vez de uma conexão MTLS (Mutual Transport Layer Security) protegida para fazer uma chamada por meio de um gateway IP do UM chamado MyUMIPGateway com o número do telefone 56780.

O terceiro exemplo testa o número de acesso do assinante em um plano de discagem usando um URI SIP. Este exemplo pode ser usado em um ambiente que possua o Microsoft Office Communications Server 2007.

O quarto exemplo testa um atendedor automático usando um URI SIP. Ele pode ser usado em um ambiente que possua o 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"