Compartilhar via


New-SafeLinksPolicy

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

Use o cmdlet New-SafeLinksPolicy para criar políticas de Links Seguros em sua organização baseada em nuvem.

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

Syntax

New-SafeLinksPolicy
   [-Name] <String>
   [-AdminDisplayName <String>]
   [-AllowClickThrough <Boolean>]
   [-Confirm]
   [-CustomNotificationText <String>]
   [-DeliverMessageAfterScan <Boolean>]
   [-DisableUrlRewrite <Boolean>]
   [-DoNotRewriteUrls <MultiValuedProperty>]
   [-EnableForInternalSenders <Boolean>]
   [-EnableOrganizationBranding <Boolean>]
   [-EnableSafeLinksForEmail <Boolean>]
   [-EnableSafeLinksForOffice <Boolean>]
   [-EnableSafeLinksForTeams <Boolean>]
   [-MakeBuiltInProtection]
   [-RecommendedPolicyType <RecommendedPolicyType>]
   [-ScanUrls <Boolean>]
   [-TrackClicks <Boolean>]
   [-UseTranslatedNotificationText <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

Links Seguros é um recurso no Microsoft Defender para Office 365 que verifica links para ver se eles levam a sites mal-intencionados. Quando um usuário clica em um link, a URL é reescrita temporariamente e verificada em uma lista de sites conhecidos e mal-intencionados. Links Seguros inclui o recurso de relatório de rastreamento de URL para ajudar a determinar quem clicou em um site mal-intencionado.

Novas políticas que você cria usando esse cmdlet não são aplicadas aos usuários e não estão visíveis em centros de administração. Você precisa usar o parâmetro SafeLinksPolicy nos cmdlets New-SafeLinksRule ou Set-SafeLinksRule para associar a política a uma regra.

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

New-SafeLinksPolicy -Name "Marketing Block URL" -EnableSafeLinksForEmail $true -AllowClickThrough $false

Este exemplo cria uma nova política de Links Seguros chamada URL do Bloco de Marketing com as seguintes opções:

  • A política é habilitada.
  • Os usuários não podem clicar na URL original.
  • Os cliques do usuário em URLs são rastreados. Esse é o valor padrão do parâmetro TrackClicks, portanto, você não precisa especifique-o.

Parâmetros

-AdminDisplayName

O parâmetro AdminDisplayName especifica uma descrição para a política. Se o valor contiver espaços, coloque-o entre aspas (").

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

-AllowClickThrough

O parâmetro AllowClickThrough especifica se os usuários podem clicar na URL original em páginas de aviso. Os valores válidos são:

  • $true: o usuário pode clicar na URL original.
  • $false: o usuário não tem permissão para clicar na URL original.

No PowerShell, o valor padrão é $false. Em novas políticas de Links Seguros criadas no portal Microsoft 365 Defender, o valor padrão é $true.

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

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-CustomNotificationText

O texto de notificação personalizada especifica o texto de notificação personalizado a ser mostrado aos usuários. Se o valor contiver espaços, coloque-o entre aspas (").

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

-DeliverMessageAfterScan

O parâmetro DeliverMessageAfterScan especifica se deve fornecer mensagens de email somente após a conclusão da verificação de Links Seguros. Os valores válidos são:

  • $true: aguarde até que a verificação de Links Seguros seja concluída antes de entregar a mensagem. Mensagens que contêm links mal-intencionados não são entregues. Esse é o valor padrão.
  • $false: se a verificação de Links Seguros não puder ser concluída, entregue a mensagem de qualquer maneira.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DisableUrlRewrite

O parâmetro DisableUrlRewrite especifica se as URLs (wrap) devem ser reescritas em mensagens de email. Os valores válidos são:

  • $true: as URLs nas mensagens não são reescritas, mas as mensagens ainda são examinadas por Links Seguros antes da entrega. O tempo de clicar em verificações nos links é feito usando a API de Links Seguros em clientes do Outlook com suporte (atualmente, Outlook para Windows e Outlook para Mac).
  • $false: AS URLs nas mensagens são reescritas. Verificações de API ainda ocorrem em URLs desembrulhadas em clientes com suporte se o usuário estiver em uma política válida de Links Seguros. Esse é o valor padrão.

No PowerShell, o valor padrão é $false. Em novas políticas de Links Seguros criadas no portal Microsoft 365 Defender, o valor padrão é $true.

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

-DoNotRewriteUrls

O parâmetro DoNotRewriteUrls especifica as URLs que não são reescritas pela verificação de Links Seguros. A lista de entradas permite que os usuários incluídos na política acessem as URLs especificadas que, de outra forma, seriam bloqueadas por Links Seguros.

Para inserir vários valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Para obter detalhes sobre a sintaxe de entrada, consulte Sintaxe de entrada para a lista "Não reescreva as URLs a seguir".

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

-EnableForInternalSenders

O parâmetro EnableForInternalSenders especifica se a política Links Seguros é aplicada a mensagens enviadas entre remetentes internos e destinatários internos na mesma organização Exchange Online. Os valores válidos são:

  • $true: a política é aplicada a remetentes internos e externos. Esse é o valor padrão.
  • $false: a política é aplicada somente a remetentes externos.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableOrganizationBranding

O parâmetro EnableOrganizationBranding especifica se o logotipo da sua organização é exibido em páginas de aviso e notificação de Links Seguros. Os valores válidos são:

  • $true: A identidade visual da organização é exibida em páginas de aviso e notificação de Links Seguros. Antes de configurar esse valor, você precisa seguir as instruções em Personalizar o tema do Microsoft 365 para sua organização carregar o logotipo da empresa.
  • $false: A identidade visual da organização não é exibida em páginas de aviso e notificação de Links Seguros. Esse é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableSafeLinksForEmail

O parâmetro EnableSafeLinksForEmail especifica se é necessário habilitar a proteção de Links Seguros para mensagens de email. Os valores válidos são:

  • $true: Links seguros estão habilitados para email. Esse é o valor padrão. Quando um usuário clica em um link em um email, o link é verificado por Links Seguros. Se o link for considerado mal-intencionado, uma página de aviso será exibida no navegador da Web padrão.
  • $false: Links seguros não estão habilitados para email.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableSafeLinksForOffice

O parâmetro EnableSafeLinksForOffice especifica se é necessário habilitar a proteção de Links Seguros para aplicativos web, móveis ou de área de trabalho do Office com suporte. Os valores válidos são:

  • $true: a verificação de Links Seguros está habilitada em aplicativos do Office. Esse é o valor padrão. Quando um usuário abre um arquivo em um aplicativo do Office com suporte e clica em um link no arquivo, o link é verificado por Links Seguros. Se o link for considerado mal-intencionado, uma página de aviso será exibida no navegador da Web padrão.
  • $false: Links seguros não estão habilitados para aplicativos do Office.

Observe que essa proteção se aplica a links em documentos do Office, não links em mensagens de email.

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

-EnableSafeLinksForTeams

O parâmetro EnableSafeLinksForTeams especifica se os Links Seguros estão habilitados para o Microsoft Teams. Os valores válidos são:

  • $true: links seguros estão habilitados para o Teams. Esse é o valor padrão. Quando um usuário clica em um link em uma conversa do Teams, chat em grupo ou em canais, o link é verificado por Links Seguros. Se o link for considerado mal-intencionado, uma página de aviso será exibida no navegador da Web padrão.
  • $false: Links seguros não estão habilitados para o Teams.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-MakeBuiltInProtection

O comutador MakeBuiltInProtection é usado para a criação de políticas de proteção internas como parte das políticas de segurança predefinidas. Não use essa opção por conta própria.

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

-Name

O parâmetro Name especifica um nome exclusivo para a política Links Seguros. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RecommendedPolicyType

O parâmetro RecommendedPolicyType é usado para a criação de políticas Standard e Strict como parte das políticas de segurança predefinidas. Não use esse parâmetro por conta própria.

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

-ScanUrls

O parâmetro ScanUrls especifica se é possível habilitar ou desabilitar a verificação em tempo real de links clicados em mensagens de email. Os valores válidos são:

  • $true: a verificação em tempo real de links clicados, incluindo links que apontam para arquivos, está habilitada. Esse é o valor padrão.
  • $false: a verificação em tempo real de links clicados, incluindo links que apontam para arquivos, está desabilitada.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-TrackClicks

O parâmetro TrackClicks especifica se o usuário deve acompanhar cliques de usuário relacionados à proteção de links seguros de links. Os valores válidos são:

  • $true: as mensagens de cliques do usuário são rastreadas. Esse é o valor padrão.
  • $false: as mensagens de clique do usuário não são rastreadas.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UseTranslatedNotificationText

O UseTranslatedNotificationText especifica se deve usar o Microsoft Translator para localizar automaticamente o texto de notificação personalizado especificado com o parâmetro CustomNotificationText. Os valores válidos são:

  • $true: traduzir texto de notificação personalizado para o idioma do usuário.
  • $false: não traduza texto de notificação personalizado para o idioma do usuário. Esse é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

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