Set-ComplianceSecurityFilter

Синтаксис

Default (По умолчанию)

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

Описание

Примеры

Пример 1

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

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

Set-ComplianceSecurityFilter -FilterName "Ottawa Users Filter" -Users $filterusers.users

Пример 2

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

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

Set-ComplianceSecurityFilter -FilterName "Ottawa Users Filter" -Users $filterusers.users

Параметры

-Action

Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям

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

• Экспорт: фильтр применяется при экспорте результатов поиска или их подготовке к анализу в eDiscovery Premium.
• Предварительный просмотр: фильтр применяется при предварительном просмотре результатов поиска.
• Очистка: фильтр применяется при удалении результатов поиска. Способ удаления элементов контролируется значением параметра PurgeType в New-ComplianceSearchAction командлете. Значение по умолчанию — SoftDelete, что означает, что удаленные элементы могут быть восстановлены пользователями до истечения срока хранения удаленных элементов.
• Поиск: фильтр применяется при выполнении поиска.
• Search. Фильтр применяется при выполнении поиска.

Свойства параметров

Наборы параметров

-Confirm

Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям

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

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

Свойства параметров

Наборы параметров

-Description

Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям

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

Свойства параметров

Наборы параметров

-FilterName

Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям

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

Свойства параметров

Наборы параметров

-Filters

Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям

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

• Фильтр почтовых ящиков: указывает почтовые ящики, в которых назначенные пользователи могут выполнять поиск. Допустимый синтаксис: Mailbox_<MailboxPropertyName>, где <MailboxPropertyName> — значение свойства почтового ящика. Например,"Mailbox_CustomAttribute10 -eq 'OttawaUsers'" позволяет пользователям искать только почтовые ящики, которые имеют значение OttawaUsers в свойстве CustomAttribute10. Список поддерживаемых свойств почтового ящика см. в разделе "Фильтруемые свойства" для параметра RecipientFilter.
• Фильтр содержимого почтового ящика: указывает содержимое почтового ящика, которое могут искать назначенные пользователи. Допустимый синтаксис — MailboxContent_<SearchablePropertyName>здесь <SearchablePropertyName> указывается свойство KQL, язык KeyQL, которое можно указать при поиске соответствия требованиям. Например, позволяет пользователям искать сообщения, "MailboxContent_Recipients -like 'contoso.com'" отправленные получателям только в домене contoso.com. Список свойств электронной почты, доступных для поиска, см. в статье Запросы по ключевым словам для обнаружения электронных данных.
• Сайт и фильтр контента сайта: Существует два фильтра, связанных с сайтами в SharePoint и 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)'".

Свойства параметров

Наборы параметров

-Region

Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям

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

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

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

Свойства параметров

Наборы параметров

-Users

Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям

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

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

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

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

Свойства параметров

Наборы параметров

-WhatIf

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

Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.

Свойства параметров

Наборы параметров

CommonParameters