Export-ContentExplorerData
Этот командлет доступен только в PowerShell безопасности и соответствия требованиям. Дополнительные сведения см. в статье PowerShell безопасности и соответствия требованиям.
Используйте командлет Export-ContentExplorerData для экспорта сведений о файле классификации данных в соответствии с Microsoft Purview.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Export-ContentExplorerData
[-TagName] <String>
[-TagType] <String>
[-Aggregate]
[[-ConfidenceLevel] <String>]
[[-PageCookie] <String>]
[[-PageSize] <Int32>]
[[-SiteUrl] <String>]
[[-UserPrincipalName] <String>]
[[-Workload] <String>]
[<CommonParameters>]
Описание
Выходные данные этого командлета содержат следующее:
- TotalCount: статистическое число. Если используются только параметры TagName и TagType, значением является общее совокупное число для этого тега. Если параметр Workload также используется, значением является совокупное число в рабочей нагрузке для этого тега. Если используются параметры UserPrincipalName или SiteUrl, значением будет счетчик для конкретной папки.
- MorePagesAvailable: показывает, осталось ли больше записей для экспорта. Значение равно True или False.
- RecordsReturned: количество записей, возвращаемых в запросе.
- PageCookie: используется для получения следующего набора записей, если Параметр MorePagesAvailable имеет значение True.
- Данные записей. Выходные данные этого командлета являются массивом. Начиная с элемента массива 1, содержит данные записей
В следующем списке описаны рекомендации по сценариям с помощью этого командлета:
Мы не рекомендуем использовать один скрипт для экспорта нескольких sit/labels. Вместо этого создайте скрипт для одного sit/label, а затем повторно используйте один и тот же скрипт для каждого SIT/Label в каждой рабочей нагрузке по мере необходимости.
При повторной попытке скрипта сначала необходимо повторно подключиться к сеансу. Срок действия маркера сеанса истекает примерно через час, что может привести к сбою командлета. Чтобы устранить эту проблему, повторно подключитесь к сеансу перед повторным выполнением сценария. Если скрипт завершается сбоем, перезапустите его, используя возвращенный файл cookie последней страницы, чтобы продолжить экспорт с того места, где он завершился.
Совет
Для поддержки автоматических скриптов, которые выполняются в течение длительного времени, можно использовать проверку подлинности на основе сертификатов (CBA).
Чтобы использовать приложение Azure, добавьте группу ролей Content Обозреватель List Viewer в удостоверение субъекта-службы.
Чтобы использовать этот командлет в PowerShell безопасности и соответствия требованиям, вам должны быть назначены соответствующие разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.
Примеры
Пример 1
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload EXO -UserPrincipalName erika@contoso.onmicrosoft.com
В этом примере записи для указанного типа конфиденциальной информации экспортируются из почтового ящика Эрики.
Пример 2
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload ODB -SiteUrl https://contoso-my.sharepoint.com/personal/erika_contoso_onmicrosoft_com
В этом примере экспортируются записи для указанного типа конфиденциальной информации на сайте OneDrive Эрики.
Пример 3
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names"
Пример 4
$Report = @()
$Content = Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names" -ConfidenceLevel high -Workload sharepoint -PageSize 1000
[string]$PageCookie = $Content.PageCookie
$Report += $Content[1..$Content[0].RecordsReturned]
while($PageCookie -notlike " * ")
{
$NewContent = Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names" -ConfidenceLevel high -Workload sharepoint -PageCookie $PageCookie -PageSize 1000
[string]$PageCookie = $NewContent.PageCookie
$Report += $NewContent[1..$NewContent[0].RecordsReturned]
}
$Report | Export-CSV C:\temp\CE_Report-AFN_high.csv -Encoding UTF8 -NoTypeInformation
В этом примере экспортируются записи для указанного типа конфиденциальной информации для всех рабочих нагрузок.
Параметры
-Aggregate
Применимо: соответствие требованиям & безопасности
Заметка: Этот параметр в настоящее время находится в закрытой предварительной версии, он доступен не во всех организациях и может быть изменен.
Параметр Aggregate возвращает агрегированные числа на уровне папки, а не возвращает сведения на уровне элемента. С этим параметром не нужно указывать значение.
Использование этого параметра значительно сокращает время экспорта. Чтобы скачать элементы в папке, выполните этот командлет для определенных папок.
При использовании этого параметра с параметрами TagName, TagType и Workload команда возвращает следующие сведения:
- SharePoint и OneDrive: список SiteUlrs.
- Exchange Online и Microsoft Teams: список имен участника-участника.
- Количество элементов в папках, помеченных соответствующим тегом.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ConfidenceLevel
Применимо: соответствие требованиям & безопасности
Параметр ConfidenceLevel указывает уровень достоверности соответствия для экспортируемых сведений о файле. Допустимые значения:
- низкий
- medium
- высокий
Свойства параметров
| Тип: | String |
| Default value: | None |
| Допустимые значения: | high, medium, low |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PageCookie
Применимо: соответствие требованиям & безопасности
Параметр PageCookie указывает, следует ли получать дополнительные данные, если значение свойства MorePagesAvailable в выходных данных команды равно True. Если параметр PageSize не используется, возвращается не более 100 записей. При использовании параметра PageSize можно вернуть не более 10 000 записей.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PageSize
Применимо: соответствие требованиям & безопасности
Параметр PageSize указывает максимальное количество записей, возвращаемых в одном запросе. Допустимые входные данные для этого параметра — целое число от 1 до 10000. Значение по умолчанию — 100.
Примечание. В пустых папках или папках с несколькими файлами этот параметр может привести к длительному выполнению команды при попытке получить количество результатов PageSize. Чтобы избежать этой проблемы, команда возвращает данные из 5 папок или количество записей, указанное параметром PageSize, в зависимости от того, какое из них выполняется первым. Например, если имеется 10 папок с 1 записью в каждой, команда возвращает 5 записей из первых 5 папок. При следующем выполнении с помощью файла cookie страницы он возвращает 5 записей из оставшихся 5 папок, даже если значение PageSize равно 10.
Свойства параметров
| Тип: | Int32 |
| Default value: | 0 |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 2 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SiteUrl
Применимо: соответствие требованиям & безопасности
Параметр SiteUrl указывает URL-адрес сайта для экспорта сведений о файлах.
Этот параметр используется для рабочих нагрузок SharePoint и OneDrive.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 3 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-TagName
Применимо: соответствие требованиям & безопасности
Параметр TagName указывает имя метки для экспорта сведений о файле. Если значение содержит пробелы, его необходимо заключить в кавычки.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 4 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-TagType
Применимо: соответствие требованиям & безопасности
Параметр TagType указывает тип метки для экспорта сведений о файле. Допустимые значения:
- Хранение
- SensitiveInformationType
- Конфиденциальность
- TrainableClassifier
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 5 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UserPrincipalName
Применимо: соответствие требованиям & безопасности
Параметр UserPrincipalName указывает учетную запись пользователя в формате имени участника-пользователя для экспорта сведений о сообщении. Пример значения имени участника-пользователя — erika@contoso.onmicrosoft.com.
Этот параметр используется для рабочих нагрузок Exchange и Microsoft Teams.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 6 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Workload
Применимо: соответствие требованиям & безопасности
Параметр Workload указывает расположение для экспорта сведений о файлах. Допустимые значения:
- EXO или Exchange
- ODB или OneDrive
- SPO или SharePoint
- Teams
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 7 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.