Set-MailboxSearch

O parâmetro AllPublicFolderSources especifica se deve incluir todas as pastas públicas da organização na pesquisa. Os valores válidos são:

• $true: todas as pastas públicas estão incluídas na pesquisa. Esse valor é necessário quando o valor do parâmetro AllSourceMailboxes é $falseand você não especifica uma ou mais caixas de correio de origem usando o parâmetro SourceMailboxes (o valor do parâmetro está em branco [$null]).
• $false: nenhuma pasta pública está incluída na pesquisa. Esse é o valor padrão. Você pode usar esse valor quando o valor do parâmetro AllSourceMailboxes estiver $trueor você especificar uma ou mais caixas de correio de origem usando o parâmetro SourceMailboxes (o valor do parâmetro não está em branco [$null]).

O parâmetro AllSourceMailboxes especifica se deve incluir todas as caixas de correio na pesquisa. Os valores válidos são:

• $true: todas as caixas de correio estão incluídas na pesquisa. Esse valor é necessário quando o valor do parâmetro AllPublicFolderSources é $falseand você não especifica uma ou mais caixas de correio de origem usando o parâmetro SourceMailboxes (o valor do parâmetro está em branco [$null]).
• $false: todas as caixas de correio não estão incluídas na pesquisa. Esse é o valor padrão. Você pode usar esse valor quando o valor do parâmetro AllPublicFolderSources estiver $trueor você especificar uma ou mais caixas de correio de origem usando o parâmetro SourceMailboxes (o valor do parâmetro não está em branco [$null]).

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.

