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


New-ComplianceSearch

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Используйте командлет New-ComplianceSearch для создания поиска соответствия требованиям в Exchange Server 2016 или более поздней версии и в Портал соответствия требованиям Microsoft Purview. Этот командлет используется для определения условий поиска.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

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

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

  • $true. Поиск не пытается проверить существование почтового ящика перед продолжением. Это значение является обязательным, если требуется выполнить поиск в почтовых ящиках, которые не разрешаются как обычные почтовые ящики.
  • $true. Если указать почтовый ящик, который не является обычным почтовым ящиком пользователя, поиск завершится ошибкой. Это значение используется по умолчанию.

К типам почтовых ящиков, на которые влияет значение этого параметра, относятся:

  • Неактивные почтовые ящики
  • Пользователи без лицензии Exchange Online, которые используют приложения Office
  • Майкрософт 365 гостевых пользователей
  • Локальные пользователи, удостоверения которых синхронизированы с вашей Майкрософт 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

-Case

Этот параметр доступен только в облачной службе.

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

Этот параметр нельзя использовать для создания поиска соответствия требованиям, связанного с случаями eDiscovery Premium.

Если параметр Name содержит пробелы, значение параметра ExchangeLocation очищается при использовании параметра Case.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 для всех почтовых ящиков. Это значение можно использовать только отдельно.

Чтобы указать почтовый ящик или группу рассылки, используйте адрес электронной почты. Вы можете указать несколько значений, разделив их запятыми.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-ExchangeLocationExclusion

Этот параметр работает только в локальной среде Exchange.

Этот параметр указывает почтовые ящики, которые следует исключить при использовании значения All для параметра ExchangeLocation. Допустимые значения:

  • Параметр ExchangeLocation указывает почтовые ящики, включаемые в политику. Допускаются следующие значения:
  • Почтовый ящик

Чтобы указать почтовый ящик или группу рассылки, используйте адрес электронной почты. Вы можете указать несколько значений, разделив их запятыми.

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. Вам также необходимо задать имя дела обнаружения электронных данных с помощью параметра Case.

Кроме того, если расположение содержимого было помещено на удержание дела на основе запроса, поиск соответствия требованиям будет выполняться только среди тех элементов, которые находятся на удержании. Например, если пользователь был помещен на удержание дела на основе запроса, при котором сохраняются элементы, отправленные или созданные до определенной даты, поиск будет выполняться только среди этих элементов по критериям, которые определены этим поиском соответствия.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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. В поиск будет включено облачное хранилище для пользователей, указанных в параметре ExchangeLocation. Если для параметра 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

-LogLevel

Этот параметр доступен только в локальной среде Exchange.

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Type:ComplianceJobLogLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Name

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

Не используйте пробелы в значении этого параметра, если планируется использовать параметр Case. Если параметр Name содержит пробелы, значение параметра ExchangeLocation очищается при использовании параметра Case.

Type:String
Position:1
Default value:None
Required:True
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

-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

-StatusMailRecipients

Этот параметр доступен только в локальной среде Exchange.

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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

-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