Compartilhar via

Test-MapiConnectivity

  • Artigo

 

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

Tópico modificado em: 2007-07-05

Use o cmdlet Test-MapiConnectivity para verificar a funcionalidade do servidor, fazendo logon na caixa de correio que especificada. Se você não especificar uma caixa de correio, o cmdlet fará logon em SystemMailbox no banco de dados especificado.

Sintaxe

Test-MAPIConnectivity [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Test-MAPIConnectivity -Database <DatabaseIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

Test-MAPIConnectivity -Identity <MailboxIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet Test-MapiConnectivity, você deve usar a conta à qual esteja delegado o seguinte:

  • Função de Administrador do Exchange Server e grupo Administradores local para o servidor de destino

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão (página em inglês).

Use o cmdlet Test-MapiConnectivity para verificar a funcionalidade do servidor. Esse cmdlet fará logon na caixa de correio que você especificar, ou em SystemMailbox se você não especificar o parâmetro Identity, e recuperará uma lista de itens da Caixa de Entrada. O logon na caixa de correio testa dois protocolos críticos que são usados quando um cliente se conecta a um servidor de caixa de correio: MAPI e LDAP. Durante a autenticação, o cmdlet Test-MapiConnectivity verifica indiretamente se o servidor MAPI, o armazenamento do Exchange e o DSAccess (Directory Service Access) estão funcionando.

O cmdlet fará logon na caixa de correio que você especificar, usando as credenciais da conta com a qual você se conectou ao computador local. Depois de uma autenticação com êxito, o cmdlet Test-MapiConnectivity acessará a caixa de correio para verificar se o banco de dados está funcionando. Se for feita uma conexão com êxito a uma caixa de correio, o cmdlet também determinará o horário em que ocorreu a tentativa de logon.

Há três parâmetros distintos que você pode usar com o comando: Database, Identity e Server.

  • O parâmetro Database adota uma identidade de banco de dados e testa a capacidade de fazer logon na caixa de correio do sistema no banco de dados especificado.

  • O parâmetro Identity adota uma identidade de caixa de correio e testa a capacidade de fazer logon em uma caixa de correio específica.

  • O parâmetro Server adota uma identidade de servidor e testa a capacidade de fazer logon em cada caixa de correio do sistema no servidor especificado.

Parâmetros

Parâmetro Necessário Tipo Descrição

Database

Necessário

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

O parâmetro Database especifica o banco de dados no qual testar a conectividade com a caixa de correio do sistema. Se você não especificar esse parâmetro ou o parâmetro Identity, o comando testará a SystemMailbox em cada banco de dados no servidor que você especificar ou no servidor local se você não especificar o parâmetro Server.

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

O parâmetro Identity especifica uma caixa de correio a ser testada. É possível usar os seguintes valores:

  • GUID

  • DN (nome distinto)

  • Domínio\Conta

  • Nome UPN

  • DN Herdado do Exchange

  • Endereço SMTP

  • Alias

  • Esse parâmetro aceita a entrada de pipeline do cmdlet Get-Mailbox ou Get-Recipient. Se um objeto for canalizado do cmdlet Get-Mailbox ou Get-Recipient, esse parâmetro não será necessário.

  • Se você não especificar esse parâmetro, o cmdlet testará a SystemMailbox no banco de dados que você especificar.

ActiveDirectoryTimeout

Opcional

System.Int32

O parâmetro ActiveDirectoryTimeout especifica o tempo, em segundos, permitido para a conclusão de cada operação do Active Directory antes que o tempo limite seja esgotado. O valor padrão é 15 segundos.

AllConnectionsTimeout

Opcional

System.Int32

O parâmetro AllConnectionTimeout especifica o tempo, em segundos, permitido para a conclusão de todas as conexões antes que o tempo limite do cmdlet seja esgotado. A contagem regressiva do tempo limite não começa até que todas as informações necessárias para estabelecer as conexões sejam obtidas do Active Directory. O valor padrão é 90 segundos.

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

O parâmetro DomainController especifica o controlador de domínio a ser usado para acessar o serviço de diretório Active Directory. Use o nome de domínio totalmente qualificado (FQDN) do controlador de domínio a ser usado.

MonitoringContext

Opcional

System.Boolean

O parâmetro MonitoringContext especifica se os resultados do comando incluirão eventos de monitoramento e contadores de desempenho. Os dois valores possíveis para esse parâmetro são $true ou $false. Se você especificar $true, os resultados incluirão eventos de monitoramento e contadores de desempenho, além das informações sobre a transação MAPI.

PerConnectionTimeout

Opcional

System.Int32

O parâmetro PerConnectionTimeout especifica o tempo, em segundos, permitido para a conclusão de cada conexão antes que o tempo limite da conexão seja esgotado. O valor padrão é 10 segundos.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

O parâmetro Server especifica o servidor no qual você testará a conectividade MAPI. O comando testará a conectividade MAPI de cada caixa de correio do sistema no servidor especificado.

Se você não especificar esse parâmetro, o comando testará a caixa de correio no servidor local.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar nenhum valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

O primeiro exemplo testa a conectividade com o servidor Server01.

O segundo exemplo testa a conectividade com uma caixa de correio, especificada como um nome de domínio e nome de usuário.

Test-MapiConnectivity -Server "Server01"
Test-MapiConnectivity -Identity "midwest\john"