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 |