Set-ContentFilterConfig

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: 2009-05-18

Use el cmdlet Set-ContentFilterConfig para modificar la configuración del filtro de contenido en un equipo que tiene instalada la función del servidor Transporte perimetral o la función del servidor Transporte de concentradores.

Sintaxis

Set-ContentFilterConfig [-BypassedRecipients <MultiValuedProperty>] [-BypassedSenderDomains <MultiValuedProperty>] [-BypassedSenders <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <ContentFilterConfig>] [-InternalMailEnabled <$true | $false>] [-OutlookEmailPostmarkValidationEnabled <$true | $false>] [-QuarantineMailbox <Nullable>] [-RejectionResponse <AsciiString>] [-SCLDeleteEnabled <$true | $false>] [-SCLDeleteThreshold <Int32>] [-SCLQuarantineEnabled <$true | $false>] [-SCLQuarantineThreshold <Int32>] [-SCLRejectEnabled <$true | $false>] [-SCLRejectThreshold <Int32>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Este comando modifica la configuración del filtro de contenido.

Para ejecutar el cmdlet Set-ContentFilterConfig, la cuenta que use debe tener delegado lo siguiente:

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

Para ejecutar el cmdlet Set-ContentFilterConfig en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión mediante una cuenta que sea miembro del grupo de administradores local en dicho equipo.

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

Parámetros

Parámetro	Necesario	Tipo	Descripción
BypassedRecipients	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Este parámetro toma los valores de direcciones SMTP de los destinatarios de la organización. El agente de filtro de contenido no procesa ningún filtrado de contenido para los mensajes que están vinculados a las direcciones incluidas en este parámetro. Para indicar varias direcciones SMTP, sepárelas mediante una coma, como por ejemplo: `recipient1@contoso.com, recipient2@contoso.com` El número máximo de destinatarios que se puede indicar es 800.
BypassedSenderDomains	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Este parámetro toma los valores de nombres de dominio de los dominios de envío. El agente de filtro de contenido no procesa ningún filtrado de contenido para los mensajes que se reciben de los dominios incluidos en este parámetro. Para indicar varios dominios, sepárelos mediante una coma, como por ejemplo: `contoso.com, example.com`. Se puede usar un carácter comodín () para especificar todos los subdominios, como por ejemplo: .`contoso.com`. El número máximo de dominios que se puede indicar es 800.
BypassedSenders	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Este parámetro toma los valores de direcciones SMTP de los remitentes. El agente de filtro de contenido no procesa ningún filtrado de contenido para los mensajes que se reciben de las direcciones incluidas en este parámetro. Para indicar varias direcciones SMTP, sepárelas mediante una coma, como por ejemplo: `sender1@contoso.com, sender2@example.com` El número máximo de direcciones SMTP que se puede indicar es 800.
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 contenido se habilita en el equipo en que se ejecuta el comando Set‑ContentFilterConfig.
ExternalMailEnabled	Opcional	System.Boolean	Las entrada 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 contenido para su procesamiento.
Instance	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.ContentFilterConfig	El parámetro Instance permite pasar todo un objeto al comando para su procesamiento. Se usa 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 conexiones autenticadas y de dominios autoritativos de su empresa pasan por el agente de filtro de contenido para su procesamiento.
OutlookEmailPostmarkValidationEnabled	Opcional	System.Boolean	La entrada válida del parámetro OutlookEmailPostmarkValidationEnabled es `$true` o `$false`. Cuando el parámetro OutlookEmailPostmarkValidationEnabled tiene el valor `$true`, el agente Filtro de contenido envía un puzzle computacional al sistema de correo electrónico del remitente para su procesamiento. Los resultados de la validación del puzzle se incluyen como factor en el nivel global de confianza contra correo electrónico no deseado (SCL). Esta funcionalidad queda expuesta para el usuario de Microsoft Outlook como validación del Certificado electrónico Office Outlook 2007. El valor predeterminado es `$false`.
QuarantineMailbox	Opcional	System.Nullable	La entrada válida del parámetro QuarantineMailbox es una dirección SMTP. Se necesita un buzón de cuarentena al establecer el parámetro SCLQuarantineEnabled en `True`. Todos los mensajes que superen el valor establecido en el parámetro SCLQuarantineThreshold se envían a la dirección SMTP definida en este parámetro.
RejectionResponse	Opcional	Microsoft.Exchange.Data.AsciiString	Se necesita este parámetro al establecer el parámetro SCLRejectEnabled en `True`. El parámetro RejectionResponse toma una cadena. Escriba el cuerpo del mensaje que desea entregar en un informe de no entrega (NDR) a los remitentes cuyos mensajes tengan (o superen) el valor SCLRejectThreshold. No supere los 240 caracteres en el argumento. Cuando pase un argumento, incluya el parámetro RejectionResponse entre comillas dobles si la frase contiene espacios, como por ejemplo: `"Message rejected"`. El valor predeterminado es `Message rejected due to content restrictions`.
SCLDeleteEnabled	Opcional	System.Boolean	Las entradas válidas del parámetro SCLDeleteEnabled son `$true` o `$false`. El valor predeterminado es `$false`. Cuando el parámetro SCLDeleteEnabled tiene el valor `$true`, se eliminan todos los mensajes que superen el valor establecido en el parámetro SCLDeleteThreshold.
SCLDeleteThreshold	Opcional	System.Int32	Este parámetro toma un valor entero comprendido entre `1` y `9`. Este valor representa la clasificación SCL que un determinado mensaje debe superar a fin de que el agente de filtro de contenido elimine el mensaje y no envíe un NDR. Para habilitar esta funcionalidad, debe establecer el parámetro SCLDeleteEnabled en `True`. El valor predeterminado es `9`.
SCLQuarantineEnabled	Opcional	System.Boolean	Las entradas válidas del parámetro SCLQuarantineEnabled son `$true` o `$false`. El valor predeterminado es `$false`. Cuando el parámetro SCLQuarantineEnabled tiene el valor `$true`, se envían todos los mensajes que superen el valor establecido en el parámetro SCLQuarantineThreshold al buzón de cuarentena especificado en el parámetro QuarantineMailbox.
SCLQuarantineThreshold	Opcional	System.Int32	Este parámetro toma un valor entero comprendido entre `1` y `9`. Este valor representa la clasificación SCL que un determinado mensaje debe superar a fin de que el agente de filtro de contenido envíe el mensaje a cuarentena. Para habilitar la funcionalidad de cuarentena, debe establecer el parámetro SCLQuarantineEnabled en `True` y proporcionar una dirección SMTP válida en el parámetro QuarantineMailbox. El valor predeterminado es `9`.
SCLRejectEnabled	Opcional	System.Boolean	Las entradas válidas del parámetro SCLRejectEnabled son `$true` o `$false`. El valor predeterminado es `$false`. Cuando el parámetro SCLRejectEnabled tiene el valor `$true`, se rechazan todos los mensajes que superen el valor establecido en el parámetro SCLRejectThreshold y se envía un NDR al remitente.
SCLRejectThreshold	Opcional	System.Int32	Este parámetro toma un valor entero comprendido entre `1` y `9`. Este valor representa la clasificación SCL que un determinado mensaje debe superar a fin de que el agente de filtro de contenido rechace el mensaje y envíe un NDR al remitente. Para habilitar la funcionalidad de eliminación, debe establecer el parámetro SCLDeleteEnabled en `True`. Asimismo, puede revisar el mensaje NDR predeterminado editando el parámetro RejectionResponse. El valor predeterminado es `9`.
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 se muestra un comando Set-ContentFilterConfig que incluye las siguientes modificaciones en la configuración del filtro de contenido:

Habilita y configura las funciones de umbral de SCL que eliminan, rechazan y envían a cuarentena los mensajes.
Hace que el buzón de cuarentena de correo electrónico no deseado sea spamQ@contoso.com.
Establece la acción de Filtro de contenido para rechazar todos los mensajes que superen el umbral de SCL.
Establece la respuesta de rechazo.
Define dos usuarios para quienes Filtro de contenido no debería procesar los mensajes.

El segundo ejemplo de código muestra un comando Set-ContentFilterConfig que especifica un dominio de remitente denominado woodgrovebank.com, cuyo correo electrónico entrante omitirá el filtrado de contenidos.

Set-ContentFilterConfig -SclQuarantineEnabled:$true -SclRejectEnabled:$true -SclDeleteEnabled:$true -SclQuarantineThreshold 5 -SclRejectThreshold 6 -SclDeleteThreshold 8  -QuarantineMailbox spamQ@contoso.com -RejectionResponse "Message rejected due to content restrictions" -BypassedRecipients user1@contoso.com,user2@contoso.com 
Set-ContentFilterConfig -BypassedSenderDomains woodgrovebank.com