Get-SafeLinksAggregateReport

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Online

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

Use o cmdlet Get-SafeLinksAggregateReport para retornar informações gerais sobre os resultados dos Links Seguros nos últimos 90 dias. Ontem é a data mais recente que você pode especificar.

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

Syntax

Get-SafeLinksAggregateReport
   [-Action <MultiValuedProperty>]
   [-AppNameList <MultiValuedProperty>]
   [-EndDate <System.DateTime>]
   [-StartDate <System.DateTime>]
   [-SummarizeBy <String>]
   [<CommonParameters>]

Description

Observação: se você executar Get-SafeLinksAggregateReport sem especificar um intervalo de datas, o comando retornará um erro não especificado.

Links Seguros é um recurso no Microsoft Defender para Office 365 que verifica links em mensagens de email para ver se eles levam a sites mal-intencionados. Quando um usuário clica em um link em uma mensagem, a URL é reescrita temporariamente e verificada em uma lista de sites mal-intencionados conhecidos.

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

  • Ação
  • Aplicativo
  • MessageCount
  • RecipientCount

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico 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-SafeLinksAggregateReport -StartDate 06-01-2020 -EndDate 06-10-2020 -SummarizeBy App -AppNameList "Email Client","Teams"

Este exemplo retorna resultados resumidos por Email resultados do Cliente e do Teams para o intervalo de datas especificado.

Parâmetros

-Action

O parâmetro Ação filtra os resultados por ação. Os valores válidos são:

  • Permitido
  • Blocked
  • Clique emDuringScan
  • Clique emEvenBlocked
  • Verificação
  • TenantAllowed
  • TenantBlocked
  • TenantBlockedAndClickedThrough

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

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-AppNameList

O parâmetro AppNameList filtra os resultados pelo aplicativo em que o link foi encontrado. Os valores válidos são:

  • cliente Email
  • OfficeDocs
  • Teams

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

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-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/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018.

Ontem é a data mais recente que você pode especificar. Você não pode especificar uma data com mais de 90 dias.

Type:System.DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-StartDate

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 usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018.

Ontem é a data mais recente que você pode especificar. Você não pode especificar uma data com mais de 90 dias.

Type:System.DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-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 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 Action ou AppNameList em uma linha individual no relatório, você pode usar o parâmetro SummarizeBy para ver o número total de instâncias dessa ação ou aplicativo específico em uma linha no relatório.

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

  • Ação: somente os valores especificados pelo parâmetro Action são retornados.
  • Aplicativo: somente os valores especificados pelo parâmetro AppNameList são retornados.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online