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 é |
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"