Test-MAPIConnectivity

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

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.

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

Syntax

Test-MAPIConnectivity
    -Database <DatabaseIdParameter>
    [-ActiveDirectoryTimeout <Int32>]
    [-AllConnectionsTimeout <Int32>]
    [-Confirm]
    [-CopyOnServer <ServerIdParameter>]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-PerConnectionTimeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]
Test-MAPIConnectivity
    [-Identity] <MailboxIdParameter>
    [-ActiveDirectoryTimeout <Int32>]
    [-AllConnectionsTimeout <Int32>]
    [-Archive]
    [-Confirm]
    [-CopyOnServer <ServerIdParameter>]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-PerConnectionTimeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]
Test-MAPIConnectivity
    [-Server <ServerIdParameter>]
    [-ActiveDirectoryTimeout <Int32>]
    [-AllConnectionsTimeout <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IncludePassive]
    [-MonitoringContext <Boolean>]
    [-PerConnectionTimeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Description

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

O cmdlet faz 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: Banco de Dados, Identidade e Servidor:

  • 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.

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-MapiConnectivity -Server "Server01"

Este exemplo testa a conectividade com o servidor Server01.

Exemplo 2

Test-MapiConnectivity -Identity "midwest\john"

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

Parâmetros

-ActiveDirectoryTimeout

Este parâmetro está disponível somente no Exchange local.

O parâmetro ActiveDirectoryTimeout especifica a quantidade de tempo, em segundos, permitida para que cada operação do Active Directory seja concluída antes do tempo limite da operação. O valor padrão é de 15 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, Exchange Server 2019

-AllConnectionsTimeout

Este parâmetro está disponível somente no Exchange local.

O parâmetro AllConnectionsTimeout especifica a quantidade de tempo, em segundos, permitido que todas as conexões fossem concluídas antes que o cmdlet acabasse. A contagem regressiva de tempo limite não começa até que todas as informações necessárias para executar as conexões sejam coletadas do Active Directory.O valor padrão é de 90 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, Exchange Server 2019

-Archive

A opção Arquivo especifica se deve testar a conectividade MAPI do arquivo pessoal associado à caixa de correio especificada. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, somente a caixa de correio primária será testada.

Type:SwitchParameter
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, Exchange Server 2019, Exchange Online

-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, Exchange Server 2019, Exchange Online

-CopyOnServer

Este parâmetro está disponível somente no Exchange local.

O parâmetro CopyOnServer especifica o servidor mailbox que contém a cópia de banco de dados específica para testar. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

  • Nome
  • FQDN
  • DN (nome diferenciado)
  • DN Herdado do Exchange

Você só pode usar esse parâmetro com o parâmetro Server, não com os parâmetros Identificar ou Banco de Dados.

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

-Database

Este parâmetro está disponível somente no Exchange local.

O parâmetro Database especifica o banco de dados no qual testar a conectividade com a caixa de correio do sistema. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Se você não usar esse parâmetro ou o parâmetro Identity, o comando testará o SystemMailbox em cada banco de dados ativo no servidor Exchange (o servidor exchange local ou o servidor que você especifica com o parâmetro Server).

Você não pode usar os parâmetros Identidade, Banco de Dados ou Servidor no mesmo comando.

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

-DomainController

Este parâmetro está disponível somente no Exchange local.

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, Exchange Server 2019

-Identity

O parâmetro Identity especifica uma caixa de correio a ser testada. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Esse cmdlet aceita a entrada de pipeline do cmdlet Get-Mailbox ou Get-Recipient. Se você canalizar a identificação dos cmdlets Get-Mailbox ou Get-Recipient, não precisará usar esse parâmetro.

Se você não usar esse parâmetro, o cmdlet testará o SystemMailbox no banco de dados especificado.

Você não pode usar os parâmetros Identidade, Banco de Dados ou Servidor no mesmo comando.

Type:MailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludePassive

Este parâmetro está disponível somente no Exchange local.

A opção IncludePassive testa a conectividade MAPI de todas as cópias de banco de dados ativo e passivo. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, o comando testará apenas a conectividade MAPI do banco de dados ativo.

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, Exchange Server 2019

-MonitoringContext

Este parâmetro está disponível somente no Exchange local.

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 Microsoft SCOM (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, Exchange Server 2019

-PerConnectionTimeout

Este parâmetro está disponível somente no Exchange local.

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.

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, Exchange Server 2019

-Server

Este parâmetro está disponível somente no Exchange local.

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 hospedada em bancos de dados ativos no servidor especificado. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

  • Nome
  • FQDN
  • DN (nome diferenciado)
  • DN Herdado do Exchange

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

Você não pode usar os parâmetros Identidade, Banco de Dados ou Servidor no mesmo comando.

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

-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, Exchange Server 2019, Exchange Online

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.