Search-Mailbox
Este cmdlet solo está disponible en el entorno local de Exchange.
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 ha quedado 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.
Sintaxis
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
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
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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, los 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 otros cmdlets (por ejemplo, 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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DeleteContent
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Mailbox
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
Identity
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DomainController
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | Fqdn |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DoNotIncludeArchive
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-EstimateResultOnly
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
EstimateResult
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Force
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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)
Propiedades del parámetro
| Tipo: | MailboxOrMailUserIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-IncludeUnsearchableItems
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-LogLevel
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Al incluir 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 encuentra 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.
Propiedades del parámetro
| Tipo: | LoggingLevel |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Mailbox
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-LogOnly
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Mailbox
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SearchDumpster
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SearchDumpsterOnly
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SearchQuery
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-TargetFolder
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Mailbox
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-TargetMailbox
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | MailboxIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Mailbox
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.
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.