Set-MailboxSearch
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 Set-MailboxSearch para modificar uma pesquisa de caixa de correio existente.
Observação: a partir de outubro de 2020, os cmdlets *-MailboxSearch foram desativados no PowerShell do Exchange Online. Em vez disso, use os cmdlets *-ComplianceSearch no PowerShell de Segurança & Conformidade. Para obter mais informações, consulte Desativação de ferramentas de descoberta eletrônica herdadas.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Set-MailboxSearch
[-Identity] <SearchObjectIdParameter>
[-AllPublicFolderSources <Boolean>]
[-AllSourceMailboxes <Boolean>]
[-Confirm]
[-Description <String>]
[-DomainController <Fqdn>]
[-DoNotIncludeArchive]
[-EndDate <ExDateTime>]
[-EstimateOnly]
[-ExcludeDuplicateMessages <Boolean>]
[-Force]
[-IncludeKeywordStatistics]
[-IncludeUnsearchableItems <Boolean>]
[-InPlaceHoldEnabled <Boolean>]
[-ItemHoldPeriod <Unlimited>]
[-Language <CultureInfo>]
[-LogLevel <LoggingLevel>]
[-MessageTypes <KindKeyword[]>]
[-Name <String>]
[-Recipients <String[]>]
[-SearchDumpster <Boolean>]
[-SearchQuery <String>]
[-Senders <String[]>]
[-SourceMailboxes <RecipientIdParameter[]>]
[-StartDate <ExDateTime>]
[-StatisticsStartIndex <Int32>]
[-StatusMailRecipients <RecipientIdParameter[]>]
[-TargetMailbox <MailboxIdParameter>]
[-WhatIf]
[<CommonParameters>]
Description
No Exchange local, as pesquisas de caixa de correio são usadas para In-Place a Descoberta Eletrônica e a Retenção In-Place. Para In-Place a Descoberta Eletrônica, a menos que especificado, as caixas de correio em todos os servidores de Caixa de Correio de uma organização são pesquisadas. Para criar um In-Place Hold, você precisa especificar as caixas de correio a serem colocadas em espera usando o parâmetro SourceMailboxes. A pesquisa pode ser interrompida, iniciada, modificada e removida.
Por padrão, as pesquisas de caixa de correio são executadas em todos os servidores de Caixa de Correio do Exchange 2013 ou posterior em uma organização, a menos que você restrinja a pesquisa a menos caixas de correio usando o parâmetro SourceMailboxes. Para pesquisar caixas de correio em servidores de Caixa de Correio do Exchange 2010, execute o comando em um servidor do Exchange 2010.
Se a pesquisa de Descoberta Eletrônica In-Place que você deseja modificar estiver em execução, interrompa-a antes de usar o cmdlet Set-MailboxSearch. Ao reiniciar uma pesquisa, todos os resultados de pesquisa anteriores são removidos da caixa de correio de destino.
Para obter mais informações, consulte Descoberta Eletrônica In-loco no Exchange Server e Bloqueio In-loco e Retenção de Litígio no Exchange Server.
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
Set-MailboxSearch -Identity "Legal-ProjectX" -StartDate "01/01/2017"
Este exemplo modifica a data de início de uma pesquisa de caixa de correio.
Exemplo 2
Set-MailboxSearch -Identity "Legal-ProjectX" -AllPublicFolderSources $true
No Exchange local, este exemplo adiciona todas as pastas públicas à pesquisa de caixa de correio existente chamada Legal-ProjectX.
Observação: se quisermos colocar os resultados dessa pesquisa em In-Place Bloqueio, o parâmetro AllSourceMailboxes deve ser definido como $false. Ainda poderíamos incluir caixas de correio específicas na pesquisa usando o parâmetro SourceMailboxes.
Parâmetros
-AllPublicFolderSources
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 sã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 valor é o padrão. Você pode usar esse valor quando o valor do parâmetro AllSourceMailboxes for $trueor 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]).
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 |
-AllSourceMailboxes
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 valor é o padrão. Você pode usar esse valor quando o valor do parâmetro AllPublicFolderSources for $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]).
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 |
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para segurança local caixas de correio
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 |
-Description
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Description especifica uma descrição para a pesquisa. Se o valor contiver espaços, coloque-o entre aspas (").
Propriedades do parâmetro
| Tipo: | String |
| 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 |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 |
-DoNotIncludeArchive
Aplicável: Exchange Server 2010
A opção DoNotIncludeArchive exclui itens na caixa de correio de Arquivo Morto do usuário das pesquisas de caixa de correio. Não é preciso especificar um valor com essa opção.
Por padrão, os itens na caixa de correio de Arquivo Morto do usuário são incluídos nas pesquisas de caixa de correio.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-EndDate
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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/aaaa, 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.
Propriedades do parâmetro
| Tipo: | ExDateTime |
| 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 |
-EstimateOnly
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-ExcludeDuplicateMessages
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro ExcludeDuplicateMessages elimina a duplicação de mensagens entre 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 valor é o padrão.
- $false: Copie todas as instâncias de uma mensagem se a mesma mensagem existir em várias pastas ou caixas de correio.
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 |
-Force
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 anteriores serão removidos da caixa de correio de destino e que a pesquisa será reiniciada.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 (").
Propriedades do parâmetro
| Tipo: | SearchObjectIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IncludeKeywordStatistics
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-IncludeUnsearchableItems
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro IncludeUnsearchableItems especifica se os itens que não puderam ser indexados pela Pesquisa do Exchange devem ser incluídos nos resultados. Os valores válidos são:
- $true: Itens não pesquisáveis são incluídos nos resultados.
- $false: Itens não pesquisáveis não são incluídos nos resultados. Esse valor é o 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.
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 |
-InPlaceHoldEnabled
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para caixas de correio locais
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 retenção está ativada nos resultados da pesquisa.
- $false: In-Place retenção não está habilitada nos resultados da pesquisa. Esse valor é o 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 uma retenção, mas não especificar caixas de correio usando o parâmetro SourceMailboxes, o comando poderá ser bem-sucedido, mas as caixas de correio não serão colocadas em In-Place Espera.
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 |
-ItemHoldPeriod
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para caixas de correio locais
O parâmetro ItemHoldPeriod especifica o número de dias para a retenção de In-Place nos itens de caixa de correio (todos os itens ou os itens de caixa de correio retornados nos resultados da consulta de pesquisa). Você usa 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 valor é o padrão. Os itens serão mantidos em espera até que você remova a In-Place Retenção 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.
Propriedades do parâmetro
| Tipo: | Unlimited |
| 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 |
-Language
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Language 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 CultureInfo do Microsoft .NET Framework. Por exemplo, da-DK para dinamarquês ou ja-JP para japonês. Para obter mais informações, consulte Classe CultureInfo.
Propriedades do parâmetro
| Tipo: | CultureInfo |
| 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 |
-LogLevel
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 valor é o padrão.
- Completo: além dos detalhes no nível de log Básico, uma lista completa de todas as mensagens retornadas é incluída.
- Suprimir: o registro em log é suprimido. Nenhum log é mantido.
Propriedades do parâmetro
| Tipo: | LoggingLevel |
| 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 |
-MessageTypes
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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
- Mensagens instantâneas
- Diários
- 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.
Propriedades do parâmetro
| Tipo: | KindKeyword[] |
| 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 |
-Name
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | String |
| 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 |
-Recipients
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Destinatários especifica um ou mais destinatários incluídos 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 desmarcar os destinatários, use o valor $null.
Propriedades do parâmetro
| Tipo: | String[] |
| 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 |
-SearchDumpster
Aplicável: Exchange Server 2010
O parâmetro SearchDumpster especifica se o dumpster é pesquisado. 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 após serem excluídos de forma irreversível e antes de serem limpos da caixa de correio com base nas configurações de Retenção de Itens Excluídos.
Defina o valor como $true para habilitar a pesquisa no dumpster ou defina como $false para desabilitá-la.
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 |
-SearchQuery
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 QL por palavra-chave (KQL) 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
- Destinatários
- Remetentes
- StartDate
Propriedades do parâmetro
| Tipo: | String |
| 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 |
-Senders
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | String[] |
| 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 |
-SourceMailboxes
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 Hold nos resultados da pesquisa, você precisa definir o parâmetro AllSourceMailboxes como $false (o valor padrão) e definir 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.
Propriedades do parâmetro
| Tipo: | RecipientIdParameter[] |
| 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 |
-StartDate
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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/aaaa, 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.
Propriedades do parâmetro
| Tipo: | ExDateTime |
| 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 |
-StatisticsStartIndex
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro StatisticsStartIndex é usado pelo EAC (centro de administração do Exchange) para recuperar estatísticas de palavra-chave em uma operação paginada.
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 |
-StatusMailRecipients
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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".
Propriedades do parâmetro
| Tipo: | RecipientIdParameter[] |
| 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 |
-TargetMailbox
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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)
- Domínio\Nome de usuário
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Propriedades do parâmetro
| Tipo: | MailboxIdParameter |
| 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 |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para segurança local caixas de correio
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.