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/меток. Вместо этого создайте сценарий для одного SIT/Label, а затем повторно используйте тот же сценарий для каждого SIT/Label в каждой рабочей нагрузке по мере необходимости.

  • При повторном запуске сценария сначала необходимо повторно подключиться к сеансу. Срок действия маркера сеанса истекает примерно через час, что может привести к сбою командлета. Чтобы устранить эту проблему, повторно подключитесь к сеансу перед повторным запуском сценария. Если сценарий не выполняется, перезапустите его, используя файл cookie последней возвращенной страницы, чтобы продолжить экспорт с того места, на котором он был прерван.

    Совет

    Для поддержки сценариев, выполняемых автоматически, которые выполняются в течение длительного времени, можно использовать проверку подлинности на основе сертификатов (CBA).

    Чтобы использовать приложение Azure, добавьте группу ролей средства просмотра списков обозревателя контента в удостоверение субъекта-службы.

Чтобы использовать этот командлет в 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

Применимо: безопасность & соответствие требованиям

Примечание. Этот параметр в настоящее время находится в закрытой предварительной версии, доступен не во всех организациях и может быть изменен.

Ключ параметров агрегирования возвращает агрегированные числа на уровне папки, а не сведения на уровне элемента. С этим параметром не нужно указывать значение.

Использование этого переключателя значительно сокращает время экспорта. Чтобы скачать элементы в папку, запустите этот командлет для определенных папок.

При использовании этого параметра с параметрами TagName, TagType и Workload команда возвращает следующие сведения:

  • SharePoint и OneDrive: список SiteUlrs.
  • Exchange Online и Microsoft Teams: список имен участников-пользователей (UPN).
  • Количество элементов в папках с соответствующим тегом.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:False
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ConfidenceLevel

Применимо: безопасность & соответствие требованиям

Параметр ConfidenceLevel определяет степень достоверности совпадения для экспортируемых сведений о файле. Допустимые значения:

  • низкий
  • medium
  • Высокий

Свойства параметров

Тип:String
Значение по умолчанию:None
Допустимые значения:high, medium, low
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

Применимо: безопасность & соответствие требованиям

Параметр PageCookie указывает, следует ли получать дополнительные данные, если свойство MorePagesAvailable в выходных данных команды имеет значение True. Если параметр PageSize не используется, возвращается максимум 100 записей. Если вы используете параметр PageSize, можно вернуть максимум 10000 записей.

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
(All)
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PageSize

Применимо: безопасность & соответствие требованиям

Параметр PageSize определяет максимальное количество записей, возвращаемых в одном запросе. Допустимыми входными данными для этого параметра является целое число от 1 до 10000. Значение по умолчанию — 100.

Примечание. В пустых папках или папках с небольшим количеством файлов этот параметр может привести к тому, что команда будет выполняться долго, пока она пытается получить количество PageSize результатов. Чтобы предотвратить эту проблему, команда возвращает данные из 5 папок или количества записей, указанного параметром PageSize, в зависимости от того, какое из них завершится первым. Например, при наличии 10 папок с одной записью в каждой, команда возвращает 5 записей из 5 первых папок. При следующем выполнении с использованием page cookie он возвращает 5 записей из оставшихся 5 папок, даже если значение PageSize равно 10.

Свойства параметров

Тип:Int32
Значение по умолчанию:0
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SiteUrl

Применимо: безопасность & соответствие требованиям

Параметр SiteUrl указывает URL-адрес сайта, с которого нужно экспортировать сведения о файле.

Этот параметр используется для рабочих нагрузок SharePoint и OneDrive.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:3
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-TagName

Применимо: безопасность & соответствие требованиям

Параметр TagName указывает имя метки, из которой нужно экспортировать сведения о файле. Если значение содержит пробелы, его необходимо заключить в кавычки.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:4
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-TagType

Применимо: безопасность & соответствие требованиям

Параметр TagType определяет тип метки, из которой нужно экспортировать сведения о файле. Допустимые значения:

  • Хранение
  • SensitiveInformationType
  • Конфиденциальность
  • ОбучаемыйКлассификатор

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:5
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-UserPrincipalName

Применимо: безопасность & соответствие требованиям

Параметр UserPrincipalName указывает учетную запись пользователя в формате имени участника-пользователя, из которой нужно экспортировать сведения о сообщении. Пример значения имени участника-пользователя: erika@contoso.onmicrosoft.com.

Этот параметр используется для рабочих нагрузок Exchange и Microsoft Teams.

Свойства параметров

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:6
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Workload

Применимо: безопасность & соответствие требованиям

Параметр Workload указывает расположение для экспорта сведений о файле. Допустимые значения:

  • EXO или Exchange
  • ODB или OneDrive
  • SPO или SharePoint
  • Teams

Свойства параметров

Тип:String
Значение по умолчанию: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.