New-ComplianceSearchAction
Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Algunos parámetros y configuraciones pueden ser exclusivos de un entorno u otro.
Use el cmdlet New-ComplianceSearchAction para crear acciones para búsquedas de contenido en Exchange Server y en Microsoft Purview.
Nota: Muchos de los parámetros de este cmdlet solo funcionan en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
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
Export
New-ComplianceSearchAction
[-SearchName] <String[]>
[-Export]
[-ActionName <String>]
[-ArchiveFormat <ComplianceExportArchiveFormat>]
[-Confirm]
[-FileTypeExclusionsForUnindexedItems <String[]>]
[-EnableDedupe <Boolean>]
[-ExchangeArchiveFormat <ComplianceExportArchiveFormat>]
[-Force]
[-Format <ComplianceDataTransferFormat>]
[-IncludeCredential]
[-IncludeSharePointDocumentVersions <Boolean>]
[-JobOptions <Int32>]
[-NotifyEmail <String>]
[-NotifyEmailCC <String>]
[-ReferenceActionName <String>]
[-Region <String>]
[-Report]
[-RetentionReport]
[-RetryOnError]
[-Scenario <ComplianceSearchActionScenario>]
[-Scope <ComplianceExportScope>]
[-SearchNames <String[]>]
[-SharePointArchiveFormat <ComplianceExportArchiveFormat>]
[-ShareRootPath <String>]
[-Version <String>]
[-WhatIf]
[<CommonParameters>]
Preview
New-ComplianceSearchAction
[-SearchName] <String[]>
[-Preview]
[-ActionName <String>]
[-Confirm]
[-Force]
[-Format <ComplianceDataTransferFormat>]
[-IncludeCredential]
[-JobOptions <Int32>]
[-ReferenceActionName <String>]
[-Region <String>]
[-RetryOnError]
[-Scenario <ComplianceSearchActionScenario>]
[-SearchNames <String[]>]
[-Version <String>]
[-WhatIf]
[<CommonParameters>]
Purge
New-ComplianceSearchAction
[-SearchName] <String[]>
[-Purge]
[-PurgeType <ComplianceDestroyType>]
[-ActionName <String>]
[-Confirm]
[-Force]
[-Format <ComplianceDataTransferFormat>]
[-IncludeCredential]
[-JobOptions <Int32>]
[-Region <String>]
[-ReferenceActionName <String>]
[-RetryOnError]
[-Scenario <ComplianceSearchActionScenario>]
[-SearchNames <String[]>]
[-Version <String>]
[-WhatIf]
[<CommonParameters>]
Description
Después de crear una búsqueda de contenido con el cmdlet de New-ComplianceSearch y ejecutarla con el cmdlet Start-ComplianceSearch, asigne una acción de búsqueda a la búsqueda con el cmdlet New-ComplianceSearchAction.
En Exchange local, este cmdlet está disponible en el rol de búsqueda de buzón. De forma predeterminada, este rol solo se asigna al grupo de rol de administración de detección.
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que tiene asignados. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.
En Microsoft 365, la cuenta que use para ejecutar este cmdlet debe tener asignada una licencia válida de Microsoft 365.
Para usar este cmdlet en Security & Compliance PowerShell, debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.
Para usar este cmdlet para acciones de purga en PowerShell de seguridad & cumplimiento, debe cumplir los siguientes requisitos:
- Use la versión 3.9.0 o posterior de PowerShell de Exchange Online (agosto de 2025). Para obtener más información, consulte las novedades del módulo de PowerShell de Exchange Online. La instalación de esta versión del módulo puede requerir que desinstale versiones anteriores del módulo.
- Ejecute el comando Connect-IPPSSession con el modificador EnableSearchOnlySession .
Ejemplos
Ejemplo 1
New-ComplianceSearchAction -SearchName "Project X" -Preview
En este ejemplo se crea una acción de búsqueda de vista previa para la búsqueda de contenido denominada Project X.
Ejemplo 2
New-ComplianceSearchAction -SearchName "Project X" -Export
En este ejemplo se crea una acción de búsqueda de exportación para la búsqueda de contenido denominada Project X.
Nota: Este ejemplo solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
Ejemplo 3
New-ComplianceSearchAction -SearchName "Remove Phishing Message" -Purge -PurgeType SoftDelete
En este ejemplo se eliminan los resultados de búsqueda devueltos por una búsqueda de contenido denominada Quitar mensaje de suplantación de identidad (phishing). Los elementos no indexados no se eliminan cuando se usa el parámetro Purgar.
Ejemplo 4
New-ComplianceSearchAction -SearchName "Case 321 All Sites" -Export -SharePointArchiveFormat SingleZip -ExchangeArchiveFormat PerUserPst -Format FxStream
En este ejemplo se exportan los resultados devueltos por la búsqueda de contenido denominada "Caso 321: Todos los sitios". Los resultados de la búsqueda se comprimen y exportan a un único archivo zip. Si la búsqueda incluyó cualquier ubicación de Exchange, los resultados de la búsqueda se exportan como un archivo PST por buzón.
Nota: Este ejemplo solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
Parámetros
-ActionName
Aplicable: Seguridad & cumplimiento
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro ActionName especifica un nombre para la acción de búsqueda de contenido. Este parámetro se usa solo cuando se especifican varias búsquedas de contenido en el parámetro SearchName.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ArchiveFormat
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Este parámetro está en desuso y ya no se usa.
Para especificar el formato de los resultados de búsqueda de Exchange, utilice el parámetro ExchangeArchiveFormat. Para especificar el formato de los resultados de búsqueda de SharePoint y OneDrive, use el parámetro SharePointArchiveFormat.
Propiedades de parámetro
| Tipo: | ComplianceExportArchiveFormat |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Export
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al 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. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.
Este cmdlet tiene una pausa integrada, así que úselo -Confirm:$false para omitir la confirmación.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-EnableDedupe
Aplicable: Seguridad & cumplimiento
Este parámetro solo está disponible en el servicio basado en la nube.
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Export
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExchangeArchiveFormat
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Nota: Este parámetro solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
Este parámetro solo es funcional en el servicio basado en la nube.
Este parámetro requiere el rol de exportación en PowerShell de seguridad & cumplimiento. De forma predeterminada, este rol solo se asigna al grupo de rol Administrador de eDiscovery.
El parámetro ExchangeArchiveFormat especifica cómo exportar los resultados de búsqueda de Exchange. Los valores admitidos son:
- PerUserPst: un archivo PST para cada buzón.
- SinglePst: un archivo PST que contiene todos los mensajes exportados.
- SingleFolderPst: un archivo PST con una sola carpeta raíz para toda la exportación.
- IndividualMessage: exporte cada mensaje como un archivo .msg mensajes. Este valor es el predeterminado.
- PerUserZip: un archivo ZIP para cada buzón. Cada archivo ZIP contiene los archivos de mensajes .msg exportados del buzón.
- SingleZip: un archivo ZIP para todos los buzones. El archivo ZIP contiene todos los archivos de mensajes .msg exportados de todos los buzones. Esta configuración de salida solo está disponible en PowerShell.
Para especificar el formato de los resultados de búsqueda de SharePoint y OneDrive, use el parámetro SharePointArchiveFormat.
Propiedades de parámetro
| Tipo: | ComplianceExportArchiveFormat |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Export
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Export
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Nota: Este parámetro solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
Este parámetro solo es funcional en el servicio basado en la nube.
Este parámetro requiere el rol de exportación en PowerShell de seguridad & cumplimiento. De forma predeterminada, este rol solo se asigna al grupo de rol Administrador de eDiscovery.
El modificador Exportar especifica que la acción de la búsqueda de contenido es exportar el conjunto completo de resultados que coincidan con los criterios de búsqueda. No es necesario especificar un valor con este modificador.
Para devolver solo la información de cada uno de los elementos que se haya detectado en un informe, use el modificador Report.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Export
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-FileTypeExclusionsForUnindexedItems
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Nota: Este parámetro solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
FileTypeExclusionsForUnindexedItems especifica los tipos de archivo que se excluirán porque no se pueden indexar. Puede especificar distintos valores separados por comas.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Export
| Posición: | Named |
| Obligatorio: | False |
| 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 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.
Este modificador se puede usar para ejecutar tareas mediante programación en las que no es apropiado solicitar una entrada administrativa.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Format
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
En Security & Compliance PowerShell, este parámetro requiere el rol Exportar. De forma predeterminada, este rol solo se asigna al grupo de rol Administrador de eDiscovery.
El parámetro Format especifica el formato de los resultados de la búsqueda cuando se usa el modificador Export. Los valores admitidos son:
- FxStream: Exportar a archivos PST. Esta es la única opción disponible al exportar los resultados de la búsqueda desde el portal de cumplimiento de Microsoft Purview.
- Mime: Exportar a .eml archivos de mensajes. Este es el valor predeterminado al usar cmdlets para exportar los resultados de la búsqueda.
- Msg: Export to .msg archivos de mensajes.
Propiedades de parámetro
| Tipo: | ComplianceDataTransferFormat |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-IncludeCredential
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
El modificador IncludeCredential especifica si se incluirán las credenciales en los resultados. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-IncludeSharePointDocumentVersions
Aplicable: Seguridad & cumplimiento
Nota: Este parámetro solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro IncludeSharePointDocumentVersions especifica si se van a exportar versiones anteriores del documento cuando se usa el modificador Export. Los valores admitidos son:
- $true: Exportar todas las versiones del documento.
- $false: Exportar solo la versión publicada actual del documento. Este valor es el predeterminado.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Export
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-JobOptions
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-NotifyEmail
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Nota: Este parámetro solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
En Security & Compliance PowerShell, este parámetro requiere el rol Exportar. De forma predeterminada, esto solo se asigna al grupo de rol Administrador de eDiscovery.
El parámetro NotifyEmail especifica el destino de dirección de correo electrónico de los resultados de la búsqueda cuando se usa el modificador Export.
El destinatario que se especifique se encuentra en el campo To: del mensaje.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Export
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-NotifyEmailCC
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Nota: Este parámetro solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
En Security & Compliance PowerShell, este parámetro requiere el rol Exportar. De forma predeterminada, este rol solo se asigna al grupo de rol Administrador de eDiscovery.
El parámetro NotifyEmailCC especifica el destino de dirección de correo electrónico de los resultados de la búsqueda cuando se usa el modificador Export.
El destinatario que se especifique se encuentra en el campo Cc: del mensaje.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Export
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Preview
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Nota: Este parámetro solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
En Security & Compliance PowerShell, este parámetro requiere el rol de versión preliminar. De forma predeterminada, este rol solo se asigna al grupo de rol Administrador de eDiscovery.
El modificador de vista previa especifica que la acción de la búsqueda de contenido es obtener una vista previa de los resultados que coinciden con los criterios de búsqueda. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Preview
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Purge
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Nota: En Security & Compliance PowerShell, este modificador solo está disponible en el rol de Buscar y purgar. De forma predeterminada, este rol solo se asigna a los grupos de rol Administración de la organización e Investigador de datos.
El modificador de purga especifica que la acción de la búsqueda de contenido es quitar los elementos que coinciden con los criterios de búsqueda. No es necesario especificar un valor con este modificador.
Se puede eliminar un máximo de 10 elementos por buzón a la vez. Como la función de buscar y quitar mensajes está diseñada para ser una herramienta de respuesta a incidentes, este límite ayuda a garantizar que los mensajes se quitan rápidamente de los buzones. Esta acción no está diseñada para limpiar buzones de usuarios.
Sugerencia: Para purgar más de 10 elementos, consulte ediscoverySearch: purgeData en la API de Microsoft Graph API, que permite purgar un máximo de 100 elementos por ubicación.
Puede quitar elementos de un máximo de 50 000 buzones con una sola búsqueda de contenido. Para quitar elementos de más de 50 000 buzones, debe crear búsquedas de contenido independientes. Para obtener más información, consulte Buscar y eliminar mensajes de correo electrónico en su organización de Microsoft 365.
Los elementos no indexados no se eliminan de los buzones cuando se usa este modificador.
El valor del parámetro PurgeType controla cómo se quitan los elementos.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Purge
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PurgeType
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Nota: En Security & Compliance PowerShell, este parámetro solo está disponible en el rol Buscar y purgar. De forma predeterminada, este rol solo se asigna a los grupos de rol Administración de la organización e Investigador de datos.
El parámetro PurgeType especifica cómo quitar elementos cuando la acción es Purge. Los valores admitidos son:
- SoftDelete: los usuarios pueden recuperar los elementos purgados hasta que expire el período de retención de elementos eliminados.
- HardDelete (solo nube): los elementos purgados se marcan para su eliminación permanente del buzón y se quitan permanentemente la próxima vez que el Asistente para carpetas administradas procese el buzón. Si la recuperación de un solo elemento está habilitada en el buzón, los elementos purgados se quitarán permanentemente después de que expire el período de retención de elementos eliminados.
Propiedades de parámetro
| Tipo: | ComplianceDestroyType |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Purge
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ReferenceActionName
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Region
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Report
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Nota: Este parámetro solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
Este parámetro solo es funcional en el servicio basado en la nube.
El modificador Informe especifica que la acción de la búsqueda de contenido consiste en exportar un informe sobre los resultados (información sobre cada elemento en lugar del conjunto completo de resultados) que coinciden con los criterios de búsqueda. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Export
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RetentionReport
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Nota: Este parámetro solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
El modificador RetentionReport especifica que la acción para la búsqueda de contenido es exportar un informe de retención. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Export
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RetryOnError
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
El modificador RetryOnError especifica si se vuelve a intentar la acción en los elementos en los que se produjo un error sin volver a ejecutar la acción completa de nuevo. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Scenario
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
En Security & Compliance PowerShell, este parámetro requiere el rol de versión preliminar. De forma predeterminada, este rol solo se asigna al grupo de rol Administrador de eDiscovery.
El parámetro Scenario especifica el tipo de escenario. Los valores admitidos son:
- AnalyzeWithZoom: preparar los resultados de la búsqueda para su procesamiento en Microsoft Purview eDiscovery premium.
- General: Exporta los resultados de la búsqueda al equipo local. Los correos electrónicos se exportan a archivos .pst. Los documentos de SharePoint y OneDrive se exportan en sus formatos nativos de Office.
- GenerateReportsOnly
- Inventario
- RetentionReports
- TriagePreview
Propiedades de parámetro
| Tipo: | ComplianceSearchActionScenario |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Scope
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Nota: Este parámetro solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
El parámetro Scope especifica los elementos que se incluirán cuando la acción sea Export. Los valores admitidos son:
- IndexedItemsOnly
- UnindexedItemsOnly
- BothIndexedAndUnindexedItems
Propiedades de parámetro
| Tipo: | ComplianceExportScope |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Export
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SearchName
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
El parámetro SearchName especifica el nombre de la búsqueda de contenido existente que se asociará a la acción de búsqueda de contenido. Puede especificar varias búsquedas de contenido separadas por comas.
Puede encontrar la búsqueda de contenido ejecutando el comando Get-ComplianceSearch | Format-Table -Nombre automático, estado.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SearchNames
Aplicable: Seguridad & cumplimiento
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro SearchNames especifica los nombres de las búsquedas de contenido existentes que se asociarán a la acción de búsqueda de contenido. Separe los nombres de búsqueda de contenido con comas.
Puede encontrar nombres de búsqueda de contenido ejecutando el comando Get-ComplianceSearch | Format-Table -Nombre automático, estado.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SharePointArchiveFormat
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Nota: Este parámetro solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
Este parámetro solo es funcional en el servicio basado en la nube.
Este parámetro requiere el rol Exportar. De forma predeterminada, este rol solo se asigna al grupo de rol Administrador de eDiscovery.
El parámetro SharePointArchiveFormat especifica cómo exportar los resultados de búsqueda de SharePoint y OneDrive. Los valores admitidos son:
- IndividualMessage: Exportar los archivos sin comprimir. Este valor es el predeterminado.
- PerUserZip: un archivo ZIP para cada usuario. Cada archivo ZIP contiene los archivos exportados para el usuario.
- SingleZip: un archivo ZIP para todos los usuarios. El archivo ZIP contiene todos los archivos exportados de todos los usuarios. Esta configuración de salida solo está disponible en PowerShell.
Para especificar el formato de los resultados de búsqueda de Exchange, utilice el parámetro ExchangeArchiveFormat.
Propiedades de parámetro
| Tipo: | ComplianceExportArchiveFormat |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Export
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ShareRootPath
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parámetro solo está disponible en Exchange local.
Nota: Este parámetro solo funciona en Exchange local. Para obtener más información, consulte los cambios de mayo de 2025 en Microsoft Purview eDiscovery.
{{ Rellenar descripción de ShareRootPath }}
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Export
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Version
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| 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 2016, Exchange Server 2019, Exchange Server SE, seguridad & cumplimiento
El modificador WhatIf no funciona en Security & Compliance PowerShell.
El modificador WhatIf muestra lo que hace el comando sin realizar ningún cambio. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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.