Add-IPBlockListProvider

Artículo
06/26/2014

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

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

Use el cmdlet Add-IPBlockListProvider para crear una nueva configuración del proveedor de la lista de IP no admitida en un equipo que tenga instalada la función del servidor Transporte perimetral o Transporte de concentradores.

Sintaxis

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

Descripción detallada

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

El parámetro Name y el parámetro LookupDomain son necesarios. Si no usa los parámetros necesarios, Shell de administración de Exchange le solicitará que lo haga.

Para ejecutar el cmdlet Add-IPBlockListProvider, debe usar una cuenta que tenga delegado lo siguiente:

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

Para ejecutar el cmdlet Add-IPBlockListProvider 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 de Administradores locales en ese 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
LookupDomain	Necesario	Microsoft.Exchange.Data.SmtpDomain	El nombre de dominio donde el agente de filtro de conexiones consulta los datos actualizados de la lista de IP no admitidas.
Name	Necesario	System.String	El nombre del servicio proveedor de la lista de IP no admitidas
AnyMatch	Opcional	System.Boolean	Las entradas válidas del parámetro Enabled 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 no 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 no 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 el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory, incluya el parámetro DomainController en el comando. El parámetro DomainController no se admite en equipos que tienen instalada la función del servidor Transporte perimetral. La función del servidor 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 no admitidas según la prioridad que se haya establecido para esta configuración del proveedor de la lista de IP no admitidas.
IPAddressesMatch	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Cuando se configura el parámetro IPAddressesMatch 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 no 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 no admitidas que se han configurado. De forma predeterminada, al agregar un nuevo servicio proveedor de la lista de IP no 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 no 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 no admitidas, incrementa en 1 la prioridad del proveedor de la lista de IP no admitidas que se ha agregado en primer lugar.
RejectionResponse	Opcional	Microsoft.Exchange.Data.AsciiString	El parámetro RejectionResponse toma una cadena. Escriba el cuerpo del mensaje que desea entregar en la sesión SMTP a los remitentes cuyos mensajes están bloqueados por el agente de filtro de conexiones cuando un servicio proveedor de la lista de IP no admitidas coincide con la dirección IP del remitente. Le recomendamos que especifique el servicio de proveedor de la lista de IP non admitidas en la respuesta de modo que los remitentes legítimos puedan entrar en contacto con el servicio proveedor de la lista de IP no admitidas. El argumento no puede superar de los 240 caracteres. Cuando pase un argumento, incluya el parámetro RejectionResponse entre comillas dobles si la frase contiene espacios, como por ejemplo: `"Originating IP addressed matched to Example.com's IP Block List provider service"`.
TemplateInstance	Opcional	System.Management.Automation.PSObject	Cuando se suministra un objeto existente a este parámetro, el comando usará 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 primer ejemplo de código muestra un comando Add-IPBlockListProvider que tiene los parámetros obligatorios. También muestra cómo agregar un nuevo proveedor de lista de IP no admitidas y establecer una respuesta de rechazo.

El segundo ejemplo de código muestra un comando Add-IPBlockListProvider que presenta los parámetros obligatorios y muestra cómo configurar un valor de retorno de máscara de bits desde el proveedor.

Add-IPBlockListProvider -Name:Example -LookupDomain:Example.com -RejectionResponse "Originating IP addressed matched to Example.com's IP Block List provider service"
Add-IPBlockListProvider -Name:Example -LookupDomain:Example.com -BitmaskMatch 127.1.0.1