Add-IPAllowListEntry
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2007-07-06
Use o cmdlet Add-IPAllowListEntry para adicionar um endereço IP ou um intervalo de endereços IP às informações de configuração da Lista de Permissões de IP do agente do Filtro de Conexão em um computador em que a função de servidor Transporte de Hub ou de Transporte de Borda esteja instalada.
Sintaxe
Add-IPAllowListEntry -IPRange <IPRange> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Add-IPAllowListEntry -IPAddress <IPAddress> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Se você não especificar o parâmetro IPAddress ao executar o cmdlet Add-IPAllowListEntry, o Shell de Gerenciamento do Exchange o solicitará. O parâmetro IPAddress ou IPRange é necessário.
Dica
Se o Microsoft Exchange Server 2007 Service Pack 1 (SP1) for implantado em um computador que esteja executando o Windows Server 2008, você poderá inserir endereços IP e intervalos de endereços IP no formato IPv4, IPv6 ou ambos. Uma instalação padrão do Windows Server 2008 permite suporte para IPv4 e IPv6. Para obter mais informações sobre o suporte do Exchange 2007 SP1 para endereços IPv6, consulte Suporte a IPv6 no Exchange 2007 SP1 e SP2 (página em inglês).
Para executar o cmdlet Add-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 Add-IPAllowListEntry 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 |
|---|---|---|---|
IPAddress |
Necessário |
System.Net.IPAddress |
Você pode especificar um único endereço IP a ser adicionado à Lista de Permissões de IP, como a seguir: |
IPRange |
Necessário |
Microsoft.Exchange.Data.IPRange |
Você pode adicionar intervalos de endereços IP à Lista de Permissões de IP nos seguintes formatos:
|
Comment |
Opcional |
System.String |
Use esse parâmetro para fazer anotações administrativas ou criar lembretes sobre essa entrada específica. Você deve incluir o valor do parâmetro Comment entre aspas duplas, conforme o exemplo a seguir: "esta é uma nota administrativa". |
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. |
ExpirationTime |
Opcional |
System.DateTime |
Você pode especificar o dia e a hora em que a entrada da Lista de Permissões de IP que está sendo criada irá expirar. Se especificar apenas a hora, a data atual será adotada. Ao inserir uma data específica, use o formato de data abreviada definido nas configurações de Opções Regionais do computador local. Por exemplo, se o computador estiver configurado para usar o formato de data abreviado, dd/mm/aaaa hh:mm:ss, e você quiser definir a data e a hora de expiração para 3 de janeiro de 2007 às 11:00, insira as informações a seguir entre aspas duplas: |
Server |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Para especificar um servidor de Transporte de Hub diferente, no qual você executa o cmdlet Add-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 |
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 primeiro exemplo de código mostra um comando Add-IPAllowListEntry que adiciona um intervalo de endereço IP à Lista de Permissões de IP do computador no qual o comando é executado. O segundo exemplo de código define que a mesma entrada da Lista de Permissões de IP expire às 11:59 da noite de 3 de janeiro de 2007.
Add-IPAllowListEntry -IPRange:192.168.0.1/24
Add-IPAllowListEntry -IPRange:192.168.0.1/24 -ExpirationTime "1/3/2007 23:59"