New-MalwareFilterRule

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet New-MalwareFilterRule para criar regras de filtro de malware da sua organização.

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-MalwareFilterRule
   [-Name] <String>
   -MalwareFilterPolicy <MalwareFilterPolicyIdParameter>
   [-Comments <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-ExceptIfRecipientDomainIs <Word[]>]
   [-ExceptIfSentTo <RecipientIdParameter[]>]
   [-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
   [-Priority <Int32>]
   [-RecipientDomainIs <Word[]>]
   [-SentTo <RecipientIdParameter[]>]
   [-SentToMemberOf <RecipientIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

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-MalwareFilterRule -Name "Contoso Recipients" -MalwareFilterPolicy "Contoso Malware Filter Policy" -RecipientDomainIs contoso.com

Este exemplo cria uma nova regra de filtro de malware denominada Destinatários de Contoso com as seguintes configurações: Se o destinatário estiver no domínio contoso.com, aplique a política de filtro de malware denominada Política de Filtro de Malware de Contoso.

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 Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-DomainController

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-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 Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-Habilitado

O parâmetro Enabled habilita ou desabilita a regra de filtro de malware. A entrada válida para esse parâmetro é $true ou $false. O valor padrão é $true.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-MalwareFilterPolicy

O parâmetro MalwareFilterPolicy especifica a política de filtro de malware associada à regra de regra de filtro de malware.

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

  • Nome

  • DN (nome diferenciado)

  • #C0.

Você não pode especificar a política de filtro de malware padrão e não pode especificar uma política que já esteja associada a outra regra de filtro de malware.

Type:MalwareFilterPolicyIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-Name

O parâmetro Name especifica um nome exclusivo para a regra de filtro de malware.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Inputs

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Outputs

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.