Test-IPBlockListProvider
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-IPBlockListProvider para testar a configuração de uma Lista de Bloqueios de IP específica em um computador em que as funções de servidor Transporte de Hub ou Transporte de Borda estejam instaladas. Esta configuração é usada pelo agente do Filtro de Conexão.
Sintaxe
Test-IPBlockListProvider -Identity <IPBlockListProviderIdParameter> -IPAddress <IPAddress> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
O comando cmdlet Test-IPBlockListProvider verifica a conectividade para o provedor de Lista de Bloqueios de IP especificado e emite uma solicitação de pesquisa para o provedor de Lista de Permissões de IP. Ao testar a conexão e a funcionalidade do provedor de Lista de Bloqueios de IP, insira um endereço IP bloqueado conhecido no parâmetro IPAddress.
Para executar o cmdlet Test-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 Test-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 |
Insira o nome do provedor da Lista de Bloqueios de IP neste parâmetro. O parâmetro Identity pode corresponder tanto ao parâmetro Name como ao parâmetro (GUID) Identity no provedor da Lista de Bloqueios 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 Bloqueios de IP configurados. |
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 em que você executará o cmdlet Test-IPBlockListProvider, 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 Bloqueio |
O Provedor de Lista de Bloqueio retorna o objeto de provedor de Lista de Bloqueios de IP armazenado no diretório ADAM local ou no 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 da Lista de Bloqueios de IP, do parâmetro IPAddress enviado no comando Test‑IPBlockListProvider. Entre em contato com o provedor de Lista de Bloqueios de IP para determinar o significado do Endereço IP retornado aqui. |
Erros
| Erro | Descrição |
|---|---|
Permissões insuficientes |
É necessário ser um Administrador 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 Bloqueios de IP. |
Entre em contato com o provedor da Lista de Bloqueios de IP. |
Exemplo
O exemplo de código a seguir mostra um comando Test‑IPBlockListProvider que tem os parâmetros necessários. O comando testa a conectividade para um provedor de Lista de Bloqueios de IP fictício chamado ExampleProviderName e, em seguida, emite uma solicitação de pesquisa para aquele provedor.
Test-IPBlockListProvider -IPAddress 192.168.0.1 -Provider ExampleProviderName