Set-ContentFilterConfig

Articolo
08/07/2014

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2009-05-18

Il cmdlet Set-ContentFilterConfig consente di modificare la configurazione del filtro contenuti di un computer in cui è installato il ruolo del server Trasporto Edge o il ruolo del server Trasporto Hub.

Sintassi

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>]]

Descrizione dettagliata

Questo comando consente di modificare la configurazione del filtro contenuti.

Per eseguire il cmdlet Set-ContentFilterConfig, è necessario utilizzare un account che disponga della seguente delega:

Ruolo Exchange Server Administrator e appartenenza al gruppo Administrators locale del server di destinazione

Per eseguire il cmdlet Set-ContentFilterConfig su un computer in cui è installato il ruolo del server Trasporto Edge, è necessario accedere al sistema utilizzando un account che sia membro del gruppo Administrators locale del computer.

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti di amministrazione necessari per l'amministrazione di Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro	Obbligatorio	Tipo	Descrizione
BypassedRecipients	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Questo parametro utilizza i valori dell'indirizzo SMTP dei destinatari dell'organizzazione. L'agente Filtro contenuti non elabora il filtro contenuti per i messaggi associati agli indirizzi elencati in questo parametro. Per immettere più indirizzi SMTP, separare gli indirizzi utilizzando una virgola, come nel seguente esempio: `recipient1@contoso.com, recipient2@contoso.com` Il numero massimo di destinatari che è possibile inserire è 800.
BypassedSenderDomains	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Questo parametro utilizza i valori dei nomi dei domini di invio. L'agente Filtro contenuti non elabora il filtro contenuti per i messaggi ricevuti dai domini elencati in questo parametro. Per immettere più domini, separare gli indirizzi utilizzando una virgola, come riportato nel seguente esempio: `contoso.com, example.com`. È possibile utilizzare un carattere jolly () per specificare tutti i sottodomini, come nel seguente esempio: .`contoso.com`. Il numero massimo di domini che è possibile inserire è 800.
BypassedSenders	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Questo parametro utilizza i valori degli indirizzi SMTP dei mittenti. L'agente Filtro contenuti non elabora il filtro contenuti per i messaggi ricevuti dagli indirizzi elencati in questo parametro. Per immettere più indirizzi SMTP, separare gli indirizzi utilizzando una virgola, come nel seguente esempio: `sender1@contoso.com, sender2@example.com` Il numero massimo di indirizzi SMTP che è possibile inserire è 800.
Confirm	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro Confirm determina l'interruzione dell'elaborazione e richiede che l'amministratore sappia quale operazione eseguirà il comando prima che l'elaborazione continui. Non è necessario specificare un valore con il parametro Confirm.
DomainController	Facoltativo	Microsoft.Exchange.Data.Fqdn	Per specificare il nome di dominio completo (FQDN, Fully Qualified Domain Name) del controller di dominio che consente di scrivere la modifica alla configurazione nel servizio directory di Active Directory, includere nel comando il parametro DomainController. Il parametro DomainController non è supportato nei computer in cui è installato il ruolo del server Trasporto Edge. Il ruolo del server Trasporto Edge consente di scrivere solo nell'istanza locale ADAM.
Enabled	Facoltativo	System.Boolean	I valori validi per il parametro Enabled sono `$true` e `$false`. L'impostazione predefinita è `$true`. Quando il parametro Enabled è impostato su `$true`, nel computer su cui si esegue il comando Set-ContentFilterConfig viene abilitato l'agente Filtro contenuti.
ExternalMailEnabled	Facoltativo	System.Boolean	I valori validi per il parametro ExternalMailEnabled sono `$true` e `$false`. L'impostazione predefinita è `$true`. Quando il parametro ExternalMailEnabled è impostato su `$true`, tutti i messaggi provenienti da connessioni non autenticate vengono filtrati dall'agente Filtro contenuti per l'elaborazione.
Instance	Facoltativo	Microsoft.Exchange.Data.Directory.SystemConfiguration.ContentFilterConfig	Il parametro Instance consente di inviare un intero oggetto al comando da elaborare. Viene utilizzato principalmente per gli script nei casi in cui è necessario passare un intero oggetto al comando.
InternalMailEnabled	Facoltativo	System.Boolean	I valori validi per il parametro InternalMailEnabled sono `$true` e `$false`. L'impostazione predefinita è `$false`. Quando il parametro InternalMailEnabled è impostato su `$true`, tutti i messaggi provenienti da connessioni autenticate e da domini autorevoli dell'azienda vengono filtrati dall'agente Filtro contenuti per l'elaborazione.
OutlookEmailPostmarkValidationEnabled	Facoltativo	System.Boolean	I valori validi per il parametro OutlookEmailPostmarkValidationEnabled sono `$true` e `$false`. Quando il parametro OutlookEmailPostmarkValidationEnabled è impostato su `$true`, l'agente Filtro contenuti invia un problema di calcolo al sistema di posta elettronica del mittente per l'elaborazione. I risultati della soluzione del problema vengono fattorizzati nel livello generale di probabilità di posta indesiderata (SCL, spam confidence level). Questa funzionalità è esposta all'utente Microsoft Outlook come convalida del Timbro posta elettronica Office Outlook 2007. L'impostazione predefinita è `$false`.
QuarantineMailbox	Facoltativo	System.Nullable	Il valore valido per il parametro QuarantineMailbox è un indirizzo SMTP. Quando si imposta il parametro SCLQuarantineEnabled su `True` è necessario disporre di una cassetta postale per la quarantena della posta indesiderata. Tutti i messaggi che superano il valore impostato nel parametro SCLQuarantineThreshold vengono inviati all'indirizzo SMTP impostato in questo parametro.
RejectionResponse	Facoltativo	Microsoft.Exchange.Data.AsciiString	Questo parametro è obbligatorio se si imposta il parametro SCLRejectEnabled su `True`. Il parametro RejectionResponse utilizza una stringa. Immettere il corpo del messaggio che si desidera venga riportato nel rapporto di mancato recapito ai mittenti i cui messaggi raggiungono o superano il valore di SCLRejectThreshold. È possibile inserire un massimo di 240 caratteri nell'argomento. Quando si invia un argomento, è necessario racchiudere il parametro RejectionResponse tra virgolette doppie se la frase contiene spazi come nel seguente esempio: `"Message rejected"`. L'impostazione predefinita è `Message rejected due to content restrictions`.
SCLDeleteEnabled	Facoltativo	System.Boolean	I valori validi per il parametro SCLDeleteEnabled sono `$true` e `$false`. L'impostazione predefinita è `$false`. Quando il parametro SCLDeleteEnabled è impostato su `$true`, tutti i messaggi che superano il valore impostato nel parametro SCLDeleteThreshold vengono eliminati.
SCLDeleteThreshold	Facoltativo	System.Int32	Questo parametro utilizza un numero intero compreso tra `1` e `9`. Questo valore rappresenta il livello di probabilità di posta indesiderata che un determinato messaggio deve superare affinché l'agente Filtro contenuti elimini il messaggio e non invii un rapporto di mancato recapito. Per abilitare questa funzionalità, è necessario impostare il parametro SCLDeleteEnabled su `True`. L'impostazione predefinita è `9`.
SCLQuarantineEnabled	Facoltativo	System.Boolean	I valori validi per il parametro SCLQuarantineEnabled sono `$true` e `$false`. L'impostazione predefinita è `$false`. Quando il parametro SCLQuarantineEnabled è impostato su `$true`, tutti i messaggi che superano il valore impostato nel parametro SCLQuarantineThreshold vengono inviati alla cassetta postale per la quarantena della posta indesiderata specificata nel parametro QuarantineMailbox.
SCLQuarantineThreshold	Facoltativo	System.Int32	Questo parametro utilizza un numero intero compreso tra `1` e `9`. Questo valore rappresenta il livello di probabilità di posta indesiderata che un determinato messaggio deve superare affinché l'agente Filtro contenuti metta in quarantena il messaggio. Per abilitare la funzionalità della quarantena, è necessario impostare il parametro SCLQuarantineEnabled su `True` e fornire un indirizzo SMTP valido nel parametro QuarantineMailbox. L'impostazione predefinita è `9`.
SCLRejectEnabled	Facoltativo	System.Boolean	I valori validi per il parametro SCLRejectEnabled sono `$true` e `$false`. L'impostazione predefinita è `$false`. Quando il parametro SCLRejectEnabled è impostato su `$true`, tutti i messaggi che superano il valore impostato nel parametro SCLRejectThreshold vengono eliminati e non viene inviato alcun rapporto di mancato recapito.
SCLRejectThreshold	Facoltativo	System.Int32	Questo parametro utilizza un numero intero compreso tra `1` e `9`. Questo valore rappresenta il livello di probabilità di posta indesiderata che un determinato messaggio deve superare affinché l'agente Filtro contenuti rifiuti il messaggio e invii un rapporto di mancato recapito al mittente. Per abilitare la funzionalità di eliminazione, è necessario impostare il parametro SCLDeleteEnabled su `True`. Inoltre, è possibile rileggere il messaggio del rapporto di mancato recapito modificando il parametro RejectionResponse. L'impostazione predefinita è `9`.
WhatIf	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro WhatIf, è possibile visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Non è necessario specificare un valore con il parametro WhatIf.

Tipi di input

Tipi restituiti

Errori

Errore	Descrizione

Esempio

Nel primo codice di esempio viene mostrato un comando Set-ContentFilterConfig con le seguenti modifiche apportate alla configurazione del Filtro contenuti:

Consente di attivare e configurare le funzionalità della soglia del livello di probabilità di posta indesiderata in grado di mettere in quarantena, rifiutare ed eliminare i messaggi.
Rende spamQ@contoso.com la cassetta postale per la quarantena della posta indesiderata.
Imposta l'azione del Filtro contenuti per rifiutare tutti i messaggi che superano la soglia del livello di probabilità di posta indesiderata.
Imposta la risposta di rifiuto.
Definisce due utenti per i quali il Filtro contenuti non dovrebbe elaborare i messaggi.

Nel secondo codice di esempio viene mostrato un comando Set-ContentFilterConfig che specifica un dominio del mittente, denominato woodgrovebank.com, il cui messaggio di posta elettronica in arrivo ignorerà il filtro contenuti.

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