Compartilhar via


Get-IPBlockListEntry

 

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 Get-IPBlockListEntry para obter informações sobre a configuração de endereço IP do agente do Filtro de Conexão para o computador em que o comando é executado.

Sintaxe

Get-IPBlockListEntry [-Identity <IPListEntryIdentity>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

Get-IPBlockListEntry -IPAddress <IPAddress> [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

Descrição detalhada

A Lista de Bloqueios de IP é usada pelo agente Filtro de Conexão.

Para executar o cmdlet Get-IPBlockListEntry, você deve usar a conta à qual esteja delegado o seguinte:

  • Função Administradores Somente para Exibição do Exchange

Para executar o cmdlet Get-IPBlockListEntry 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

IPAddress

Necessário

System.Net.IPAddress

Se desejar exibir uma entrada ou entradas da Lista de Bloqueios de IP que contenham um Endereço IP específico, use o parâmetro IPAddress para especificar um endereço IP. Por exemplo, se você tiver uma entrada da Lista de Bloqueios de IP que especifica um intervalo de endereços IP de 192.168.0.1 a 192.168.0.20, insira qualquer endereço IP contido no intervalo para retornar a entrada da Lista de Bloqueios de IP.

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.IPListEntryIdentity

Se você desejar exibir uma entrada específica da Lista de Bloqueios de IP, use o parâmetro Identity para especificar o número de configuração. Quando você adiciona um endereço IP à Lista de Bloqueios de IP, o parâmetro Identity é incrementado automaticamente.

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Se desejar retornar todas as entradas, use unlimited como valor para este parâmetro. O valor padrão é 1000.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Para especificar um servidor de Transporte de Hub em que será executado o cmdlet Get-IPBlockListEntry, 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.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exemplo

O primeiro exemplo de código mostra um comando Get-IPBlockListEntry que retorna entradas geradas automaticamente e inseridas pela reputação do remetente.

O segundo exemplo de código mostra um comando Get-IPBlockListEntry que exclui entradas geradas automaticamente que expiraram há 14 dias.

Get-IPBlockListEntry | where { $_.IsMachineGenerated }
Get-IPBlockListEntry | where { $_.IsMachineGenerated -and $_.ExpirationTime -lt (date).AddDays(-14) } | Remove-IPBlockListEntry