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 來重新啟動指令碼,以從上次中斷的位置繼續匯出。
若要在安全性與合規性 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
適用對象:安全性 & 合規性
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。