Add-IPBlockListEntry
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2007-07-06
Utilice el cmdlet Add-IPBlockListEntry para agregar una dirección IP o un intervalo de direcciones IP a la información de configuración de la lista de direcciones IP bloqueadas para la configuración del filtro de conexiones del equipo en el que se ejecuta el comando. Debe tener derechos de administrador en el equipo que tiene instalada la función del servidor Transporte de concentradores o Transporte perimetral.
Sintaxis
Add-IPBlockListEntry -IPRange <IPRange> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Add-IPBlockListEntry -IPAddress <IPAddress> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ExpirationTime <DateTime>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Si no especifica el parámetro IPAddress cuando ejecuta el cmdlet Add-IPBlockListEntry, el comando del Shell de administración de Exchange le pedirá que lo haga. Tiene que especificar el parámetro IPAddress o el parámetro IPRange.
Nota
Si el Service Pack 1 (SP1) de Microsoft Exchange Server 2007 se implementa en un equipo que ejecuta Windows Server 2008, puede introducir direcciones IP e intervalos de direcciones IP en formato de Protocolo de Internet versión 4 (IPv4), en formato Protocolo de Internet versión 6 (IPv6) o en ambos formatos. Una instalación predeterminada de Windows Server 2008 permite la compatibilidad para IPv4 e IPv6. Para obtener más información acerca de la compatibilidad de Exchange 2007 SP1 con direcciones IPv6, consulte Compatibilidad con IPv6 en Exchange 2007 SP1 y SP2.
Para ejecutar el cmdlet Add-IPBlockListEntry, la cuenta que use debe tener delegado lo siguiente:
- Función Administrador de Exchange Server y grupo local Administradores para el servidor de destino
Para ejecutar el cmdlet Add-IPBlockListEntry en un equipo que tenga instalada la función del servidor Transporte perimetral, tiene que iniciar sesión con una cuenta que sea miembro del grupo local de administradores en ese 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 |
|---|---|---|---|
IPAddress |
Necesario |
System.Net.IPAddress |
Puede especificar una sola dirección IP para agregar a la lista de direcciones IP bloqueadas. Por ejemplo, |
IPRange |
Necesario |
Microsoft.Exchange.Data.IPRange |
Puede agregar direcciones IP a la lista de direcciones IP bloqueadas con los siguientes formatos:
|
Comment |
Opcional |
System.String |
Utilice este parámetro para hacer notas administrativas o recordatorios acerca de esta entrada específica. El valor del parámetro Comment debe escribirse entre comillas, como en el siguiente ejemplo: "esto es una nota del administrador". |
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. |
ExpirationTime |
Opcional |
System.DateTime |
Puede especificar un día y una hora en los que expirará la entrada de la lista de direcciones IP bloqueadas que está creando. Si especifica únicamente la hora, sin la fecha, se tomará el día actual. Cuando escriba una fecha específica, utilice el formato de fecha abreviado definido en las opciones de Configuración regional configuradas en el equipo local. Por ejemplo, si el equipo se ha configurado para usar el formato de fecha abreviado dd/mm/aaaa hh:mm:ss, para establecer el período de expiración a las 11:00 a.m. del 3 de enero de 2007, especifique la siguiente información entre comillas dobles: |
Server |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Para especificar un servidor de transporte de concentradores diferente en el que se ejecuta el cmdlet Add-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 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 |
|---|---|
|
Ejemplo
El siguiente ejemplo de código muestra cómo usar el cmdlet Add-IPBlockListEntry para agregar un intervalo de direcciones IP a la lista de direccionees IP bloqueadas del equipo en el que se ejecuta el comando. El segundo ejemplo establece la misma entrada de la lista de direcciones IP bloqueadas para que caduque a las 11:59 p.m. del 3 de enero de 2007.
Add-IPBlockListEntry -IPRange:192.168.0.1/24
Add-IPBlockListEntry -IPRange:192.168.0.1/24 -ExpirationTime "1/3/2007 23:59"