New-ComplianceSearchAction
Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут быть эксклюзивными для той или иной среды.
Используйте командлет New-ComplianceSearchAction для создания действий для поиска контента в Exchange Server и в Microsoft Purview.
Примечание. Некоторые параметры этого командлета работают только в локальном Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Export
New-ComplianceSearchAction
[-SearchName] <String[]>
[-Export]
[-ActionName <String>]
[-ArchiveFormat <ComplianceExportArchiveFormat>]
[-Confirm]
[-FileTypeExclusionsForUnindexedItems <String[]>]
[-EnableDedupe <Boolean>]
[-ExchangeArchiveFormat <ComplianceExportArchiveFormat>]
[-Force]
[-Format <ComplianceDataTransferFormat>]
[-IncludeCredential]
[-IncludeSharePointDocumentVersions <Boolean>]
[-JobOptions <Int32>]
[-NotifyEmail <String>]
[-NotifyEmailCC <String>]
[-ReferenceActionName <String>]
[-Region <String>]
[-Report]
[-RetentionReport]
[-RetryOnError]
[-Scenario <ComplianceSearchActionScenario>]
[-Scope <ComplianceExportScope>]
[-SearchNames <String[]>]
[-SharePointArchiveFormat <ComplianceExportArchiveFormat>]
[-ShareRootPath <String>]
[-Version <String>]
[-WhatIf]
[<CommonParameters>]
Preview
New-ComplianceSearchAction
[-SearchName] <String[]>
[-Preview]
[-ActionName <String>]
[-Confirm]
[-Force]
[-Format <ComplianceDataTransferFormat>]
[-IncludeCredential]
[-JobOptions <Int32>]
[-ReferenceActionName <String>]
[-Region <String>]
[-RetryOnError]
[-Scenario <ComplianceSearchActionScenario>]
[-SearchNames <String[]>]
[-Version <String>]
[-WhatIf]
[<CommonParameters>]
Purge
New-ComplianceSearchAction
[-SearchName] <String[]>
[-Purge]
[-PurgeType <ComplianceDestroyType>]
[-ActionName <String>]
[-Confirm]
[-Force]
[-Format <ComplianceDataTransferFormat>]
[-IncludeCredential]
[-JobOptions <Int32>]
[-Region <String>]
[-ReferenceActionName <String>]
[-RetryOnError]
[-Scenario <ComplianceSearchActionScenario>]
[-SearchNames <String[]>]
[-Version <String>]
[-WhatIf]
[<CommonParameters>]
Описание
Создав поиск контента с помощью командлета New-ComplianceSearch и запустив его с помощью командлета Start-ComplianceSearch, вы назначаете действие поиска с помощью командлета New-ComplianceSearchAction.
В локальной среде Exchange этот командлет доступен в роли "Поиск почтовых ящиков". По умолчанию эта роль назначается только группе ролей "Управление обнаружением".
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
В Microsoft 365 учетной записи, которую вы используете для запуска этого командлета, должна быть назначена действующая лицензия Microsoft 365.
Чтобы использовать этот командлет в PowerShell безопасности и соответствия требованиям, вам должны быть назначены соответствующие разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Чтобы использовать этот командлет для действий очистки в Security & Compliance PowerShell, необходимо выполнить следующие требования:
- Используйте Exchange Online PowerShell версии 3.9.0 или более поздней (август 2025 г.). Дополнительные сведения см. в статье Новые возможности модуля PowerShell Exchange Online. Для установки этой версии модуля может потребоваться очистка предыдущих версий модуля.
- Выполните команду Connect-IPPSSession с параметром EnableSearchOnlySession .
Примеры
Пример 1
New-ComplianceSearchAction -SearchName "Project X" -Preview
В этом примере создается действие предварительного просмотра для поиска контента с именем Project X.
Пример 2
New-ComplianceSearchAction -SearchName "Project X" -Export
В этом примере создается экспортное действие поиска для поиска контента с именем Project X.
Примечание. Этот пример работает только в локальной среде Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
Пример 3
New-ComplianceSearchAction -SearchName "Remove Phishing Message" -Purge -PurgeType SoftDelete
В этом примере удаляются результаты поиска контента с именем "Удалить фишинговое сообщение". Неиндексированные элементы не удаляются при использовании параметра "Очистить".
Пример 4
New-ComplianceSearchAction -SearchName "Case 321 All Sites" -Export -SharePointArchiveFormat SingleZip -ExchangeArchiveFormat PerUserPst -Format FxStream
В этом примере экспортируются результаты, возвращенные поиском контента с именем "Случай 321: все сайты". Результаты поиска сжимаются и экспортируются в один ZIP-файл. Если поиск включает какие-либо расположения Exchange, результаты поиска экспортируются в виде одного PST-файла для каждого почтового ящика.
Примечание. Этот пример работает только в локальной среде Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
Параметры
-ActionName
Применимо: безопасность & соответствие требованиям
Этот параметр доступен только в облачной службе.
Параметр ActionName задает имя для действия поиска содержимого. Этот параметр используется только в том случае, если в параметре SearchName указано несколько поисковых запросов по содержимому.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ArchiveFormat
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Этот параметр устарел и больше не используется.
Чтобы указать формат результатов поиска Exchange, используйте параметр ExchangeArchiveFormat. Чтобы указать формат результатов поиска в SharePoint и OneDrive, используйте параметр SharePointArchiveFormat.
Свойства параметров
| Тип: | ComplianceExportArchiveFormat |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.
Этот командлет имеет встроенную паузу, поэтому используйте -Confirm:$false его, чтобы пропустить подтверждение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EnableDedupe
Применимо: безопасность & соответствие требованиям
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExchangeArchiveFormat
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Примечание. Этот параметр работает только в локальной версии Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
Этот параметр работает только в облачном сервисе.
Для этого параметра требуется роль "Экспорт" в Security & Compliance PowerShell. По умолчанию эта роль назначается только группе ролей диспетчера обнаружения электронных данных.
Параметр ExchangeArchiveFormat определяет, как экспортировать результаты поиска Exchange. Допустимые значения:
- PerUserPst: один PST-файл для каждого почтового ящика.
- SinglePst — один PST-файл, содержащий все экспортированные сообщения.
- SingleFolderPst — один PST-файл с одной корневой папкой для всего экспорта.
- IndividualMessage: экспорт каждого сообщения в файл .msg сообщений. Это значение используется по умолчанию.
- PerUserZip: один ZIP-файл для каждого почтового ящика. Каждый ZIP-файл содержит экспортированные файлы сообщений .msg из почтового ящика.
- SingleZip: один ZIP-файл для всех почтовых ящиков. ZIP-файл содержит все экспортированные файлы сообщений .msg из всех почтовых ящиков. Этот параметр вывода доступен только в PowerShell.
Чтобы указать формат результатов поиска в SharePoint и OneDrive, используйте параметр SharePointArchiveFormat.
Свойства параметров
| Тип: | ComplianceExportArchiveFormat |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Export
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Примечание. Этот параметр работает только в локальной версии Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
Этот параметр работает только в облачном сервисе.
Для этого параметра требуется роль "Экспорт" в Security & Compliance PowerShell. По умолчанию эта роль назначается только группе ролей диспетчера обнаружения электронных данных.
Ключ экспорта указывает, что действие поиска контента заключается в экспорте полного набора результатов, удовлетворяющих условиям поиска. С этим параметром не нужно указывать значение.
Чтобы возвратить только сведения о каждом обнаруженном элементе в отчете, используйте параметр Report.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FileTypeExclusionsForUnindexedItems
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Примечание. Этот параметр работает только в локальной версии Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
FileTypeExclusionsForUnindexedItems указывает типы файлов, которые следует исключить, так как они не могут быть проиндексированы. Вы можете указать несколько значений, разделив их запятыми.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Format
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
В Security & Compliance PowerShell для этого параметра требуется роль "Экспорт". По умолчанию эта роль назначается только группе ролей диспетчера обнаружения электронных данных.
Параметр Format определяет формат результатов поиска при использовании параметра Export. Допустимые значения:
- FxStream: экспорт в PST-файлы. Это единственный доступный параметр при экспорте результатов поиска с портала соответствия требованиям Microsoft Purview.
- MIME: экспорт в файлы сообщений .eml. Это значение по умолчанию при использовании командлетов для экспорта результатов поиска.
- Msg: экспорт в файлы сообщений .msg.
Свойства параметров
| Тип: | ComplianceDataTransferFormat |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeCredential
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Ключ IncludeCredential указывает, следует ли включать учетные данные в результаты. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeSharePointDocumentVersions
Применимо: безопасность & соответствие требованиям
Примечание. Этот параметр работает только в локальной версии Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
Этот параметр доступен только в облачной службе.
Параметр IncludeSharePointDocumentVersions определяет, следует ли экспортировать предыдущие версии документа при использовании параметра Export. Допустимые значения:
- $true. Экспорт всех версий документа.
- $false: экспорт только текущей опубликованной версии документа. Это значение используется по умолчанию.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-JobOptions
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Int32 |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NotifyEmail
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Примечание. Этот параметр работает только в локальной версии Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
В Security & Compliance PowerShell для этого параметра требуется роль "Экспорт". По умолчанию этот параметр назначается только группе ролей диспетчера обнаружения электронных данных.
Параметр NotifyEmail указывает целевой адрес электронной почты для результатов поиска при использовании параметра Export.
Получатель указывается в поле сообщения To:.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-NotifyEmailCC
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Примечание. Этот параметр работает только в локальной версии Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
В Security & Compliance PowerShell для этого параметра требуется роль "Экспорт". По умолчанию эта роль назначается только группе ролей диспетчера обнаружения электронных данных.
Параметр NotifyEmailCC указывает целевой адрес электронной почты для результатов поиска при использовании параметра Export.
Получатель указывается в поле сообщения Cc:.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Preview
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Примечание. Этот параметр работает только в локальной версии Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
В Security & Compliance PowerShell для этого параметра требуется роль "Предварительный просмотр". По умолчанию эта роль назначается только группе ролей диспетчера обнаружения электронных данных.
Переключатель предварительного просмотра указывает, что действие поиска контента заключается в предварительном просмотре результатов, соответствующих условиям поиска. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | 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 этот переключатель доступен только для роли "Поиск и очистка". По умолчанию эта роль назначается только группам ролей "Управление организацией" и "Исследователь данных".
Переключатель "Очистить" указывает, что действием поиска контента является удаление элементов, отвечающих условиям поиска. С этим параметром не нужно указывать значение.
За один раз можно удалить не более 10 элементов из одного почтового ящика. Так как возможность поиска и удаления сообщений предназначена для реагирования на инциденты, это ограничение обеспечивает быстрое удаление сообщений из почтовых ящиков. Это действие не предназначено для очистки почтовых ящиков пользователей.
Совет. Чтобы удалить более 10 элементов, см. раздел ediscoverySearch: purgeData в Microsoft API Graph, который позволяет удалить максимум 100 элементов в одном расположении.
С помощью одного поиска содержимого можно удалить элементы из не более чем 50 000 почтовых ящиков. Чтобы удалить элементы из более чем 50 000 почтовых ящиков, необходимо создать отдельные поисковые запросы по содержимому. Дополнительные сведения см. в статье "Поиск и удаление сообщений электронной почты в организации Microsoft 365".
Неиндексированные элементы не удаляются из почтовых ящиков при использовании этого переключателя.
Значение параметра PurgeType управляет удалением элементов.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Purge
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PurgeType
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Примечание. В Security & Compliance PowerShell этот параметр доступен только в роли "Поиск и очистка". По умолчанию эта роль назначается только группам ролей "Управление организацией" и "Исследователь данных".
Параметр PurgeType определяет способ удаления элементов при использовании действия Purge. Допустимые значения:
- SoftDelete: удаленные элементы могут быть восстановлены пользователями до истечения срока хранения удаленных элементов.
- Жесткое удаление (только в облаке): удаленные элементы помечаются для окончательного удаления из почтового ящика и окончательно удаляются при следующей обработке почтового ящика помощником по работе с управляемыми папками. Если для почтового ящика включено восстановление одного элемента, удаленные элементы окончательно удаляются по истечении периода хранения удаленных элементов.
Свойства параметров
| Тип: | ComplianceDestroyType |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Purge
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ReferenceActionName
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Region
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Report
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Примечание. Этот параметр работает только в локальной версии Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
Этот параметр работает только в облачном сервисе.
Ключ "Отчет" указывает, что действие поиска контента заключается в экспорте отчета о результатах (информации о каждом элементе вместо полного набора результатов), которые соответствуют условиям поиска. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetentionReport
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Примечание. Этот параметр работает только в локальной версии Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
Ключ RetentionReport указывает, что действием поиска контента является экспорт отчета о сроках хранения. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetryOnError
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Параметр RetryOnError определяет, нужно ли повторять действие с отказавшим элементом, не выполняя все действие снова. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Scenario
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
В Security & Compliance PowerShell для этого параметра требуется роль "Предварительный просмотр". По умолчанию эта роль назначается только группе ролей диспетчера обнаружения электронных данных.
Параметр Scenario определяет тип сценария. Допустимые значения:
- AnalyzeWithZoom: подготовка результатов поиска к обработке в eDiscovery Premium Microsoft Purview.
- Общие: экспорт результатов поиска на локальный компьютер. Сообщения электронной почты экспортируются в PST-файлы. Документы SharePoint и OneDrive экспортируются в собственных форматах Office.
- GenerateReportsOnly
- Инвентаризация
- RetentionReports
- TriagePreview
Свойства параметров
| Тип: | ComplianceSearchActionScenario |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Scope
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Примечание. Этот параметр работает только в локальной версии Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
Параметр Scope определяет элементы, которые необходимо включить при использовании действия Export. Допустимые значения:
- IndexedItemsOnly
- UnindexedItemsOnly
- BothIndexedAndUnindexedItems
Свойства параметров
| Тип: | ComplianceExportScope |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SearchName
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Параметр SearchName указывает имя существующего поиска контента, которое должно быть связано с действием поиска контента. Вы можете указать несколько поисковых запросов содержимого, разделенных запятыми.
Функцию поиска контента можно найти с помощью команды Get-ComplianceSearch | Format-Table — автоимя,состояние.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SearchNames
Применимо: безопасность & соответствие требованиям
Этот параметр доступен только в облачной службе.
Параметр SearchNames указывает имена существующих поисковых запросов контента, которые должны быть связаны с действием поиска контента. Имена для поиска контента разделяются запятыми.
Чтобы найти имена для поиска контента, выполните команду Get-ComplianceSearch | Format-Table — автоимя,состояние.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SharePointArchiveFormat
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Примечание. Этот параметр работает только в локальной версии Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
Этот параметр работает только в облачном сервисе.
Для этого параметра требуется роль Export. По умолчанию эта роль назначается только группе ролей диспетчера обнаружения электронных данных.
Параметр SharePointArchiveFormat определяет способ экспорта результатов поиска SharePoint и OneDrive. Допустимые значения:
- IndividualMessage: экспорт файлов в несжатом виде. Это значение используется по умолчанию.
- PerUserZip: по одному ZIP-файлу для каждого пользователя. Каждый ZIP-файл содержит экспортированные файлы для пользователя.
- SingleZip: один ZIP-файл для всех пользователей. ZIP-файл содержит все экспортированные файлы от всех пользователей. Этот параметр вывода доступен только в PowerShell.
Чтобы указать формат результатов поиска Exchange, используйте параметр ExchangeArchiveFormat.
Свойства параметров
| Тип: | ComplianceExportArchiveFormat |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ShareRootPath
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Примечание. Этот параметр работает только в локальной версии Exchange. Подробнее см. в разделе Изменения Microsoft Purview eDiscovery за май 2025 г.
{{ Заполнение ShareRootPath Описание }}
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Version
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, безопасность & соответствие требованиям
Параметр WhatIf не поддерживается в PowerShell безопасности и соответствия требованиям.
Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.