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 |