Add-IPBlockListProvider

Artigo
09/30/2014

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-06-22

Use o cmdlet Add-IPBlockListProvider para criar uma nova configuração do provedor da Lista de Bloqueios de IP no computador em que a função de servidor Transporte de Borda ou Transporte de Hub esteja instalada.

Sintaxe

Add-IPBlockListProvider -Name <String> -LookupDomain <SmtpDomain> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-Priority <Int32>] [-RejectionResponse <AsciiString>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

A configuração do provedor da Lista de Bloqueios de IP é usada pelo agente do Filtro de Conexão.

O parâmetro Name e o parâmetro LookupDomain são necessários. Se você não passar os parâmetros necessários, o Shell de Gerenciamento do Exchange os solicitará a você.

Para executar o cmdlet Add-IPBlockListProvider, você deve usar a conta à qual esteja delegado o seguinte:

Função de Administrador do Exchange Server e grupo Administradores local para o servidor de destino

Para executar o cmdlet Add-IPBlockListProvider em um computador em que a função de servidor Transporte de Borda esteja instalada, faça logon com uma conta que seja membro do grupo Administradores local no computador.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro	Necessário	Tipo	Descrição
LookupDomain	Necessário	Microsoft.Exchange.Data.SmtpDomain	O nome de domínio que o agente do Filtro de Conexão consulta para obter dados atualizados da Lista de Bloqueios de IP.
Name	Necessário	System.String	O nome do serviço provedor da Lista de Bloqueios de IP
AnyMatch	Opcional	System.Boolean	A entrada válida para o parâmetro Enabled é `$true` ou `$false`. A configuração padrão é `$false`. Quando o parâmetro AnyMatch é definido como `$true`, o agente do Filtro de Conexão trata como correspondência qualquer código de status de Endereço IP retornado pelo serviço provedor da Lista de Bloqueios de IP.
BitmaskMatch	Opcional	System.Net.IPAddress	Quando você configura o parâmetro BitmaskMatch para usar um endereço IP, o agente do Filtro de Conexão funciona apenas em mensagens que correspondam ao código de status de Endereço IP que é retornado pelo serviço do provedor da Lista de Bloqueios de IP.
Confirm	Opcional	System.Management.Automation.SwitchParameter	O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. O parâmetro DomainController não tem suporte em computadores em que a função de servidor Transporte de Borda está instalada. A função de servidor Transporte de Borda grava apenas para a instância ADAM local.
Enabled	Opcional	System.Boolean	A entrada válida para o parâmetro Enabled é `$true` ou `$false`. A configuração padrão é `$true`. Quando o parâmetro Enabled é definido como `$true`, o agente do Filtro de Conexão consulta o serviço do provedor Lista de Bloqueios de IP de acordo com a prioridade definida para essa configuração do provedor Lista de Bloqueios de IP.
IPAddressesMatch	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Quando o parâmetro IPAddressesMatch é configurado para usar um Endereço IP, o agente do Filtro de Conexão funciona apenas em mensagens que correspondam ao mesmo código de status de Endereço IP que é retornado pelo serviço provedor da Lista de Bloqueios de IP.
Priority	Opcional	System.Int32	Defina o parâmetro Priority para configurar a ordem em que o agente do Filtro de Conexão consulta os serviços do provedor Lista de Bloqueios de IP que você configurou. Por padrão, sempre que você adicionar um novo provedor Lista de Bloqueios de IP, uma prioridade de N+1 será atribuída à entrada, onde N é o número de serviços provedores da Lista de Bloqueios de IP configurados. Se você definir o parâmetro Priority para um valor igual ao de outro serviço provedor da Lista de Bloqueios de IP, a prioridade do provedor que for adicionada primeiro será incrementada em 1 unidade.
RejectionResponse	Opcional	Microsoft.Exchange.Data.AsciiString	O parâmetro RejectionResponse aceita uma cadeia de caracteres. Insira o corpo da mensagem a ser fornecida na sessão SMTP para os remetentes cujas mensagens forem bloqueadas pelo agente do Filtro de Conexão quando um serviço provedor da Lista de Bloqueios de IP corresponder ao endereço IP do remetente. Recomendamos especificar o serviço provedor da Lista de Bloqueios de IP na resposta, de forma que remetentes legítimos possam entrar em contato com o serviço provedor da Lista de Bloqueios de IP. O argumento não pode ter mais de 240 caracteres. Quando você passa um argumento, é necessário incluir o parâmetro RejectionResponse entre aspas duplas, se a frase contiver espaços, como mostra o exemplo: `"Originating IP addressed matched to Example.com's IP Block List provider service"`.
TemplateInstance	Opcional	System.Management.Automation.PSObject	Quando um objeto existente for fornecido para este parâmetro, o comando usará a configuração desse objeto para criar uma duplicata exata do objeto em um servidor local ou de destino.
WhatIf	Opcional	System.Management.Automation.SwitchParameter	O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exemplo

O primeiro exemplo de código mostra um comando Add‑IPBlockListProvider que tem os parâmetros necessários. Ele também mostra como adicionar um novo provedor da Lista de Bloqueios de IP e definir uma resposta de rejeição.

O segundo exemplo de código mostra um comando Add‑IPBlockListProvider que tem os parâmetros necessários e mostra como configurar um valor de retorno de máscara de bits a partir do provedor.

Add-IPBlockListProvider -Name:Example -LookupDomain:Example.com -RejectionResponse "Originating IP addressed matched to Example.com's IP Block List provider service"
Add-IPBlockListProvider -Name:Example -LookupDomain:Example.com -BitmaskMatch 127.1.0.1

Compartilhar via