Compartir a través de


Export-ActivityExplorerData

Este cmdlet solo está disponible en PowerShell de cumplimiento de seguridad & . Para obtener más información, consulte Security & Compliance PowerShell.

Use el cmdlet Export-ActivityExplorerData para exportar actividades desde el Explorador de actividad de clasificación > de datos en el portal de cumplimiento de Microsoft 365 Purview.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

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

Para usar este cmdlet en PowerShell de cumplimiento de seguridad & , debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.

Ejemplos

Ejemplo 1

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

En este ejemplo se exporta un máximo de 5000 registros para el intervalo de fechas especificado en formato JSON.

Ejemplo 2

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

En este ejemplo se exportan hasta 100 registros para el intervalo de fechas especificado en formato Json. Si hay más de 100 registros disponibles, el valor de la propiedad LastPage en la salida del comando será False. Use el valor de la propiedad Watermark como valor del parámetro PageCookie en una nueva consulta para obtener el siguiente conjunto de registros.

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

Este ejemplo está relacionado con el ejemplo anterior donde había más de 100 registros disponibles (el valor de la propiedad LastPage de ese comando era False). Estamos usando el mismo intervalo de fechas, pero esta vez estamos usando el valor de la propiedad Watermark del comando anterior para el parámetro PageCookie en este comando para obtener los resultados restantes.

Ejemplo 4

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

En este ejemplo se exportan hasta 100 registros para el intervalo de fechas especificado en formato CSV y se filtra la salida por el valor de actividad FileArchived.

Ejemplo 5

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

En este ejemplo se exportan hasta 100 registros para el intervalo de fechas especificado en formato JSON y se filtra la salida por el valor de actividad FileArchived o ArchiveCreated.

Ejemplo 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

En este ejemplo se exportan hasta 100 registros para el intervalo de fechas especificado en formato JSON y se filtra la salida por el valor de Carga de trabajo Enpoint para las actividades FileArchived o ArchiveCreated.

Parámetros

-EndTime

El parámetro EndTime especifica la fecha de finalización del intervalo de fechas.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/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

El parámetro Filter1 filtra los datos que se van a exportar. Este parámetro toma como entrada un mínimo de dos valores: un nombre de filtro y al menos un valor de filtro. Por ejemplo, @("Activity", "LabelApplied") devuelve registros con el valor LabelAppliedde actividad .

Si especifica varios valores de filtro para el mismo parámetro, se usa el comportamiento OR. Por ejemplo, @("Activity", "LabelApplied", "LabelRemoved") devuelve registros con los valores LabelApplied de actividad o LabelRemoved.

Si usa este parámetro con otros parámetros de filtro, el comportamiento AND se usa en todos los parámetros. Por ejemplo:

-Filter1 @("Activity", "LabelApplied", "LabelRemoved") -Filter2 = @("Workload", "Exchange") devuelve registros con los valores LabelApplied de actividad o LabelRemoved para la carga de Exchange trabajo. En otras palabras, ((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

El parámetro Filter2 filtra los datos que se van a exportar. Este parámetro tiene los mismos requisitos de sintaxis que el parámetro Filter1, el mismo comportamiento OR para varios valores en el mismo parámetro y el mismo comportamiento AND para varios parámetros de filtro.

Use este parámetro solo si también usa el parámetro Filter1 en el mismo comando.

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

-Filter3

El parámetro Filter3 filtra los datos que se van a exportar. Este parámetro tiene los mismos requisitos de sintaxis que el parámetro Filter1, el mismo comportamiento OR para varios valores en el mismo parámetro y el mismo comportamiento AND para varios parámetros de filtro.

Use este parámetro solo si también usa los parámetros Filter2 y Filter1 en el mismo comando.

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

-Filter4

El parámetro Filter4 filtra los datos que se van a exportar. Este parámetro tiene los mismos requisitos de sintaxis que el parámetro Filter1, el mismo comportamiento OR para varios valores en el mismo parámetro y el mismo comportamiento AND para varios parámetros de filtro.

Use este parámetro solo si también usa los parámetros Filter3, Filter2 y Filter1 en el mismo comando.

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

-Filter5

El parámetro Filter5 filtra los datos que se van a exportar. Este parámetro tiene los mismos requisitos de sintaxis que el parámetro Filter1, el mismo comportamiento OR para varios valores en el mismo parámetro y el mismo comportamiento AND para varios parámetros de filtro.

Use este parámetro solo si también usa los parámetros Filter4, Filter3, Filter2 y Filter1 en el mismo comando.

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

-OutputFormat

El parámetro OutputFormat especifica el formato de salida. Los valores admitidos son:

  • 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

El parámetro PageCookie especifica si se obtienen más datos cuando el valor de la propiedad LastPage en la salida del comando es False. Si no usa el parámetro PageSize, se devuelve un máximo de 100 registros. Si usa el parámetro PageSize, se puede devolver un máximo de 5000 registros. Para obtener más registros de los que se devuelven en el comando actual, use el valor de la propiedad Watermark de la salida del comando actual como valor del parámetro PageCookie en un nuevo comando con el mismo intervalo de fechas y filtros.

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

-PageSize

El parámetro PageSize especifica el número máximo de entradas por página. La entrada válida para este parámetro es un número entero entre 1 y 5000. El valor predeterminado es 100.

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

-StartTime

El parámetro StartTime especifica la fecha de inicio del intervalo de fechas.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/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