Set-GlobalAddressList

  • Artikel

 

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 Set-GlobalAddressList, um die Attribute einer globalen Adressliste (GAL) im Active Directory-Verzeichnisdienst zu ändern.

Syntax

Set-GlobalAddressList -Identity <GlobalAddressListIdParameter> [-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>]] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Set-GlobalAddressList [-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>]] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <GlobalAddressList>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Das Cmdlet Set-GlobalAddressList ändert die Eigenschaften einer GAL.

Damit Sie das Cmdlet Set-GlobalAddressList 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.

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter

Verwenden Sie den Parameter Identity, um die GUID, den DN (Distinguished Name) oder den Adresslistennamen anzugeben, die bzw. der eine bestimmte GAL darstellt. Sie können den auch den Pfad einschließen, indem Sie das Format Pfad\Name_der_globalen_Adressliste verwenden.

Die Parameternezeichnung Identity kann ausgelassen werden, sodass nur der GAL-Name oder die GUID angegeben wird.

ConditionalCompany

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Der Parameter ConditionalCompany wird zum Angeben eines Unternehmen verwendet. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste verwenden. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute1

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute10

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute11

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute12

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute13

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute14

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute15

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute2

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute3

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute4

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute5

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute6

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute7

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute8

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalCustomAttribute9

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden benutzerdefinierte Attribute angegeben. Sie können in diesen Attributen zusätzliche Informationen speichern. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalDepartment

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Der Parameter ConditionalDepartment wird zum Angeben einer Abteilung verwendet. Alle GALs mit einem Abteilungsattribut, das dem Wert entspricht, den Sie für diesen Parameter eingeben, werden aufgenommen. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste verwenden. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalStateOrProvince

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Der Parameter ConditionalStateOrProvince legt das Bundesland oder den Kanton für die globale Adressliste fest. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste übergeben. Es muss ein Parameter IncludedRecipients verwendet werden, wenn Sie einen Parameter Conditional 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.

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 Active Directory 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 GAL aktualisieren, die in Microsoft Exchange Server 2003 or Exchange 2000 Server erstellt wurde. Eine Exchange 2003- oder Exchange 2000-GAL 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, die zum Erstellen der GAL verwendet werden. 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.GlobalAddressList

Der Parameter Instance ermöglicht das Übergeben eines vollständigen Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein vollständiges Objekt an den Befehl übergeben werden muss.

Name

Optional

System.String

Der Parameter Name gibt den neuen Namen für globale Adressliste an.

RecipientFilter

Optional

System.String

Der Parameter RecipientFilter gibt einen Filter für Empfänger an, die in die GAL aufgenommen werden sollen. Der Parameter kann nicht verwendet werden, wenn einer der folgenden Filterparameter verwendet wird:

  • ConditionalCompany

  • ConditionalDepartment

  • IncludedRecipients

  • ConditionalStateorProvince

Es muss entweder dieser Parameter oder einer der zuvor aufgeführten Filterparameter verwendet werden.

Weitere Informationen über die filterbaren Eigenschaften finden Sie unter Filterbare Eigenschaften für den Parameter "-RecipientFilter".

UseRusServer

Optional

System.String
noteHinweis:
Dieser Parameter steht nur in Exchange 2007 SP2 zur Verfügung.

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.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

Ausnahmen

Ausnahmen Beschreibung

 

Beispiel

In diesem Beispiel wird mithilfe des Befehls Set-GlobalAddressList der GAL mit der GUID 96d0c505-eba8-4103-ad4f-577a1bf4ad7b ein neuer Name, GALwithNewName, zugewiesen.

Set-GlobalAddressList 96d0c505-eba8-4103-ad4f-577a1bf4ad7b -Name GALwithNewName