Freigeben über


Export-ActivityExplorerData

Dieses Cmdlet ist nur in PowerShell zur Sicherheitskonformität & verfügbar. Weitere Informationen finden Sie unter Security & Compliance PowerShell.

Verwenden Sie das Cmdlet Export-ActivityExplorerData, um Aktivitäten aus der Datenklassifizierungsaktivität > Explorer im Microsoft 365 Purview-Complianceportal zu exportieren.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Export-ActivityExplorerData
      -EndTime <DateTime>
      -OutputFormat <String>
      -StartTime <DateTime>
      [-Filter1 <String[]>]
      [-Filter2 <String[]>]
      [-Filter3 <String[]>]
      [-Filter4 <String[]>]
      [-Filter5 <String[]>]
      [-PageCookie <String>]
      [-PageSize <Int32>]
      [<CommonParameters>]

Beschreibung

Um dieses Cmdlet in PowerShell für Sicherheitskonformität & verwenden zu können, müssen Ihnen Berechtigungen zugewiesen werden. Weitere Informationen finden Sie unter Berechtigungen im Microsoft Purview-Complianceportal.

Beispiele

Beispiel 1

Export-ActivityExplorerData -StartTime "07/08/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -PageSize 5000 -OutputFormat Json

In diesem Beispiel werden maximal 5.000 Datensätze für den angegebenen Datumsbereich im JSON-Format exportiert.

Beispiel 2

Export-ActivityExplorerData -StartTime "07/08/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -OutputFormat Json

In diesem Beispiel werden bis zu 100 Datensätze für den angegebenen Datumsbereich im JSON-Format exportiert. Wenn mehr als 100 Datensätze verfügbar sind, lautet der Wert der LastPage-Eigenschaft in der Befehlsausgabe False. Verwenden Sie den Wert der Watermark-Eigenschaft als Wert des PageCookie-Parameters in einer neuen Abfrage, um den nächsten Satz von Datensätzen abzurufen.

Beispiel 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'

Dieses Beispiel bezieht sich auf das vorherige Beispiel, in dem mehr als 100 Datensätze verfügbar waren (der Wert der LastPage-Eigenschaft aus diesem Befehl war False). Wir verwenden den gleichen Datumsbereich, aber dieses Mal verwenden wir den Wert der Watermark-Eigenschaft aus dem vorherigen Befehl für den PageCookie-Parameter in diesem Befehl, um die verbleibenden Ergebnisse abzurufen.

Beispiel 4

Export-ActivityExplorerData -StartTime "07/06/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -Filter1 @("Activity", "FileArchived") -OutputFormat Csv

In diesem Beispiel werden bis zu 100 Datensätze für den angegebenen Datumsbereich im CSV-Format exportiert und die Ausgabe nach dem Aktivitätswert FileArchived gefiltert.

Beispiel 5

Export-ActivityExplorerData -StartTime "07/06/2022 07:15 AM" -EndTime "07/08/2022 11:08 AM" -Filter1 @("Activity", "FileArchived", "ArchiveCreated") -OutputFormat Json

In diesem Beispiel werden bis zu 100 Datensätze für den angegebenen Datumsbereich im JSON-Format exportiert und die Ausgabe nach dem Aktivitätswert FileArchived oder ArchiveCreated gefiltert.

Beispiel 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

In diesem Beispiel werden bis zu 100 Datensätze für den angegebenen Datumsbereich im JSON-Format exportiert und die Ausgabe nach dem Workloadwert Enpoint für FileArchived- oder ArchiveCreated-Aktivitäten gefiltert.

Parameter

-EndTime

