Partilhar via

Get-MailTrafficPolicyReport

Módulo:
Exchange PowerShell

Esse cmdlet só está disponível no serviço baseado em nuvem.

Utilize o cmdlet Get-MailTrafficPolicyReport para ver estatísticas sobre mensagens afetadas por políticas de prevenção de perda de dados (DLP) e regras de transporte dos últimos 90 dias.

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

Sintaxe

Default (Default) 

Get-MailTrafficPolicyReport
    [-Action <MultiValuedProperty>]
    [-AggregateBy <String>]
    [-Direction <MultiValuedProperty>]
    [-DlpPolicy <MultiValuedProperty>]
    [-Domain <MultiValuedProperty>]
    [-EndDate <DateTime>]
    [-EventType <MultiValuedProperty>]
    [-Page <Int32>]
    [-PageSize <Int32>]
    [-ProbeTag <String>]
    [-StartDate <DateTime>]
    [-SummarizeBy <MultiValuedProperty>]
    [-TransportRule <MultiValuedProperty>]
    [<CommonParameters>]

Description

Para o período do relatório especificado, o cmdlet retorna as seguintes informações:

  • Domínio
  • Data
  • Política DLP
  • Regra de Transporte
  • Tipo de Evento
  • Direção
  • Contagem de Mensagens

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-MailTrafficPolicyReport -Direction Outbound -StartDate 06/13/2015 -EndDate 06/15/2015

Este exemplo recupera a estatística de mensagens enviadas entre 13 de junho de 2015 e 15 de junho de 2015. que foram afetadas pelas políticas de DLP e regras de transporte.

Exemplo 2

Get-MailTrafficPolicyReport -StartDate 12/12/2015 -EndDate 12/12/2015 -Direction Outbound | Format-Table Domain,Date,EventType,Action,MessageCount

Este exemplo obtém as estáticas das mensagens enviadas a 12 de dezembro de 2015 e apresenta os resultados numa tabela. Cada combinação exclusiva de EventType e Action é exibida em uma linha separada na tabela.

Exemplo 3

Get-MailTrafficPolicyReport -StartDate 12/12/2015 -EndDate 12/12/2015 -Direction Outbound -SummarizeBy Domain,DlpPolicy,TransportRule,EventType | Format-Table Domain,Date,EventType,Action,MessageCount

Este exemplo é parecido com o exemplo anterior, mas agora os resultados são resumidos. Como o EventType é um dos valores resumidos, as linhas na tabela agora contêm os valores exclusivos de Action. O número total de linhas no relatório é reduzido e os valores de MessageCount ficam, de forma correspondente, maiores em cada linha.

Parâmetros

-Action

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro Ação filtra o relatório pela ação executada nas mensagens. Para ver a lista completa de valores válidos para este parâmetro, execute o comando: Get-MailFilterListReport -SelectionTarget Actions. A ação que especificar tem de corresponder ao tipo de relatório. Por exemplo, só pode especificar ações de filtro de software maligno para relatórios de software maligno.

O parâmetro Action filtra o relatório de acordo com a ação executada pelas políticas de DLP, regras de transporte, filtragem de malware ou filtragem de spam. Para exibir a lista completa de valores válidos para esse parâmetro, execute o comando Get-MailFilterListReport -SelectionTarget Actions. A ação que você especificar deve corresponder ao tipo de relatório. Por exemplo, você só pode especificar ações de filtro de malware para relatórios de malware.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AggregateBy

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro AggregateBy especifica o período do relatório. Os valores válidos são Hour, Day ou Summary. O valor padrão é Day.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Direction

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro Direction filtra os resultados por mensagens de entrada ou de saída. Os valores válidos são:

  • Entrada
  • Saída

Vários valores, separados por vírgulas, podem ser especificados.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DlpPolicy

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro DlpPolicy filtra o relatório de acordo com o nome da política de DLP. Vários valores, separados por vírgulas, podem ser especificados. Se o valor contiver espaços, coloque-o entre aspas (").

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Domain

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro Domain filtra os resultados por um domínio aceito na organização baseada na nuvem. Você pode especificar vários valores de domínio separados por vírgulas ou o valor All.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-EndDate

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro EndDate 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 utilizar o formato de data abreviada MM/dd/aaaa, introduza 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".

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EventType

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro EventType filtra o relatório pelo tipo de evento. Os valores válidos são:

  • DLPActionHits
  • DLPPolicyFalsePositive
  • DLPPolicyHits
  • DLPPolicyOverride
  • DLPRuleHits
  • TransportRuleActionHits
  • TransportRuleHits

Para ver a lista potencial de valores válidos para este parâmetro, execute o comando: Get-MailFilterListReport -SelectionTarget EventTypes. O tipo de evento que especificar tem de corresponder ao relatório. Por exemplo, só pode especificar tipos de eventos de política para relatórios de política.

Vários valores, separados por vírgulas, podem ser especificados.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Page

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro Page especifica o número de página dos resultados que você pretende exibir. A entrada válida para este parâmetro é um número inteiro entre 1 e 1000. O valor padrão é 1.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PageSize

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

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 é 1000.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProbeTag

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

Esse parâmetro está reservado para uso interno da Microsoft.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StartDate

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro StartDate 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 utilizar o formato de data abreviada MM/dd/aaaa, introduza 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".

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SummarizeBy

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro SummarizeBy retorna totais com base nos valores que você especificar. Quando o relatório filtra dados usando qualquer um dos valores aceitos por esse parâmetro, você pode usar o parâmetro SummarizeBy para resumir os resultados com base nesses valores. Para diminuir o número de linhas retornado no relatório, considere usar o parâmetro SummarizeBy. O resumo reduz a quantidade de dados que serão recuperados para o relatório e entrega o relatório mais rapidamente. Por exemplo, em vez de ver cada instância de um valor específico de EventType em uma linha individual no relatório, use o parâmetro SummarizeBy para ver o número total de instâncias do valor de EventType em uma linha no relatório.

Para este cmdlet, os valores válidos são:

  • Ação
  • Direção
  • DLPPolicy
  • Domínio
  • EventType
  • TransportRule

Vários valores, separados por vírgulas, podem ser especificados. Quando especifica os valores DLPPolicy, Domain, EventType ou TransportRule, o valor não é apresentado nos resultados (os valores nas colunas correspondentes estão em branco).

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TransportRule

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro TransportRule filtra o relatório pelo nome da regra de transporte. Vários valores, separados por vírgulas, podem ser especificados. Se o valor contiver espaços, coloque-o entre aspas (").

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.