Update-SafeList

Referenz

Modul:: ExchangePowerShell

Gilt für::: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet Update-SafeList, um die Aggregationsdaten für sichere Listen in Active Directory zu aktualisieren. Aggregationsdaten für sichere Listen werden in der integrierten Antispamfilterung in Microsoft Exchange verwendet. EdgeSync repliziert Aggregationsdaten von Listen sicherer IP-Adressen auf Edge-Transport-Servern im Umkreisnetzwerk.

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

Syntax

Update-SafeList
      [-Identity] <MailboxIdParameter>
      [-Confirm]
      [-DomainController <Fqdn>]
      [-EnsureJunkEmailRule]
      [-IncludeDomains]
      [-Type <UpdateType>]
      [-WhatIf]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Update-SafeList liest die Aggregationsdaten für sichere Listen, die in einem Microsoft Outlook-Benutzerpostfach gespeichert sind, und erstellt dann einen Hash und schreibt die Daten in das entsprechende Benutzerobjekt in Active Directory. Der Befehl vergleicht das erstellte binäre Attribut mit den für das Attribut gespeicherten Werten. Stimmen die beiden Werte überein, aktualisiert der Befehl den Benutzerattributwert nicht mit den Aggregationsdaten aus den Listen sicherer Adressen. Aggregationsdaten für sichere Listen enthalten die Liste sicherer Absender und die Liste der sicheren Empfänger des Outlook-Benutzers.

Berücksichtigen Sie den Netzwerk- und Replikationsdatenverkehr, der bei der Ausführung des Cmdlets Update-SafeList möglicherweise hervorgerufen wird. Wenn der Befehl für mehrere Postfächer ausgeführt wird, die in großem Umfang von Listen sicherer IP-Adressen Gebrauch machen, kann dies erheblichen Datenverkehr verursachen. Wenn der Befehl für mehrere Postfächer ausgeführt werden soll, ist es empfehlenswert, den Befehl außerhalb von Spitzen- und Arbeitszeiten auszuführen.

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

Update-Safelist kim@contoso.com

In diesem Beispiel werden Listendaten für sichere Absender für den einzelnen Benutzer kim@contoso.comaktualisiert.

Beispiel 2

Set-AdServerSettings -ViewEntireForest $true

Get-Mailbox -ResultSize Unlimited -RecipientTypeDetails UserMailbox | Update-Safelist

In diesem Beispiel werden Daten zu sicheren Listen für alle Benutzerpostfächer in Ihrer Exchange-Organisation aktualisiert. Standardmäßig ist die Exchange-Verwaltungsshell so konfiguriert, dass Objekte abgerufen oder geändert werden, die sich in der Domäne befinden, in der sich der Exchange-Server befindet. Daher müssen Sie zum Abrufen aller Postfächer in Ihrer Exchange-Organisation zunächst den Bereich der Exchange-Verwaltungsshell mithilfe des Cmdlets Set-AdServerSettings auf die gesamte Gesamtstruktur festlegen.

Parameter

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

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

-EnsureJunkEmailRule

Die Option EnsureJunkEmailRule erzwingt, dass die Junk-E-Mail-Regel für das Postfach aktiviert wird, wenn die Regel noch nicht aktiviert ist. Sie müssen bei dieser Option keinen Wert angeben.

Die Junk-E-Mail-Regel kann erst nach der Anmeldung des Benutzers am Postfach erstellt werden. Wenn sich der Benutzer noch nie am Postfach angemeldet hat, kann dieser Parameter die Junk-E-Mail-Regel nicht aktivieren.

Type:	SwitchParameter
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

-Identity

Der Parameter Identity gibt das Postfach an, aus dem Aggregationsdaten von Listen sicherer IP-Adressen gesammelt werden sollen. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:

Name
Alias
Distinguished Name (DN)
Distinguished Name (DN)
Domäne\benutzername
E-Mail-Adresse
GUID
LegacyExchangeDN
SamAccountName
Benutzer-ID oder User Principal Name (UPN)

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

-IncludeDomains

Der Schalter IncludeDomains gibt an, ob die von Benutzern in Outlook angegebenen Absenderdomänen in die Aggregationsdaten für sichere Listen eingeschlossen werden sollen. Sie müssen bei dieser Option keinen Wert angeben.

Standardmäßig werden die von den Absendern angegebenen Domänen nicht eingeschlossen.

In der Regel sollten keine Domänen mit aufgenommen werden, weil Benutzer die Domänen großer Internetdienstanbieter (Internet Service Providers, ISPs) einschließen können. Dies kann zur unabsichtlichen Offenlegung von Adressen führen, die von Spammern verwendet oder für Spoofing benutzt werden können.

Type:	SwitchParameter
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

-Type

Der ParameterType gibt an, welche vom Benutzer generierte Liste für das Benutzerobjekt aktualisiert wird. Gültige Werte für diesen Parameter sind SafeSenders, SafeRecipients und Both. Der Standardwert ist SafeSenders.

Die Funktion für die Aggregation von Listen sicherer IP-Adressen verarbeitet keine Daten der Liste sicherer Empfänger. Es wird nicht empfohlen, den Parameter Type mit dem Wert SafeRecipients oder Both auszuführen.

Type:	UpdateType
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.