Get-ComplianceSearch

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

Используйте командлет Get-ComplianceSearch для просмотра поиска оценки соответствия требованиям в Exchange Server 2016 и более поздних версиях, а также в Портал соответствия требованиям Microsoft Purview. Воспользовавшись командлетом New-ComplianceSearchAction, чтобы определить действие просмотра результатов поиска для обеспечения соответствия требованиям, с помощью командлета Get-ComplianceSearchAction просмотрите такие результаты.

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

Синтаксис

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

Get-ComplianceSearch
    [[-Identity] <ComplianceSearchIdParameter>]
    [-Case <String>]
    [-DomainController <Fqdn>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Описание

Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

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

Чтобы использовать этот командлет в PowerShell безопасности и соответствия требованиям, вам должны быть назначены соответствующие разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.

Примеры

Пример 1

Get-ComplianceSearch

В этом примере приведен сводный список всех запросов на поиск для обеспечения соответствия требованиям.

Пример 2

Get-ComplianceSearch -Identity "Case 1234" | Format-List

В этом примере приведены подробные сведения о запросе на поиск для обеспечения соответствия требованиям, названном Case 1234.

Параметры

-Case

Применимо: безопасность & соответствие требованиям

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

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

Этот параметр нельзя использовать для просмотра поисковых запросов соответствия, связанных с делами eDiscovery Premium.

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

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DomainController

Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

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

Тип:Fqdn
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

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

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

Этот параметр необходимо использовать с параметром Identity, но значение игнорируется. Например, используйте значение 000 для параметра Identity.

  • Имя
  • JobRunId (GUID)

JobRunId (GUID)

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

  • Элементы
  • Размер
  • SuccessResults
  • NumBindings
  • ExchangeLocation
  • SharePointLocation
  • OneDriveLocation

Чтобы просмотреть эти свойства, необходимо использовать параметр Identity в команде.

Примечание. Свойство NumBindings включает основной почтовый ящик, основной архив и любые дополнительные архивы для пользователей, включенных в поиск. NumBindings — это не число пользователей, включенных в поиск, так как каждый включенный пользователь может иметь или не иметь комбинацию основного почтового ящика, основного архива и дополнительных архивов.

Внимание: значение $null или несуществующее значение параметра Identity возвращает все объекты так, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity точны и не содержат несуществующих значений $null.

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

Тип:ComplianceSearchIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:1
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ResultSize

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

Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.

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

Тип:Unlimited
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.