Set-ComplianceSearch
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.
Используйте командлет Set-ComplianceSearch, чтобы изменить не выполняющийся поиск соответствия требованиям в Exchange Server 2016 г. или более поздней версии и в Портал соответствия требованиям Microsoft Purview.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Set-ComplianceSearch
[-Identity] <ComplianceSearchIdParameter>
[-AddExchangeLocation <String[]>]
[-AddExchangeLocationExclusion <String[]>]
[-AddSharePointLocation <String[]>]
[-AddSharePointLocationExclusion <String[]>]
[-AllowNotFoundExchangeLocationsEnabled <Boolean>]
[-Confirm]
[-ContentMatchQuery <String>]
[-Description <String>]
[-ExchangeLocation <String[]>]
[-ExchangeLocationExclusion <String[]>]
[-Force]
[-HoldNames <String[]>]
[-IncludeOrgContent <Boolean>]
[-IncludeUserAppContent <Boolean>]
[-Language <CultureInfo>]
[-Name <String>]
[-PublicFolderLocation <String[]>]
[-RefinerNames <String[]>]
[-RemoveExchangeLocation <String[]>]
[-RemoveExchangeLocationExclusion <String[]>]
[-RemovePublicFolderLocation <String[]>]
[-RemoveSharePointLocation <String[]>]
[-RemoveSharePointLocationExclusion <String[]>]
[-SharePointLocation <String[]>]
[-SharePointLocationExclusion <String[]>]
[-WhatIf]
[<CommonParameters>] Описание
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
В локальной среде Exchange этот командлет доступен в роли поиска почтовых ящиков. По умолчанию эта роль назначается только группе ролей Управление обнаружением.
Чтобы использовать этот командлет в PowerShell для соответствия требованиям безопасности & , необходимо назначить разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
Set-ComplianceSearch -Identity "Project X" -ExchangeLocation AllВ этом примере изменяется существующий поиск соответствия с именем Project X. Область поиска Exchange изменяется для всех почтовых ящиков.
Пример 2
Set-ComplianceSearch -Identity "Contoso Case Search 1" -HoldNames All -ExchangeLocation $null -SharePointLocation $nullВ этом примере изменяется существующий поиск соответствия требованиям, связанный с делом обнаружения электронных данных в Портал соответствия требованиям Microsoft Purview. Область поиска меняется с поиска выбранных почтовых ящиков и сайтов SharePoint на поиск всех расположений контента, которые были помещены на удержание в случае обнаружения электронных данных.
Пример 3
Set-ComplianceSearch -Identity "China Subsidiary Search" -Language zh-CNВ этом примере параметр языка для существующего поиска соответствия требованиям изменяется на китайский.
Если в поисковом запросе используются ключевые слова, отличные от английского, может потребоваться изменить параметр языка (который указан в параметре ContentMatchQuery).
Параметры
-AddExchangeLocation
Параметр AddExchangeLocation указывает почтовые ящики, добавляемые в список включенных почтовых ящиков, если для параметра ExchangeLocation не используется значение All. Допустимые значения:
- Обычный почтовый ящик пользователя. Включение других типов почтовых ящиков (например, неактивных почтовых ящиков или Майкрософт 365 гостевых пользователей) управляется параметром AllowNotFoundExchangeLocationsEnabled.
- Почтовый ящик
Чтобы указать почтовый ящик или группу рассылки, используйте адрес электронной почты. Вы можете указать несколько значений, разделив их запятыми.
| 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 |
-AddExchangeLocationExclusion
Этот параметр работает только в локальной среде Exchange.
Этот параметр указывает почтовые ящики, добавляемые в список исключенных почтовых ящиков при использовании значения All для параметра ExchangeLocation. Допустимые значения:
- Обычный почтовый ящик пользователя. Включение других типов почтовых ящиков (например, неактивных почтовых ящиков или Майкрософт 365 гостевых пользователей) управляется параметром AllowNotFoundExchangeLocationsEnabled.
- Почтовый ящик
Чтобы указать почтовый ящик или группу рассылки, используйте адрес электронной почты. Вы можете указать несколько значений, разделив их запятыми.
| 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 |
-AddSharePointLocation
Этот параметр доступен только в облачной службе.
Параметр AddSharePointLocation указывает сайты SharePoint Online, добавляемые в список включенных сайтов, если для параметра SharePointLocation не используется значение All. Чтобы добавить сайт, укажите его URL-адрес.
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddSharePointLocationExclusion
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AllowNotFoundExchangeLocationsEnabled
Параметр AllowNotFoundExchangeLocationsEnabled указывает, следует ли включать почтовые ящики, отличные от обычных почтовых ящиков пользователей, в поиск соответствия требованиям. Допустимые значения:
- $true. Поиск не пытается проверить существование почтового ящика перед продолжением. Это значение является обязательным, если требуется выполнить поиск в почтовых ящиках, которые не разрешаются как обычные почтовые ящики.
- $true. Если указать почтовый ящик, который не является обычным почтовым ящиком пользователя, поиск завершится ошибкой. Это значение используется по умолчанию.
К типам почтовых ящиков, на которые влияет значение этого параметра, относятся:
- Неактивные почтовые ящики
- Пользователи без лицензии Exchange Online, которые используют приложения Office
- Гостевые пользователи
- Локальные пользователи, удостоверения которых синхронизированы с вашей Майкрософт 365 организации
| Type: | Boolean |
| 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 |
-ContentMatchQuery
Параметр ContentMatchQuery указывает фильтр поиска контента.
Этот параметр использует строку текстового поиска или запрос, созданный с использованием языка запросов по ключевым словам (KQL). Дополнительные сведения см. в статье Справочник по синтаксису языка запросов ключевых слов (KQL) и Запросы ключевых слов и условия поиска для обнаружения электронных данных.
| 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 |
-Description
Параметр Description задает описание для поиска соответствия требованиям. Если значение содержит пробелы, его необходимо заключить в кавычки.
| 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 |
-ExchangeLocation
Параметр ExchangeLocation указывает почтовые ящики для включения. Допустимые значения:
- Обычный почтовый ящик пользователя. Включение других типов почтовых ящиков (например, неактивных почтовых ящиков или Майкрософт 365 гостевых пользователей) управляется параметром AllowNotFoundExchangeLocationsEnabled.
- Почтовый ящик
- Значение All для всех почтовых ящиков. Это значение можно использовать только отдельно.
Чтобы указать почтовый ящик или группу рассылки, используйте адрес электронной почты. Вы можете указать несколько значений, разделив их запятыми.
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| 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 |
-ExchangeLocationExclusion
Этот параметр работает только в локальной среде Exchange.
Этот параметр указывает почтовые ящики, которые следует исключить при использовании значения All для параметра ExchangeLocation. Допустимые значения:
- Обычный почтовый ящик пользователя. Включение других типов почтовых ящиков (например, неактивных почтовых ящиков или Майкрософт 365 гостевых пользователей) управляется параметром AllowNotFoundExchangeLocationsEnabled.
- Почтовый ящик
Чтобы указать почтовый ящик или группу рассылки, используйте адрес электронной почты. Вы можете указать несколько значений, разделив их запятыми.
| 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 |
-Force
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.
| Type: | SwitchParameter |
| 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 |
-HoldNames
Этот параметр доступен только в облачной службе.
Параметр HoldNames указывает, что будет выполнен поиск в расположениях содержимого, которые были помещены на удержание в случае обнаружения электронных данных. Вы используете для этого параметра значение All. Этот параметр можно использовать только при выполнении поиска соответствия требованиям, связанного с делом обнаружения электронных данных.
Если расположения содержимого в поиске соответствия требованиям включают почтовые ящики, необходимо также использовать параметр ExchangeLocation со значением $null. Аналогичным образом, если поиск по соответствию включает сайты SharePoint, необходимо также использовать параметр SharePointLocation со значением $null.
Кроме того, если расположение содержимого было помещено на удержание дела на основе запроса, при перезапуске поиска соответствия требованиям поиск будет выполняться только среди тех элементов, которые находятся на удержании. Например, если пользователь был помещен на удержание дела на основе запроса, при котором сохраняются элементы, отправленные или созданные до определенной даты, поиск будет выполняться только среди этих элементов по критериям, которые определены этим поиском соответствия.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Identity
Параметр Identity определяет запрос на поиск для обеспечения соответствия, который требуется изменить.
Этот параметр необходимо использовать с параметром Identity, но значение игнорируется. Например, используйте значение 000 для параметра Identity.
- Имя
- JobRunId (GUID)
JobRunId (GUID)
| Type: | ComplianceSearchIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-IncludeOrgContent
{{ Fill IncludeOrgContent Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IncludeUserAppContent
Этот параметр доступен только в облачной службе.
Параметр IncludeUserAppContent указывает, что вы хотите искать в облачном хранилище пользователей, у которых в организации нет обычной учетной записи Майкрософт 365. Эти типы пользователей включают пользователей без лицензии на Exchange Online, которые используют приложения Office, Майкрософт 365 гостевых пользователей и локальных пользователей, удостоверения которых синхронизируются с вашей организацией Майкрософт 365. Допустимые значения:
- $true. В поиск будет включено облачное хранилище для пользователей, указанных в любом из параметров расположения Exchange. Если для параметра ExchangeLocation используется значение All, в поиск будет включено облачное хранилище для любого гостевого или локального пользователя.
- $false. Расположение облачного хранилища для пользователей, указанных в параметре ExchangeLocation, не будет включаться в поиск. Это значение используется по умолчанию.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Language
Параметр Language указывает язык, который будет использоваться при поиске для обеспечения соответствия требованиям.
Допустимые входные данные для этого параметра — это поддерживаемое значение кода языка и региональных параметров из класса Майкрософт платформа .NET Framework CultureInfo. Например, da-DK для датского языка или ja-JP для японского. Дополнительные сведения см. в разделе Класс CultureInfo.
| Type: | CultureInfo |
| 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 |
-Name
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| 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 |
-PublicFolderLocation
Этот параметр доступен только в облачной службе.
Параметр PublicFolderLocation указывает, что в поиск необходимо включить все общедоступные папки. Для этого параметра используется значение All.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RefinerNames
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveExchangeLocation
Параметр RemoveExchangeLocation указывает почтовые ящики, которые нужно удалить из списка включенных почтовых ящиков, если для параметра ExchangeLocation не используется значение All. Допустимые значения:
- Этот параметр указывает почтовые ящики, удаляемые из списка исключенных почтовых ящиков, когда для параметра ExchangeLocation используется значение All. Допускаются следующие значения:
- Почтовый ящик
Чтобы указать почтовый ящик или группу рассылки, используйте адрес электронной почты. Вы можете указать несколько значений, разделив их запятыми.
| 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 |
-RemoveExchangeLocationExclusion
Этот параметр работает только в локальной среде Exchange.
Этот параметр указывает почтовые ящики, которые необходимо удалить из списка исключенных почтовых ящиков при использовании значения All для параметра ExchangeLocation. Допустимые значения:
- Этот параметр указывает почтовые ящики, удаляемые из списка исключенных почтовых ящиков, когда для параметра ExchangeLocation используется значение All. Допускаются следующие значения:
- Почтовый ящик
Чтобы указать почтовый ящик или группу рассылки, используйте адрес электронной почты. Вы можете указать несколько значений, разделив их запятыми.
| 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 |
-RemovePublicFolderLocation
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSharePointLocation
Этот параметр доступен только в облачной службе.
Параметр RemoveSharePointLocation указывает сайты SharePoint Online, которые нужно удалить из списка включенных сайтов, если для параметра SharePointLocation не используется значение All. Чтобы добавить сайт, укажите его URL-адрес.
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSharePointLocationExclusion
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocation
Этот параметр доступен только в облачной службе.
Параметр SharePointLocation указывает сайты SharePoint Online для включения. Чтобы добавить сайт, укажите его URL-адрес или укажите значение All, чтобы включить все сайты.
Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocationExclusion
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-WhatIf
Параметр WhatIf не работает в PowerShell для соответствия требованиям безопасности & .
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
| 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 |
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по