Get-SafeLinksAggregateReport

Módulo:: Exchange PowerShell

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 de Links Seguros dos ú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.

Sintaxe

Default (Default)

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 do 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
App
MessageCount
RecipientCount

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-SafeLinksAggregateReport -StartDate 06-01-2020 -EndDate 06-10-2020 -SummarizeBy App -AppNameList "Email Client","Teams"

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

Parâmetros

-Action

Aplicável: Exchange Online

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

Permitido
Blocked
ClickedDuringScan
ClickedEvenBlocked
Verificação
TenantAllowed
TenantBlocked
TenantBlockedAndClickedThrough

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

-AppNameList

Aplicável: Exchange Online

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

Cliente de Email
OfficeDocs
Teams

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

Aplicável: Exchange Online

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.

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

Propriedades do parâmetro

Tipo:	System.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

-StartDate

Aplicável: Exchange Online

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

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

Propriedades do parâmetro

Tipo:	System.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

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 Action ou App específico em uma linha do relatório.

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

Ação: somente os valores especificados pelo parâmetro Ação são retornados.
App: somente os valores especificados pelo parâmetro AppNameList são retornados.

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

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?