Export-ActivityExplorerData

  • 參考
模組:
ExchangePowerShell
適用於:
Security & Compliance

此 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