Set-AddressList
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2009-05-12
Mithilfe des Cmdlets Set-AddressList können Sie eine vorhandene Adressliste ändern.
Syntax
Set-AddressList -Identity <AddressListIdParameter> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Set-AddressList [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <AddressList>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Damit Sie das Cmdlet Set-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 Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Wenn Sie die Exchange-Verwaltungskonsole zum Verwalten von Adresslisten verwenden möchten, die in Exchange Server 2003 oder Exchange 2000 Server erstellt wurden, müssen Sie wie folgt vorgehen:
Aktualisieren Sie das Versionsattribut der Adressliste mithilfe des ForceUpgrade-Parameters.
Ändern Sie den Empfängerfilter mithilfe des RecipientFilter-Parameters oder eines der folgenden Filterparameter:
ConditionalCompany
ConditionalDepartment
ConditionalStateOrProvince
IncludedRecipients
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. |
||
ConditionalCompany |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter ConditionalCompany ist ein Filter, mit dem ein Unternehmen angegeben wird. Alle Empfänger mit einem Unternehmensattribut, das dem Wert entspricht, den Sie für diesen Parameter eingeben, werden in die zu ändernde Adressliste aufgenommen. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste verwenden. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute1 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute1 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute10 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute10 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute11 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute11 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute12 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute12 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute13 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute13 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute14 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute14 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute15 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute15 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute2 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute2 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute3 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute3 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute4 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute4 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute5 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute5 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute6 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute6 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute7 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute7 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute8 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute8 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalCustomAttribute9 |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Mit dem Parameter ConditionalCustomAttribute9 werden benutzerdefinierte Attribute angegeben. Mit benutzerdefinierten Attributen können Sie der Adressliste zusätzliche Informationen hinzufügen, die zum Sortieren und Gruppieren von Adresslisten verwendet werden können. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalDepartment |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter ConditionalDepartment ist ein Filter, mit dem eine Abteilung angegeben wird. Alle Empfänger mit einem Abteilungsattribut, das dem Wert entspricht, den Sie für diesen Parameter eingeben, werden in die Adressliste aufgenommen. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste verwenden. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
ConditionalStateOrProvince |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Der Parameter ConditionalStateOrProvince ist ein Filter, mit dem ein Bundesland oder ein Kanton angegeben wird. Alle Empfänger mit einem Attribut ConditionalStateOrProvince, das dem Wert entspricht, den Sie für diesen Parameter eingeben, werden in die Adressliste aufgenommen. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste verwenden. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Bedingungsparameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Confirm-Parameter muss kein Wert angegeben werden. |
||
DisplayName |
Optional |
System.String |
Der Parameter DisplayName gibt den gewünschten Anzeigenamen der Adressliste an. |
||
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. |
||
ForceUpgrade |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter ForceUpgrade unterdrückt die folgende Bestätigung: "Damit die Änderungen am Objekt gespeichert werden können, muss das Objekt auf die aktuelle Exchange-Version aktualisiert werden. Nach dem Upgrade kann dieses Objekt nicht von einer früheren Version von Exchange-System-Manager verwaltet werden. Möchten Sie die Aktualisierung fortsetzen und das Objekt speichern?" Diese Bestätigung tritt auf, wenn Sie eine Adressliste aktualisieren, die in Microsoft Exchange Server 2003 or Exchange 2000 Server erstellt wurde. Eine Exchange 2003- oder Exchange 2000-Adressliste kann erst mit der Exchange-Verwaltungskonsole verwaltet werden, wenn die Version des Objekts aktualisiert und der Empfängerfilter mithilfe des Parameters RecipientFilter oder des Parameters IncludedRecipients geändert wurde. |
||
IncludedRecipients |
Optional |
System.Nullable |
Der Parameter IncludedRecipients filtert die Empfängertypen, aus denen die globale Adressliste (GAL) erstellt wird. Die verfügbaren Werte für den Parameter IncludedRecipients sind AllRecipients, MailboxUsers, Resources, Contacts und MailGroups. Der Wert AllRecipients kann nur alleine verwendet werden. Werden mehrere Werte des Parameters IncludedRecipients durch Kommas getrennt, wird der Boolesche Operator OR angewendet. Sie müssen diesen Parameter verwenden, wenn Sie einen der folgenden Conditional-Parameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden. |
||
Instance |
Optional |
Microsoft.Exchange.Data.Directory.Management.AddressList |
Der Instance-Parameter wird in seltenen Fällen von Administratoren verwendet, die an der Eingabeaufforderung arbeiten. Er ist in der Parametertabelle als Entwicklerreferenz enthalten. |
||
Name |
Optional |
System.String |
Der Parameter Name gibt einen neuen Namen für die Adressliste an. Der Name darf maximal 64 Zeichen lang sein und darf keine Wagenrückläufe oder umgekehrten Schrägstriche (\) enthalten. |
||
RecipientFilter |
Optional |
System.String |
Der Parameter RecipientFilter gibt einen Filter für Empfänger an, die in die Adressliste aufgenommen werden sollen. Dieser Parameter kann nicht zusammen mit einem der folgenden Parameter verwendet werden:
Weitere Informationen über die filterbaren Eigenschaften finden Sie unter Filterbare Eigenschaften für den Parameter "-RecipientFilter". |
||
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 WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den WhatIf-Parameter muss kein Wert angegeben werden. |
.gif "note")
Hinweis:Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Im ersten Beispiel wird gezeigt, wie der Name einer vorhandenen Adressliste geändert wird.
Das zweite Beispiel veranschaulicht, wie der Empfängertyp und die Abteilung der in Empfänger geändert wird, die in die vorhandene Adressliste mit dem Namen MyAddressList2 aufgenommen werden sollen. MyAddressList2 ist eine Adressliste aus Exchange 2003. Daher wird mit diesem Befehl zugleich auch die Aktualisierung dieser Adressliste ausgeführt.
Set-AddressList -Identity "All Users\Sales\building4" -Name building9
Set-Addresslist -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -IncludedRecipients UserMailbox -ConditionalDepartment Sales -ForceUpgrade:$true
Verwenden Sie den Befehl Get-AddressList mit einer Pipeline an Format-List, um die GUID, den Distinguished Name oder den Pfad und Namen einer vorhandenen Adressliste abzurufen. Alternativ können Sie Get-AddressList verwenden, um eine bestimmte vorhandene Adressliste abzurufen. Die Ausgabe des Befehls leiten Sie direkt mittels einer Pipeline an Set-AddressList weiter.