Set-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-28

Use o cmdlet Set-IPBlockListProvider para modificar as informações de configuração de uma configuração específica do provedor de Lista de Bloqueios de IP em um computador em que a função de servidor Transporte de Borda ou Transporte de Hub esteja instalada.

Sintaxe

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

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

Descrição detalhada

Use o cmdlet Set-IPBlockListProvider para modificar as configurações do provedor da Lista de Bloqueios de IP existentes. Esta configuração é usada pelo agente do Filtro de Conexão. O parâmetro Identity é necessário.

Para executar o cmdlet Set-IPBlockListProvider, você deve usar uma 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 Set-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
Identity	Necessário	Microsoft.Exchange.Configuration.Tasks.IPBlockListProviderIdParameter	O parâmetro Identity pode ter um valor de cadeia de caracteres, que é o valor Name ou a GUID.
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 o endereço IP é configurado para o parâmetro BitmaskMatch, o agente do Filtro de Conexão atua somente em mensagens que correspondam ao código de status do endereço IP retornado pelo serviço 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 do controlador de domínio que grava essa alteração de configuração no serviço de diretório Active Directory, inclua o parâmetro DomainController no comando. O parâmetro DomainController não tem suporte em computadores que executam a função de servidor Transporte de Borda. 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.
Instance	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.IPBlockListProvider	O parâmetro Instance permite que você passe um objeto inteiro para o comando para ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.
IPAddressesMatch	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Quando o endereço IP é configurado para o parâmetro IPAddressesMatch, o agente do Filtro de Conexão atua somente em mensagens que correspondam ao código de status do endereço IP retornado pelo serviço provedor da Lista de Bloqueios de IP.
LookupDomain	Opcional	Microsoft.Exchange.Data.SmtpDomain	Esse parâmetro especifica o nome do domínio que o agente do Filtro de Conexão consulta para obter dados atualizados da Lista de Bloqueios de IP.
Name	Opcional	System.String	Esse parâmetro especifica o nome do serviço de provedor da Lista de Bloqueios de IP. O valor de cadeia de caracteres do parâmetro Identity não será alterado se você alterar esse valor.
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 com o mesmo valor que o de outro serviço provedor da Lista de Bloqueios de IP, o outro provedor da Lista de Bloqueios de IP será incrementado 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. É recomendável especificar o serviço provedor da Lista de Bloqueios de IP na resposta, de modo que remetentes legítimos entrem em contato com o serviço provedor. 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 addresses matched to Example.com's IP Block List Provider service"`.
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 exemplo de código a seguir mostra dois comandos Set‑IPBlockListProvider.

O primeiro código de exemplo mostra um comando Set‑IPBlockListProvider que define o Filtro de Conexão para tratar qualquer correspondência do serviço provedor da Lista de Bloqueios de IP como evento acionável.

O segundo exemplo de código mostra um comando Set‑IPBlockListProvider que define a prioridade de uma configuração existente como 1.

Set-IPBlockListProvider -Identity Example.com -AnyMatch:$true 
Set-IPBlockListProvider -Identity Example.com -Priority 1

Compartilhar via