Test-UMConnectivity

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Test-UMConnectivity para testar a operação de servidores UM (Mensagens Unificadas).

Observação: este cmdlet funciona melhor no Exchange 2010. Em versões posteriores do Exchange, a funcionalidade desse cmdlet foi substituída pela Disponibilidade Gerenciada. Para obter os melhores resultados, use o cmdlet Invoke-MonitoringProbe e especifique a investigação de monitor ativo relevante em vez de usar esse cmdlet.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Test-UMConnectivity
    -Phone <String>
    -PIN <String>
    -TUILogon <Boolean>
    -UMDialPlan <UMDialPlanIdParameter>
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -Phone <String>
    -UMIPGateway <UMIPGatewayIdParameter>
    [-DiagDtmfDurationInMilisecs <Int32>]
    [-DiagDtmfSequence <String>]
    [-DiagInitialSilenceInMilisecs <Int32>]
    [-DiagInterDtmfDiffGapInMilisecs <String>]
    [-DiagInterDtmfGapInMilisecs <Int32>]
    [-From <String>]
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -ResetPIN <Boolean>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    -TUILogonAll <Boolean>
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Test-UMConnectivity
    [-CallRouter]
    [-CertificateThumbprint <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ListenPort <Int32>]
    [-MediaSecured <Boolean>]
    [-MonitoringContext <Boolean>]
    [-RemotePort <Int32>]
    [-Secured <Boolean>]
    [-Timeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Description

Dois testes de diagnóstico foram criados para testar a operação do software do servidor de Caixa de Correio (modo 1) e a operação de todo o sistema que inclui os componentes de telefonia conectados (modo 2).

O cmdlet Test-UMConnectivity pode ser usado para testar a operação de um servidor de Caixa de Correio e do equipamento de telefonia conectado relacionado. Quando esse cmdlet é executado e inclui o parâmetro UMIPGateway, o servidor de Caixa de Correio testa a operação completa do sistema de Unificação de Mensagens. Este teste inclui os componentes de telefonia conectados ao servidor mailbox, como gateways de IP, PBXs (Private Branch eXchanges) e cabeamento. Se o parâmetro UMIPGateway não for especificado, o servidor de Caixa de Correio testa somente a operação dos componentes da Unificação de Mensagens instalados e configurados no servidor.

Quando você executar esse cmdlet em uma implantação local de Unificação de Mensagens, precisará criar um objeto de gateway IP de Unificação de Mensagens (UM) para o computador ou servidor que o cmdlet está testando. Ao criar o objeto de gateway IP da UM, você deverá configurá-lo com um nome de domínio totalmente qualificado (FQDN) e esse FQDN deverá corresponder ao nome do computador que estará executando esse cmdlet.

Depois de concluída essa tarefa, o cmdlet terá testado a operação do servidor de Caixa de Correio e dos componentes de telefonia relacionados.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Test-UMConnectivity

Este exemplo realiza testes operacionais e de conectividade no servidor de Caixa de Correio local e depois exibe as informações de conectividade de VoIP (Voz sobre IP).

Exemplo 2

Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false

Este exemplo testa a capacidade do servidor de Caixa de Correio local de usar uma conexão TCP insegura em vez de uma conexão TLS mútua segura para fazer uma chamada por meio do gateway IP da UM MyUMIPGateway, usando o número do telefone 56780.

Exemplo 3

Test-UMConnectivity -Phone sip:sipdp.contoso.com@contoso.com -UMIPGateway MyUMIPGateway -Secured $true -From sip:user1@contoso.com -MediaSecured $true

Este exemplo testa um plano de discagem SIP usando uma URI SIP. Este exemplo pode ser usado em um ambiente que inclui o Lync Server ou Skype for Business Server.

Parâmetros

-CallRouter

A opção CallRouter especifica se deve testar o serviço roteador de chamadas de mensagens unificadas do Microsoft Exchange (front-end). Não é preciso especificar um valor com essa opção.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016

-CertificateThumbprint

O parâmetro CertificateThumbprint especifica a impressão digital do certificado usado para o modo seguro e para o modo SIP seguro.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-DiagDtmfDurationInMilisecs

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-DiagDtmfSequence

O parâmetro DiagDtmfSequence especifica a sequência de dígitos enviados.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-DiagInitialSilenceInMilisecs

O parâmetro DiagInitialSilenceInMilisecs especifica o período em milissegundos que o cmdlet ficará pausado antes de a sequência de dígitos ser enviada.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-DiagInterDtmfDiffGapInMilisecs

O parâmetro DiagInterDtmfDiffGapInMilisecs especifica se o tempo entre os dígitos na sequência de diagnósticos deve ser personalizado. Essa é uma lista delimitada por vírgulas que pode aceitar entradas nulas. Ela deve incluir vários valores.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-DiagInterDtmfGapInMilisecs

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-DomainController

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-From

O parâmetro From especifica o URI SIP ou o endereço SIP do qual a chamada se originou. Ele só é usado quando você usa o parâmetro Phone. A configuração padrão é o URI SIP especificado quando você usa o parâmetro Phone.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-ListenPort

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-MediaSecured

O parâmetro MediaSecured especifica se deve ser usado o modo RTP Seguro ou o modo RTP (inseguro).

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-MonitoringContext

O parâmetro MonitoringContext especifica se é preciso incluir os eventos de monitoramento e contadores de desempenho associados nos resultados. Os valores válidos são:

$true: os contadores de desempenho e eventos de monitoramento são incluídos nos resultados do comando. Normalmente, você inclui os eventos de monitoramento e contadores de desempenho nos resultados quando a saída é passada para o SCOM (Microsoft System Center Operations Manager).
$false: os contadores de monitoramento e desempenho não estão incluídos nos resultados do comando. Esse é o valor padrão.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Phone

O parâmetro Phone especifica o número do telefone ou URI do SIP usado quando a ligação de teste for redirecionada. O número do ramal deve ser configurado no PBX para encaminhar chamadas para o grupo de busca da UM.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-PIN

O parâmetro PIN especifica o PIN associado à caixa de correio habilitada para a UM.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-RemotePort

O parâmetro RemotePort especifica a porta usada para a chamada. Se não for especificada, a porta padrão será a 5060 para TCP e a 5061 para TLS mútuo.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-ResetPIN

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Secured

O parâmetro Secured especifica se o teste será executado no modo SIP seguro.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Timeout

O parâmetro Timeout especifica o tempo, em segundos, a ser aguardado até a conclusão da operação de teste. O padrão é 600 segundos. Você não pode definir esse parâmetro com um valor inferior a 60 segundos. No entanto, recomendamos que você sempre configure esse parâmetro com um valor de 60 segundos ou mais. O valor máximo desse parâmetro é 1800 segundos.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-TUILogon

O parâmetro TUILogon especifica se você deseja que o cmdlet tente fazer o login 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 um ao qual o servidor da caixa de correio que executa o serviço de Mensagens Unificadas do Microsoft Exchange pertence. A configuração padrão é $false.

Type:	Boolean
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-TUILogonAll

O parâmetro TUILogonAll especifica se deve tentar se conectar a todas as caixas de correio de teste no site do Active Directory atual. A configuração padrão é $false. As contas testadas devem ser geradas chamando-se o script New-TestCasConnectivityUser.ps1, e as caixas de correio correspondentes devem estar habilitadas para UM. Caso contrário, nenhuma ação é realizada.

Type:	Boolean
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-UMDialPlan

O parâmetro UMDialPlan especifica o plano de discagem da UM que será testado. Esse parâmetro deve ser usado junto com o parâmetro TUILogon.

Type:	UMDialPlanIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-UMIPGateway

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

Type:	UMIPGatewayIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.

Compartilhar via