Set-ComplianceSecurityFilter
Este cmdlet solo funciona en PowerShell de cumplimiento de seguridad & . Para obtener más información, consulte Security & Compliance PowerShell.
Use el cmdlet Set-ComplianceSecurityFilter para modificar los filtros de seguridad de cumplimiento en el portal de cumplimiento Microsoft Purview.
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
Set-ComplianceSecurityFilter
-FilterName <String>
[-Action <ComplianceSecurityFilterActionType>]
[-Confirm]
[-Description <String>]
[-Filters <MultiValuedProperty>]
[-Region <String>]
[-Users <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Description
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
$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"
$filterusers.users.add("pilarp@contoso.com")
Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.usersEn este ejemplo se agrega el usuario pilarp@contoso.com al filtro de seguridad de cumplimiento denominado Filtro de usuarios de Ottawa sin afectar a otros usuarios asignados al filtro.
Ejemplo 2
$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"
$filterusers.users.remove("annb@contoso.com")
Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.usersEn este ejemplo se quita el usuario annb@contoso.com del filtro de seguridad de cumplimiento denominado Filtro de usuarios de Ottawa sin afectar a otros usuarios asignados al filtro.
Parámetros
-Action
El parámetro Action especifica ese tipo de acción de búsqueda a la que se aplica el filtro. Un valor válido para este parámetro es All, lo que significa que el filtro se aplica a todas las acciones de búsqueda.
- 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 |
-Description
El parámetro Description especifica una descripción para el filtro de seguridad de cumplimiento. La longitud máxima es de 256 caracteres. 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 |
-FilterName
El parámetro FilterName especifica el nombre del filtro de seguridad de cumplimiento que desea modificar. Si el valor contiene espacios, escriba el valor entre comillas (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-Filters
El parámetro Filters especifica los criterios de búsqueda del filtro de seguridad de cumplimiento. Puede crear tres tipos de filtros diferentes:
- Filtro de buzón: especifica los buzones que pueden buscar los usuarios asignados. La sintaxis válida es
Mailbox_<MailboxPropertyName>, donde<MailboxPropertyName>es un valor de propiedad de buzón. Por ejemplo,"Mailbox_CustomAttribute10 -eq 'OttawaUsers'"permite a los usuarios buscar solo buzones que tengan el valor OttawaUsers en la propiedad CustomAttribute10. Para obtener una lista de las propiedades de buzón admitidas, vea Propiedades filtrables para el parámetro RecipientFilter. - Filtro de contenido de buzón: especifica el contenido del buzón que los usuarios asignados pueden buscar. La sintaxis válida es
MailboxContent_<SearchablePropertyName>, donde<SearchablePropertyName>especifica una propiedad de lenguaje de consulta de palabras clave (KQL) que se puede especificar en una búsqueda de cumplimiento. Por ejemplo,"MailboxContent_Recipients -like 'contoso.com'"permite a los usuarios buscar solo los mensajes enviados a los destinatarios en el dominio contoso.com. Para obtener una lista de las propiedades de correo electrónico que se pueden buscar, vea Consultas de palabras clave para eDiscovery. - Filtro de contenido de sitio y sitio: hay dos filtros relacionados con el sitio de SharePoint Online y OneDrive para la Empresa que puede crear:
Site_<SearchableSiteProperty>(especifica las propiedades relacionadas con el sitio. Por ejemplo,"Site_Path -eq 'https://contoso.sharepoint.com/sites/doctors'"permite a los usuarios buscar solo contenido en lahttps://contoso.sharepoint.com/sites/doctorscolección de sitios) ySiteContent_<SearchableSiteProperty>(especifica propiedades relacionadas con el contenido. Por ejemplo,"SiteContent_FileExtension -eq 'docx'"permite a los usuarios buscar solo documentos de Word). Para obtener una lista de las propiedades de sitio que se pueden buscar, vea Información general sobre las propiedades rastreadas y administradas en SharePoint Server. Las propiedades marcadas con un Sí en la columna Consultable se pueden usar para crear un sitio o un filtro de contenido de sitio.
Puede especificar varios filtros del mismo tipo. Por ejemplo, "Mailbox_CustomAttribute10 -eq 'FTE' -and Mailbox_MemberOfGroup -eq '$($DG.DistinguishedName)'".
| Type: | MultiValuedProperty |
| 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 |
-Region
El parámetro Region especifica la ubicación satélite para que los inquilinos multigeográficos realicen búsquedas de exhibición de documentos electrónicos en . Los valores admitidos son:
- APC: Asia-Pacific
- AUS: Australia
- CAN: Canadá
- EUR: Europa, Oriente Medio, África
- FRA: Francia
- GBR: Reino Unido
- IND: India
- JPN: Japón
- LAM: América Latina
- NAM: Norteamérica
Si no usa este parámetro en un inquilino multigeográfico, las búsquedas de exhibición de documentos electrónicos se realizan en la ubicación central.
| 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 |
-Users
El parámetro Users especifica el usuario a cuyas búsquedas se aplica este filtro. Los valores admitidos son:
- Uno o varios usuarios: identifique a los usuarios por su alias o dirección de correo electrónico. Puede especificar distintos valores separados por comas.
- Valor All: asigna el filtro a todos los usuarios. Este valor únicamente se puede usar solo.
- Uno o varios grupos de roles: identifique el grupo de roles por su nombre. Puede especificar distintos valores separados por comas.
Con este parámetro no es posible especificar grupos de distribución.
Los valores que especifique sobrescribirán las entradas existentes. Consulte la sección Ejemplos para agregar o quitar usuarios sin que se vean afectadas otras entradas existentes.
| Type: | MultiValuedProperty |
| 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 |