Test-IPAllowListProvider
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 Test-IPAllowListProvider para testar a configuração de um provedor de Lista de Bloqueios de IP específico em um computador em que a função de servidor Transporte de Borda ou a função de servidor Transporte de Hub esteja instalada. Esta configuração é usada pelo agente do Filtro de Conexão.
Sintaxe
Test-IPAllowListProvider -Identity <IPAllowListProviderIdParameter> -IPAddress <IPAddress> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Este comando verifica a conectividade do provedor de Lista de Bloqueios de IP especificado e depois envia uma solicitação de pesquisa ao provedor de Lista de Permissões de IP. Ao testar a conexão e a funcionalidade do provedor de Lista de Permissões de IP, você deve inserir um endereço IP permitido no parâmetro Endereço IP.
Para executar o cmdlet Test-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 Test-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 |
Insira o nome do provedor de Lista de Permissões de IP neste parâmetro. O parâmetro Identity deve corresponder ao parâmetro Name ou ao parâmetro Identity (GUID) do provedor de Lista de Permissões de IP que você deseja testar. |
IPAddress |
Necessário |
System.Net.IPAddress |
O parâmetro IPAddress é usado para verificar e testar os provedores de Lista de Permissões de IP que você configurou. |
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. |
Server |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Para especificar o servidor no qual você executa o cmdlet Test-IPAllowListProvider, inclua o parâmetro Server no comando. Se você não usar o comando Server, o comando será executado no servidor local onde a tarefa for executada. |
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
| Saída | Descrição |
|---|---|
Provedor de Lista de Permissão |
O Provedor de Lista de Permissão retorna o objeto do provedor de Lista de Permissões de IP conforme armazenado no diretório do ADAM local ou no serviço de diretório do Active Directory. |
Connected |
Connected retorna os seguintes valores: True ou False.
|
Matched |
Matched retorna os seguintes valores: True ou False.
|
ProviderResult |
ProviderResult retorna um endereço IP, que representa o status, de acordo com o provedor de Lista de Permissões de IP, do parâmetro IPAddress que é enviado no comando Test-IPAllowListProvider. Contate seu provedor de Lista de Permissões de IP para determinar o significado do endereço IP retornado aqui. |
Erros
| Erro | Descrição |
|---|---|
Permissões insuficientes |
Você deve fazer logon usando uma conta membro do grupo Administradores local no computador local em que a função de servidor Transporte de Borda esteja instalada para executar esse comando. |
Não é possível conectar ao ADAM |
Se você estiver executando esta tarefa em um computador em que a função de servidor Transporte de Borda esteja instalada, verifique se o serviço ADAM (MsExchangeAdam) está sendo executado no computador local. Se você estiver executando esta tarefa em um computador em que a função de servidor Transporte de Hub esteja instalada, verifique se o computador pode se conectar a Active Directory. |
Não é possível conectar-se ao provedor de Lista de Permissões de IP. |
Entre em contato com o provedor de Lista de Permissões de IP. |
Exemplo
O exemplo de código a seguir mostra um comando Test-IPAllowListProvider que tem os parâmetros necessários. O comando testa a conectividade de um provedor de Lista de Permissões de IP fictício, chamado ExampleProviderName, e depois envia uma solicitação de pesquisa ao provedor.
Test-IPAllowListProvider -IPAddress 192.168.0.1 -Provider ExampleProviderName