Compartir a través de


Search-Mailbox

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet Search-Mailbox para buscar un buzón y copiar los resultados en un buzón de destino especificado, eliminar mensajes del buzón de origen, o ambas cosas.

Nota: En entornos basados en la nube, el cmdlet Search-Mailbox está en desuso a favor de New-ComplianceSearch y los cmdlets de eDiscovery relacionados.

De forma predeterminada, Search-Mailbox solo está disponible en los roles De búsqueda de buzón o Exportación de importación de buzones, y estos roles no se asignan a ningún grupo de roles. Para usar este cmdlet, debe agregar uno o ambos roles a un grupo de roles (por ejemplo, el grupo de roles Administración de la organización). Solo el rol Exportación de importación de buzón le proporciona acceso al parámetro DeleteContent. Para obtener más información sobre cómo agregar roles a grupos de roles, vea Agregar un rol a un grupo de roles.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Search-Mailbox
      [-Identity] <MailboxOrMailUserIdParameter>
      [-Confirm]
      [-DeleteContent]
      [-DomainController <Fqdn>]
      [-DoNotIncludeArchive]
      [-Force]
      [-IncludeUnsearchableItems]
      [-SearchDumpster]
      [-SearchDumpsterOnly]
      [-SearchQuery <String>]
      [-WhatIf]
      [<CommonParameters>]
Search-Mailbox
      [-Identity] <MailboxOrMailUserIdParameter>
      [-EstimateResultOnly]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-DoNotIncludeArchive]
      [-Force]
      [-IncludeUnsearchableItems]
      [-SearchDumpster]
      [-SearchDumpsterOnly]
      [-SearchQuery <String>]
      [-WhatIf]
      [<CommonParameters>]
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

Puede usar el cmdlet Search-Mailbox para buscar mensajes en un buzón especificado y realizar cualquiera de las siguientes tareas:

  • Copiar mensajes en un buzón de destino especificado.
  • Eliminar mensajes del buzón de origen. Para eliminar mensajes, debe tener asignado el rol de administración Importar o exportar buzones.
  • Realizar la recuperación de un solo elemento para recuperar elementos de una carpeta de elementos recuperables del usuario.
  • Limpiar la carpeta de elementos recuperables de un buzón cuando ha alcanzado la cuota máxima de elementos recuperables.

Ejemplos

Ejemplo 1

Search-Mailbox -Identity "Joe Healy" -SearchQuery "Subject:Project Hamilton" -TargetMailbox "DiscoveryMailbox" -TargetFolder "JoeHealy-ProjectHamilton" -LogLevel Full

En este ejemplo se hace una búsqueda en el buzón de correo de Antonio Bermejo y se copian los resultados de la búsqueda en DiscoveryMailbox en la carpeta AntonioBermejo-ProyectoHamilton.

Ejemplo 2

Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -TargetMailbox "administrator" -TargetFolder "SearchAndDeleteLog" -LogOnly -LogLevel Full

En este ejemplo, se buscan mensajes que contengan la frase "Su extracto bancario" en el asunto en el buzón de correo de Yolanda Sánchez y se registra el resultado en la carpeta SearchAndDeleteLog en el buzón de correo del administrador. Los mensajes no se copian en el buzón de correo de destino.

Ejemplo 3

Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -DeleteContent

En este ejemplo, se buscan mensajes que contengan la frase "Su extracto bancario" en el asunto en el buzón de correo de Yolanda Sánchez y se eliminan los mensajes del buzón de correo de origen. Para usar el modificador DeleteContent, debe tener asignado el rol de administración Importar o exportar buzones.

Ejemplo 4

Get-Mailbox | Search-Mailbox -SearchQuery 'election OR candidate OR vote' -TargetMailbox "Discovery Search Mailbox" -TargetFolder "AllMailboxes-Election" -LogLevel Full

En este ejemplo se busca en todos los buzones de correo de la organización mensajes que contengan las palabras "elecciones", "candidato" o "voto". Los resultados de la búsqueda se copian en el buzón de búsqueda de detección en la carpeta TodosLosBuzones-Elecciones.

Parámetros

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DeleteContent

Nota: Debe tener asignado el rol de administración De exportación de importación de buzones para usar este modificador. De forma predeterminada, este rol no se asigna a ningún grupo de roles (incluida la administración de la organización). Normalmente, se asigna un rol a un grupo de roles integrado o personalizado.

El modificador DeleteContent especifica que los mensajes devueltos por la búsqueda se eliminarán permanentemente del buzón de correo de origen. No es necesario especificar un valor con este modificador.

Cuando se usa este modificador con el parámetro TargetMailbox, los mensajes se copian en el buzón de correo de destino y se quitan del buzón de origen. Si el nivel de registro de la búsqueda se establece en Basic o Full, debe especificar un buzón de destino y una carpeta de destino para colocar el registro. Para eliminar mensajes del buzón de origen sin copiarlos en el buzón de destino, no especifique los parámetros TargetMailbox, TargetFolder y LogLevel.

