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.
Чтобы использовать этот командлет для действий Purge в 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
В этом примере удаляются результаты поиска, возвращенные поиском контента с именем Remove Phishing Message. Неиндексированные элементы не удаляются при использовании параметра Purge.
Пример 4
New-ComplianceSearchAction -SearchName "Case 321 All Sites" -Export -SharePointArchiveFormat SingleZip -ExchangeArchiveFormat PerUserPst -Format FxStream
В этом примере экспортируются результаты, возвращенные поиском контента с именем "Вариант 321 All Sites". Результаты поиска сжимаются и экспортируются в один ZIP-файл. Если поиск включал какие-либо расположения Exchange, результаты поиска экспортируются как один PST-файл на почтовый ящик.
Примечание. Этот пример работает только в локальной среде Exchange. Дополнительные сведения см. в статье Изменения в Microsoft Purview eDiscovery за май 2025 г.
Параметры
-ActionName
Применимо: соответствие требованиям & безопасности
Этот параметр доступен только в облачной службе.
Параметр ActionName указывает имя действия поиска контента. Этот параметр используется только при указании нескольких поисковых запросов контента в параметре SearchName.
Свойства параметров
| Тип: | String |
| Default value: | 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 |
| Default value: | 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EnableDedupe
Применимо: соответствие требованиям & безопасности
Этот параметр доступен только в облачной службе.
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Boolean |
| Default value: | 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 г.
Этот параметр работает только в облачном сервисе.
Для этого параметра требуется роль Экспорта в PowerShell для обеспечения соответствия требованиям безопасности &. По умолчанию эта роль назначается только группе ролей Диспетчер обнаружения электронных данных.
Параметр ExchangeArchiveFormat указывает, как экспортировать результаты поиска Exchange. Допустимые значения:
- PerUserPst: один PST-файл для каждого почтового ящика.
- SinglePst: один PST-файл, содержащий все экспортированные сообщения.
- SingleFolderPst: один PST-файл с одной корневой папкой для всего экспорта.
- IndividualMessage: экспортируйте каждое сообщение в виде файла сообщения .msg. Это значение является значением по умолчанию.
- PerUserZip: один ZIP-файл для каждого почтового ящика. Каждый ZIP-файл содержит экспортированные .msg файлы сообщений из почтового ящика.
- SingleZip: один ZIP-файл для всех почтовых ящиков. ZIP-файл содержит все экспортированные .msg файлы сообщений из всех почтовых ящиков. Этот параметр вывода доступен только в PowerShell.
Чтобы указать формат для результатов поиска SharePoint и OneDrive, используйте параметр SharePointArchiveFormat.
Свойства параметров
| Тип: | ComplianceExportArchiveFormat |
| Default value: | 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 г.
Этот параметр работает только в облачном сервисе.
Для этого параметра требуется роль Экспорта в PowerShell для обеспечения соответствия требованиям безопасности &. По умолчанию эта роль назначается только группе ролей Диспетчер обнаружения электронных данных.
Параметр Экспорт указывает действие для поиска контента— экспортировать полный набор результатов, соответствующих условиям поиска. С этим параметром не нужно указывать значение.
Чтобы возвратить только сведения о каждом обнаруженном элементе в отчете, используйте параметр Report.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | 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[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.
Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Format
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
В PowerShell & соответствия требованиям безопасности для этого параметра требуется роль Экспорт. По умолчанию эта роль назначается только группе ролей Диспетчер обнаружения электронных данных.
Параметр Format определяет формат результатов поиска при использовании параметра Export. Допустимые значения:
- FxStream: экспорт в PST-файлы. Это единственный вариант, доступный при экспорте результатов поиска из Портал соответствия требованиям Microsoft Purview.
- Mime: экспорт в файлы сообщений .eml. Это значение по умолчанию при использовании командлетов для экспорта результатов поиска.
- Msg. Экспорт в файлы сообщений .msg.
Свойства параметров
| Тип: | ComplianceDataTransferFormat |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | 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 |
-IncludeSharePointDocumentVersions
Применимо: соответствие требованиям & безопасности
Примечание. Этот параметр работает только в локальной среде Exchange. Дополнительные сведения см. в статье Изменения в Microsoft Purview eDiscovery за май 2025 г.
Этот параметр доступен только в облачной службе.
Параметр IncludeSharePointDocumentVersions определяет, следует ли экспортировать предыдущие версии документа при использовании параметра Export. Допустимые значения:
- $true: экспорт всех версий документа.
- $false: экспортируйте только текущую опубликованную версию документа. Это значение является значением по умолчанию.
Свойства параметров
| Тип: | Boolean |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-JobOptions
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | Int32 |
| Default value: | 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 г.
В PowerShell & соответствия требованиям безопасности для этого параметра требуется роль Экспорт. По умолчанию эта функция назначается только группе ролей диспетчера обнаружения электронных данных.
Параметр NotifyEmail указывает целевой адрес электронной почты для результатов поиска при использовании параметра Export.
Получатель указывается в поле сообщения To:.
Свойства параметров
| Тип: | String |
| Default value: | 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 г.
В PowerShell & соответствия требованиям безопасности для этого параметра требуется роль Экспорт. По умолчанию эта роль назначается только группе ролей Диспетчер обнаружения электронных данных.
Параметр NotifyEmailCC указывает целевой адрес электронной почты для результатов поиска при использовании параметра Export.
Получатель указывается в поле сообщения Cc:.
Свойства параметров
| Тип: | String |
| Default value: | 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 г.
В PowerShell по обеспечению безопасности & соответствия этому параметру требуется роль предварительной версии. По умолчанию эта роль назначается только группе ролей Диспетчер обнаружения электронных данных.
Параметр Предварительный просмотр указывает действие для поиска контента— предварительный просмотр результатов, соответствующих условиям поиска. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | 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 указывает, что действие для поиска контента заключается в удалении элементов, соответствующих условиям поиска. С этим параметром не нужно указывать значение.
За один раз можно удалить не более 10 элементов из одного почтового ящика. Так как возможность поиска и удаления сообщений предназначена для реагирования на инциденты, это ограничение обеспечивает быстрое удаление сообщений из почтовых ящиков. Это действие не предназначено для очистки почтовых ящиков пользователей.
Совет. Чтобы очистить более 10 элементов, см. статью ediscoverySearch: purgeData в microsoft API Graph, которая позволяет очистить не более 100 элементов в каждом расположении.
Вы можете удалить элементы из не более 50 000 почтовых ящиков с помощью одного поиска контента. Чтобы удалить элементы из более чем 50 000 почтовых ящиков, необходимо создать отдельный поиск контента. Дополнительные сведения см. в статье Поиск и удаление сообщений электронной почты в организации Microsoft 365.
Неиндексированные элементы не удаляются из почтовых ящиков при использовании этого параметра.
Значение параметра PurgeType определяет способ удаления элементов.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Purge
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PurgeType
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Примечание. В PowerShell для обеспечения соответствия требованиям безопасности & этот параметр доступен только в роли Поиска и очистки. По умолчанию эта роль назначается только группам ролей "Управление организацией" и "Следователь данных".
Параметр PurgeType определяет способ удаления элементов при использовании действия Purge. Допустимые значения:
- SoftDelete: очищенные элементы могут быть восстановлены пользователями до истечения срока хранения удаленных элементов.
- HardDelete (только в облаке). Очищенные элементы помечаются для окончательного удаления из почтового ящика и окончательно удаляются при следующей обработке почтового ящика помощником по управляемым папкам. Если в почтовом ящике включено восстановление одного элемента, очищенные элементы окончательно удаляются по истечении срока хранения удаленных элементов.
Свойства параметров
| Тип: | ComplianceDestroyType |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Purge
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ReferenceActionName
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Region
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | String |
| Default value: | 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 |
| Default value: | 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RetryOnError
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Параметр RetryOnError определяет, нужно ли повторять действие с отказавшим элементом, не выполняя все действие снова. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Scenario
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
В PowerShell по обеспечению безопасности & соответствия этому параметру требуется роль предварительной версии. По умолчанию эта роль назначается только группе ролей Диспетчер обнаружения электронных данных.
Параметр Scenario указывает тип сценария. Допустимые значения:
- AnalyzeWithZoom: подготовьте результаты поиска для обработки в eDiscovery премиум Microsoft Purview.
- Общие. Экспорт результатов поиска на локальный компьютер. Сообщения электронной почты экспортируются в PST-файлы. Документы SharePoint и OneDrive экспортируются в собственных форматах Office.
- GenerateReportsOnly
- Инвентаризация
- RetentionReports
- TriagePreview
Свойства параметров
| Тип: | ComplianceSearchActionScenario |
| Default value: | 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 |
| Default value: | 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 -Auto Name,Status.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SearchNames
Применимо: соответствие требованиям & безопасности
Этот параметр доступен только в облачной службе.
Параметр SearchNames указывает имена существующих поисковых запросов контента, которые необходимо связать с действием поиска контента. Имена поиска содержимого разделяются запятыми.
Имена поиска контента можно найти, выполнив команду Get-ComplianceSearch | Format-Table -Auto Name,Status.
Свойства параметров
| Тип: | String[] |
| Default value: | 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 г.
Этот параметр работает только в облачном сервисе.
Для этого параметра требуется роль Экспорта. По умолчанию эта роль назначается только группе ролей Диспетчер обнаружения электронных данных.
Параметр SharePointArchiveFormat указывает, как экспортировать результаты поиска SharePoint и OneDrive. Допустимые значения:
- IndividualMessage: экспортируйте несжатые файлы. Это значение является значением по умолчанию.
- PerUserZip: один ZIP-файл для каждого пользователя. Каждый ZIP-файл содержит экспортированные файлы для пользователя.
- SingleZip: один ZIP-файл для всех пользователей. ZIP-файл содержит все экспортированные файлы всех пользователей. Этот параметр вывода доступен только в PowerShell.
Чтобы указать формат для результатов поиска Exchange, используйте параметр ExchangeArchiveFormat.
Свойства параметров
| Тип: | ComplianceExportArchiveFormat |
| Default value: | 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 г.
{{ Fill ShareRootPath Description }}
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Export
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Version
Применимо: Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, соответствие требованиям безопасности &
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | String |
| Default value: | 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 |
| Default value: | 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.