Поделиться через


Set-ComplianceSecurityFilter

Этот командлет работает только в PowerShell для обеспечения соответствия требованиям безопасности & . Дополнительные сведения см. в разделе Соответствие требованиям безопасности & PowerShell.

Используйте командлет Set-ComplianceSecurityFilter для изменения фильтров безопасности соответствия в Портал соответствия требованиям Microsoft Purview.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Set-ComplianceSecurityFilter
   -FilterName <String>
   [-Action <ComplianceSecurityFilterActionType>]
   [-Confirm]
   [-Description <String>]
   [-Filters <MultiValuedProperty>]
   [-Region <String>]
   [-Users <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Чтобы использовать этот командлет в PowerShell для соответствия требованиям безопасности & , необходимо назначить разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.

Примеры

Пример 1

$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"

$filterusers.users.add("pilarp@contoso.com")

Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.users

В этом примере пользователь pilarp@contoso.com добавляется в фильтр безопасности соответствия с именем "Фильтр пользователей Оттавы", не затрагивая других пользователей, назначенных фильтру.

Пример 2

$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"

$filterusers.users.remove("annb@contoso.com")

Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.users

В этом примере пользователь annb@contoso.com удаляется в фильтр безопасности соответствия с именем Ottawa Users Filter, не затрагивая других пользователей, назначенных фильтру.

Параметры

-Action

Параметр Action указывает тип действия поиска, к которому применяется фильтр. Допустимое значение для этого параметра — All, что означает, что фильтр применяется ко всем действиям поиска.

  • Экспорт. Фильтр применяется при экспорте результатов поиска или их подготовке к анализу в eDiscovery Premium.
  • Предварительный просмотр. Фильтр применяется при предварительном просмотре результатов поиска.
  • Очистка. Фильтр применяется при очистке результатов поиска. Порядок удаления элементов управляется значением параметра PurgeType в командлете New-ComplianceSearchAction. Значение по умолчанию — SoftDelete, что означает, что очищенные элементы могут быть восстановлены пользователями до истечения срока хранения удаленных элементов.
  • Поиск. Фильтр применяется при выполнении поиска.
  • Search. Фильтр применяется при выполнении поиска.
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

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
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

Параметр Description задает описание фильтра соответствия требованиям безопасности. Максимальная длина имени составляет 256 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").

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

Параметр FilterName определяет имя фильтра соответствия требованиям безопасности, который требуется изменить. Если значение содержит пробелы, его необходимо заключить в кавычки (").

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

Параметр Filters определяет критерии поиска для фильтра соответствия требованиям безопасности. Можно создать три различных типа фильтров, указанные ниже.

  • Фильтр почтовых ящиков. Указывает почтовые ящики, в которые могут искать назначенные пользователи. Допустимый синтаксис — Mailbox_<MailboxPropertyName>, где <MailboxPropertyName> — значение свойства почтового ящика. Например,"Mailbox_CustomAttribute10 -eq 'OttawaUsers'" позволяет пользователям выполнять поиск только в почтовых ящиках со значением OttawaUsers в свойстве CustomAttribute10. Список поддерживаемых свойств почтового ящика см . в разделе Фильтруемые свойства для параметра RecipientFilter.
  • Фильтр содержимого почтового ящика. Указывает содержимое почтового ящика, которое могут искать назначенные пользователи. Допустимый синтаксис — MailboxContent_<SearchablePropertyName>, где <SearchablePropertyName> указывает свойство языка запросов ключевых слов (KQL), которое можно указать в поиске соответствия. Например, позволяет пользователям искать только сообщения, "MailboxContent_Recipients -like 'contoso.com'" отправленные получателям в домене contoso.com. Список свойств электронной почты с возможностью поиска см. в разделе Запросы ключевых слов для обнаружения электронных данных.
  • Фильтр содержимого сайта и сайта. Существует два фильтра SharePoint Online и OneDrive для бизнеса, связанные с сайтом: Site_<SearchableSiteProperty> (указывает свойства, связанные с сайтом. Например,"Site_Path -eq 'https://contoso.sharepoint.com/sites/doctors'" позволяет пользователям искать только содержимое в семействе https://contoso.sharepoint.com/sites/doctors веб-сайтов) и SiteContent_<SearchableSiteProperty> (указывает свойства, связанные с содержимым. Например, "SiteContent_FileExtension -eq 'docx'" позволяет пользователям искать только документы Word. Список свойств сайта, доступных для поиска, см. в статье Общие сведения о свойствах для обхода и управляемых свойствах в SharePoint Server. Свойства, для которых есть отметка Да в столбце Запрашиваемый, можно использовать для создания фильтра сайтов или фильтра их содержимого.

Можно задать несколько фильтров одного типа. Например, "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

Параметр Region указывает вспомогательное расположение для клиентов с несколькими регионами для проведения поиска электронных данных. Допустимые значения:

  • APC: Asia-Pacific
  • AUS: Австралия
  • CAN: Канада
  • EUR: Европа, Ближний Восток, Африка
  • FRA: Франция
  • GBR: Соединенное Королевство
  • IND: Индия
  • JPN: Япония
  • LAM: Латинская Америка
  • NAM: Северная Америка

Если этот параметр не используется в клиенте с несколькими регионами, поиск по обнаружению электронных данных выполняется в центральном расположении.

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

Параметр Users определяет пользователей, для которых применяется этот фильтр, когда они выполняют поиск. Допустимые значения:

  • Один или несколько пользователей. Определите пользователей по их псевдониму или адресу электронной почты. Вы можете указать несколько значений, разделив их запятыми.
  • Значение All: назначает фильтр всем пользователям. Это значение можно использовать только отдельно.
  • Одна или несколько групп ролей. Определите группу ролей по ее имени. Вы можете указать несколько значений, разделив их запятыми.

Вы не можете указывать группы рассылки с этим параметром.

Указанные значения перезапишут все существующие записи. Сведения о том, как добавлять или удалять пользователей, не затрагивая другие существующие записи, см. в разделе "Примеры".

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

Параметр WhatIf не работает в PowerShell для соответствия требованиям безопасности & .

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