Set-ComplianceSecurityFilter

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2016, Exchange Server 2019, Security & Compliance

Этот командлет работает только в 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

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