Add-IPAllowListEntry
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-IPAllowListEntry para agregar una dirección IP o un intervalo de direcciones IP a la información de configuración de la lista de IP admitidas del agente de filtro de conexiones en un equipo que tenga instalada la función del servidor Transporte de concentradores o transporte perimetral.
Sintaxis
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>]]
Descripción detallada
Si no especifica el parámetro IPAddress cuando ejecuta el cmdlet Add-IPAllowListEntry, el 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-IPAllowListEntry, se debe utilizar una cuenta en la que se delegue lo siguiente:
- Función de administrador de servidores de Exchange y grupo local Administradores para el servidor de destino
Para ejecutar el cmdlet Add-IPAllowListEntry en un equipo que tiene instalada la función del servidor Transporte perimetral, debe 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 dirección IP única que agregar a la lista de IP admitidas del siguiente modo: |
IPRange |
Necesario |
Microsoft.Exchange.Data.IPRange |
Puede agregar intervalos de direcciones IP a la lista de IP admitidas con los siguientes formatos:
|
Comment |
Opcional |
System.String |
Utilice este parámetro para crear notas administrativas o avisos 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 hora en la que expirará la entrada de la lista de IP admitidas 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 utilizar 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-IPAllowListEntry, incluya el parámetro Server en el comando. Si no utiliza el parámetro Server, el comando se ejecuta en el servidor local donde se ejecuta el comando. No puede utilizar 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 primer ejemplo de código muestra un comando Add-IPAllowListEntry que agrega un intervalo de direcciones IP a la lista de IP admitidas del equipo en el que se ejecuta el comando. El segundo ejemplo de código establece que esa misma entrada de la lista de IP admitidas caduque a las 11:59 p.m. del 1 de marzo de 2007.
Add-IPAllowListEntry -IPRange:192.168.0.1/24
Add-IPAllowListEntry -IPRange:192.168.0.1/24 -ExpirationTime "1/3/2007 23:59"