Remove-IPBlockListEntry

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2011-01-12

Utilice el cmdlet Remove-IPBlockListEntry para quitar una dirección IP de la información de configuración para el agente de filtro de conexiones en el equipo en que se ejecuta el cmdlet.

Sintaxis

Remove-IPBlocklistEntry -Identity <IPListEntryIdentity> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Si no especifica el parámetro Identity cuando ejecuta el cmdlet Remove‑IPBlockListEntry, el Shell de administración de Exchange le pedirá que lo haga.

La configuración de entrada de la lista de IP no admitidas la usa el agente de filtro de conexiones.

Para ejecutar el cmdlet Remove-IPBlockListEntry, deberá delegar a la cuenta que use las funciones siguientes:

  • Función de administrador de servidores de Exchange y grupo local Administradores para el servidor de destino

Para ejecutar el cmdlet Remove-IPBlockListEntry en un equipo que tenga instalada la función de servidor de transporte perimetral, debe iniciar sesión mediante una cuenta que sea miembro del grupo local de administradores de dicho equipo.

Para obtener más información sobre los permisos, funciones de delegación y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

Identity

Necesario

Microsoft.Exchange.Configuration.Tasks.IPListEntryIdentity

Debe especificar el parámetro Identity de la dirección IP que desea quitar. Cuando agregue una dirección IP a la lista de IP no admitidas, el parámetro Identity se incrementará automáticamente.

Confirm

Opcional

System.Management.Automation.SwitchParameter

El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Para especificar un servidor de transporte de concentrador en el que ejecutar el cmdlet Remove-IPBlockListEntry, incluya el parámetro Server en el comando. Si no usa el parámetro Server, el comando se ejecuta en el servidor local donde se gestiona el comando.

No puede usar este cmdlet para configurar otros servidores de transporte perimetral de manera remota.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

Ejemplos

Descripción

El siguiente ejemplo de código muestra un comando Remove-IPBlockListEntry que quita la dirección IP o un intervalo de direcciones IP de la lista de IP no admitidas del equipo en el que se ejecuta el comando.

EJEMPLO 1

En el ejemplo siguiente se quita la dirección IP 192.168.0.100 de la lista de IP bloqueadas.

Get-IPBlockListEntry | Where {$_.IPRange -eq '192.168.0.100'} | Remove-IPBlockListEntry

EJEMPLO 2

En el ejemplo siguiente se quita el intervalo IP 192.168.0.0/24 de la lista de IP bloqueadas.

Get-IPBlockListEntry | Where {$_.IPRange -eq '192.168.0.0/24'} | Remove-IPBlockListEntry

Nota

Debe especificar el atributo Identity de una entrada de la lista de IP bloqueadas cuando use el comando Remove-PBlockListEntry. El atributo Identity es un valor entero que se asigna automáticamente cuando se crea por primera vez la entrada de la lista de IP bloqueadas. Para quitar una dirección o intervalo de direcciones IP de la lista de IP bloqueadas, puede usar el resultado del comando Get-IPBlockListEntry.

Código

Remove-IPBlockListEntry -Identity <Integer>