Set-SafeLinksRule

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

Use o cmdlet Set-SafeLinksRule para criar as regras de Links seguros em sua organização baseada na nuvem.

Observação: Recomendamos que você use o módulo do PowerShell v2 do Exchange Online para se conectar ao PowerShell do Exchange Online. Para obter instruções, confira Conectar-se ao PowerShell do Exchange Online.

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

Syntax

Set-SafeLinksRule
   [-Identity] <RuleIdParameter>
   [-Comments <String>]
   [-Confirm]
   [-ExceptIfRecipientDomainIs <Word[]>]
   [-ExceptIfSentTo <RecipientIdParameter[]>]
   [-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
   [-Name <String>]
   [-Priority <Int32>]
   [-RecipientDomainIs <Word[]>]
   [-SafeLinksPolicy <SafeLinksPolicyIdParameter>]
   [-SentTo <RecipientIdParameter[]>]
   [-SentToMemberOf <RecipientIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

Links Seguros é um recurso da Proteção Avançada contra Ameaças que verifica links em mensagens de email de modo a conferir 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. 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 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.

Examples

Exemplo 1

Set-SafeLinksRule -Identity "Engineering Department URL Rule" -ExceptIfRecipientDomainIs fabrikam.com

Este exemplo modifica a regra de Links seguros existente chamada Regra de URL do Departamento de Engenharia a fim de excluir as mensagens enviadas ao domínio fabrikam.com.

Parameters

-Comentários

O parâmetro Comments especifica comentários informativos para a regra, como a finalidade de uso da regra ou as respectivas mudanças ao longo do tempo. O tamanho do comentário não pode exceder 1024 caracteres.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-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, Remover-* cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-ExceptIfRecipientDomainIs

O parâmetro ExceptIfRecipientDomainIs especifica uma exceção que procura destinatários com endereços de email nos domínios especificados. É possível especificar vários domínios, separando-os por vírgulas.

Type:Word[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-ExceptIfSentTo

O parâmetro ExceptIfSentTo especifica uma exceção que procura destinatários em mensagens. É possível usar qualquer valor que identifique o destinatário com exclusividade. Por exemplo:

  • Nome

  • Alias

  • Nome diferenciado (DN)

  • Nome diferenciado (DN)

  • DN canônico

  • GUID

Para inserir vários valores, use a seguinte sintaxe: <value1> , <value2> ,... <valueX> . Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueX> ".

Type:RecipientIdParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-ExceptIfSentToMemberOf

O parâmetro ExceptIfSentToMemberOf especifica uma exceção que procura mensagens enviadas para membros de grupos. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:

  • Nome

  • Alias

  • Nome diferenciado (DN)

  • Nome diferenciado (DN)

  • DN canônico

  • GUID

Para inserir vários valores, use a seguinte sintaxe: <value1> , <value2> ,... <valueX> . Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueX> ".

PD_UCC_Multiple_Values

Type:RecipientIdParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Identity

O parâmetro Identity especifica a regra de Links seguros que você deseja modificar.

Caminho: (<TopLevelPublicFolderName><PublicFolderName>

  • Nome

  • DN (nome diferenciado)

  • GUID

Type:RuleIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Name

O parâmetro Nome especifica um nome exclusivo para a regra de Links seguros. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Priority

O parâmetro Priority especifica um valor de prioridade para a regra que determina a ordem de processamento da regra. Um valor inteiro menor indica uma prioridade mais alta, o valor 0 é a prioridade mais alta e as regras não podem ter o mesmo valor de prioridade.

O parâmetro Priority especifica um valor de prioridade para a regra que determina a ordem do processamento da regra. Um valor inteiro mais baixo indica uma prioridade mais alta, o valor 0 é a prioridade mais alta, e as regras não podem ter o mesmo valor de prioridade.

  • Os valores válidos e o valor padrão para esse parâmetro dependem do número de regras existentes. Por exemplo, se houver 8 regras existentes:

  • Os valores válidos de prioridade para as 8 regras existentes vão de 0 a 7.

  • Os valores válidos de prioridade para uma nova regra (a 9ª) vão de 0 a 8.

O valor padrão para uma nova regra (a 9ª) é 8.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-RecipientDomainIs

O parâmetro RecipientDomainIs especifica uma condição que procura destinatários com endereços de email nos domínios especificados. É possível especificar vários domínios, separando-os por vírgulas.

Type:Word[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-SafeLinksPolicy

O parâmetro SafeLinksPolicy especifica a política de links seguros associada a essa regra de links seguros. A regra define as condições e a política define as ações.

Você encontra esses valores executando o comando Get-ComplianceSearch | Format-Table -Auto Name,JobRunId,Status

  • Nome

  • DN (nome diferenciado)

  • GUID

Você não pode especificar uma política de Anexos confiáveis que já esteja associada a outra regra de Anexos confiáveis.

Type:SafeLinksPolicyIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-SentTo

O parâmetro SentTo especifica uma condição que procura por destinatários em mensagens. É possível usar qualquer valor que identifique o destinatário com exclusividade. Por exemplo:

  • Nome

  • Alias

  • Nome diferenciado (DN)

  • Nome diferenciado (DN)

  • DN canônico

  • GUID

Para inserir vários valores, use a seguinte sintaxe: <value1> , <value2> ,... <valueX> . Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueX> ".

Type:RecipientIdParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-SentToMemberOf

O parâmetro SentToMemberOf especifica uma condição que procura mensagens enviadas para membros de grupos de distribuição, grupos dinâmicos de distribuição ou grupos de segurança habilitados para email. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:

  • Nome

  • Alias

  • Nome diferenciado (DN)

  • Nome diferenciado (DN)

  • DN canônico

  • GUID

Para inserir vários valores, use a seguinte sintaxe: <value1> , <value2> ,... <valueX> . Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueX> ".

PD_UCC_Multiple_Values

Type:RecipientIdParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

Inputs

Outputs