O parâmetro Description especifica uma descrição para a pesquisa. Se o valor contiver espaços, coloque-o entre aspas (").

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.

Esse parâmetro só está disponível no Exchange Server 2010.

A opção DoNotIncludeArchive exclui itens na caixa de correio Arquivo do usuário de pesquisas de caixa de correio. Não é preciso especificar um valor com essa opção.

Por padrão, os itens na caixa de correio Arquivo do usuário são incluídos em pesquisas de caixa de correio.

O parâmetro EndDate especifica a data de término do intervalo de datas.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Para limpar a data de término, use o valor $null.

A opção EstimateOnly fornece apenas uma estimativa do número de itens que serão retornados sem copiar a mensagem para a caixa de correio de destino. Não é preciso especificar um valor com essa opção.

O parâmetro ExcludeDuplicateMessages elimina a duplicação de mensagens em caixas de correio em uma pesquisa de descoberta eletrônica In-Place. Os valores válidos são:

• $true: copie uma única instância de uma mensagem se a mesma mensagem existir em várias pastas ou caixas de correio. Esse é o valor padrão.
• $false: copie todas as instâncias de uma mensagem se a mesma mensagem existir em várias pastas ou caixas de correio.

A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.

Use isso para alternar para ocultar o prompt de confirmação que indica que os resultados da pesquisa anterior serão removidos da caixa de correio de destino e que a pesquisa será reiniciada.

O parâmetro Identity especifica o nome da pesquisa de caixa de correio que você deseja modificar. Se o valor contiver espaços, coloque-o entre aspas (").

A opção IncludeKeywordStatistics retorna estatísticas de palavra-chave (número de instâncias para cada palavra-chave). Não é preciso especificar um valor com essa opção.

O parâmetro IncludeUnsearchableItems especifica se itens que não puderam ser indexados pelo Exchange Search devem ser incluídos nos resultados. Os valores válidos são:

• $true: Itens inexequíveis são incluídos nos resultados.
• $false: Itens insaquáveis não estão incluídos nos resultados. Esse é o valor padrão.

Itens não pesquisáveis não são colocados em retenção para um Bloqueio In-loco baseado em consulta. Se for necessário colocar itens não pesquisáveis em espera, você deve criar uma espera indefinida (uma espera sem a especificação de parâmetros de pesquisa) que fornece funcionalidade semelhante à retenção de litígio.

O parâmetro InPlaceHoldEnabled especifica se deve definir um Bloqueio In-loco nos itens dos resultados da pesquisa. Os valores válidos são:

• $true: In-Place Hold está habilitado nos resultados da pesquisa.
• $false: In-Place Hold não está habilitado nos resultados da pesquisa. Esse é o valor padrão.

Não é possível definir um Bloqueio In-loco nos resultados da pesquisa, quando o parâmetro AllSourceMailboxes é $true.

Se você tentar colocar um porão, mas não especificar caixas de correio usando o parâmetro SourceMailboxes, o comando poderá ter êxito, mas as caixas de correio não serão colocadas em In-Place Hold.

O parâmetro ItemHoldPeriod especifica o número de dias para o In-Place Manter nos itens da caixa de correio (todos os itens ou os itens da caixa de correio que são retornados nos resultados da consulta de pesquisa). Use esse parâmetro com o parâmetro InPlaceHoldEnabled para definir um In-Place Hold. A duração é calculada a partir do momento em que o item é recebido ou criado na caixa de correio. Os valores válidos são:

• O parâmetro SyncSchedule especifica ???. Os valores válidos para este parâmetro são:
• O valor unlimited. Esse é o valor padrão. Os itens são mantidos até que você remova o In-Place Hold removendo a pesquisa usando o cmdlet Remove-MailboxSearch, removendo a caixa de correio de origem da pesquisa usando o cmdlet Set-MailboxSearch e o parâmetro SourceMailboxes ou no Exchange local, você remove todas as pastas públicas da pesquisa usando o cmdlet Set-MailboxSearch para alterar o parâmetro AllPublicFolderSources de $true para $false.

O parâmetro Idioma especifica uma localidade para a pesquisa de caixa de correio.

A entrada válida para esse parâmetro é um valor de código de cultura com suporte da classe Microsoft .NET Framework CultureInfo. Por exemplo, da-DK para dinamarquês ou ja-JP para japonês. Para obter mais informações, consulte Classe CultureInfo.

O parâmetro LogLevel especifica um nível de log para a pesquisa de caixa de correio. Os valores válidos são:

• Básico: os detalhes básicos da pesquisa são mantidos. Esse é o valor padrão.
• Completo: Além dos detalhes no nível básico do log, uma lista completa de todas as mensagens retornadas está incluída.
• Supressão: o registro em log é suprimido. Nenhum log é mantido.

O parâmetro MessageTypes especifica os tipos de mensagem que devem ser incluídos na consulta da pesquisa. Os valores válidos são:

• Contatos
• Docs
• Email
• Mensagens instantâneas
• Revistas
• Reuniões
• Observações
• Tarefas

Vários valores, separados por vírgulas, podem ser especificados.

O valor padrão está em branco ($null), o que significa que todos os tipos de mensagem são incluídos. Para limpar todos os valores especificados, use o valor $null.

O parâmetro Name especifica um nome para a pesquisa. Se o valor contiver espaços, coloque-o entre aspas (").

O valor desse parâmetro é usado para criar uma pasta de nível superior que armazena os resultados de pesquisa na caixa de correio de destino especificada pelo parâmetro TargetMailbox.

O parâmetro Destinatários especifica que um ou mais destinatários incluem na consulta de pesquisa. As mensagens que têm os destinatários especificados nos campos Para, Cc e Cco são retornadas nos resultados da pesquisa.

Você pode especificar vários destinatários separados por vírgulas. Se o valor contiver espaços, coloque-o entre aspas (").

Para limpar os destinatários, use o valor $null.

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro SearchDumpster especifica se a lixeira é pesquisada. A lixeira é uma área de armazenamento na caixa de correio em que os itens excluídos são armazenados temporariamente após serem excluídos ou removidos da pasta Itens Excluídos ou depois de serem excluídos e antes de serem removidos da caixa de correio com base nas configurações de retenção de item excluído.

Defina o valor como $true para habilitar a pesquisa na lixeira ou defina como $false para desabilitá-lo.

O parâmetro SearchQuery especifica palavras-chave para a consulta de pesquisa usando a KQL (Linguagem de Consulta de Palavra-chave). Para obter mais informações, consulte Referência de sintaxe KQL (Linguagem de Consulta de Palavra-Chave) e consultas de palavra-chave e condições de pesquisa para descoberta eletrônica.

Quando você usa esse parâmetro com outros parâmetros de consulta de pesquisa, a consulta combina esses parâmetros usando o operador AND.

Os outros parâmetros de consulta de pesquisa são:

• EndDate
• MessageTypes
• Recipients
• Remetentes
• StartDate

O parâmetro Senders especifica um ou mais remetentes a serem incluídos na consulta da pesquisa. As mensagens com remetente especificado são retornadas nos resultados da pesquisa. Os remetentes podem incluir usuários, grupos de distribuição (mensagens enviadas por membros do grupo), endereços SMTP ou domínios.

Você pode especificar vários remetentes separados por vírgulas. Se o valor contiver espaços, coloque-o entre aspas (").

Para limpar os remetentes, use o valor $null.

O parâmetro SourceMailboxes especifica as caixas de correio a serem pesquisadas. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Nome diferenciado (DN)
• DN canônico
• GUID

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Para usar esse parâmetro, o parâmetro AllSourceMailboxes precisa ser $false (o valor padrão).

Para limpar as caixas de correio de origem, use o valor $null.

Para habilitar In-Place Manter os resultados da pesquisa, você precisa definir o parâmetro AllSourceMailboxes como $false (o valor padrão) e configurar uma ou ambas as seguintes configurações:

• Especifique uma ou mais caixas de correio de origem usando o parâmetro SourceMailboxes.
• No Exchange local, defina o parâmetro AllPublicFolderSources como $true.

O parâmetro StartDate especifica a data de início do intervalo de datas.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Para limpar a data de início, use o valor $null.

O parâmetro StatisticsStartIndex é usado pelo Centro de Administração do Exchange (EAC) para recuperar estatísticas de palavras-chave em uma operação de página.

O parâmetro StatusMailRecipients especifica um ou mais destinatários para receber uma mensagem de status de mail ao término da pesquisa. É possível usar qualquer valor que identifique o destinatário com exclusividade. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Nome diferenciado (DN)
• DN canônico
• GUID

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

O parâmetro TargetMailbox especifica a caixa de correio de destino onde os resultados da pesquisa são copiados. É 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

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.