Test-MAPIConnectivity

Módulo:: Exchange PowerShell

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 ambiente ou de outro.

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.

Sintaxe

Database

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

Identity

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

Server

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 do Test-MapiConnectivity verifica indiretamente se o servidor MAPI, o armazenamento do Exchange e o DSAccess (Acesso ao Serviço de Diretório) 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.

Existem 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 artigo 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 que a operação atinja o tempo limite. O valor padrão é de 15 segundos.

Propriedades do parâmetro

Tipo:	Int32
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-AllConnectionsTimeout

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

O parâmetro AllConnectionsTimeout especifica a quantidade de tempo, em segundos, permitida para que todas as conexões sejam concluídas antes que o cmdlet atinja o tempo limite. 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 é 90 segundos.

Propriedades do parâmetro

Tipo:	Int32
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Archive

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

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

Identity

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	cf

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-CopyOnServer

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

O parâmetro CopyOnServer especifica o servidor de Caixa de Correio que contém a cópia de banco de dados específica a ser testada. É 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 Identify ou Database.

Propriedades do parâmetro

Tipo:	ServerIdParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

Database

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

Identity

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-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 especificado com o parâmetro Server).

Você não pode usar os parâmetros Identity, Database ou Server no mesmo comando.

Propriedades do parâmetro

Tipo:	DatabaseIdParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

Database

Cargo:	Named
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

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

Propriedades do parâmetro

Tipo:	Fqdn
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-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)
Domínio\Nome de usuário
Endereço de email
GUID
LegacyExchangeDN
SamAccountName
ID de usuário ou nome UPN

Este cmdlet aceita a entrada de pipeline do Get-Mailbox ou Get-Recipient cmdlet. 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 Identity, Database ou Server no mesmo comando.

Propriedades do parâmetro

Tipo:	MailboxIdParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

Identity

Cargo:	1
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-IncludePassive

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

O comutador IncludePassive testa a conectividade MAPI de todas as cópias de banco de dados ativas e passivas. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, o comando testará a conectividade MAPI somente de cópias de banco de dados ativas.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

Server

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

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

Propriedades do parâmetro

Tipo:	Boolean
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

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

Propriedades do parâmetro

Tipo:	Int32
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Server

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

O parâmetro Server especifica o servidor no qual 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 Identity, Database ou Server no mesmo comando.

Propriedades do parâmetro

Tipo:	ServerIdParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

Server

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-WhatIf

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	wi

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

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.

Comentários

Esta página foi útil?