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 o OneDrive en la 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.
Sintaxis
Default (Es el valor predeterminado).
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 Security & Compliance PowerShell, 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
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
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.
Propiedades del parámetro
| Tipo: | ComplianceSecurityFilterActionType |
| 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 |
-Confirm
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
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 |
-FilterName
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
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 (").
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 |
-User
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
El parámetro User filtra los resultados por el usuario que obtiene un filtro aplicado a sus búsquedas. Los valores admitidos son:
- La dirección de correo electrónico o el alias de un usuario.
- El valor All.
- El nombre de un grupo de roles.
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 |
-WhatIf
Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
El modificador WhatIf no funciona en Security & Compliance PowerShell.
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.