Add-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-22

Use o cmdlet Add-IPAllowListProvider para criar uma nova configuração de provedor de Lista de Permissões de IP no computador no qual a função de servidor Transporte de Hub ou Transporte de Borda está instalada.

Sintaxe

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

Descrição detalhada

A configuração do provedor de Lista de Permissões 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-IPAllowListProvider, 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 Add-IPAllowListProvider em um computador em que a função de servidor Transporte de Borda esteja instalada, você deve fazer logon usando 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 do domínio que o agente do Filtro de Conexão consulta para obter informações atualizadas da Lista de Permissões de IP.
Name	Necessário	System.String	O nome do serviço provedor da Lista de Permissões de IP
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 parâmetro BitmaskMatch é configurado para usar um endereço IP, o agente do Filtro de Conexão atua somente em mensagens que correspondem 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.
IPAddressesMatch	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Quando o endereço IP é configurado para o parâmetro IPAddressMatch, o agente do Filtro de Conexão atua somente em mensagens que correspondem ao código de status do endereço IP retornado pelo serviço provedor da Lista de Permissões 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 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 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.
TemplateInstance	Opcional	System.Management.Automation.PSObject	Quando um objeto existente for fornecido para esse 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 exemplo de código a seguir mostra um comando Add‑IPAllowListProvider que tem os parâmetros necessários: LookupDomain e Name.

Add-IPAllowListProvider -Name:Example -LookupDomain:Example.com

Compartilhar via