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 重新啟動,從中止處繼續匯出。
若要在安全性與合規性 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
適用:安全性 & 合規
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。