Get-ComplianceSearchAction
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и параметры могут быть эксклюзивными для одной или другой среды.
Используйте командлет Get-ComplianceSearchAction для просмотра сведений о действиях по поиску соответствия требованиям.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Identity
Get-ComplianceSearchAction
[[-Identity] <ComplianceSearchActionIdParameter>]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Preview
Get-ComplianceSearchAction
[-Preview]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Purge
Get-ComplianceSearchAction
[-Purge]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Export
Get-ComplianceSearchAction
[-Export]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-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 фильтрует результаты по имени указанного случая. Если значение содержит пробелы, его необходимо заключить в кавычки.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Details
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Параметр Details определяет, следует ли включать подробные сведения в области результатов. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Export
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Примечание. Этот параметр работает только в локальной среде Exchange. Дополнительные сведения см. в статье Изменения в Microsoft Purview eDiscovery за май 2025 г.
Параметр Export фильтрует результаты по действиям поиска соответствия Export. С этим параметром не нужно указывать значение.
Этот параметр нельзя использовать с параметрами Identity, Preview или Purge.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Параметр Identity определяет действие, связанное с запросом на поиск для обеспечения соответствия требованиям, которое требуется просмотреть. Можно использовать любое уникальное значение, определяющее такое действие. Например, вы можете:
- Имя. Имя действия поиска соответствия требованиям использует синтаксис
"Compliance Search Name_Action". Например,"Case 1234_Preview". - JobRunId (GUID)
Этот параметр нельзя использовать с параметрами Export, Preview или Purge.
При использовании параметра Identity в результатах возвращаются дополнительные сведения. Например, вы можете:
- В строке Результаты заполняются значения свойств "Количество элементов", "Общий размер" и "Сведения".
- В результаты добавляются строки расположения.
- Значение свойства NumBindings заполняется. Это свойство включает основной почтовый ящик, основной архив и любые дополнительные архивы для пользователей, включенных в поиск. NumBindings не является числом пользователей, включенных в поиск, так как каждый включенный пользователь может иметь или не иметь сочетание основного почтового ящика, основного архива и дополнительных архивов.
- Заполняются затронутые свойства расположения (например, ExchangeLocation).
- Заполняется значение свойства CaseName.
Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.
Свойства параметров
| Тип: | ComplianceSearchActionIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IncludeCredential
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Параметр IncludeCredential указывает, следует ли включать учетные данные в результаты. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Organization
Применимо: соответствие требованиям & безопасности
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | OrganizationIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Preview
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Параметр Preview фильтрует результаты по действию предварительного просмотра. С этим параметром не нужно указывать значение.
Этот параметр нельзя использовать с параметрами Export, Identity или Purge.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Preview
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Purge
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Примечание. В PowerShell для обеспечения соответствия требованиям безопасности & этот параметр доступен только в роли Поиска и очистки. По умолчанию эта роль назначается только группам ролей "Управление организацией" и "Следователь данных".
Параметр Purge фильтрует результаты по действию удаления. С этим параметром не нужно указывать значение.
Этот параметр нельзя использовать с параметрами Экспорт, Удостоверение или Предварительный просмотр.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Purge
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.
Свойства параметров
| Тип: | Unlimited |
| Default value: | 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.