Get-ComplianceSecurityFilter

Este cmdlet solo funciona en PowerShell de cumplimiento de seguridad & . Para obtener más información, consulte Security & Compliance PowerShell.

Use el cmdlet Get-ComplianceSecurityFilter para ver los filtros de seguridad de cumplimiento en el portal de cumplimiento Microsoft Purview. Estos filtros permiten a los usuarios especificados buscar solo un subconjunto de buzones y sitios de SharePoint Online o OneDrive para la Empresa en su organización de Microsoft 365.

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

Get-ComplianceSecurityFilter
   [-Action <ComplianceSecurityFilterActionType>]
   [-Confirm]
   [-FilterName <String>]
   [-User <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

Los filtros de seguridad de cumplimiento funcionan con búsquedas de cumplimiento en el portal de cumplimiento Microsoft Purview (cmdlets*-ComplianceSearch), no In-Place búsquedas de eDiscovery en Exchange Online (cmdlets*-MailboxSearch).

Para usar este cmdlet en PowerShell de cumplimiento de seguridad & , debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.

Ejemplos

Ejemplo 1

Get-ComplianceSecurityFilter | Format-Table -Auto FilterName,Action

En este ejemplo se devuelve una lista resumida de todos los filtros de seguridad de cumplimiento.

Ejemplo 2

Get-ComplianceSecurityFilter -FilterName "HR Filter"

En este ejemplo se devuelve información detallada sobre el filtro de seguridad de cumplimiento denominado HR Filter.

Parámetros

-Action

El parámetro Action filtra los resultados por el tipo de acción de búsqueda a la que se aplica un filtro. Los valores admitidos son:

  • Exportar: el filtro se aplica al exportar los resultados de búsqueda o prepararlos para su análisis en eDiscovery Premium.
  • Versión preliminar: el filtro se aplica al obtener una vista previa de los resultados de la búsqueda.
  • Purgar: el filtro se aplica al purgar los resultados de la búsqueda. La forma en que se eliminan los elementos se controla mediante el valor del parámetro PurgeType en el cmdlet New-ComplianceSearchAction. El valor predeterminado es SoftDelete, lo que significa que los usuarios pueden recuperar los elementos purgados hasta que expire el período de retención de elementos eliminados.
  • Búsqueda: el filtro se aplica al ejecutar una búsqueda.
  • Search: el filtro se aplica cuando se ejecuta una búsqueda.
Type:ComplianceSecurityFilterActionType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-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 2016, Exchange Server 2019, Security & Compliance

-FilterName

El parámetro FilterName especifica el nombre del filtro de seguridad de cumplimiento que desea ver. Si el valor contiene espacios, escriba el valor entre comillas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-User

El parámetro User filtra los resultados por el usuario que obtiene un filtro aplicado a sus búsquedas. Los valores válidos son:

  • La dirección de correo electrónico o el alias de un usuario.
  • El valor All.
  • El nombre de un grupo de roles.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-WhatIf

El modificador WhatIf no funciona en PowerShell de cumplimiento de seguridad & .

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