Add-IPAllowListProvider

 

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

Última modificación del tema: 2007-06-22

Utilice el cmdlet Add‑IPAllowListProvider para crear una nueva configuración de los proveedores de la lista de IP admitidas en un equipo que tiene instalada la función del servidor Transporte perimetral o de transporte de concentradores.

Sintaxis

Add-IPAllowListProvider -Name <String> -LookupDomain <SmtpDomain> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-Priority <Int32>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

La configuración del proveedor de la lista de IP admitidas la utiliza el agente de filtro de conexiones.

Se requieren los parámetros Name y LookupDomain. Si no pasa los parámetros necesarios, Shell de administración de Exchange se los solicita.

Para ejecutar el cmdlet Add-IPAllowListProvider, deberá delegar a la cuenta que utilice los elementos siguientes:

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

Para ejecutar el cmdlet Add‑IPAllowListProvider 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 de Administradores locales en ese equipo.

Para obtener más información sobre 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

LookupDomain

Necesario

Microsoft.Exchange.Data.SmtpDomain

El nombre de dominio donde el agente de filtro de conexiones consulta la información actualizada de la lista de IP admitidas.

Name

Necesario

System.String

El nombre del servicio proveedor de la lista de IP admitidas

AnyMatch

Opcional

System.Boolean

Las entradas válidas del parámetro AnyMatch son $true o $false. El valor predeterminado es $false. Cuando el parámetro AnyMatch tiene el valor $true, el agente de filtro de conexiones considera como coincidencia todos los códigos de estado de dirección IP que devuelve el servicio proveedor de la lista de IP admitidas.

BitmaskMatch

Opcional

System.Net.IPAddress

Cuando se configura el parámetro BitmaskMatch para que use una dirección IP, el agente de filtro de conexiones sólo actúa con los mensajes que coinciden con el código de estado dirección IP que devuelve el servicio proveedor de la lista de IP admitidas.

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.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar qué controlador de dominio escribe este cambio de configuración correspondiente a los datos de configuración de filtrado de conexiones en el servicio de directorio Active Directory, incluya el parámetro DomainController en el comando. No se admite el parámetro DomainController si está ejecutando este comando en un equipo con la función del servidor Transporte perimetral instalada. El servidor de transporte perimetral sólo escribe en la instancia de ADAM local.

Enabled

Opcional

System.Boolean

Las entradas válidas del parámetro Enabled son $true o $false. El valor predeterminado es $true. Cuando el parámetro Enabled tiene el valor $true, el agente de filtro de conexiones consulta el servicio proveedor de la lista de IP admitidas según la prioridad que se haya establecido para esta configuración del proveedor de la lista de IP admitidas.

IPAddressesMatch

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Cuando se configura una dirección IP para el parámetro IPAddressMatch, el agente de filtro de conexiones sólo actúa con los mensajes que coinciden con el código de estado dirección IP que devuelve el servicio proveedor de la lista de IP admitidas.

Priority

Opcional

System.Int32

Establezca el parámetro Priority para configurar el orden en que el agente de filtro de conexiones consulta los servicios proveedores de la lista de IP admitidas que se han definido. De forma predeterminada, al agregar un nuevo servicio proveedor de la lista de IP admitidas, a la entrada se le asigna la prioridad N+1, donde N es el número de servicios proveedores de la lista de IP admitidas que se han configurado.

Si al parámetro Priority se le asigna un valor idéntico al de otro servicio proveedor de la lista de IP admitidas, incrementa en 1 la prioridad del servicio proveedor de la lista de IP admitidas que se ha agregado en primer lugar.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Cuando se suministra un objeto existente a este parámetro, el comando utilizará la configuración de dicho objeto para crear un duplicado exacto del mismo en un servidor local o de destino.

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 un comando Add‑IPAllowListProvider que tiene los siguientes parámetros obligatorios: LookupDomain y Name.

Add-IPAllowListProvider -Name:Example -LookupDomain:Example.com