Add-ContentFilterPhrase
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-06-22
Mit dem Cmdlet Add-ContentFilterPhrase können benutzerdefinierte Wörter für den Inhaltsfilter-Agent definiert werden. Ein benutzerdefiniertes Wort ist ein Wort oder Ausdruck, der bzw. das vom Administrator festgelegt wird, damit der Inhaltsfilter-Agent den Inhalt einer E-Mail-Nachricht auswertet und eine entsprechende Filterverararbeitung anwendet.
Syntax
Add-ContentFilterPhrase -Phrase <String> -Influence <GoodWord | BadWord> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Um anzupassen, wie vom Inhaltsfilter-Agent SCL-Bewertungen (Spam Confidence Level) durch Identifizieren von zugelassenen und nicht zugelassenen Wörtern und Ausdrücken zugewiesen werden, müssen zuerst benutzerdefinierte Wörter definiert werden.
Eine erforderliche Eigenschaft eines benutzerdefinierten Worts oder Ausdrucks ist der Parameter Influence. Der Parameter Influence akzeptiert einen von zwei Werten: GoodWord oder BadWord.
Einer Nachricht, die ein benutzerdefiniertes Wort oder einen Ausdruck mit einem Influence-Wert von GoodWord enthält, wird automatisch eine SCL-Bewertung (Spam Confidence Level) von 0 zugewiesen. Deshalb kann sie die Downstream-Spamverarbeitung umgehen. Einer Nachricht, die ein benutzerdefiniertes Wort oder einen Ausdruck mit einem Influence-Wert von BadWord enthält, wird automatisch eine SCL-Bewertung (Spam Confidence Level) von 9 zugewiesen. Sie wird deshalb gemäß den von Ihnen in Microsoft Exchange Server 2007 konfigurierten Richtlinien als Spam behandelt.
Benuzerdefinierte Wörter und Ausdrücke können in jeder beliebigen Kombination von Groß- und Kleinbuchstaben eingegeben werden. Bei der Auswertung von Nachrichteninhalten ignoriert der Inhaltsfilter-Agent die Groß-/Kleinschreibung. Es können maximal 800 benutzerdefinierte Wörter und Ausdrücke erstellt werden.
Weitere Informationen zum Ändern des Inhaltsfilter-Agents finden Sie unter Set-ContentFilterConfig.
Damit Sie das Cmdlet Add-ContentFilterPhrase ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Serveradministrator und die Mitgliedschaft in der lokalen Gruppe Administratoren für den Zielserver
Um das Cmdlet Add-ContentFilterPhrase auf einem Computer auszuführen, auf dem die Serverfunktion Edge-Transport installiert ist, müssen Sie sich mit einem Konto anmelden, das Mitglied der lokalen Gruppe Administratoren auf diesem Computer ist.
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Influence |
Erforderlich |
Microsoft.Exchange.Data.Directory.SystemConfiguration.Influence |
Gültige Werte sind |
Phrase |
Erforderlich |
System.String |
Wenn Sie ein Argument übergeben, müssen Sie den Parameter Phrase in doppelte Anführungszeichen setzen, falls der Ausdruck Leerzeichen wie im folgenden Beispiel enthält: |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter Confirm bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm muss kein Wert angegeben werden. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu. Der Parameter DomainController wird nicht auf Computern unterstützt, auf denen die Serverfunktion Edge-Transport ausgeführt wird. Die Serverfunktion Edge-Transport liest und schreibt nur in der lokalen ADAM-Instanz. |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des Parameters WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
Beispiel
Das folgende Codebeispiel zeigt einen Add-ContentFilterPhrase-Befehl an, mit dem ein benutzerdefiniertes Wort als BadWord-Ausdruck definiert wird, This is a bad phrase.
Add-ContentFilterPhrase -Phrase:"This is a bad phrase" -Influence:BadWord