Επεξεργασία

Κοινή χρήση μέσω


Export-ContentExplorerData

Note: This cmdlet is currently in Preview and is subject to change.

This cmdlet is available only in Security & Compliance PowerShell. For more information, see Security & Compliance PowerShell.

Use the Export-ContentExplorerData cmdlet to export data classification file details in Microsoft Purview compliance.

For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.

Syntax

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

Description

The output of this cmdlet contains the following information:

  • TotalCount: Aggregate count. If only the TagName and TagType parameters are used, the value is the total aggregate count for that tag. If the Workload parameter is also used, the value is the aggregate count in the workload for that tag. If the UserPrincipalName or SiteUrl parameters are used, the value is the count for that specific folder.
  • MorePagesAvailable: Shows whether there are more records left to export. The value is True or False.
  • RecordsReturned: The number of records returned in the query.
  • PageCookie: Used to get the next set of records when MorePagesAvailable is True.

To use this cmdlet in Security & Compliance PowerShell, you need to be assigned permissions. For more information, see Permissions in the Microsoft Purview compliance portal.

Examples

Example 1

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

This example exports records for the specified sensitive info type from Erika's mailbox.

Example 2

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

This example exports records for the specified sensitive info type in Erika's OneDrive site.

Example 3

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

This example exports records for the specified sensitive info type for all workloads.

Parameters

-Aggregate

{{ Fill Aggregate Description }}

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

The PageCookie parameter specifies whether to get more data when the value of the MorePagesAvailable property in the command output is True. If you don't use the PageSize parameter, a maximum of 100 records are returned. If you use the PageSize parameter, a maximum of 10000 records can be returned.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-PageSize

The PageSize parameter specifies the maximum number of records to return in a single query. Valid input for this parameter is an integer between 1 and 10000. The default value is 100.

Type:Int32
Position:2
Default value:0
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SiteUrl

The SiteUrl parameter specifies the site URL to export file details from.

You use this parameter for SharePoint and OneDrive workloads.

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TagName

The TagName parameter specifies the name of the label to export file details from. If the value contains spaces, enclose the value in quotation marks.

Type:String
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TagType

The TagType parameter specifies the type of label to export file details from. Valid values are:

  • Retention
  • SensitiveInformationType
  • Sensitivity
  • TrainableClassifier
Type:String
Position:5
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-UserPrincipalName

The UserPrincipalName parameter specifies the user account in UPN format to export message details from. An example UPN value is erika@contoso.onmicrosoft.com.

You use this parameter for Exchange and Microsoft Teams workloads.

Type:String
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Workload

The Workload parameter specifies the location to export file details from. Valid values are:

  • EXO or Exchange
  • ODB or OneDrive
  • SPO or SharePoint
  • Teams
Type:String
Position:7
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance