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 的输出是一个数组。 从数组项 1 开始,包含记录数据
下表介绍了使用此 cmdlet 脚本的最佳做法:
建议不要使用单个脚本导出多个 SIT/标签。 相反,请为一个 SIT/标签创建脚本,然后根据需要为每个工作负载中的每个 SIT/标签重复使用相同的脚本。
重试脚本时,请确保首先重新连接到会话。 会话的令牌将在大约一小时后过期,这可能导致 cmdlet 失败。 要解决此问题,请先重新连接到会话,然后再重试脚本。 如果脚本失败,请使用返回的最后一页 Cookie 重启它,以便从上次中断的位置继续导出。
要在安全与合规中心 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"
示例 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
适用:安全性 & 合规性
注意: 此参数当前处于个人预览状态,并非在所有组织中都可用,并且可能会发生更改。
聚合参数开关返回文件夹级别的聚合数字,而不是返回项级别的详细信息。 不必为此开关指定值。
使用此开关可显著缩短导出时间。 若要下载文件夹中的项目,请对特定文件夹运行此 cmdlet。
将此开关与 TagName、TagType 和 Workload 参数配合使用时,该命令将返回以下信息:
- SharePoint 和 OneDrive:SiteUlr 的列表。
- Exchange Online 和 Microsoft Teams:UPN 列表。
- 标有相关标记的文件夹中的项目计数。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ConfidenceLevel
适用:安全性 & 合规性
ConfidenceLevel 参数指定要导出的文件详细信息的匹配的可信度。 有效值包含:
- low
- 中等
- 高
参数属性
| 类型: | String |
| 默认值: | None |
| 接受的值: | high, medium, low |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PageCookie
适用:安全性 & 合规性
PageCookie 参数指定当命令输出中的 MorePagesAvailable 属性值为 True 时是否获取更多数据。 如果不使用 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 的执行中,它将从其余 5 个文件夹中返回 5 条记录,即使 PageSize 值为 10。
参数属性
| 类型: | 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
适用:安全性 & 合规性
工作负载参数指定要从中导出文件详细信息的位置。 有效值包含:
- 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。