Compartilhar via


Set-IPAllowListConfig

 

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-IPAllowListConfig para modificar a configuração da Lista de Permissões de IP em um computador com a função de servidor Transporte de Borda ou de Transporte de Hub instalada.

Sintaxe

Set-IPAllowListConfig [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <IPAllowListConfig>] [-InternalMailEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

A Lista de Permissões de IP é usada pelo agente de Filtro de Conexão.

Para executar o cmdlet Set-IPAllowListConfig, você deve usar uma conta à qual esteja delegada a seguinte função:

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

Para executar o cmdlet Set-IPAllowListConfig em um computador com a função de servidor Transporte de Borda instalada, faça 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

Confirm

Optional

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 está definido como $true, a filtragem de conexão é habilitada no computador em que você está executando o comando Set-IPAllowListConfig.

ExternalMailEnabled

Opcional

System.Boolean

A entrada válida para o parâmetro ExternalMailEnabled é $true ou $false. A configuração padrão é $true. Quando o parâmetro ExternalMailEnabled é definido como $true, todas as mensagens de conexões fora da organização Exchange são passadas para o agente do Filtro de Conexão para serem processadas.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.IPAllowListConfig

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.

InternalMailEnabled

Opcional

System.Boolean

A entrada válida para o parâmetro InternalMailEnabled é $true ou $false. A configuração padrão é $false. Quando o parâmetro InternalMailEnabled é definido como $true, todas as mensagens de remetentes dentro da organização do Exchange são transmitidas por meio do agente de Filtro de Conexão para processamento. Mensagens de parceiros autenticadas não são consideradas email interno.

WhatIf

Optional

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 como usar o comando Set-IPAllowListConfig para especificar o controlador de domínio que gravará a alteração dos dados de configuração de filtragem de conexão no Active Directory.

Set-IPAllowListConfig -InternalMailEnabled:$true -DomainController ad-server.example.com