Antes de usar el modificador DeleteContent para eliminar el contenido, se recomienda probar los parámetros de búsqueda mediante el parámetro LogOnly, como se muestra en el Ejemplo 2.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Este parámetro solo está disponible en Exchange local.

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DoNotIncludeArchive

El modificador DoNotIncludeArchive especifica que el buzón del archivo del usuario no se debe incluir en la búsqueda. No es necesario especificar un valor para este modificador.

De forma predeterminada, siempre se busca en el buzón de archivo.

Si el archivado de expansión automática está habilitado para un buzón de Exchange Online, solo se busca en el buzón de archivo principal del usuario. No se incluyen los buzones de archivo auxiliares en la búsqueda.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-EstimateResultOnly

El modificador EstimateResultOnly solo devuelve una estimación del número total y el tamaño de los mensajes. Los mensajes no se copian en el buzón de correo de destino. No es necesario especificar un valor con este modificador.

No puede usar este modificador con el parámetro TargetMailbox.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Force

El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.

Use este modificador para ocultar el símbolo del sistema de confirmación cuando use el modificador DeleteContent para eliminar mensajes de forma permanente.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

El parámetro Identity especifica la identidad del buzón de correo que se desea buscar. Es posible usar cualquier valor que identifique exclusivamente el buzón. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • Dominio\Nombre de usuario
  • Dirección de correo electrónico
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuario o nombre de la entidad de seguridad de usuario (UPN)
Type:MailboxOrMailUserIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeUnsearchableItems

El modificador IncludeUnsearchableItems incluye elementos que búsqueda de Exchange no pudo indexar en los resultados de la búsqueda. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-LogLevel

El parámetro LogLevel especifica el nivel de registro para la búsqueda. Puede tener uno de los siguientes valores:

  • Suprimir: no se conservan registros.
  • Básico: se conserva información básica sobre la consulta y quién la ejecutó.
  • Completo: además de la información que mantiene el nivel de registro básico, el nivel de registro completo agrega una lista completa de resultados de búsqueda.

El nivel de registro predeterminado es Basic.

Cuando se incluye este parámetro, se crea un mensaje de correo electrónico y se envía al buzón especificado por el parámetro TargetMailbox. El archivo de registro (que es un archivo con formato CSV denominado Search Results.csv) se adjunta a este mensaje de correo electrónico y se ubicará en la carpeta especificada por el parámetro TargetFolder. El archivo de registro contiene una fila por cada mensaje incluido en los resultados de la búsqueda al ejecutar el cmdlet Search-Mailbox.

Type:LoggingLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-LogOnly

El modificador LogOnly realiza una búsqueda, pero solo genera un registro. Los mensajes devueltos por la búsqueda no se copian en el buzón de correo de destino. No es necesario especificar un valor con este modificador.

El nivel de registro se especifica mediante el parámetro LogLevel.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SearchDumpster

El modificador SearchDumpster especifica si se debe incluir la carpeta Elementos recuperables en la búsqueda. La carpeta Elementos recuperables almacena los elementos que se eliminaron de la carpeta Elementos eliminados o elementos que se eliminaron de forma rígida hasta que se purgan de la base de datos del buzón de correo.

De forma predeterminada, la carpeta Elementos recuperables siempre se incluye en la búsqueda. Para excluir la carpeta Elementos recuperables de la búsqueda, use esta sintaxis exacta: -SearchDumpster:$false.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SearchDumpsterOnly

El modificador SearchDumpsterOnly especifica que solo se busca en la carpeta Elementos recuperables del buzón especificado. No es necesario especificar un valor con este modificador.

La carpeta Elementos recuperables almacena los elementos que se eliminaron de la carpeta Elementos eliminados o elementos que se eliminaron de forma rígida hasta que se purgan de la base de datos del buzón de correo.

También se puede usar el modificador DeleteContent para eliminar los mensajes de la carpeta Elementos recuperables y reducir el tamaño de la carpeta.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SearchQuery

El parámetro SearchQuery especifica una cadena de búsqueda o una consulta con formato usando el idioma de consulta de palabra clave (KQL). Para obtener más información sobre KQL en Exchange, vea Propiedades de mensajes y operadores de búsqueda para In-Place eDiscovery.

Si este parámetro está vacío, se devuelven todos los mensajes.

Nota: El cmdlet Search-Mailbox devuelve hasta 10000 resultados por buzón si se especifica una consulta de búsqueda.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetFolder

El parámetro TargetFolder especifica un nombre de carpeta donde se guardarán los resultados de la búsqueda en el buzón de correo de destino. La carpeta se crea en el buzón de correo de destino tras la ejecución.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetMailbox

El parámetro TargetMailbox especifica el buzón de destino donde se copian los resultados de la búsqueda. Es posible usar cualquier valor que identifique exclusivamente el buzón. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • Dominio\Nombre de usuario
  • Dirección de correo electrónico
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuario o nombre de la entidad de seguridad de usuario (UPN)

Debe usar este parámetro con el parámetro TargetFolder. No puede usar este parámetro con el modificador EstimateResultOnly.

Type:MailboxIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.