Export-ActivityExplorerData

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Security & Compliance

Esse cmdlet está disponível apenas no PowerShell de Conformidade de Segurança & . Para obter mais informações, consulte PowerShell de Conformidade de Segurança&.

Use o cmdlet Export-ActivityExplorerData para exportar atividades do Explorer de atividade de classificação > de dados no portal de conformidade do Microsoft 365 Purview.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

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 esse cmdlet no PowerShell de Conformidade de Segurança & , você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.

Exemplos

Exemplo 1

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

Este exemplo exporta um máximo de 5.000 registros para o intervalo de datas especificado no formato JSON.

Exemplo 2

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

Este exemplo exporta até 100 registros para o intervalo de datas especificado no formato Json. Se mais de 100 registros estiverem disponíveis, o valor da propriedade LastPage na saída de comando será False. Use o valor da propriedade Watermark como o valor do parâmetro PageCookie em uma nova consulta para obter o próximo conjunto de registros.

Exemplo 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 exemplo está relacionado ao exemplo anterior em que mais de 100 registros estavam disponíveis (o valor da propriedade LastPage desse comando era False). Estamos usando o mesmo intervalo de datas, mas desta vez estamos usando o valor da propriedade Watermark do comando anterior para o parâmetro PageCookie neste comando para obter os resultados restantes.

Exemplo 4

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

Este exemplo exporta até 100 registros para o intervalo de datas especificado no formato CSV e filtra a saída pelo valor de atividade FileArchived.

Exemplo 5

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

Este exemplo exporta até 100 registros para o intervalo de datas especificado no formato JSON e filtra a saída pelo valor de atividade FileArchived ou ArchiveCreated.

Exemplo 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

Este exemplo exporta até 100 registros para o intervalo de datas especificado no formato JSON e filtra a saída pelo ponto de enpoint de valor de carga de trabalho para atividades FileArchived ou ArchiveCreated.

Parâmetros

-EndTime

O parâmetro EndTime especifica a data de término do intervalo de datas.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/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

O parâmetro Filter1 filtra os dados a serem exportados. Esse parâmetro usa um mínimo de dois valores como entrada: um nome de filtro e pelo menos um valor de filtro. Por exemplo, @("Activity", "LabelApplied") retorna registros com o valor LabelAppliedda atividade .

Se você especificar vários valores de filtro para o mesmo parâmetro, o comportamento OR será usado. Por exemplo, @("Activity", "LabelApplied", "LabelRemoved") retorna registros com os valores LabelApplied de atividade ou LabelRemoved.

Se você usar esse parâmetro com outros parâmetros de filtro, o comportamento E será usado entre parâmetros. Por exemplo:

-Filter1 @("Activity", "LabelApplied", "LabelRemoved") -Filter2 = @("Workload", "Exchange") retorna registros com os valores LabelApplied de atividade ou LabelRemoved para a Exchange carga de trabalho. Em outras palavras, ((Activity eq LabelApplied) OR (Activity eq LabelRemoved)) E (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

O parâmetro Filter2 filtra os dados a serem exportados. Esse parâmetro tem os mesmos requisitos de sintaxe que o parâmetro Filter1, o mesmo comportamento OR para vários valores no mesmo parâmetro e o mesmo comportamento E para vários parâmetros de filtro.

Use esse parâmetro somente se você também estiver usando o parâmetro Filter1 no mesmo comando.

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

-Filter3

O parâmetro Filter3 filtra os dados a serem exportados. Esse parâmetro tem os mesmos requisitos de sintaxe que o parâmetro Filter1, o mesmo comportamento OR para vários valores no mesmo parâmetro e o mesmo comportamento E para vários parâmetros de filtro.

Use esse parâmetro somente se você também estiver usando os parâmetros Filter2 e Filter1 no mesmo comando.

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

-Filter4

O parâmetro Filter4 filtra os dados a serem exportados. Esse parâmetro tem os mesmos requisitos de sintaxe que o parâmetro Filter1, o mesmo comportamento OR para vários valores no mesmo parâmetro e o mesmo comportamento E para vários parâmetros de filtro.

Use esse parâmetro somente se você também estiver usando os parâmetros Filter3, Filter2 e Filter1 no mesmo comando.

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

-Filter5

O parâmetro Filter5 filtra os dados a serem exportados. Esse parâmetro tem os mesmos requisitos de sintaxe que o parâmetro Filter1, o mesmo comportamento OR para vários valores no mesmo parâmetro e o mesmo comportamento E para vários parâmetros de filtro.

Use esse parâmetro somente se você também estiver usando os parâmetros Filter4, Filter3, Filter2 e Filter1 no mesmo comando.

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

-OutputFormat

O parâmetro OutputFormat especifica o formato de saída. Os valores válidos são:

  • 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

O parâmetro PageCookie especifica se deve obter mais dados quando o valor da propriedade LastPage na saída de comando é False. Se você não usar o parâmetro PageSize, um máximo de 100 registros serão retornados. Se você usar o parâmetro PageSize, um máximo de 5.000 registros poderá ser retornado. Para obter mais registros do que o retornado no comando atual, use o valor da propriedade Watermark da saída do comando atual como o valor do parâmetro PageCookie em um novo comando com o mesmo intervalo de datas e filtros.

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

-PageSize

O parâmetro PageSize especifica o número máximo de entradas por página. A entrada válida para esse parâmetro é um número inteiro entre 1 e 5000. O valor padrão é 100.

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

-StartTime

O parâmetro StartTime especifica a data de início do intervalo de datas.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

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