Compartilhar via


Test-ExchangeSearch

 

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

Tópico modificado em: 2009-05-05

Use o cmdlet Test-ExchangeSearch para testar se a pesquisa está habilitada no momento e indexando novas mensagens de email em tempo hábil.

Sintaxe

Test-ExchangeSearch [-Identity <MailboxIdParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IndexingTimeout <Int32>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]

Test-ExchangeSearch [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IndexingTimeout <Int32>] [-MonitoringContext <$true | $false>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Test-ExchangeSearch [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IndexingTimeout <Int32>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Test-ExchangeSearch cria uma mensagem e anexo que apenas a pesquisa do Microsoft Exchange pode localizar. A menos que uma caixa de correio seja especificada no parâmetro Identity, a mensagem é armazenada na caixa de correio do Atendedor do Sistema. O comando aguarda a mensagem ser indexada e pesquisa o conteúdo. O comando relatará o êxito se o conteúdo da mensagem for localizado. O comando reportará a falha se o conteúdo não for encontrado depois de decorrido o intervalo definido no parâmetro IndexingTimeout.

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

  • Função de Administrador de Destinatários do Exchange

  • 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 Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que recupera dados do serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

O parâmetro Identity especifica o destinatário que você deseja testar com a pesquisa. Se esse parâmetro não for especificado, a caixa de correio do Atendedor do Sistema será usada.

IndexingTimeout

Optional

System.Int32

O parâmetro IndexingTimeout especifica a quantia máxima de tempo de espera entre a adição da nova mensagem de email à caixa de correio de teste e o retorno dela em um resultado de pesquisa. O valor padrão é 2 minutes. Se esse parâmetro não for especificado, o intervalo padrão será usado.

MonitoringContext

Optional

System.Boolean

O parâmetro MonitoringContext especifica um arquivo de saída XML para gravar para o Microsoft Operations Manager.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

O parâmetro Server especifica o servidor Exchange do destinatário que você usará para testar a pesquisa.

Confirm

Optional

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.

WhatIf

Optional

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 um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

Exceções

Exceções Descrição

Exemplo

Esse exemplo testa se a pesquisa está habilitada para o usuário, John@contoso.com.

Test-ExchangeSearch -Identity john@contoso.com