Update-AddressList
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2009-05-12
Verwenden Sie das Cmdlet Update-AddressList, um die Empfänger zu aktualisieren, die in der angegebenen Adressliste enthalten sind.
Syntax
update-AddressList -Identity <AddressListIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Damit Sie das Cmdlet Update-AddressList ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- Rolle Exchange-Organisationsadministrator
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.
Die Ausführung dieses Befehls kann mehrere Stunden in Anspruch nehmen, abhängig von der Größe der Exchange-Organisation.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung | ||
|---|---|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter |
Verwenden Sie den Parameter Identity, um die GUID, den DN (Distinguished Name) oder den Adresslistennamen anzugeben, die bzw. der eine bestimmte Adressliste darstellt. Sie können den auch den Pfad einschließen, indem Sie das Format Pfad\Adresslistenname verwenden. Die Bezeichnung des Parameters Identity kann ausgelassen werden, sodass nur der Adresslistenname oder seine GUID angegeben wird. |
||
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 |
Dieser Parameter gibt den Domänencontroller an, der zum Vornehmen der Änderungen in Active Directory an den in der betreffenden Adressliste enthaltenen Adressen verwendet werden soll. |
||
UseRusServer |
Optional |
System.String |
Der Parameter UseRusServer weist den Befehl an, den angegebenen Postfachserver, auf dem der Adresslistendienst ausgeführt wird, zum Abrufen und Festlegen von Postfach- und Active Directory-Benutzerattributen zu verwenden. Der Adresslistendienst ist eine Komponente des Exchange-Systemaufsichtsdiensts. Der Adresslistendienst erstellt und verwaltet Exchange-spezifische Attributwerte in Active Directory. Sie können den Adresslistendienst zum Aktualisieren von Empfängerobjekten in einer Domäne mithilfe bestimmter Informationen verwenden, z. B. anhand von Adresslistenmitgliedschaft und E-Mail-Adressen. |
||
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. |
.gif "note")
Hinweis:Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Das folgende Beispiel veranschaulicht, wie die Empfänger der Adressliste mit dem Namen "building4" unter dem Container All Users\Sales aktualisiert werden.
Update-AddressList -Identity "All Users\Sales\building4"
Verwenden Sie das Cmdlet Get-AddressList, nach Format-List umgeleitet, um die GUID, den Distinguished Name oder Pfad und Namen einer vorhandenen Adressliste abzurufen. Oder verwenden Sie Get-AddressList, um eine bestimmte vorhandene Adressliste abzurufen, und leiten Sie dann die Ausgabe direkt nach Update-AddressList um.