Set-IPAllowListProvider

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-IPAllowListProvider para modificar as informações de configuração de uma Lista de Permissões de IP específica em um computador em que as funções de servidor Transporte de Hub ou Transporte de Borda estejam instaladas.

Sintaxe

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

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

Descrição detalhada

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

Para executar o cmdlet Set-IPAllowListProvider, 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 Set-IPAllowListProvider 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.IPAllowListProviderIdParameter	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 AnyMatch é `$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 de Lista de Permissões 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 Permissões 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 controlador de domínio que grava essa alteração de configuração dos dados de configuração de filtragem de conexão no serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. Se você estiver executando esse comando em um computador em que a função de servidor Transporte de Borda esteja instalada, não haverá suporte para o parâmetro DomainController. O servidor de Transporte de Borda grava somente na instância local do ADAM.
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 Permissões de IP de acordo com a prioridade definida para essa configuração do provedor Lista de Permissões de IP.
Instance	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.IPAllowListProvider	O parâmetro Instance permite que você passe um objeto inteiro para o comando a 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 Permissões de IP.
LookupDomain	Opcional	Microsoft.Exchange.Data.SmtpDomain	O nome do domínio em que o agente do Filtro de Conexão consulta dados atualizados da Lista de Permissões de IP.
Name	Opcional	System.String	O nome do serviço provedor da Lista de Permissões 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 provedores da Lista de Permissões de IP que você configurou. Por padrão, cada vez que um novo serviço provedor da Lista de Permissões de IP é adicionado, uma prioridade de N+1 é atribuída à entrada, onde N é o número de serviços provedores da Lista de Permissões de IP configurados. Se você definir o parâmetro Priority com o mesmo valor que o de outro serviço provedor da Lista de Permissões de IP, a prioridade do serviço provedor da Lista de Permissões de IP adicionado primeiro será incrementada em 1 unidade.
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 código de exemplo mostra um comando Set‑IPAllowListProvider que define o Filtro de Conexão para tratar qualquer correspondência do serviço provedor da Lista de Permissões de IP como evento acionável.

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

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

Share via