New-AntiPhishRule

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

Use o cmdlet New-AntiPhishRule para criar regras de antiphish 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 (https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

Syntax

New-AntiPhishRule
   [-Name] <String>
   -AntiPhishPolicy <String>
   [-Comments <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExceptIfRecipientDomainIs <Word[]>]
   [-ExceptIfSentTo <RecipientIdParameter[]>]
   [-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
   [-Priority <Int32>]
   [-RecipientDomainIs <Word[]>]
   [-SentTo <RecipientIdParameter[]>]
   [-SentToMemberOf <RecipientIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

Você precisa adicionar a regra de antiphish a uma política existente usando o parâmetro AntiPhishPolicy. Você cria políticas de antiphishing usando o cmdlet New-AntiPhishPolicy.

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

New-AntiPhishRule -Name "Research Department" -AntiPhishPolicy "Research Quarantine" -SentToMemberOf "Research Department"

Este exemplo cria uma regra de antiphish chamada departamento de pesquisa com as seguintes configurações:

  • A regra é associada à política de antiphish chamada quarentena de pesquisa.
  • A regra se aplica aos membros do grupo chamado Departamento de pesquisa.

Parameters

-AntiPhishPolicy

O parâmetro AntiPhishPolicy especifica a política de antiphish associada à regra de antiphishing.

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 a política de antiphishing padrão. E você não pode especificar uma política de antiphishing que já esteja associada a outra regra de antiphishing.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-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
-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
-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
-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
-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
-Habilitado

O parâmetro Enabled especifica se a regra está habilitada. Os valores válidos são:

  • $true: a regra está habilitada. Esse é o valor padrão.

  • $false: a regra está desabilitada.

Nas propriedades da regra, o valor desse parâmetro é visível na propriedade Estado.

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

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

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-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
-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
-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
-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
-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

Inputs

Outputs