Set-SafeLinksPolicy
Esse cmdlet só está disponível no serviço baseado em nuvem.
Use o cmdlet Set-SafeLinksPolicy para modificar as políticas de Links seguros em sua organização baseada na nuvem.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
Set-SafeLinksPolicy
[-Identity] <SafeLinksPolicyIdParameter>
[-AdminDisplayName <String>]
[-AllowClickThrough <Boolean>]
[-Confirm]
[-CustomNotificationText <String>]
[-DeliverMessageAfterScan <Boolean>]
[-DisableUrlRewrite <Boolean>]
[-DoNotRewriteUrls <MultiValuedProperty>]
[-EnableForInternalSenders <Boolean>]
[-EnableOrganizationBranding <Boolean>]
[-EnableSafeLinksForEmail <Boolean>]
[-EnableSafeLinksForOffice <Boolean>]
[-EnableSafeLinksForTeams <Boolean>]
[-ScanUrls <Boolean>]
[-TrackClicks <Boolean>]
[-UseTranslatedNotificationText <Boolean>]
[-WhatIf]
[<CommonParameters>]
Description
As Ligações Seguras são uma funcionalidade no Microsoft Defender para Office 365 que verifica as ligações para ver se levam a sites maliciosos. Quando um utilizador clica numa ligação, o URL é reescrito temporariamente e verificado numa lista de sites conhecidos e maliciosos. Links Seguros inclui o recurso de relatório de rastreamento de URL para ajudar a determinar quem clicou em um site mal-intencionado.
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
Set-SafeLinksPolicy -Identity "Engineering Block URL" -AllowClickThrough $false
Este exemplo modifica a política de Ligações Seguras existente denominada URL do Bloco de Engenharia para não permitir o clique nos URLs originais em páginas de aviso.
Parâmetros
-AdminDisplayName
Aplicável: Exchange Online
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
Aplicável: Exchange Online
O parâmetro AllowClickThrough especifica se deve permitir que os utilizadores cliquem no URL original em páginas de aviso. Os valores válidos são:
$true: o utilizador tem permissão para clicar no URL original. $false: o utilizador não tem permissão para clicar no URL original.
No PowerShell, o valor predefinido é $false. Nas novas políticas de Ligações Seguras criadas no portal do Microsoft Defender, o valor predefinido é $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
Aplicável: Exchange Online
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, 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 confirmar 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
Aplicável: Exchange Online
O texto de notificação personalizado especifica o texto de notificação personalizado a mostrar aos utilizadores. 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
Aplicável: Exchange Online
O parâmetro DeliverMessageAfterScan especifica se pretende entregar mensagens de e-mail apenas após a análise das Ligações Seguras estar concluída. Os valores válidos são:
- $true: aguarde até que a análise das Ligações Seguras esteja concluída antes de entregar a mensagem. Este valor é a predefinição. As mensagens que contêm ligações maliciosas não são entregues.
- $false: se a análise de Ligações Seguras não for concluída, entregue a mensagem mesmo assim.
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
Aplicável: Exchange Online
O parâmetro DisableUrlRewrite especifica se pretende reescrever (moldar) URLs em mensagens de e-mail. Os valores válidos são:
- $true: os URLs nas mensagens não são reescritos, mas as mensagens continuam a ser analisadas pelas Ligações Seguras antes da entrega. As verificações de tempo de clique nas ligações são efetuadas através da API de Ligações Seguras em clientes do Outlook suportados (atualmente, Outlook para Windows e Outlook para Mac).
- $false: os URLs nas mensagens são reescritos. As verificações de API ainda ocorrem em URLs não substituídos em clientes suportados se o utilizador estiver numa política de Ligações Seguras válida.
No PowerShell, o valor predefinido é $false. Nas novas políticas de Ligações Seguras criadas no portal do Microsoft Defender, o valor predefinido é $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
Aplicável: Exchange Online
O parâmetro DoNotRewriteUrls especifica os URLs que não são reescritos pela análise de Ligações Seguras. A lista de entradas permite que os utilizadores incluídos na política acedam aos URLs especificados que, de outra forma, seriam bloqueados pelas Ligações Seguras.
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Para obter detalhes sobre a sintaxe de entrada, veja Sintaxe de entrada para a lista "Não reescrever os 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
Aplicável: Exchange Online
O parâmetro EnableForInternalSenders especifica se a política ligações seguras é 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. Este valor é a predefinição.
- $false: a política é aplicada apenas 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
Aplicável: Exchange Online
O parâmetro EnableOrganizationBranding especifica se o logótipo da sua organização é apresentado nas páginas de aviso e notificação das Ligações Seguras. Os valores válidos são:
- $true: a imagem corporativa da organização é apresentada nas páginas de aviso e notificação das Ligações Seguras. Antes de configurar este valor, tem de seguir as instruções em Personalizar o tema do Microsoft 365 para a sua organização carregar o logótipo da sua empresa.
- $false: a imagem corporativa da organização não é apresentada nas páginas de aviso e notificação das Ligações Seguras. Este valor é a predefiniçã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
Aplicável: Exchange Online
O parâmetro EnableSafeLinksForEmail especifica se pretende ativar a proteção de Ligações Seguras para mensagens de e-mail. Os valores válidos são:
- $true: As Ligações Seguras estão ativadas para e-mail. Este valor é a predefinição. Quando um utilizador clica numa ligação num e-mail, a ligação é verificada por Ligações Seguras. Se a ligação for considerada maliciosa, será apresentada uma página de aviso no browser predefinido.
- $false: As Ligações Seguras não estão ativadas para e-mail.
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
Aplicável: Exchange Online
O parâmetro EnableSafeLinksForOffice especifica se pretende ativar a proteção de Ligações Seguras para aplicações Web, móveis ou de ambiente de trabalho do Office suportadas. Os valores válidos são:
- $true: a análise de Ligações Seguras está ativada nas aplicações do Office. Este valor é a predefinição. Quando um utilizador abre um ficheiro numa aplicação suportada do Office e clica numa ligação no ficheiro, a ligação é verificada por Ligações Seguras. Se a ligação for considerada maliciosa, será apresentada uma página de aviso no browser predefinido.
- $false: as Ligações Seguras não estão ativadas para aplicações do Office.
Esta proteção aplica-se a ligações em documentos do Office e não a ligações em mensagens de e-mail.
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
Aplicável: Exchange Online
O parâmetro EnableSafeLinksForTeams especifica se as Ligações Seguras estão ativadas para o Microsoft Teams. Os valores válidos são:
- $true: as Ligações Seguras estão ativadas para o Teams. Este valor é a predefinição. Quando um utilizador clica numa ligação numa conversação do Teams, chat de grupo ou a partir de canais, a ligação é verificada por Ligações Seguras. Se a ligação for considerada maliciosa, será apresentada uma página de aviso no browser predefinido.
- $false: As Ligações Seguras não estão ativadas 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 |
-Identity
Aplicável: Exchange Online
O parâmetro Identity especifica a política de Links seguros que você deseja modificar. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Propriedades do parâmetro
| Tipo: | SafeLinksPolicyIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ScanUrls
Aplicável: Exchange Online
O parâmetro ScanUrls especifica se pretende ativar ou desativar a análise em tempo real de ligações clicadas em mensagens de e-mail. Os valores válidos são:
- $true: a análise em tempo real de ligações clicadas, incluindo ligações que apontam para ficheiros, está ativada. Este valor é a predefinição.
- $false: a análise em tempo real de ligações clicadas, incluindo ligações que apontam para ficheiros, 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
Aplicável: Exchange Online
O parâmetro TrackClicks especifica se pretende controlar os cliques dos utilizadores relacionados com a proteção de Ligações Seguras das ligações. Os valores válidos são:
- $true: os cliques do utilizador são controlados. Este valor é a predefinição.
- $false: os cliques do utilizador não são monitorizados.
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
Aplicável: Exchange Online
O UseTranslatedNotificationText especifica se deve utilizar o Microsoft Translator para localizar automaticamente o texto de notificação personalizado que especificou com o parâmetro CustomNotificationText. Os valores válidos são:
- $true: traduzir texto de notificação personalizado para o idioma do utilizador.
- $false: não traduzir texto de notificação personalizado para o idioma do utilizador. Este valor é a predefiniçã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
Aplicável: Exchange Online
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.
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 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.