Set-ComplianceSecurityFilter
Этот командлет работает только в PowerShell для обеспечения соответствия требованиям безопасности &. Дополнительные сведения см. в статье PowerShell безопасности и соответствия требованиям.
Используйте командлет Set-ComplianceSecurityFilter для изменения фильтров безопасности соответствия в Портал соответствия требованиям Microsoft Purview.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
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 "Ottawa Users Filter" -Users $filterusers.users
В этом примере пользователь pilarp@contoso.com добавляется в фильтр безопасности соответствия с именем "Фильтр пользователей Оттавы", не затрагивая других пользователей, назначенных фильтру.
Пример 2
$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"
$filterusers.users.remove("annb@contoso.com")
Set-ComplianceSecurityFilter -FilterName "Ottawa Users Filter" -Users $filterusers.users
В этом примере пользователь annb@contoso.com удаляется в фильтр безопасности соответствия с именем Ottawa Users Filter, не затрагивая других пользователей, назначенных фильтру.
Параметры
-Action
Применимо: Exchange Server 2016 г., Exchange Server 2019 г. Соответствие требованиям безопасности &
Параметр Action указывает тип действия поиска, к которому применяется фильтр. Допустимое значение для этого параметра — All, что означает, что фильтр применяется ко всем действиям поиска.
- Экспорт. Фильтр применяется при экспорте результатов поиска или их подготовке к анализу в eDiscovery Premium.
- Предварительный просмотр. Фильтр применяется при предварительном просмотре результатов поиска.
- Очистка. Фильтр применяется при очистке результатов поиска. Порядок удаления элементов управляется значением параметра PurgeType в командлете New-ComplianceSearchAction. Значение по умолчанию — SoftDelete, что означает, что очищенные элементы могут быть восстановлены пользователями до истечения срока хранения удаленных элементов.
- Поиск. Фильтр применяется при выполнении поиска.
- Search. Фильтр применяется при выполнении поиска.
Свойства параметров
| Тип: | ComplianceSecurityFilterActionType |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Server 2016 г., Exchange Server 2019 г. Соответствие требованиям безопасности &
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Description
Применимо: Exchange Server 2016 г., Exchange Server 2019 г. Соответствие требованиям безопасности &
Параметр Description задает описание фильтра соответствия требованиям безопасности. Максимальная длина имени составляет 256 символов. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FilterName
Применимо: Exchange Server 2016 г., Exchange Server 2019 г. Соответствие требованиям безопасности &
Параметр FilterName определяет имя фильтра соответствия требованиям безопасности, который требуется изменить. Если значение содержит пробелы, его необходимо заключить в кавычки (").
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Filters
Применимо: Exchange Server 2016 г., Exchange Server 2019 г. Соответствие требованиям безопасности &
Параметр Filters определяет критерии поиска для фильтра соответствия требованиям безопасности. Можно создать три различных типа фильтров, указанные ниже.
- Фильтр почтовых ящиков. Указывает почтовые ящики, в которые могут искать назначенные пользователи. Допустимый синтаксис —
Mailbox_<MailboxPropertyName>, где<MailboxPropertyName>— значение свойства почтового ящика. Например,"Mailbox_CustomAttribute10 -eq 'OttawaUsers'"позволяет пользователям выполнять поиск только в почтовых ящиках со значением OttawaUsers в свойстве CustomAttribute10. Список поддерживаемых свойств почтового ящика см . в разделе Фильтруемые свойства для параметра RecipientFilter. - Фильтр содержимого почтового ящика. Указывает содержимое почтового ящика, которое могут искать назначенные пользователи. Допустимый синтаксис —
MailboxContent_<SearchablePropertyName>, где<SearchablePropertyName>указывает свойство языка запросов ключевых слов (KQL), которое можно указать в поиске соответствия. Например, позволяет пользователям искать только сообщения,"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)'".
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Region
Применимо: Exchange Server 2016 г., Exchange Server 2019 г. Соответствие требованиям безопасности &
Параметр Region указывает вспомогательное расположение для клиентов с несколькими регионами для проведения поиска электронных данных. Допустимые значения:
- APC: Asia-Pacific
- AUS: Австралия
- CAN: Канада
- EUR: Европа, Ближний Восток, Африка
- FRA: Франция
- GBR: Соединенное Королевство
- IND: Индия
- JPN: Япония
- LAM: Латинская Америка
- NAM: Северная Америка
Если этот параметр не используется в клиенте с несколькими регионами, поиск по обнаружению электронных данных выполняется в центральном расположении.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Users
Применимо: Exchange Server 2016 г., Exchange Server 2019 г. Соответствие требованиям безопасности &
Параметр Users определяет пользователей, для которых применяется этот фильтр, когда они выполняют поиск. Допустимые значения:
- Один или несколько пользователей. Определите пользователей по их псевдониму или адресу электронной почты. Вы можете указать несколько значений, разделив их запятыми.
- Значение All: назначает фильтр всем пользователям. Это значение можно использовать только отдельно.
- Одна или несколько групп ролей. Определите группу ролей по ее имени. Вы можете указать несколько значений, разделив их запятыми.
Вы не можете указывать группы рассылки с этим параметром.
Указанные значения перезаписывают все существующие записи. Сведения о том, как добавлять или удалять пользователей, не затрагивая другие существующие записи, см. в разделе "Примеры".
Свойства параметров
| Тип: | MultiValuedProperty |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2016 г., Exchange Server 2019 г. Соответствие требованиям безопасности &
Параметр WhatIf не поддерживается в PowerShell безопасности и соответствия требованиям.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.