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>]

Description

此 Cmdlet 的輸出包含下列資訊:

  • TotalCount:彙總計數。 如果僅使用 TagName 和 TagType 參數,則該值是該標籤的總彙總計數。 如果還使用 Workload 參數,則該值是該標籤的工作負載中的彙總計數。 如果使用 UserPrincipalName 或 SiteUrl 參數,則該值就是該特定資料夾的計數。
  • MorePagesAvailable:顯示是否還有更多記錄要匯出。 值為 True 或 False。
  • RecordsReturned:查詢中傳回的記錄數目。
  • PageCookie:當 MorePagesAvailable 為 True 時,用於取得下一組記錄。
  • 記錄資料: 此 Cmdlet 的輸出是陣列。 從陣列項目 1 開始,包含記錄資料

下列清單說明使用此 Cmdlet 的指令碼最佳做法:

  • 建議您不要使用單一指令碼匯出多個 SIT/標籤。 相反地,請為一個 SIT/標籤建立指令碼,然後視需要針對每個工作負載中的每個 SIT/標籤重複使用相同的指令碼。

  • 重試指令碼時,請務必先重新連線至工作階段。 工作階段的權杖會在大約一小時後過期,這可能會導致 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"

範例 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 參數參數會傳回資料夾層級的彙總數字,而不是在項目層級傳回詳細資料。 您不需要使用此參數指定值。

使用此參數可大幅減少匯出時間。 若要下載資料夾中的項目,請針對特定資料夾執行此 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 參數會指定要匯出的檔案詳細資料相符項目的信賴等級。 有效值為:

  • 低
  • 中等
  • 高度

參數屬性

類型:String
預設值:None
接受的值:high, medium, low
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:0
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

適用對象:安全性 & 合規性

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 筆記錄。 下次使用 page 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。