Set-ContentFilterConfig
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2009-05-18
Verwenden Sie das Cmdlet Set-ContentFilterConfig zum Ändern der Inhaltsfilterkonfiguration auf einem Computer, auf dem die Serverfunktion Edge-Transport oder Hub-Transport installiert ist.
Syntax
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>]]
Detaillierte Beschreibung
Dieser Befehl ändert die Inhaltsfilterkonfiguration.
Damit Sie das Cmdlet Set-ContentFilterConfig 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 Set-ContentFilterConfig auf einem Computer ausführen zu können, 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 Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
BypassedRecipients |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Dieser Parameter nimmt die SMTP-Adresswerte von Empfängern in Ihrer Organisation an. Der Inhaltsfilter-Agent führt keine Inhaltsfilter für Nachrichten aus, die an die für diesen Parameter aufgelisteten Adressen gebunden sind. Trennen Sie die Adressen mit einem Komma, um mehrere SMTP-Adressen einzugeben (siehe folgendes Beispiel): Die Höchstanzahl der Empfänger, die Sie eingeben können, ist 800. |
BypassedSenderDomains |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Dieser Parameter nimmt Domänennamenwerte sendender Domänen an. Der Inhaltsfilter-Agent führt keine Inhaltsfilter für Nachrichten aus, die von den für diesen Parameter aufgelisteten Domänen empfangen werden. Trennen Sie die Adressen mit einem Komma, um mehrere Domänen einzugeben (siehe folgendes Beispiel): |
BypassedSenders |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Dieser Parameter nimmt die SMTP-Adresswerte von Absendern an. Der Inhaltsfilter-Agent führt keine Inhaltsfilter für Nachrichten aus, die von den für diesen Parameter aufgelisteten Adressen empfangen werden. Trennen Sie die Adressen mit einem Komma, um mehrere SMTP-Adressen einzugeben (siehe folgendes Beispiel): Die Höchstanzahl der SMTP-Adressen, die Sie eingeben können, ist 800. |
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 installiert ist. Die Serverfunktion Edge-Transport schreibt nur in die lokale ADAM-Instanz. |
Enabled |
Optional |
System.Boolean |
Die gültige Eingabe für den Parameter Enabled lautet |
ExternalMailEnabled |
Optional |
System.Boolean |
Die gültige Eingabe für den Parameter ExternalMailEnabled lautet |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ContentFilterConfig |
Der Parameter Instance ermöglicht das Übergeben eines gesamten Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein gesamtes Objekt an den Befehl übergeben werden muss. |
InternalMailEnabled |
Optional |
System.Boolean |
Die gültige Eingabe für den Parameter InternalMailEnabled lautet |
OutlookEmailPostmarkValidationEnabled |
Optional |
System.Boolean |
Die gültige Eingabe für den Parameter OutlookEmailPostmarkValidationEnabled lautet |
QuarantineMailbox |
Optional |
System.Nullable |
Die gültige Eingabe für den Parameter QuarantineMailbox ist eine SMTP-Adresse. Ein Quarantänepostfach für Spam ist erforderlich, wenn Sie den Parameter SCLQuarantineEnabled auf |
RejectionResponse |
Optional |
Microsoft.Exchange.Data.AsciiString |
Dieser Parameter ist erforderlich, wenn Sie den Parameter SCLRejectEnabled auf |
SCLDeleteEnabled |
Optional |
System.Boolean |
Die gültige Eingabe für den Parameter SCLDeleteEnabled lautet |
SCLDeleteThreshold |
Optional |
System.Int32 |
Dieser Parameter benötigt einen Ganzzahlwert zwischen |
SCLQuarantineEnabled |
Optional |
System.Boolean |
Die gültige Eingabe für den Parameter SCLQuarantineEnabled lautet |
SCLQuarantineThreshold |
Optional |
System.Int32 |
Dieser Parameter benötigt einen Ganzzahlwert zwischen |
SCLRejectEnabled |
Optional |
System.Boolean |
Die gültige Eingabe für den Parameter SCLRejectEnabled lautet |
SCLRejectThreshold |
Optional |
System.Int32 |
Dieser Parameter benötigt eine Ganzzahlwert zwischen |
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 erste Codebeispiel zeigt einen Set-ContentFilterConfig-Befehl, der die folgenden Änderungen der Inhaltsfilterkonfiguration aufweist:
Er aktiviert und konfiguriert die SCL-Schwellenwertfunktionen, die Nachrichten isolieren, zurückweisen und löschen.
Er definiert spamQ@contoso.com als Quarantänepostfach für Spam.
Er legt die Inhaltsfilteraktion so fest, dass alle Nachrichten zurückgewiesen werden, die den SCL-Schwellenwert überschreiten.
Er legt die Zurückweisungsantwort fest.
Er definiert zwei Benutzer, für die der Inhaltsfilter keine Nachrichten verarbeiten soll.
Das zweite Codebeispiel zeigt einen Set-ContentFilterConfig-Befehl, der eine Absenderdomäne namens woodgrovebank.com angibt, deren eingehende E-Mail die Inhaltsfilterung umgeht.
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