Partilhar via

Get-SafeLinksDetailReport

Módulo:
Exchange PowerShell

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

Utilize o cmdlet Get-SafeLinksDetailReport para devolver informações detalhadas sobre os resultados das Ligações Seguras dos últimos 7 dias. Ontem é a data mais recente que pode especificar.

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

Sintaxe

Default (Padrão) 

Get-SafeLinksDetailReport

    [-Action <MultiValuedProperty>]
    [-AppNameList <MultiValuedProperty>]
    [-Domain <MultiValuedProperty>]
    [-EndDate <System.DateTime>]
    [-Page <Int32>]
    [-PageSize <Int32>]
    [-RecipientAddress <MultiValuedProperty>]
    [-StartDate <System.DateTime>]
    [<CommonParameters>]

Description

Nota: se executar Get-SafeLinksDetailReport sem especificar um intervalo de datas, o comando devolve um erro não especificado.

As Ligações Seguras são uma funcionalidade no Microsoft Defender para Office 365 que verifica as ligações nas mensagens de e-mail para ver se levam a sites maliciosos. 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.

Este cmdlet devolve as seguintes informações:

  • ClickTime
  • NetworkMessageId
  • ClientMessageId
  • SenderAddress
  • RecipientAddress
  • Url
  • UrlDomain
  • Ação
  • AppName
  • SourceId
  • Organização
  • DetectedBy (Ligações Seguras no Microsoft Defender para Office 365)
  • UrlType (atualmente vazio)
  • Sinalizadores (0: Permitido 1: Bloqueado 2: ClickedEvenBlocked 3: ClickedDuringScan)

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-SafeLinksDetailReport -StartDate 06-07-2020 -EndDate 06-10-2020 -Action Allowed,Blocked -AppNameList "Email Client","Teams" -Domain google.com,teams.com -RecipientAddress faith@contoso.com,chris@contoso.com

Este exemplo devolve filtros pelos resultados pelas seguintes informações:

  • Intervalo de datas: 7 de junho de 2020 a 10 de junho de 2020
  • Ação: Permitido e Bloqueado
  • AppNameList: Email Client e Teams
  • Domínio de URL: google.com e teams.com
  • Endereço de e-mail do destinatário: faith@contoso.com e chris@contoso.com

Parâmetros

-Action

Aplicável: Exchange Online

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

  • Permitido: o URL foi permitido devido a um veredicto "Bom".
  • Bloqueado: o URL foi bloqueado devido a um veredicto "Incorreto".
  • ClickedDuringScan: o utilizador ignorou a verificação do URL e avançou para o URL de destino antes de as Ligações Seguras terminarem a análise.
  • ClickedEvenBlocked: o utilizador foi bloqueado no momento do clique para aceder ao URL.
  • Análise: o URL está a ser analisado.
  • TenantAllowed: entrada de permissão de URL na Lista de Permissões/Bloqueios do Inquilino.
  • TenantBlocked: entrada de bloco de URL na Lista de Permissões/Bloqueios do Inquilino.
  • TenantBlockedAndClickedThrough: o URL foi bloqueado devido a uma entrada de bloco na Lista de Permissões/Bloqueios do Inquilino e o utilizador clicou na página de bloco para aceder ao URL.

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

Nota: os valores para este parâmetro são sensíveis às maiúsculas e minúsculas. Não foram devolvidos dados para uma ação, o que implica que a ação não ocorreu.

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 pela aplicação onde a ligação foi encontrada. 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".

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

O parâmetro Domain filtra os resultados pelo domínio no URL.

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:True
Valor do pipeline pelo nome da propriedade:True
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 utilizar o formato de data abreviada MM/dd/aaaa, introduza 01/09/2018 para especificar 1 de setembro de 2018.

Ontem é a data mais recente que pode especificar. Não pode especificar uma data com mais de 7 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:True
Valor dos argumentos restantes:False

-Page

Aplicável: Exchange Online

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

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

-RecipientAddress

Aplicável: Exchange Online

O parâmetro RecipientAddress filtra os resultados pelo endereço de email do destinatário.

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:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-StartDate

Aplicável: Exchange Online

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.

Ontem é a data mais recente que pode especificar. Não pode especificar uma data com mais de 7 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:True
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.