共用方式為


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

此指令小程式的輸出包含以下資訊:

  • 總計數:總計數。 若僅使用 TagName 與 TagType 參數,該值即為該標籤的總總總集計數。 若同時使用工作負載參數,則該值為該標籤工作負載中的總計數。 若使用 UserPrincipalName 或 SiteUrl 參數,該值即為該特定資料夾的數量。
  • MorePagesAvailable:顯示是否有更多紀錄可匯出。 該數值為真或假。
  • RecordsReturned:查詢中回傳的紀錄數量。
  • PageCookie:用於在 MorePagesAvailable 為真時取得下一組紀錄。
  • 記錄資料:此指令檔的輸出為陣列。 從陣列項目 1 開始,包含記錄資料

以下列表說明使用此 cmdlet 的腳本最佳實務:

  • 我們建議不要用單一腳本匯出多個 SIT/標籤。 相反地,先為一個 SIT/Label 建立腳本,然後根據需要在每個工作負載中重複使用相同的腳本。

  • 重試腳本時,務必先重新連接連線。 該會話的標記約一小時後到期,可能導致指令檔失敗。 要解決這個問題,請在重新嘗試腳本前重新連接連線。 如果腳本失敗,請使用最後回傳的頁面 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

適用:安全性 & 合規

便條: 此參數目前處於私人預覽狀態,並非所有組織都能提供,且可能會有所變動。

彙總參數切換會回傳資料夾層級的彙總數字,而非項目層級的詳細資料。 您不需要使用此參數指定值。

使用此開關大幅縮短匯出時間。 要下載資料夾中的物品,請執行這個針對特定資料夾的 cmdlet。

當你使用這個交換器搭配 TagName、TagType 和 Workload 參數時,指令會回傳以下資訊:

  • SharePoint 與 OneDrive:網站 ULRS 名單。
  • 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 個資料夾的紀錄。 在下一次使用 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 參數指定要匯出檔案細節的標籤類型。 有效值為:

  • 保留
  • 敏感資訊類型
  • 敏感度
  • 可訓練分類器

參數屬性

類型: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