Der Parameter EndTime gibt das Enddatum des Datumsbereichs an.

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn auf dem Computer z. B. das kurze Datumsformat TT.MM.JJJJ konfiguriert ist, geben Sie "01.09.2018" ein, um als Datum den 1. September 2018 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie das Datum und die Uhrzeit eingeben, setzen Sie das den Wert in Anführungszeichen ("), z. B. "09.01.2018 17:00".

Type:DateTime
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Filter1

Der Parameter Filter1 filtert die zu exportierenden Daten. Dieser Parameter verwendet mindestens zwei Werte als Eingabe: einen Filternamen und mindestens einen Filterwert. Gibt beispielsweise @("Activity", "LabelApplied") Datensätze mit dem Aktivitätswert LabelAppliedzurück.

Wenn Sie mehrere Filterwerte für denselben Parameter angeben, wird OR-Verhalten verwendet. Gibt beispielsweise @("Activity", "LabelApplied", "LabelRemoved") Datensätze mit den Aktivitätswerten LabelApplied oder LabelRemovedzurück.

Wenn Sie diesen Parameter mit anderen Filterparametern verwenden, wird DAS AND-Verhalten parameterübergreifend verwendet. Zum Beispiel:

-Filter1 @("Activity", "LabelApplied", "LabelRemoved") -Filter2 = @("Workload", "Exchange") gibt Datensätze mit den Aktivitätswerten LabelApplied oder LabelRemoved für die Exchange Workload zurück. Anders ausgedrückt: ((Activity eq LabelApplied) ODER (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

Der Parameter Filter2 filtert die zu exportierenden Daten. Dieser Parameter hat die gleichen Syntaxanforderungen wie der Parameter Filter1, das gleiche OR-Verhalten für mehrere Werte im gleichen Parameter und das gleiche AND-Verhalten für mehrere Filterparameter.

Verwenden Sie diesen Parameter nur, wenn Sie auch den Parameter Filter1 im selben Befehl verwenden.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Filter3

Der Parameter Filter3 filtert die zu exportierenden Daten. Dieser Parameter hat die gleichen Syntaxanforderungen wie der Parameter Filter1, das gleiche OR-Verhalten für mehrere Werte im gleichen Parameter und das gleiche AND-Verhalten für mehrere Filterparameter.

Verwenden Sie diesen Parameter nur, wenn Sie auch die Parameter Filter2 und Filter1 im selben Befehl verwenden.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Filter4

Der Parameter Filter4 filtert die zu exportierenden Daten. Dieser Parameter hat die gleichen Syntaxanforderungen wie der Parameter Filter1, das gleiche OR-Verhalten für mehrere Werte im gleichen Parameter und das gleiche AND-Verhalten für mehrere Filterparameter.

Verwenden Sie diesen Parameter nur, wenn Sie auch die Parameter Filter3, Filter2 und Filter1 im selben Befehl verwenden.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Filter5

Der Parameter Filter5 filtert die zu exportierenden Daten. Dieser Parameter hat die gleichen Syntaxanforderungen wie der Parameter Filter1, das gleiche OR-Verhalten für mehrere Werte im gleichen Parameter und das gleiche AND-Verhalten für mehrere Filterparameter.

Verwenden Sie diesen Parameter nur, wenn Sie auch die Parameter Filter4, Filter3, Filter2 und Filter1 im selben Befehl verwenden.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-OutputFormat

Der OutputFormat-Parameter gibt das Ausgabeformat an. Gültige Werte sind:

  • 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

Der PageCookie-Parameter gibt an, ob weitere Daten abgerufen werden sollen, wenn der Wert der LastPage-Eigenschaft in der Befehlsausgabe False ist. Wenn Sie den PageSize-Parameter nicht verwenden, werden maximal 100 Datensätze zurückgegeben. Wenn Sie den PageSize-Parameter verwenden, können maximal 5.000 Datensätze zurückgegeben werden. Um mehr Datensätze abzurufen, als im aktuellen Befehl zurückgegeben werden, verwenden Sie den Wert der Watermark-Eigenschaft aus der Ausgabe des aktuellen Befehls als Wert für den PageCookie-Parameter in einem neuen Befehl mit demselben Datumsbereich und denselben Filtern.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-PageSize

Der PageSize-Parameter gibt die maximale Anzahl von Einträgen pro Seite an. Gültige Eingabewerte für diesen Parameter sind ganze Zahlen zwischen 1 und 5000. Der Standardwert ist 100.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-StartTime

Der StartTime-Parameter gibt das Startdatum des Datumsbereichs an.

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn auf dem Computer z. B. das kurze Datumsformat TT.MM.JJJJ konfiguriert ist, geben Sie "01.09.2018" ein, um als Datum den 1. September 2018 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie das Datum und die Uhrzeit eingeben, setzen Sie das den Wert in Anführungszeichen ("), z. B. "09.01.2018 17:00".

Type:DateTime
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance