Remove-IPAllowListEntry

 

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‑IPAllowListEntry 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 comando.

Sintaxis

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

Descripción detallada

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

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

Para ejecutar el cmdlet Remove-IPAllowListEntry, la cuenta que use deberá tener delegado lo siguiente:

  • Función Administrador de Exchange Server y grupo local Administradores para el servidor de destino

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

Para obtener más información acerca de los permisos, la delegación de funciones 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 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 otro servidor de transporte de concentradores en el que ejecutar el cmdlet Remove-IPAllowListEntry, 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 ejecuta el comando.

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

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-IPAllowListEntry que quita la dirección IP o un intervalo de direcciones IP de la lista de direcciones IP permitidas del equipo en el que se ejecuta el comando.

EJEMPLO 1

El siguiente ejemplo quita la dirección IP 192.168.0.100 de la lista de direcciones IP permitidas.

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

EJEMPLO 2

El siguiente ejemplo quita el intervalo de direcciones IP 192.168.0.0/24 de la lista de direcciones IP permitidas.

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

Nota

Especifique el atributo Identity de una entrada de la lista de direcciones IP permitidas cuando utilice el comando Remove-IPAllowListEntry. El atributo Identity es un valor entero asignado automáticamente cuando se crea la entrada de la lista de direcciones IP permitidas por primera vez. Para quitar una dirección IP concreta o un intervalo de direcciones IP de la lista de direcciones IP permitidas, utilice el resultado del comando Get-IPAllowListEntry.

Código

Remove-IPAllowListEntry -Identity <Integer>