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.