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:

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.