Get-DlpDetectionsReport

Módulo:: Exchange PowerShell

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

Observação: Este cmdlet será desativado. Use o cmdlet Export-ActivityExplorerData para exibir informações de DLP. Os dados do Export-ActivityExplorerData são os mesmos que o cmdlet Get-DlpIncidentDetailReport desativado.

Use o cmdlet Get-DlpDetectionsReport para listar um resumo das correspondências de regra de DLP (prevenção contra perda de dados) para Exchange Online, SharePoint e OneDrive em sua organização baseada em nuvem nos últimos 30 dias.

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

Sintaxe

Default (Default)

Get-DlpDetectionsReport
    [-Action <MultiValuedProperty>]
    [-AggregateBy <String>]
    [-DlpCompliancePolicy <MultiValuedProperty>]
    [-DlpComplianceRule <MultiValuedProperty>]
    [-EndDate <DateTime>]
    [-Expression <Expression>]
    [-EventType <MultiValuedProperty>]
    [-Page <Int32>]
    [-PageSize <Int32>]
    [-Source <MultiValuedProperty>]
    [-StartDate <DateTime>]
    [-SummarizeBy <MultiValuedProperty>]
    [<CommonParameters>]

Description

O cmdlet Get-DlpDetectionsReport retorna dados gerais da detecção de DLP que são agregados por dia. As propriedades retornadas incluem:

Data
Política DLP
Regra de conformidade de DLP
Tipo de Evento
Origem
Contagem de mensagens

Para ver todas essas colunas (problemas de largura), grave a saída em um arquivo. Por exemplo, Get-DlpDetectionsReport | Out-String -Width 4096 | Out-File "C:\Users\admin\Desktop\DLP Detections Report.txt".

Para ver informações detalhadas sobre cada correspondência de regra DLP, use o cmdlet Get-DlpDetailReport.

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. 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-DlpDetectionsReport -StartDate 11/01/2018 -EndDate 11/30/2018

Este exemplo lista as atividades de DLP para novembro de 2018.

Parâmetros

-Action

O parâmetro Action filtra o relatório pela ação realizada pelas políticas DLP. Os valores válidos são:

BlockAccess
GenerateIncidentReport
NotifyUser

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

-AggregateBy

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

-DlpCompliancePolicy

O parâmetro DlpCompliancePolicy filtra o relatório pelo nome da política de conformidade DLP. Várias políticas podem ser especificadas, separadas por vírgulas.

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

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

-DlpComplianceRule

O parâmetro DlpComplianceRule filtra o relatório pelo nome da regra de conformidade DLP. Várias regras podem ser especificadas, separadas por vírgulas.

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

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

-EndDate

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 usar o formato de data abreviada MM/dd/aaaa, 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".

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

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

DataRetentions
DLPActionHits
DLPActionUndo
DLPByIncidentIdActionHits
DLPByIncidentIdMessages
DLPByIncidentIdPolicyFalsePositive
DLPByIncidentIdPolicyHits
DLPByIncidentIdPolicyOverride
DLPByIncidentIdRuleHits
DLPMessages
DLPPolicyFalsePositive
DLPPolicyHits
DLPPolicyOverride
DLPRuleHits

Para exibir a lista potencial de valores válidos para esse parâmetro, execute o comando: Get-MailFilterListReport -SelectionTarget EventTypes. O tipo de evento especificado deve corresponder ao relatório. Por exemplo, você só pode especificar tipos de evento DLP para relatórios DLP.

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

-Expression

Esse parâmetro só está disponível no PowerShell de Segurança & Conformidade

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

Propriedades do parâmetro

Tipo:	Expression
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

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

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

-Source

O parâmetro Source filtra o relatório por carga de trabalho. Os valores válidos são:

EXCH: Exchange Online
ODB: OneDrive
SPO: SharePoint

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

-StartDate

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

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

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 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 esse cmdlet, os valores válidos são:

DLPPolicy
Domínio
EventType

Vários valores, separados por vírgulas, podem ser especificados. Os valores especificados para esse parâmetro não são exibidos nos resultados (os valores nas colunas correspondentes ficam 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

CommonParameters

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

Comentários

Esta página foi útil?