Set-RecipientFilterConfig (RTM)

 

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-08-27

Utilice el cmdlet Set-RecipientFilterConfig para habilitar y configurar el agente de filtro de destinatarios en un equipo que tenga instalada la función del servidor Transporte perimetral o la función del servidor Concentrador de transporte.

Sintaxis

Set-RecipientFilterConfig [-BlockedRecipients <MultiValuedProperty>] [-BlockListEnabled <$true | $false>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <RecipientFilterConfig>] [-InternalMailEnabled <$true | $false>] [-RecipientValidationEnabled <$true | $false>]

Descripción detallada

Para ejecutar el cmdlet Set-RecipientFilterConfig, 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-RecipientFilterConfig en un equipo que tenga instalada la función del servidor Transporte perimetral, debe iniciar sesión con una cuenta que sea miembro del grupo local de administradores en dicho equipo.

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro	Necesario	Tipo	Descripción
BlockedRecipients	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	La entrada válida del parámetro BlockedRecipients Enabled corresponde a una o varias direcciones SMTP. Puede indicar un máximo de 800 direcciones SMTP individuales para el parámetro BlockedRecipients .
BlockListEnabled	Opcional	System.Boolean	Las entradas válidas del parámetro BlockListEnabled Enabled son $true o $false. El valor predeterminado es $false. Cuando el parámetro BlockListEnabled tiene el valor $true, el agente de filtro de destinatarios bloquea los mensajes que se envían a los destinatarios incluidos en el parámetro BlockedRecipients.
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 Filtro de destinatarios se habilita en el equipo en que se ejecuta el cmdlet Set-RecipientFilterConfig.
ExternalMailEnabled	Opcional	System.Boolean	Las entradas válidas del parámetro ExternalMailEnabled son $true o $false. El valor predeterminado es $true. Cuando el parámetro ExternalMailEnabled tiene el valor $true, todos los mensajes procedentes de conexiones no autenticadas pasan por el agente de filtro de destinatarios para su procesamiento.
Instance	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.RecipientFilterConfig	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.
InternalMailEnabled	Opcional	System.Boolean	Las entradas válidas del parámetro InternalMailEnabled son $true o $false. El valor predeterminado es $false. Cuando el parámetro InternalMailEnabled tiene el valor $true, todos los mensajes procedentes de dominios de remitentes autenticados que pertenecen a dominios autoritativos de su empresa pasan por el agente de filtro de destinatarios para su procesamiento.
RecipientValidationEnabled	Opcional	System.Boolean	Las entradas válidas del parámetro RecipientValidationEnabled Enabled son $true o $false. El valor predeterminado es $false. Cuando el parámetro RecipientValidationEnabled tiene el valor $true, el agente de filtro de destinatarios bloquea los mensajes que contienen destinatarios que no existen en su organización.

Tipos de entrada

Tipos de valores devueltos

Errores

Error	Descripción

Ejemplo

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

En el primer ejemplo de código se explica cómo modificar la configuración del filtro de destinatarios para habilitar la validación de destinatarios.

En el segundo ejemplo de código se explica cómo habilitar la lista de direcciones IP bloqueadas y cómo agregar destinatarios a la lista de destinatarios bloqueada.

La propiedad BlockedRecipients admite varios valores; cuando pase un valor a la propiedad BlockedRecipients, se reemplaza el valor existente con el nuevo. Para consultar información de procedimientos que explica cómo anexar valores a una propiedad multivalor existente, consulte Modificar propiedades con varios valores.

Set-RecipientFilterConfig -RecipientValidationEnabled:$true
Set-RecipientFilterConfig -BlockListEnabled:$true -BlockedRecipients user1@contoso.com,user2@contoso.com