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 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Details
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Параметр Details определяет, следует ли включать подробные сведения в области результатов. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | 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 |
-Export
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Примечание. Этот параметр работает только в локальной версии Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
Параметр Export фильтрует результаты по действиям поиска соответствия Export. С этим параметром не нужно указывать значение.
Этот переключатель нельзя использовать с параметрами Identity, Preview или Punge.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | 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)
Вы не можете использовать этот параметр с параметрами Экспорт, Просмотр или Очистка.
При использовании параметра Identity в результатах возвращаются дополнительные сведения. Например, вы можете:
- В строке "Результаты" заполняются значения свойств Число элементов, Общий размер и Подробности.
- К результатам будут добавлены линии расположения.
- Значение свойства NumBindings заполняется. Это свойство включает основной почтовый ящик, основной архив и любые дополнительные архивы для пользователей, включенных в поиск. NumBindings — это не число пользователей, включенных в поиск, так как каждый включенный пользователь может иметь или не иметь комбинацию основного почтового ящика, основного архива и дополнительных архивов.
- Свойства затронутого расположения (например, ExchangeLocation) заполняются.
- Значение свойства CaseName заполняется.
Внимание: значение $null или несуществующее значение параметра Identity возвращает все объекты так, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity точны и не содержат несуществующих значений $null.
Свойства параметров
| Тип: | ComplianceSearchActionIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IncludeCredential
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Ключ IncludeCredential указывает, следует ли включать учетные данные в результаты. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Organization
Применимо: безопасность & соответствие требованиям
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | OrganizationIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Preview
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Параметр Preview фильтрует результаты по действию предварительного просмотра. С этим параметром не нужно указывать значение.
Этот переключатель нельзя использовать с параметрами "Экспорт", "Удостоверение" или "Очистка".
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Preview
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Purge
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Примечание. В Security & Compliance PowerShell этот параметр доступен только в роли "Поиск и очистка". По умолчанию эта роль назначается только группам ролей "Управление организацией" и "Исследователь данных".
Параметр Purge фильтрует результаты по действию удаления. С этим параметром не нужно указывать значение.
Этот переключатель нельзя использовать с параметрами "Экспорт", "Удостоверение" или "Предварительный просмотр".
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | 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 |
| Значение по умолчанию: | 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.