New-ComplianceSearch
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут быть эксклюзивными для той или иной среды.
Используйте командлет New-ComplianceSearch для создания поиска соответствия требованиям в Exchange Server 2016 или более поздних версиях, а также в Портал соответствия требованиям Microsoft Purview. Этот командлет используется для определения условий поиска.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Примечание.
Для работы в облаке этот командлет выполняет следующие требования:
- Версия 3.9.0 или более поздняя версия модуля Exchange Online PowerShell (август 2025 г.).
- Используйте параметр EnableSearchOnlySession при выполнении команды Connect-IPPSSession для подключения к Security & Compliance PowerShell.
Синтаксис
Default (По умолчанию)
New-ComplianceSearch
[-Name] <String>
[-AllowNotFoundExchangeLocationsEnabled <Boolean>]
[-Case <String>]
[-Confirm]
[-ContentMatchQuery <String>]
[-Description <String>]
[-ExchangeLocation <String[]>]
[-ExchangeLocationExclusion <String[]>]
[-Force]
[-HoldNames <String[]>]
[-IncludeOrgContent <Boolean>]
[-IncludeUserAppContent <Boolean>]
[-Language <CultureInfo>]
[-LogLevel <ComplianceJobLogLevel>]
[-PublicFolderLocation <String[]>]
[-RefinerNames <String[]>]
[-SharePointLocation <String[]>]
[-SharePointLocationExclusion <String[]>]
[-StatusMailRecipients <String[]>]
[-WhatIf]
[<CommonParameters>]
Описание
Чтобы можно было выполнить поиск для обеспечения соответствия требованиям, нужно указать хотя бы одно расположение. Например, почтовые ящики с параметром ExchangeLocation или сайты SharePoint с параметром SharePointLocation.
После создания запроса на поиск для обеспечения соответствия требованиям с помощью командлета New-ComplianceSearch выполните поиск с помощью командлета Start-ComplianceSearch.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
В локальной среде Exchange этот командлет доступен в роли "Поиск почтовых ящиков". По умолчанию эта роль назначается только группе ролей "Управление обнаружением".
Чтобы использовать этот командлет в PowerShell безопасности и соответствия требованиям, вам должны быть назначены соответствующие разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
New-ComplianceSearch -Name "Hold Project X" -ExchangeLocation "Finance Department"
В этом примере создается новый запрос на поиск для обеспечения соответствия требованиям, Hold-Project X, охватывающий всех членов группы рассылки Finance Department. Поскольку в этом поиске не используется параметр ContentMatchQuery, он охватывает все элементы в почтовых ящиках.
Пример 2
New-ComplianceSearch -Name "Hold-Tailspin Toys" -ExchangeLocation "Research Department" -ContentMatchQuery "'Patent' AND 'Project Tailspin Toys'"
В этом примере создается новый запрос на поиск для обеспечения соответствия требованиям, Hold-Tailspin Toys, охватывающий всех членов группы рассылки Research Department. Поскольку в этом поиске используется параметр ContentMatchQuery, он охватывает лишь соответствующие запросу сообщения.
Пример 3
New-ComplianceSearch -Name "AnnBeebe-InactiveMailbox" -ExchangeLocation .annb@contoso.onmicrosoft.com -AllowNotFoundExchangeLocationsEnabled $true
В этом примере создается новый запрос на поиск соответствия, AnnBeebe-InactiveMailbox, который охватывает весь неактивный почтовый ящик и возвращает все элементы в нем. Для поиска в неактивном почтовом ящике используется его основной адрес SMTP с поставленной перед ним точкой ("."). Также необходимо включить параметр AllowNotFoundExchangeLocationsEnabled, чтобы поиск не пытался проверить существование неактивного почтового ящика.
Параметры
-AllowNotFoundExchangeLocationsEnabled
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Параметр AllowNotFoundExchangeLocationsEnabled указывает, следует ли включать почтовые ящики, отличные от обычных почтовых ящиков, в поиск соответствия. Допустимые значения:
- $true. Поиск не пытается проверить существование почтового ящика перед продолжением. Это значение необходимо для поиска почтовых ящиков, которые не разрешаются как обычные почтовые ящики.
- $true. Если указать почтовый ящик, который не является обычным почтовым ящиком пользователя, поиск завершится сбоем. Это значение используется по умолчанию.
Типы почтовых ящиков, на которые влияет значение этого параметра:
- Неактивные почтовые ящики
- Пользователи без лицензии Exchange Online, работающие с приложениями Office
- Гостевые пользователи Microsoft 365
- Локальные пользователи, удостоверение которых синхронизировано с организацией Microsoft 365
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Case
Применимо: безопасность & соответствие требованиям
Этот параметр доступен только в облачной службе.
Параметр Case указывает имя случая обнаружения электронных данных Standard, с которым будет связан новый поиск соответствия. Если значение содержит пробелы, его необходимо заключить в кавычки.
Этот параметр нельзя использовать для создания запросов соответствия требованиям, связанных с делами eDiscovery Premium.
Если параметр Name содержит пробелы, значение параметра ExchangeLocation очищается при использовании параметра Case.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ContentMatchQuery
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Параметр ContentMatchQuery указывает фильтр поиска контента.
Этот параметр использует строку текстового поиска или запрос, созданный с использованием языка запросов по ключевым словам (KQL). Дополнительные сведения см. в разделах Справочник по синтаксису язык KeyQL (KQL) и Запросы по ключевым словам и условия поиска для обнаружения электронных данных.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Description
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Параметр Description указывает необязательное описание запроса на поиск для обеспечения соответствия требованиям. Если значение содержит пробелы, его необходимо заключить в кавычки.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExchangeLocation
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Параметр ExchangeLocation указывает почтовые ящики, которые нужно включить. Допустимые значения:
- Обычный почтовый ящик пользователя. Включение почтовых ящиков других типов (например, неактивных почтовых ящиков или гостевых пользователей Microsoft 365) управляется параметром AllowNotFoundExchangeLocationsEnabled.
- Почтовый ящик
- Значение "Все" для всех почтовых ящиков. Это значение можно использовать только отдельно.
Чтобы указать почтовый ящик или группу рассылки, используйте адрес электронной почты. Вы можете указать несколько значений, разделив их запятыми.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ExchangeLocationExclusion
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Этот параметр работает только в локальной среде Exchange.
Этот параметр определяет почтовые ящики, которые следует исключить при использовании значения All для параметра ExchangeLocation. Допустимые значения:
- Параметр ExchangeLocation указывает почтовые ящики, включаемые в политику. Допускаются следующие значения:
- Почтовый ящик
Чтобы указать почтовый ящик или группу рассылки, используйте адрес электронной почты. Вы можете указать несколько значений, разделив их запятыми.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-HoldNames
Применимо: безопасность & соответствие требованиям
Этот параметр доступен только в облачной службе.
Параметр HoldNames указывает, где производится поиск в расположениях содержимого, помещенных на удержание в указанном случае обнаружения электронных данных. Для этого параметра используется значение All. Вам также необходимо задать имя дела обнаружения электронных данных с помощью параметра Case.
Кроме того, если расположение контента помещено в удержание на основе запроса, при выполнении этого поиска соответствия будут поиск только тех элементов, которые находятся на удержании. Например, если пользователь был помещен на удержание дела на основе запроса, при котором сохраняются элементы, отправленные или созданные до определенной даты, поиск будет выполняться только среди этих элементов по критериям, которые определены этим поиском соответствия.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeOrgContent
Применимо: безопасность & соответствие требованиям
{{ Fill IncludeOrgContent Description }}
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeUserAppContent
Применимо: безопасность & соответствие требованиям
Этот параметр доступен только в облачной службе.
Параметр IncludeUserAppContent указывает, что вы хотите выполнить поиск в облачном хранилище для пользователей, у которых нет учетной записи обычного пользователя Microsoft 365 в вашей организации. К таким типам пользователей относятся пользователи без лицензии Exchange Online, использующие приложения Office, гостевые пользователи Microsoft 365 и локальные пользователи, удостоверения которых синхронизированы с вашей организацией Microsoft 365. Допустимые значения:
- $true: Облачное хранилище для пользователей, указанных в параметре ExchangeLocation, включается в поиск. Если для параметра ExchangeLocation используется значение All, то в поиск включается облачное хранилище для всех гостевых или локальных пользователей.
- $false. Облачное хранилище для пользователей, указанное в параметре ExchangeLocation, не включается в поиск. Это значение используется по умолчанию.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Language
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Параметр Language указывает язык, который будет использоваться при поиске для обеспечения соответствия требованиям.
Допустимыми входными данными для этого параметра является поддерживаемое значение кода языка и региональных параметров из класса CultureInfo Microsoft платформа .NET Framework. Например, da-DK для датского языка или ja-JP для японского. Подробнее см. в разделе Класс CultureInfo.
Свойства параметров
| Тип: | CultureInfo |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-LogLevel
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | ComplianceJobLogLevel |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Параметр Name указывает имя поиска соответствия. Если значение содержит пробелы, его необходимо заключить в кавычки.
Не используйте пробелы в значении этого параметра, если вы планируете использовать параметр Case. Если параметр Name содержит пробелы, значение параметра ExchangeLocation очищается при использовании параметра Case.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PublicFolderLocation
Применимо: безопасность & соответствие требованиям
Этот параметр доступен только в облачной службе.
Параметр PublicFolderLocation указывает, что в поиск необходимо включить все общедоступные папки. Для этого параметра используется значение All.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RefinerNames
Применимо: безопасность & соответствие требованиям
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SharePointLocation
Применимо: безопасность & соответствие требованиям
Этот параметр доступен только в облачной службе.
Параметр SharePointLocation указывает сайты SharePoint, которые необходимо включить. Чтобы добавить сайт, укажите его URL-адрес или укажите значение All, чтобы включить все сайты.
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SharePointLocationExclusion
Применимо: безопасность & соответствие требованиям
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-StatusMailRecipients
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | 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.