Set-RecipientFilterConfig

 

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

Última modificación del tema: 2009-05-18

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>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <RecipientFilterConfig>] [-InternalMailEnabled <$true | $false>] [-RecipientValidationEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

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 local Administradores 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 Microsoft 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.
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 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.
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.

Typos 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 destinatarios bloqueada y cómo agregarle destinatarios.

El parámetro BlockedRecipients toma varios valores. Cuando pasa un valor al parámetro BlockedRecipients, el valor existente se sustituye por el valor nuevo. Para obtener más información acerca de cómo agregar o quitar valores de propiedades de varios valores, consulte Modificar propiedades con varios valores.

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