Export-ContentExplorerData

此 cmdlet 仅在安全与合规中心 PowerShell 内可用。 有关更多信息,请参见 安全与合规中心 PowerShell

使用 Export-ContentExplorerData cmdlet 导出数据分类文件详细信息,Microsoft Purview 符合性。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Default (默认值)

Export-ContentExplorerData
    [-TagName] <String>
    [-TagType] <String>
    [-Aggregate]
    [[-ConfidenceLevel] <String>]
    [[-PageCookie] <String>]
    [[-PageSize] <Int32>]
    [[-SiteUrl] <String>]
    [[-UserPrincipalName] <String>]
    [[-Workload] <String>]
    [<CommonParameters>]

说明

此 cmdlet 的输出包含以下信息:

  • TotalCount:聚合计数。 如果仅使用 TagName 和 TagType 参数,则该值是该标记的总聚合计数。 如果还使用了 Workload 参数,则该值是该标记的工作负荷中的聚合计数。 如果使用 UserPrincipalName 或 SiteUrl 参数,则该值是该特定文件夹的计数。
  • MorePagesAvailable:显示是否还有更多要导出的记录。 值为 True 或 False。
  • RecordsReturned:查询中返回的记录数。
  • PageCookie:用于在 MorePagesAvailable 为 True 时获取下一组记录。

以下列表介绍了使用此 cmdlet 的脚本的最佳做法:

  • 建议不要使用单个脚本导出多个 SCT/标签。 相反,请为一个 SIT/Label 创建一个脚本,然后根据需要对每个工作负载中的每个 SIT/Label 重复使用相同的脚本。

  • 重试脚本时,请确保先重新连接到会话。 会话的令牌在大约一小时后过期,这可能导致 cmdlet 失败。 若要解决此问题,请在重试脚本之前重新连接到会话。 如果脚本失败,请使用返回的最后一页 Cookie 重新启动它,以继续从其中断位置导出。

    提示

    若要支持长时间运行的无人参与脚本,可以使用 基于证书的身份验证 (CBA)

    若要使用 Azure 应用,请将内容资源管理器列表查看者的角色组添加到服务主体标识。

要在安全与合规中心 PowerShell 中使用此 cmdlet,必须分配权限。 有关详细信息,请参阅 Microsoft Purview 合规门户中的权限

示例

示例 1

Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload EXO -UserPrincipalName erika@contoso.onmicrosoft.com

此示例从 Erika 的邮箱中导出指定敏感信息类型的记录。

示例 2

Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload ODB -SiteUrl https://contoso-my.sharepoint.com/personal/erika_contoso_onmicrosoft_com

本示例导出 Erika 的 OneDrive 网站中指定敏感信息类型的记录。

示例 3

Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names"

此示例导出所有工作负荷的指定敏感信息类型的记录。

参数

-Aggregate

适用:安全 & 合规性

注意: 此参数目前为个人预览版,并非在所有组织中都可用,并且可能会发生更改。

聚合参数开关返回文件夹级别的聚合数字,而不是返回项目级别的详细信息。 不必为此开关指定值。

使用此开关可显著缩短导出时间。 若要下载文件夹中的项目,请针对特定文件夹运行此 cmdlet。

将此开关与 TagName、TagType 和 Workload 参数一起使用时,命令将返回以下信息:

  • SharePoint 和 OneDrive:SiteUlrs 的列表。
  • Exchange Online和Microsoft Teams:UPN 列表。
  • 标记有相关标记的文件夹中的项目计数。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ConfidenceLevel

适用:安全 & 合规性

ConfidenceLevel 参数指定要导出的文件详细信息的匹配项的置信度。 有效值包含:

  • 中等

参数属性

类型:String
默认值:None
接受的值:high, medium, low
支持通配符:False
不显示:False

参数集

(All)
Position:0
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

适用:安全 & 合规性

当命令输出中的 MorePagesAvailable 属性的值为 True 时,PageCookie 参数指定是否获取更多数据。 如果不使用 PageSize 参数,则最多返回 100 条记录。 如果使用 PageSize 参数,最多可以返回 10000 条记录。

类型:String
默认值:None
支持通配符:False
不显示:False
(All)
Position:1
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PageSize

适用:安全 & 合规性

PageSize 参数指定要在单个查询中返回的最大记录数。 此参数的有效输入是介于 1 和 10000 之间的整数。 默认值为 100。

注意:在空文件夹或文件较少的文件夹中,此参数可能会导致命令在尝试获取结果的 PageSize 计数时长时间运行。 为防止此问题,该命令从 5 个文件夹或 PageSize 参数指定的记录数(以先完成者为准)返回数据。 例如,如果有 10 个文件夹,每个文件夹有 1 条记录,则命令将返回前 5 个文件夹的 5 条记录。 在下一次使用页 Cookie 执行时,即使 PageSize 值为 10,它也会从剩余的 5 个文件夹中返回 5 条记录。

参数属性

类型:Int32
默认值:0
支持通配符:False
不显示:False

参数集

(All)
Position:2
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SiteUrl

适用:安全 & 合规性

SiteUrl 参数指定要从中导出文件详细信息的网站 URL。

此参数用于 SharePoint 和 OneDrive 工作负载。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:3
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TagName

适用:安全 & 合规性

TagName 参数指定要从中导出文件详细信息的标签的名称。 如果值包含空格,则使用引号括住该值。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:4
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TagType

适用:安全 & 合规性

TagType 参数指定要从中导出文件详细信息的标签类型。 有效值包含:

  • 保留
  • SensitiveInformationType
  • 敏感度
  • TrainableClassifier

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:5
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-UserPrincipalName

适用:安全 & 合规性

UserPrincipalName 参数以 UPN 格式指定要从中导出消息详细信息的用户帐户。 一个 UPN 值示例为 erika@contoso.onmicrosoft.com。

此参数用于 Exchange 和 Microsoft Teams 工作负载。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:6
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Workload

适用:安全 & 合规性

Workload 参数指定要从中导出文件详细信息的位置。 有效值包含:

  • EXO 或 Exchange
  • ODB 或 OneDrive
  • SPO 或 SharePoint
  • Teams

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:7
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters