Compartilhar via


Set-HostedConnectionFilterPolicy

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

Use o cmdlet Set-HostedConnectionFilterPolicy para modificar as configurações de políticas de filtro de conexão na sua organização baseada na nuvem.

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

Syntax

Set-HostedConnectionFilterPolicy
   [-Identity] <HostedConnectionFilterPolicyIdParameter>
   [-AdminDisplayName <String>]
   [-ConfigurationXmlRaw <String>]
   [-Confirm]
   [-EnableSafeList <Boolean>]
   [-IPAllowList <MultiValuedProperty>]
   [-IPBlockList <MultiValuedProperty>]
   [-MakeDefault]
   [-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.

Exemplos

Exemplo 1

Set-HostedConnectionFilterPolicy "Default" -IPAllowList 192.168.1.10,192.168.1.23 -IPBlockList 10.10.10.0/25,172.17.17.0/24

Este exemplo modifica a política de filtro de conexão chamada Padrão com as seguintes configurações:

  • Mensagens de 192.168.1.10 e 192.168.1.23 nunca são identificadas como spam.
  • Mensagens de 10.10.10.0/25 e 172.17.17.0/24 são sempre identificadas como spam.

Exemplo 2

Set-HostedConnectionFilterPolicy "Default" -IPAllowList @{Add="192.168.2.10","192.169.3.0/24","192.168.4.1-192.168.4.5"; Remove="192.168.1.10"}

Este exemplo modifica a política de filtro de conexão chamada Padrão com as seguintes configurações:

  • Os seguintes endereços IP são adicionados aos valores existentes na lista de permissões de IP: 192.168.2.10, 192.169.3.0/24 e 192.168.4.1-192.168.4.5.
  • O endereço IP 192.168.1.10 é removido dos valores existentes na lista de IPs permitidos.

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 ("). O tamanho máximo é de 255 caracteres.

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

-ConfigurationXmlRaw

Esse parâmetro está reservado para uso interno da Microsoft.

Type:String
Position:Named
Default value:None
Required:False
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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EnableSafeList

O parâmetro EnableSafeList habilita ou desabilita o uso da lista de confiança. A lista de confiança é uma lista dinâmica de permissões no datacenter da Microsoft que não requer configuração pelo consumidor. Os valores válidos são:

$true: use a lista segura para ignorar a filtragem de spam em mensagens de remetentes confiáveis que são identificadas por várias fontes de terceiros às quais a Microsoft assina.

$false: não use a lista de segurança. Esse é o valor padrão.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

O parâmetro Identity especifica a política de filtro de conexão que você deseja modificar. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Normalmente, você só tem uma política de filtro de conexão: a política padrão chamada Default.

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

-IPAllowList

O parâmetro IPAllowList especifica endereços IP dos quais as mensagens são sempre permitidas. As mensagens dos endereços IP que você especificar não serão identificadas como spam, mesmo que haja outras características de spam nas mensagens. Os valores válidos são:

  • Endereço IP único: por exemplo, 192.168.1.1.
  • Intervalo de endereços IP: você pode usar um intervalo de endereços IP, por exemplo, 192.168.0.1-192.168.0.254. O número máximo de endereços no intervalo é 256.
  • Intervalo de endereços IP cidr (roteamento interdomínio sem classe): por exemplo, 192.168.0.1/25. Os valores válidos da máscara de sub-rede são de /24 a /32.

Você pode especificar vários endereços IP do mesmo tipo separados por vírgulas. Por exemplo: SingleIP1, SingleIP2,...SingleIPN ou CIDRIP1,CIDRIP2,...CIDRIPN. Para especificar vários endereços IP de tipos diferentes ao mesmo tempo, você precisa usar a seguinte sintaxe de propriedade multivalued: @{Add="SingleIP1","IPRange1","CIDRIP1",...}.

Observação: não há suporte para intervalos IPv6.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IPBlockList

O parâmetro IPBlockList especifica endereços IP dos quais as mensagens nunca são permitidas. As mensagens dos endereços IP que você especificar serão bloqueadas sem nenhuma verificação adicional de spam. Os valores válidos são:

  • Endereço IP único: por exemplo, 192.168.1.1.
  • Intervalo de endereços IP: você pode usar um intervalo de endereços IP, por exemplo, 192.168.0.1-192.168.0.254. O número máximo de endereços no intervalo é 256.
  • Intervalo de endereços IP cidr (roteamento interdomínio sem classe): por exemplo, 192.168.0.1/25. Os valores válidos da máscara de sub-rede são de /24 a /32.

Você pode especificar vários endereços IP do mesmo tipo separados por vírgulas. Por exemplo: SingleIP1, SingleIP2,...SingleIPN ou CIDRIP1,CIDRIP2,...CIDRIPN. Para especificar vários endereços IP de tipos diferentes ao mesmo tempo, você precisa usar a seguinte sintaxe de propriedade multivalued: @{Add="SingleIP1","IPRange1","CIDRIP1",...}.

Observação: não há suporte para intervalos IPv6.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-MakeDefault

Esse parâmetro está reservado para uso interno da Microsoft.

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

Entradas

Input types

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.

Saídas

Output types

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.