Export-ActivityExplorerData
此 Cmdlet 僅適用于安全 & 性合規性 PowerShell。 如需詳細資訊,請參閱 安全 & 性合規性 PowerShell。
使用 Export-ActivityExplorerData Cmdlet,從 Microsoft 365 Purview 合規性入口網站中的資料分類 > 活動總管匯出活動。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
Export-ActivityExplorerData
-EndTime <DateTime>
-OutputFormat <String>
-StartTime <DateTime>
[-Filter1 <String[]>]
[-Filter2 <String[]>]
[-Filter3 <String[]>]
[-Filter4 <String[]>]
[-Filter5 <String[]>]
[-PageCookie <String>]
[-PageSize <Int32>]
[<CommonParameters>]
Description
若要在安全 & 性合規性 PowerShell 中使用此 Cmdlet,您必須獲指派許可權。 如需詳細資訊,請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
Export-ActivityExplorerData -StartTime "07/08/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -PageSize 5000 -OutputFormat Json
此範例會針對 JSON 格式的指定日期範圍,匯出最多 5000 筆記錄。
範例 2
Export-ActivityExplorerData -StartTime "07/08/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -OutputFormat Json
此範例會針對 Json 格式的指定日期範圍,匯出最多 100 筆記錄。 如果有超過 100 筆記錄可用,命令輸出中的 LastPage 屬性值會是 False。 在新的查詢中,使用 Watermark 屬性的值做為 PageCookie 參數的值,以取得下一組記錄。
範例 3
Export-ActivityExplorerData -StartTime "07/08/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -OutputFormat Json -PageCookie 'JZDRkpowAEV%2fZYfn6hIQCr4tCwEdoQWT4OalAyQVJEAKUtRO%2f31ZvM%2fnnjtz%2fyneTVb9HVUNV7bK91frVVM17cXaaputAV7eQuWbEmZFWbU8yham002jkqxqs0Y1V3xgq2lcqWA98eE6Dtq6EN3IMinX2WPs%2bbromllxLPpOiJ07990WAnraG8QvRV5Twfyoe3%2f7itOO00rCNvmJsfiDvOmKBbsyYNeFb7gUwzKsvYX0urPNHKpyLNNEdxxM4DUjyQWJ0mB%2bskMqdJ7KR3ojQ3pSuyk87VGcAoQacCUtxQWCQe6Rmk0LCLP9jsBWxETsKUkTF5%2fYiT3KmHvgB65hEAbFonxfyYPu0JoHSYhg0hUkGnJUlhG0jBRTk7el%2fgQPpe2H6YF8qDGgt%2bhBk7zxjNw9qxglkqCoi%2bOF7P0dl7CBAgOWRb74i5ubSC%2bJ%2bQG6eyxgE7XP7fAC6S9n3kjl7yOQPYb7KdYsIwJ2gC5n4%2bjZzvx2kA0lZ%2fHI%2b%2ft8uK5urM3Gtk1L%2bf8J'
此範例與上一個範例有關,其中有超過 100 筆記錄可用, (該命令的 LastPage 屬性值為 False) 。 我們使用的日期範圍相同,但這次我們使用此命令中 PageCookie 參數上一個命令中的 Watermark 屬性值來取得其餘結果。
範例 4
Export-ActivityExplorerData -StartTime "07/06/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -Filter1 @("Activity", "FileArchived") -OutputFormat Csv
此範例會以 CSV 格式匯出最多 100 筆指定日期範圍的記錄,並依活動值 FileArchived 篩選輸出。
範例 5
Export-ActivityExplorerData -StartTime "07/06/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -Filter1 @("Activity", "FileArchived", "ArchiveCreated") -OutputFormat Json
此範例會以 JSON 格式匯出最多 100 筆指定日期範圍的記錄,並依活動值 FileArchived 或 ArchiveCreated 篩選輸出。
範例 6
Export-ActivityExplorerData -StartTime "07/06/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -Filter1 @("Activity", "FileArchived", "ArchiveCreated") -Filter2 @("Workload","Endpoint") -OutputFormat Json
此範例會針對 JSON 格式的指定日期範圍匯出最多 100 筆記錄,並依 FileArchived 或 ArchiveCreated 活動的工作負載值 Enpoint 篩選輸出。
參數
-EndTime
EndTime 參數會指定日期範圍的結束日期。
在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定成使用簡短日期格式 mm/dd/yyyy,請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期,或者也可以輸入日期和時間。 如果輸入日期和時間,請使用引號 (") 括住值,例如 "09/01/2018 5:00 PM"。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Filter1
Filter1 參數會篩選要匯出的資料。 此參數至少接受兩個值作為輸入:篩選名稱和至少一個篩選值。 例如, 會傳 @("Activity", "LabelApplied")
回活動值 LabelApplied
為 的記錄。
如果您為相同的參數指定多個篩選值,則會使用 OR 行為。 例如, 會傳 @("Activity", "LabelApplied", "LabelRemoved")
回活動值 LabelApplied
為 或 LabelRemoved
的記錄。
如果您將此參數與其他篩選參數搭配使用,則會跨參數使用 AND 行為。 例如:
-Filter1 @("Activity", "LabelApplied", "LabelRemoved") -Filter2 = @("Workload", "Exchange")
傳回具有活動值 LabelApplied
或 LabelRemoved
工作負載的 Exchange
記錄。 換句話說, ( (Activity eq LabelApplied
) OR (Activity eq LabelRemoved
) ) AND () Workload eq Exchange
。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Filter2
Filter2 參數會篩選要匯出的資料。 此參數的語法需求與 Filter1 參數相同、相同參數中多個值的相同 OR 行為,以及多個篩選參數的相同 AND 行為。
只有當您也在同一個命令中使用 Filter1 參數時,才使用此參數。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Filter3
Filter3 參數會篩選要匯出的資料。 此參數的語法需求與 Filter1 參數相同、相同參數中多個值的相同 OR 行為,以及多個篩選參數的相同 AND 行為。
只有在相同命令中也使用 Filter2 和 Filter1 參數時,才使用此參數。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Filter4
Filter4 參數會篩選要匯出的資料。 此參數的語法需求與 Filter1 參數相同、相同參數中多個值的相同 OR 行為,以及多個篩選參數的相同 AND 行為。
只有在相同命令中也使用 Filter3、Filter2 和 Filter1 參數時,才使用此參數。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Filter5
Filter5 參數會篩選要匯出的資料。 此參數的語法需求與 Filter1 參數相同、相同參數中多個值的相同 OR 行為,以及多個篩選參數的相同 AND 行為。
只有在相同命令中也使用 Filter4、Filter3、Filter2 和 Filter1 參數時,才使用此參數。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-OutputFormat
OutputFormat 參數會指定輸出格式。 有效值為:
- Csv
- Json
Type: | String |
Accepted values: | csv, json |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-PageCookie
PageCookie 參數會指定當命令輸出中的 LastPage 屬性值為 False 時,是否要取得更多資料。 如果您未使用 PageSize 參數,則會傳回最多 100 筆記錄。 如果您使用 PageSize 參數,則最多可以傳回 5000 筆記錄。 若要取得比目前命令中所傳回更多的記錄,請在具有相同日期範圍和篩選的新命令中,使用目前命令輸出中的 Watermark 屬性值作為 PageCookie 參數的值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-PageSize
PageSize 參數會指定每頁的顯示項目數上限。 此參數的有效輸入是 1 與 5000 之間的整數。 預設值為 100。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-StartTime
StartTime 參數會指定日期範圍的開始日期。
在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定成使用簡短日期格式 mm/dd/yyyy,請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期,或者也可以輸入日期和時間。 如果輸入日期和時間,請使用引號 (") 括住值,例如 "09/01/2018 5:00 PM"。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |