Add-IPAllowListProvider

Esse cmdlet está disponível ou é eficaz somente em servidores de Transporte de Borda no Exchange local.

Use o cmdlet Add-IPAllowListProvider para criar provedores de lista de Permissões de IP, que são usados pelo agente de Filtragem de Conexão nos servidores Transporte de Borda.

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

Syntax

Add-IPAllowListProvider
   [-Name] <String>
   -LookupDomain <SmtpDomain>
   [-AnyMatch <Boolean>]
   [-BitmaskMatch <IPAddress>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-IPAddressesMatch <MultiValuedProperty>]
   [-Priority <Int32>]
   [-WhatIf]
   [<CommonParameters>]

Description

Nos servidores de Transporte de Borda, você deve ser um membro do grupo local de administradores para executar esse cmdlet.

Exemplos

Exemplo 1

Add-IPAllowListProvider -Name "Contoso.com Allow List" -LookupDomain allowlist.contoso.com -AnyMatch $true

Este exemplo adiciona um novo provedor de lista de Permissões de IP e configura o agente de filtragem de conexão para tratar qualquer código de status de endereço IP, retornado do provedor de lista de Permissões de IP, como uma correspondência e autorizar a conexão. Você obtém o valor do parâmetro LookupDomain no provedor de lista de permissões.

Exemplo 2

Add-IPAllowListProvider -Name "Fabrikam.com Allow List" -LookupDomain allowlist.fabrikam.com -BitmaskMatch 127.1.0.1

Este exemplo adiciona um provedor de lista de Permissões de IP e configura um valor de retorno de bitmask do provedor. Você obtém o valor dos parâmetros LookupDomain e BitmaskMatch no provedor de lista de permissões.

Parâmetros

-AnyMatch

O parâmetro AnyMatch especifica se qualquer resposta do provedor de lista de permissões é tratada como uma correspondência. A entrada válida para esse parâmetro é $true ou $false. O valor padrão é $false. Quando esse parâmetro é configurado como $true e a filtragem de conexão envia o endereço IP do servidor SMTP da conexão para o provedor de lista de permissões, qualquer código de resposta retornado pelo provedor de lista de permissões faz com que a filtragem de conexão permita mensagens dessa origem.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BitmaskMatch

O parâmetro BitmaskMatch especifica o código de status de bitmask que é retornado pelo provedor de lista de permissões. Use esse parâmetro se o provedor de lista de permissões retornar respostas de bitmask. A entrada válida desse parâmetro é um endereço IP único no formato 127.0.0.1.

Type:IPAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

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.

O parâmetro DomainController não é compatível com os servidores de Transporte do Microsoft Edge. Um servidor de Transporte do Microsoft Edge usa a instância local dos Serviços AD LDS para ler e gravar dados.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

O parâmetro Enabled especifica se a filtragem de conexão usa esse provedor de Lista de Permissões de IP. A entrada válida para esse parâmetro é $true ou $false. O valor padrão é $true. Por padrão, a filtragem de conexão usa os novos provedores de Lista de Permissões de IP que você cria.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IPAddressesMatch

O parâmetro IPAddressesMatch especifica os códigos de status de endereço IP retornados pelo provedor de lista de permissões. Use esse parâmetro se o provedor de lista permitir retornar endereço IP ou respostas de registro. Entrada válida para este parâmetro um ou mais endereços IP no formato 127.0.0.1. Você pode inserir vários endereços IP separados por vírgulas.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LookupDomain

O parâmetro LookupDomain especifica o nome de host que deve usar o provedor de lista de permissões. A filtragem de conexão envia o endereço IP do servidor SMTP da conexão para o valor de nome de host especificado. Um valor de exemplo é allowlist.spamservice.com. O valor real a ser usado é fornecido pelo provedor de lista de permissões.

Type:SmtpDomain
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Name

O parâmetro Name especifica um nome descritivo para o provedor de lista de Permissões de IP.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Priority

O parâmetro Priority especifica a ordem em que o agente de Filtragem de Conexão consultará os provedores de Lista de Permissões de IP que você configurou. Um valor de número inteiro mais baixo indica uma prioridade mais alta. Por padrão, sempre que um novo provedor de lista de Permissões de IP é adicionado, uma prioridade N+1 é atribuída à entrada, sendo que N é o número de provedores de lista de Permissões de IP que você configurou.

Se o parâmetro Priority for definido com um valor igual ao de outro provedor da lista de Permissões de IP, a prioridade do primeiro provedor da lista de Permissões de IP adicionado será aumentada em 1.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.