Get-SafeLinksAggregateReport
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 |