Set-ComplianceSecurityFilter

Este cmdlet solo está disponible o funciona en PowerShell & Centro de seguridad y cumplimiento. Para obtener más información, consulte PowerShell del Centro de seguridad y cumplimiento.

Use el cmdlet Set-ComplianceSecurityFilter para modificar los filtros de seguridad de cumplimiento en el Centro de & cumplimiento.

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

Necesita que se le asignen permisos en el Centro de seguridad y cumplimiento para poder usar este cmdlet. Para más información, consulte Permisos en el Centro de seguridad y cumplimiento.

Ejemplos

Ejemplo 1

$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"
$filterusers.users.add("pilarp@contoso.com")
Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.users

En este ejemplo se agrega al usuario pilarp@contoso.com al filtro de seguridad de cumplimiento denominado Ottawa Users Filter sin que ello afecte 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.users

En este ejemplo se quita al usuario annb@contoso.com del filtro de seguridad de cumplimiento denominado Ottawa Users Filter sin que ello afecte a otros usuarios asignados al filtro.

Parámetros

-Action

El parámetro Action especifica el tipo de acción de búsqueda al que se aplica el filtro. Los valores válidos son:

  • Exportar: el filtro se aplica al exportar los resultados de la búsqueda o al prepararlos para su análisis en eDiscovery avanzado de Microsoft 365.
  • Vista previa: el filtro se aplica al obtener una vista previa de los resultados de la búsqueda.
  • Purga: el filtro se aplica al depurar los resultados de la búsqueda. El modo en que se eliminan los elementos se controla mediante el valor del parámetro PurgeType en New-ComplianceSearchAction cmdlet. 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-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, 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-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 Mailbox_<MailboxPropertyName> es , donde es un valor de propiedad de <MailboxPropertyName> buzón. Por ejemplo, permite a los usuarios buscar solo en buzones que tengan "Mailbox_CustomAttribute10 -eq 'OttawaUsers'" el valor OttawaUsers en la propiedad CustomAttribute10. Para obtener una lista de las propiedades de buzón admitidas, vea Filterable properties for the RecipientFilter parameter.
  • Filtro de contenido de buzón: especifica el contenido del buzón que pueden buscar los usuarios asignados. La sintaxis válida es , donde especifica una propiedad del lenguaje de consulta de palabras clave (KQL) que se puede MailboxContent_<SearchablePropertyName>:<value> especificar en una búsqueda de <SearchablePropertyName> cumplimiento. Por ejemplo, MailboxContent_recipients:contoso.com permite que los usuarios solo busquen mensajes enviados a destinatarios del contoso.com dominio. Para obtener una lista de propiedades de mensaje que se pueden buscar, vea Consultas de palabras clave para búsqueda de cumplimiento.
  • Filtro de contenido de sitio y sitio: hay dos filtros relacionados con sitios de SharePoint Online y OneDrive para la Empresa que puede crear: (especifica las propiedades Site_<SearchableSiteProperty> relacionadas con el sitio. Por ejemplo, permite que los usuarios solo busquen contenido en la colección de sitios) y (especifica propiedades "Site_Path -eq 'https://contoso.sharepoint.com/sites/doctors'" https://contoso.sharepoint.com/sites/doctors relacionadas con el SiteContent_<SearchableSiteProperty> contenido. Por ejemplo, "SiteContent_FileExtension -eq 'docx'" permite que los usuarios solo busquen documentos de Word. Para obtener una lista de las propiedades de sitio que se pueden buscar, vea Información general sobre las propiedades administradas y rastreadas 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-Region

El parámetro Region especifica la ubicación satélite para que los inquilinos multigemicos realicen búsquedas de exhibición de documentos electrónicos. Los valores válidos son:

  • APC: Asia-Pacific
  • AUS: Australia
  • CAN: Canada
  • 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 multigemico, las búsquedas de exhibición de documentos electrónicos se realizan en la ubicación central.

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

El parámetro Users especifica el usuario a cuyas búsquedas se aplica este filtro. Los valores válidos son:

  • Uno o más usuarios: identificar a los usuarios por su alias o dirección de correo electrónico. Puede especificar distintos valores separados por comas.
  • El valor All: asigna el filtro a todos los usuarios. Este valor únicamente se puede usar solo.
  • Uno o más 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance Center
-WhatIf

El modificador WhatIf no funciona en el PowerShell del Centro de seguridad y cumplimiento.

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

Entradas

Salidas