Search-Mailbox
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Search-Mailbox para pesquisar uma caixa de correio e copiar os resultados para uma caixa de correio de destino especificada, excluir mensagens da caixa de correio de origem, ou ambos.
Nota: em ambientes baseados na cloud, o cmdlet Search-Mailbox foi preterido a favor de New-ComplianceSearch e cmdlets de Deteção de Dados Eletrónicos relacionados.
Por predefinição, Search-Mailbox está disponível apenas nas funções Pesquisa de Caixa de Correio ou Importação de Caixa de Correio Exportar e estas funções não são atribuídas a nenhum grupo de funções. Para utilizar este cmdlet, tem de adicionar uma ou ambas as funções a um grupo de funções (por exemplo, o grupo de funções Gestão da Organização). Apenas a função Importar Exportação da Caixa de Correio lhe dá acesso ao parâmetro DeleteContent. Para obter mais informações sobre como adicionar funções a grupos de funções, veja Adicionar uma função a um grupo de funções.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Identity
Search-Mailbox
[-Identity] <MailboxOrMailUserIdParameter>
[-Confirm]
[-DeleteContent]
[-DomainController <Fqdn>]
[-DoNotIncludeArchive]
[-Force]
[-IncludeUnsearchableItems]
[-SearchDumpster]
[-SearchDumpsterOnly]
[-SearchQuery <String>]
[-WhatIf]
[<CommonParameters>]
EstimateResult
Search-Mailbox
[-Identity] <MailboxOrMailUserIdParameter>
[-EstimateResultOnly]
[-Confirm]
[-DomainController <Fqdn>]
[-DoNotIncludeArchive]
[-Force]
[-IncludeUnsearchableItems]
[-SearchDumpster]
[-SearchDumpsterOnly]
[-SearchQuery <String>]
[-WhatIf]
[<CommonParameters>]
Mailbox
Search-Mailbox
[-Identity] <MailboxOrMailUserIdParameter>
-TargetFolder <String>
-TargetMailbox <MailboxIdParameter>
[-Confirm]
[-DeleteContent]
[-DomainController <Fqdn>]
[-DoNotIncludeArchive]
[-Force]
[-IncludeUnsearchableItems]
[-LogLevel <LoggingLevel>]
[-LogOnly]
[-SearchDumpster]
[-SearchDumpsterOnly]
[-SearchQuery <String>]
[-WhatIf]
[<CommonParameters>]
Description
Você pode usar o cmdlet Search-Mailbox para pesquisar mensagens em uma caixa de correio especificada e desempenhar quaisquer uma das seguintes tarefas:
- Copiar mensagens para uma caixa de correio de destino especificada.
- Excluir mensagens da caixa de correio de origem. Você deve receber a atribuição de função de gerenciamento Importar Exportar Caixa de Correio para excluir mensagens.
- Desempenhar recuperação de item única para recuperar itens de uma pasta de Itens Recuperáveis do usuário.
- Limpar a pasta Itens Recuperáveis para uma caixa de correio quando ela alcançar a cota fixa de Itens Recuperáveis.
Exemplos
Exemplo 1
Search-Mailbox -Identity "Joe Healy" -SearchQuery "Subject:Project Hamilton" -TargetMailbox "DiscoveryMailbox" -TargetFolder "JoeHealy-ProjectHamilton" -LogLevel Full
Este exemplo pesquisa a caixa de correio de Joe Healy e copia os resultados da pesquisa em DiscoveryMailbox na pasta JoeHealy-ProjectHamilton.
Exemplo 2
Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -TargetMailbox "administrator" -TargetFolder "SearchAndDeleteLog" -LogOnly -LogLevel Full
Este exemplo pesquisa a caixa de correio de April Stewart em busca de mensagens que contenham a frase "Your bank statement" no assunto e registra o resultado em log na pasta SearchAndDeleteLog, na caixa de correio do administrador. As mensagens não são copiadas para a caixa de correio de destino.
Exemplo 3
Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -DeleteContent
Este exemplo pesquisa a caixa de correio de April Stewart em busca de mensagens que contenham a frase "Your bank statement" no assunto e exclui as mensagens da caixa de correio de origem. Você precisa receber a atribuição da função de gerenciamento Importar Exportar Caixa de Correio para usar a opção DeleteContent.
Exemplo 4
Get-Mailbox | Search-Mailbox -SearchQuery 'election OR candidate OR vote' -TargetMailbox "Discovery Search Mailbox" -TargetFolder "AllMailboxes-Election" -LogLevel Full
Este exemplo pesquisa todas as caixas de correio na sua organização por mensagens que contenham as palavras "election", "candidate" ou "vote". Os resultados da pesquisa serão copiados para a Caixa de Correio de Pesquisa de Descoberta na pasta AllMailboxes-Election.
Parâmetros
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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, 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 confirmar 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 |
-DeleteContent
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Nota: tem de lhe ser atribuída a função de gestão Importar Exportação da Caixa de Correio para utilizar este comutador. Por predefinição, esta função não está atribuída a nenhum grupo de funções (incluindo a Gestão da Organização). Normalmente, você pode atribuir uma função a um grupo de funções internas ou personalizadas.
A opção DeleteContent especifica que as mensagens retornadas pela pesquisa sejam permanentemente excluídas da caixa de correio de origem. Não é preciso especificar um valor com essa opção.
Quando utiliza este comutador com o parâmetro TargetMailbox, as mensagens são copiadas para a caixa de correio de destino e removidas da caixa de correio de origem. Se o nível de registro em log for definido para a pesquisa como Basic ou Full, uma caixa de correio de destino e uma pasta de destino devem ser especificadas para armazenar o log. Para excluir mensagens da caixa de correio de origem sem copiá-las para a caixa de correio de destino, não especifique os parâmetros TargetMailbox, TargetFolder e LogLevel.
Antes de usar a opção DeleteContent para excluir conteúdo, é recomendável testar parâmetros de pesquisa usando o parâmetro LogOnly, como mostra o Exemplo 2.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Mailbox
| 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 |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
A opção DoNotIncludeArchive especifica que a caixa de correio de arquivo morto do usuário não deve ser incluída na pesquisa. Não é necessário especificar um valor para esta opção.
Por padrão, a caixa de correio de arquivo morto sempre é pesquisada.
Se o arquivo de expansão automática estiver ativado para uma caixa de correio Exchange Online, apenas a caixa de correio de arquivo principal do utilizador é pesquisada. As caixas de correio de arquivo morto auxiliares não são incluídas na pesquisa.
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 |
-EstimateResultOnly
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador EstimateResultOnly devolve apenas uma estimativa do número total e do tamanho das mensagens. As mensagens não são copiadas para a caixa de correio de destino. Não é preciso especificar um valor com essa opção.
Não é possível usar essa opção com o parâmetro TargetMailbox.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
EstimateResult
| Cargo: | Named |
| Obrigatório: | True |
| 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
O comutador Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Utilize este comutador para ocultar o pedido de confirmação quando utilizar o comutador DeleteContent para eliminar mensagens permanentemente.
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
O parâmetro Identity especifica a identidade da caixa de correio de pesquisa. É 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 Utilizador
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Propriedades do parâmetro
| Tipo: | MailboxOrMailUserIdParameter |
| 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 |
-IncludeUnsearchableItems
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador IncludeUnsearchableItems inclui itens que não puderam ser indexados pela Pesquisa do Exchange nos resultados da pesquisa. 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 |
-LogLevel
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro LogLevel especifica o nível do registro em log da pesquisa. Pode ter um dos seguintes valores:
- Suprimir: não são mantidos registos.
- Básico: as informações básicas sobre a consulta e quem a executou são mantidas.
- Completo: para além das informações mantidas pelo nível de registo Básico, o nível de registo Completo adiciona uma lista completa dos resultados da pesquisa.
O nível de log padrão é Basic.
Quando incluiu este parâmetro, é criada e enviada uma mensagem de e-mail para a caixa de correio especificada pelo parâmetro TargetMailbox. O ficheiro de registo (que é um ficheiro formatado em CSV com o nome Search Results.csv) está anexado a esta mensagem de e-mail e está localizado na pasta especificada pelo parâmetro TargetFolder. O ficheiro de registo contém uma linha para cada mensagem incluída nos resultados da pesquisa quando executa o cmdlet Search-Mailbox.
Propriedades do parâmetro
| Tipo: | LoggingLevel |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Mailbox
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-LogOnly
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador LogOnly efetua uma pesquisa, mas gera apenas um registo. As mensagens retornadas pela pesquisa não são copiadas para a caixa de correio de destino. Não é preciso especificar um valor com essa opção.
O nível de registro em log é especificado usando o parâmetro LogLevel.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Mailbox
| 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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador SearchDumpster especifica se pretende incluir a pasta Itens Recuperáveis na pesquisa. A pasta Itens recuperáveis armazena itens que foram eliminados da pasta Itens Eliminados ou itens que foram eliminados até serem removidos da base de dados da caixa de correio.
Por predefinição, a pasta Itens Recuperáveis está sempre incluída na pesquisa. Para excluir a pasta Itens Recuperáveis da pesquisa, utilize esta sintaxe exata: -SearchDumpster:$false.
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 |
-SearchDumpsterOnly
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador SearchDumpsterOnly especifica que apenas a pasta Itens Recuperáveis da caixa de correio especificada é pesquisada. Não é preciso especificar um valor com essa opção.
A pasta Itens recuperáveis armazena itens que foram eliminados da pasta Itens Eliminados ou itens que foram eliminados até serem removidos da base de dados da caixa de correio.
Também é possível utilizá-la com a opção DeleteContent para excluir mensagens da pasta Itens Recuperáveis e reduzir o tamanho da pasta.
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 |
-SearchQuery
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro SearchQuery especifica uma sequência de caracteres para pesquisa ou uma consulta formatada usando a Linguagem de Consulta de Palavra-chave (KQL). Para obter mais informações sobre o KQL no Exchange, veja Propriedades da mensagem e operadores de pesquisa para In-Place Deteção de Dados Eletrónicos.
Se esse parâmetro estiver vazio, todas as mensagens serão retornadas.
Nota: o cmdlet Search-Mailbox devolve até 10 000 resultados por caixa de correio se for especificada uma consulta de pesquisa.
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 |
-TargetFolder
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro TargetFolder especifica um nome de pasta onde os resultados da pesquisa são salvos na caixa de correio de destino. A pasta é criada na caixa de correio de destino durante a execução.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Mailbox
| Cargo: | Named |
| Obrigatório: | True |
| 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
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 Utilizador
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Tem de utilizar este parâmetro com o parâmetro TargetFolder. Não é possível usar esse parâmetro com a opção EstimateResultOnly.
Propriedades do parâmetro
| Tipo: | MailboxIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Mailbox
| Cargo: | Named |
| Obrigatório: | True |
| 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
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.
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 suporta os 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.