Remove-IPAllowListEntry
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2011-01-12
Use o cmdlet Remove-IPAllowListEntry para remover um endereço IP das informações de configuração do agente do Filtro de Conexão no computador em que o comando é executado.
Sintaxe
Remove-IPAllowListEntry -Identity <IPListEntryIdentity> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Se você não especificar o parâmetro Identity quando executar o comando Remove‑IPAllowListEntry, o Shell de Gerenciamento do Exchange solicitará que faça isso.
A configuração de entrada Lista de Permissões de IP é usada pelo agente do Filtro de Conexão.
Para executar o cmdlet Remove-IPAllowListEntry, 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 Remove-IPAllowListEntry em um computador em que a função de servidor Transporte de Borda esteja 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 |
|---|---|---|---|
Identity |
Necessário |
Microsoft.Exchange.Configuration.Tasks.IPListEntryIdentity |
Especifique o parâmetro Identity do endereço IP a ser removido. Quando você adiciona um endereço IP à Lista de Permissões de IP, o parâmetro Identity é incrementado automaticamente. |
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. |
Server |
Optional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Para especificar um servidor de Transporte de Hub diferente no qual você executa o cmdlet Remove-IPAllowListEntry, inclua o parâmetro Server no comando. Se você não usar o parâmetro Server, o comando será executado no servidor local onde o comando for executado. Você não pode usar esse cmdlet para configurar outros servidores de Transporte de Borda remotamente. |
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 |
|---|---|
|
Exemplos
Descrição
Os exemplos de código a seguir mostram um comando Remove‑IPAllowListEntry que remove o endereço IP ou o intervalo de endereço IP na Lista de Permissões de IP do computador em que o comando é executado.
EXEMPLO 1
O exemplo a seguir remove o endereço IP 192.168.0.100 da Lista de Permissões de IP.
Get-IPAllowListEntry | Where {$_.IPRange -eq '192.168.0.100'} | Remove-IPAllowListEntry
EXEMPLO 2
O exemplo a seguir remove o intervalo IP 192.168.0.0/24 da Lista de Permissões de IP.
Get-IPAllowListEntry | Where {$_.IPRange -eq '192.168.0.0/24'} | Remove-IPAllowListEntry
Dica
É necessário especificar o atributo Identidade de uma entrada da Lista de Permissões de IP ao usar o comando Remove-IPAllowListEntry. O atributo Identidade é um valor inteiro que é automaticamente atribuído quando a entrada da Lista de Permissões de IP é criada pela primeira vez. Para remover o endereço ou intervalo IP da Lista de Permissões de IP, é possível usar a saída do comando Get-IPAllowListEntry.
Código
Remove-IPAllowListEntry -Identity <Integer>