Set-HostedConnectionFilterPolicy

Módulo:
Exchange PowerShell

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.

Sintaxe

Default (Default) 

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 artigo 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

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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.

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

-ConfigurationXmlRaw

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

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

-Confirm

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer 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

-EnableSafeList

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

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, complemento de segurança interno para caixas de correio locais

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 Padrão.

Propriedades do parâmetro

Tipo:HostedConnectionFilterPolicyIdParameter
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

-IPAllowList

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

O parâmetro IPAllowList especifica endereços IP dos quais as mensagens são sempre permitidas. As mensagens dos endereços IP especificados não são identificadas como spam, apesar de quaisquer outras características de spam das 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 entre domínios sem classificação): por exemplo, 192.168.0.1/25. Os valores válidos de máscara de sub-rede são /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 de valores múltiplos: @{Add="SingleIP1","IPRange1","CIDRIP1",...}.

Observação: intervalos de IPv6 não são suportados.

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

-IPBlockList

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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 entre domínios sem classificação): por exemplo, 192.168.0.1/25. Os valores válidos de máscara de sub-rede são /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 de valores múltiplos: @{Add="SingleIP1","IPRange1","CIDRIP1",...}.

Observação: intervalos de IPv6 não são suportados.

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

-MakeDefault

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

Propriedades do parâmetro

Tipo:SwitchParameter
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, complemento de segurança interno para caixas de correio locais

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. 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 dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

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.