Set-IPBlockListProvider (RTM)

Artículo
06/26/2014

Se aplica a: Exchange Server 2007

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

Utilice el cmdlet Set-IPBlockListProvider para modificar la información de configuración de un proveedor de lista de IP no admitidas en un equipo que tiene instalada la función del servidor Transporte perimetral o de concentradores.

Sintaxis

Set-IPBlockListProvider -Identity <IPBlockListProviderIdParameter> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>] [-RejectionResponse <AsciiString>]

Set-IPBlockListProvider [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Instance <IPBlockListProvider>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>] [-RejectionResponse <AsciiString>]

Descripción detallada

Utilice el cmdlet Set-IPBlockListProvider para modificar las configuraciones establecidas para el proveedor de lista de IP no admitidas. Esta configuración la utiliza el agente de filtro de conexiones. Se necesita el parámetro Identity.

Para ejecutar el cmdlet Set-IPBlockListProvider, debe utilizar una cuenta en la que se delegue lo siguiente:

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

Para ejecutar el cmdlet Set-IPBlockListProvider 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, 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.IPBlockListProviderIdParameter	El parámetro Identity puede incluir un valor de cadena, que es el valor Name o la GUID.
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 una dirección IP para el parámetro BitmaskMatch, el agente de filtro de conexiones sólo actúa en los mensajes que coinciden con el mismo código de estado de dirección IP que devuelve el servicio proveedor de la lista de IP no admitidas.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Para especificar el nombre de dominio completo 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 ejecutan 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.
Instance	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.IPBlockListProvider	El parámetro Instance permite pasar todo un objeto al comando para su procesamiento. Se utiliza principalmente en scripts donde hay que pasar un objeto completo al comando.
IPAddressesMatch	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Cuando se configura una dirección IP para el parámetro IPAddressesMatch, el agente de filtro de conexiones sólo actúa en los mensajes que coinciden con el código de estado de dirección IP que devuelve el servicio proveedor de la lista de IP no admitidas.
LookupDomain	Opcional	Microsoft.Exchange.Data.SmtpDomain	Este parámetro especifica el nombre de dominio que el agente de filtro de conexión consulta en busca de datos actualizados de la lista de IP no admitidas.
Name	Opcional	System.String	Este parámetro especifica el nombre del servicio proveedor de la lista de IP no admitidas. El valor de cadena del parámetro Identity no cambia al modificar este valor.
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 proveedor de la lista de IP no admitidas, el otro proveedor de la lista de IP no admitidas se incrementa en 1.
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 proveedor de la lista de IP no admitidas en la respuesta, para que los remitentes legítimos se pongan en contacto con el servicio proveedor. El argumento no puede superar 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 addresses matched to Example.com's IP Block List Provider service"`.

Tipos de entrada

Tipos de valores devueltos

Errores

Error	Descripción

Ejemplo

Los siguientes ejemplos de código muestran dos comandos Set-IPBlockListProvider.

El primer ejemplo de código muestra un comando Set-IPBlockListProvider que hace que el agente de filtro de conexión considere como evento procesable todas las coincidencias procedentes del servicio proveedor de la lista de IP no admitidas.

El segundo ejemplo de código muestra un comando Set-IPBlockListProvider que establece en 1 la prioridad de una configuración existente.

Set-IPBlockListProvider -Identity Example.com -AnyMatch:$true 
Set-IPBlockListProvider -Identity Example.com -Priority 1