Set-ContentFilterConfig

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet Set-ContentFilterConfig, um die Inhaltsfilterkonfiguration auf einem Postfachserver oder einem Edge-Transport-Server zu ändern.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Set-ContentFilterConfig
   [-BypassedRecipients <MultiValuedProperty>]
   [-BypassedSenderDomains <MultiValuedProperty>]
   [-BypassedSenders <MultiValuedProperty>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-ExternalMailEnabled <Boolean>]
   [-InternalMailEnabled <Boolean>]
   [-OutlookEmailPostmarkValidationEnabled <Boolean>]
   [-QuarantineMailbox <SmtpAddress>]
   [-RejectionResponse <AsciiString>]
   [-SCLDeleteEnabled <Boolean>]
   [-SCLDeleteThreshold <Int32>]
   [-SCLQuarantineEnabled <Boolean>]
   [-SCLQuarantineThreshold <Int32>]
   [-SCLRejectEnabled <Boolean>]
   [-SCLRejectThreshold <Int32>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Set-ContentFilterConfig -BypassedSenderDomains woodgrovebank.com

In diesem Beispiel wird die Absenderdomäne "woodgrovebank.com" als umgangene Domäne angegeben. Nachrichten, die von dieser Domäne empfangen werden, umgehen den Inhaltsfilter-Agent.

Beispiel 2

Set-ContentFilterConfig -SCLQuarantineEnabled $true -SCLRejectEnabled $true -SCLDeleteEnabled $true -SCLQuarantineThreshold 5 -SCLRejectThreshold 6 -SCLDeleteThreshold 8 -QuarantineMailbox SpamQuarantineMailbox@contoso.com -RejectionResponse "Message rejected due to content restrictions" -BypassedRecipients user1@contoso.com,user2@contoso.com

In diesem Beispiel werden die folgenden Änderungen an der Konfiguration des Inhaltsfilter-Agents vorgenommen:

Es aktiviert und konfiguriert die SCL-Schwellenwertfunktionen, die Nachrichten unter Quarantäne stellen, ablehnen und löschen, auf 5, 6 bzw. 8.

Es gibt als Spamquarantänepostfach an SpamQuarantineMailbox@contoso.com .

Es werden zwei Benutzer definiert, deren Nachrichten nicht vom Inhaltsfilter verarbeitet werden.

Parameter

-BypassedRecipients

Der Parameter BypassedRecipients gibt die SMTP-Adresswerte von Empfängern in Ihrer Organisation an. Der Inhaltsfilter-Agent verarbeitet keine Inhaltsfilterung für Nachrichten, die an die in diesem Parameter aufgeführten Adressen gebunden sind. Um mehrere SMTP-Adressen einzugeben, trennen Sie die Adressen durch ein Komma, z. B.: recipient1@contoso.com,recipient2@contoso.com. Die maximale Anzahl von Empfängern, die Sie eingeben können, ist 100.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BypassedSenderDomains

Der Parameter BypassedSenderDomains gibt Domänennamenwerte von sendenden Domänen an. Der Inhaltsfilter-Agent verarbeitet keine Inhaltsfilterung für Nachrichten, die von den in diesem Parameter aufgeführten Domänen empfangen werden. Um mehrere Domänen einzugeben, trennen Sie die Adressen durch ein Komma, z. B. contoso.com, example.com. Ein Platzhalterzeichen (*) kann verwendet werden, um alle Unterdomänen anzugeben, z. B. *.contoso.com. Die maximale Anzahl von Domänen, die Sie eingeben können, ist 100.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BypassedSenders

Der Parameter BypassedSenders gibt die SMTP-Adresswerte von Absendern an. Der Inhaltsfilter-Agent verarbeitet keine Inhaltsfilterung für Nachrichten, die von den in diesem Parameter aufgeführten Adressen empfangen werden. Um mehrere SMTP-Adressen einzugeben, trennen Sie die Adressen durch ein Komma, z. B.: sender1@contoso.com, sender2@example.com. Die maximale Anzahl von SMTP-Adressen, die Sie eingeben können, ist 100.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.

Der DomainController-Parameter wird auf Edge-Transport-Servern nicht unterstützt. Edge-Transport-Server verwenden die lokale Instanz von Active Directory Lightweight Directory Services (AD LDS), um Daten zu lesen und zu schreiben.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

Der Parameter Enabled aktiviert oder deaktiviert den Inhaltsfilter-Agent auf dem Computer, auf dem der Befehl ausgeführt wird. Die gültige Eingabe für den Parameter Enabled lautet $true oder $false. Die Standardeinstellung ist $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExternalMailEnabled

Der Parameter ExternalMailEnabled gibt an, ob alle Nachrichten von nicht authentifizierten Verbindungen aus Quellen außerhalb Ihrer Exchange-Organisation zur Verarbeitung über den Inhaltsfilter-Agent übergeben werden. Die gültige Eingabe für den Parameter ExternalMailEnabled lautet $true oder $false. Die Standardeinstellung ist $true. Wenn der Parameter ExternalMailEnabled auf $true festgelegt ist, werden sämtliche Nachrichten aus nicht authentifizierten Verbindungen zur Verarbeitung durch den Inhaltsfilter-Agent geleitet.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-InternalMailEnabled

Der Parameter InternalMailEnabled gibt an, ob alle Nachrichten von authentifizierten Verbindungen und von autoritativen Domänen in Ihrem Unternehmen zur Verarbeitung durch den Verbindungsfilter-Agent geleitet werden. Die gültige Eingabe für den Parameter InternalMailEnabled lautet $true oder $false. Die Standardeinstellung ist $false. Wenn der Parameter InternalMailEnabled auf $true festgelegt ist, werden sämtliche Nachrichten aus authentifizierten Verbindungen und von autoritativen Domänen in Ihrem Unternehmen zur Verarbeitung durch den Verbindungsfilter-Agent geleitet.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-OutlookEmailPostmarkValidationEnabled

Der Parameter OutlookEmailPostmarkValidationEnabled gibt an, ob der Inhaltsfilter-Agent zur Verarbeitung ein Berechnungsrätsel an das System des Absenders sendet. Die gültige Eingabe für den Parameter OutlookEmailPostmarkValidationEnabled lautet $true oder $false. Wenn der Parameter OutlookEmailPostmarkValidationEnabled auf $true festgelegt ist, sendet der Inhaltsfilter-Agent ein Berechnungsrätsel zur Verarbeitung an das System des Absenders. Die Ergebnisse der Rechenrätselüberprüfung werden in der SCL-Gesamtbewertung (Spam Confidence Level) berücksichtigt. Diese Funktion wird für den Microsoft Outlook-Benutzer als Outlook-E-Mail-Poststempelüberprüfung verfügbar gemacht. Die Standardeinstellung ist $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-QuarantineMailbox

Der Parameter QuarantineMailbox gibt eine SMTP-Adresse an, die als Spam-Quarantänepostfach verwendet werden soll. Ein Spam-Quarantänepostfach ist erforderlich, wenn Sie den Parameter SCLQuarantineEnabled auf $true festlegen. Alle Nachrichten, die den im Parameter SCLQuarantineThreshold festgelegten Wert erfüllen oder überschreiten, werden an die SMTP-Adresse gesendet, die Sie in diesem Parameter festgelegt haben.

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RejectionResponse

Der Parameter RejectResponse gibt den Nachrichtentext an, der im Non-Delivery Report (NDR) an Absender übermittelt werden soll, deren Nachrichten den SCLRejectThreshold-Wert erfüllen oder überschreiten. Der RejectResponse-Parameter ist erforderlich, wenn Sie den SCLRejectEnabled-Parameter auf $true festlegen. Der Parameter RejectionResponse akzeptiert eine Zeichenfolge. Überschreiten Sie im Argument nicht mehr als 240 Zeichen. Wenn Sie ein Argument übergeben, müssen Sie den RejectResponse-Parameter in Anführungszeichen (") einschließen, wenn der Ausdruck Leerzeichen enthält, z. B. "Nachricht abgelehnt". Die Standardeinstellung ist Nachricht aufgrund von Inhaltsbeschränkungen abgelehnt.

Type:AsciiString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLDeleteEnabled

Der Parameter SCLDeleteEnabled gibt an, ob alle Nachrichten gelöscht werden, die den im SCLDeleteThreshold-Parameter festgelegten Wert erfüllen oder überschreiten. Die gültige Eingabe für den Parameter SCLDeleteEnabled lautet $true oder $false. Die Standardeinstellung ist $false. Wenn der SCLDeleteEnabled-Parameter auf $true festgelegt ist, werden alle Nachrichten gelöscht, die den im SCLDeleteThreshold-Parameter festgelegten Wert erfüllen oder überschreiten.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLDeleteThreshold

Der Parameter SCLDeleteThreshold gibt einen ganzzahligen Wert zwischen 1 und 9 an. Dieser Wert stellt die SCL-Bewertung dar, die eine bestimmte Nachricht erfüllen oder überschreiten muss, damit der Inhaltsfilter-Agent die Nachricht löschen und keinen NDR senden kann. Zum Aktivieren dieser Funktion müssen Sie den Parameter SCLDeleteEnabled auf $true festlegen. Die Standardeinstellung ist 9.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLQuarantineEnabled

Der Parameter SCLQuarantineEnabled gibt an, ob alle Nachrichten, die den im Parameter SCLQuarantineThreshold festgelegten Wert erfüllen oder überschreiten, an das Spamquarantänepostfach gesendet werden, das im Parameter QuarantineMailbox angegeben ist. Die gültige Eingabe für den Parameter SCLQuarantineEnabled lautet $true oder $false. Die Standardeinstellung ist $false. Wenn der Parameter SCLQuarantineEnabled auf $true festgelegt ist, werden alle Nachrichten, die den im Parameter SCLQuarantineThreshold festgelegten Wert erfüllen oder überschreiten, an das Spamquarantänepostfach gesendet, das im Parameter QuarantineMailbox angegeben ist.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLQuarantineThreshold

Der Parameter SCLQuarantineThreshold gibt einen ganzzahligen Wert zwischen 1 und 9 an. Dieser Wert stellt die SCL-Bewertung dar, die eine bestimmte Nachricht erfüllen oder überschreiten muss, damit der Inhaltsfilter-Agent die Nachricht unter Quarantäne stellt. Zum Aktivieren der Quarantänefunktion müssen Sie den Parameter SCLQuarantineEnabled auf $true festlegen und eine gültige SMTP-Adresse im Parameter QuarantineMailbox bereitstellen. Die Standardeinstellung ist 9.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLRejectEnabled

Der Parameter SCLRejectEnabled gibt an, ob alle Nachrichten, die den im SCLRejectThreshold-Parameter festgelegten Wert erfüllen oder überschreiten, abgelehnt und ein NDR an den Absender gesendet wird. Die gültige Eingabe für den Parameter SCLRejectEnabled lautet $true oder $false. Die Standardeinstellung ist $false. Wenn der SCLRejectEnabled-Parameter auf $true festgelegt ist, werden alle Nachrichten, die den im SCLRejectThreshold-Parameter festgelegten Wert erfüllen oder überschreiten, abgelehnt, und ein NDR wird an den Absender gesendet.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SCLRejectThreshold

Der Parameter SCLRejectThreshold gibt einen ganzzahligen Wert zwischen 1 und 9 an. Dieser Wert stellt die SCL-Bewertung dar, die eine bestimmte Nachricht erfüllen oder überschreiten muss, damit der Inhaltsfilter-Agent die Nachricht ablehnen und einen NDR an den Absender senden kann. Zum Aktivieren der Löschfunktion müssen Sie den Parameter SCLDeleteEnabled auf $true festlegen. Sie können auch die Unzustellbarkeitsbericht-Standardnachricht überprüfen, indem Sie den Parameter RejectionResponse bearbeiten. Die Standardeinstellung ist 7.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.