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 указывает, следует ли получать дополнительные данные, если значение свойства 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.