New-SafeLinksPolicy

Módulo:: Exchange PowerShell

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.

Sintaxe

Default (Default)

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 do Microsoft Defender para Office 365 que verifica os links para ver se eles levam a sites mal-intencionados. Quando um usuário clica em um link, a URL é temporariamente reescrita 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.

As novas políticas que você cria usando esse cmdlet não são aplicadas aos usuários e não são visíveis nos 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 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

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

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

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

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 (").

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

-AllowClickThrough

O parâmetro AllowClickThrough especifica se os usuários têm permissão para clicar na URL original nas páginas de aviso. Os valores válidos são:

$true: O usuário tem permissão para 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. Nas novas políticas de Links Seguros criadas no portal Microsoft Defender, o valor padrão é $true.

Propriedades do parâmetro

Tipo:	Boolean
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

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	cf

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

-CustomNotificationText

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

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

-DeliverMessageAfterScan

O parâmetro DeliverMessageAfterScan especifica se as mensagens de email devem ser entregues 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 valor é o padrão.
$false: se a verificação de links seguros não for concluída, entregue a mensagem de qualquer maneira.

Propriedades do parâmetro

Tipo:	Boolean
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

-DisableUrlRewrite

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

$true: URLs em mensagens não são regravadas, mas as mensagens ainda são verificadas por links seguros antes da entrega. As verificações de tempo de clique nos links são feitas usando a API de Links Seguros em clientes Outlook com suporte (atualmente, Outlook para Windows e Outlook para Mac).
$false: URLs em mensagens são reescritas. As verificações de API ainda ocorrerão em URLs não encapsuladas em clientes com suporte se o usuário estiver em uma política de Links Seguros válida. Esse valor é o padrão.

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

Propriedades do parâmetro

Tipo:	Boolean
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

-DoNotRewriteUrls

O parâmetro DoNotRewriteUrls especifica os URLs que não são reescritos 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 as 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 reescrever as seguintes URLs".

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

-EnableForInternalSenders

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

$true: A política é aplicada a remetentes internos e externos. Esse valor é o padrão.
$false: A política é aplicada somente a remetentes externos.

Propriedades do parâmetro

Tipo:	Boolean
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

-EnableOrganizationBranding

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

$true: A identidade visual da organização é exibida nas 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 sua empresa.
$false: A identidade visual da organização não é exibida nas páginas de aviso e notificação de Links Seguros. Esse valor é o padrão.

Propriedades do parâmetro

Tipo:	Boolean
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

-EnableSafeLinksForEmail

O parâmetro EnableSafeLinksForEmail especifica se a proteção de links seguros deve ser habilitada para mensagens de email. Os valores válidos são:

$true: os links seguros estão habilitados para email. Esse valor é o 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: o Safe Links não está habilitado para email.

Propriedades do parâmetro

Tipo:	Boolean
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

-EnableSafeLinksForOffice

O parâmetro EnableSafeLinksForOffice especifica se a proteção de Links Seguros deve ser habilitada para aplicativos da Web, móveis ou da área de trabalho do Office com suporte. Os valores válidos são:

$true: A verificação de Links Seguros está habilitada em aplicativos Office. Esse valor é o padrão. Quando um usuário abre um arquivo em um aplicativo do Office compatível 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: O Safe Links não está habilitado para aplicativos do Office.

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

Propriedades do parâmetro

Tipo:	Boolean
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

-EnableSafeLinksForTeams

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

$true: o Safe Links está habilitado para o Teams. Esse valor é o padrão. Quando um usuário clica em um link em uma conversa do Teams, chat em grupo ou de 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: o Safe Links não está habilitado para o Teams.

Propriedades do parâmetro

Tipo:	Boolean
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

-MakeBuiltInProtection

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

Propriedades do parâmetro

Tipo:	SwitchParameter
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

-Name

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	1
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-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.

Propriedades do parâmetro

Tipo:	RecommendedPolicyType
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

-ScanUrls

O parâmetro ScanUrls especifica se a verificação em tempo real de links clicados em mensagens de email deve ser habilitada. Os valores válidos são:

$true: A verificação em tempo real dos links clicados, incluindo links que apontam para arquivos, está ativada. Esse valor é o padrão.
$false: A verificação em tempo real dos links clicados, incluindo links que apontam para arquivos, está desativada.

Propriedades do parâmetro

Tipo:	Boolean
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

-TrackClicks

O parâmetro TrackClicks especifica se os cliques do usuário devem ser rastreados relacionados à proteção de links seguros. Os valores válidos são:

$true: As mensagens de cliques do usuário são rastreadas. Esse valor é o padrão.
$false: As mensagens de cliques do usuário não são rastreadas.

Propriedades do parâmetro

Tipo:	Boolean
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

-UseTranslatedNotificationText

O UseTranslatedNotificationText especifica se o Microsoft Translator deve ser usado para localizar automaticamente o texto de notificação personalizado que você especificou com o parâmetro CustomNotificationText. Os valores válidos são:

$true: Traduza o texto de notificação personalizado para o idioma do usuário.
$false: Não traduza o texto de notificação personalizado para o idioma do usuário. Esse valor é o padrão.

Propriedades do parâmetro

Tipo:	Boolean
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

-WhatIf

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	wi

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?