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


Get-ComplianceSearchAction

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

Используйте командлет Get-ComplianceSearchAction для просмотра сведений о действиях по поиску соответствия требованиям.

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

Синтаксис

Get-ComplianceSearchAction
   [[-Identity] <ComplianceSearchActionIdParameter>]
   [-Case <String>]
   [-Details]
   [-DomainController <Fqdn>]
   [-IncludeCredential]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-ComplianceSearchAction
   [-Preview]
   [-Case <String>]
   [-Details]
   [-DomainController <Fqdn>]
   [-IncludeCredential]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-ComplianceSearchAction
   [-Purge]
   [-Case <String>]
   [-Details]
   [-DomainController <Fqdn>]
   [-IncludeCredential]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-ComplianceSearchAction
   [-Export]
   [-Case <String>]
   [-Details]
   [-DomainController <Fqdn>]
   [-IncludeCredential]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Описание

После создания запроса на поиск для обеспечения соответствия требованиям с помощью командлета New-ComplianceSearch и его запуска с помощью командлета Start-ComplianceSearch можно назначить действие поиска, используя командлет New-ComplianceSearchAction. С помощью командлета Get-ComplianceSearchAction отслеживается ход выполнения действия при поиске для обеспечения соответствия требованиям.

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

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

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

Примеры

Пример 1

Get-ComplianceSearchAction

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

Пример 2

Get-ComplianceSearchAction -Identity "Case 1234_Preview" | Format-List

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

Параметры

-Case

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Details

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

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

-DomainController

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

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

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

-Export

Параметр Export фильтрует результаты по действиям поиска соответствия Export. Указывать значение для этого параметра необязательно.

Этот параметр нельзя использовать с параметрами Identity, Preview или Purge.

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

-Identity

Параметр Identity определяет действие, связанное с запросом на поиск для обеспечения соответствия требованиям, которое требуется просмотреть. Можно использовать любое уникальное значение, определяющее такое действие. Например:

  • Имя. Имя действия поиска соответствия требованиям использует синтаксис "Compliance Search Name_Action". Например, "Case 1234_Preview".
  • JobRunId (GUID)

Этот параметр нельзя использовать с параметрами Export, Preview или Purge.

При использовании параметра Identity в результатах возвращаются дополнительные сведения. Например:

  • В строке Результаты заполняются значения свойств "Количество элементов", "Общий размер" и "Сведения".
  • В результаты добавляются строки расположения.
  • Заполняется значение свойства NumBinding.
  • Заполняются затронутые свойства расположения (например, ExchangeLocation).
  • Заполняется значение свойства CaseName.
Type:ComplianceSearchActionIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-IncludeCredential

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

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

-Preview

Параметр Preview фильтрует результаты по действию предварительного просмотра. Указывать значение для этого параметра необязательно.

Этот параметр нельзя использовать с параметрами Export, Identity или Purge.

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

-Purge

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

Параметр Purge фильтрует результаты по действию удаления. Указывать значение для этого параметра необязательно.

Этот параметр нельзя использовать с параметрами Экспорт, Удостоверение или Предварительный просмотр.

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

-ResultSize

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

Type:Unlimited
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