Set-EmailAddressPolicy

  • 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-EmailAddressPolicy, um die Active Directory-Verzeichnisdienstattribute für eine E-Mail-Adressenrichtlinie festzulegen.

Syntax

Set-EmailAddressPolicy -Identity <EmailAddressPolicyIdParameter> [-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>]] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Set-EmailAddressPolicy [-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>]] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <EmailAddressPolicy>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mithilfe des Cmdlets Set-EmailAddressPolicy können Administratoren Active Directory-Attribute für eine spezifische E-Mail-Adressenrichtlinie festlegen. Das Cmdlet Set-EmailAddressPolicy wendet die Änderungen jedoch nicht auf die E-Mail-Adressenrichtlinie an. Verwenden Sie das Cmdlet Update-EmailAddressPolicy im Anschluss an das Cmdlet Set-EmailAddressPolicy, damit die Änderungen angewendet werden. 

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

Weitere Informationen zum Cmdlet Update-EmailAddressPolicy finden Sie unter Update-EmailAddressPolicy.

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.EmailAddressPolicyIdParameter

Verwenden Sie den Parameter Identity, um die GUID, den DN (Distinguished Name) oder den Namen der E-Mail-Adressenrichtlinie anzugeben, die bzw. der eine bestimmte E-Mail-Adressenrichtlinie 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, so dass nur der Name der E-Mail-Adressenrichtlinie oder ihre GUID angegeben wird.

ConditionalCompany

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Der Parameter ConditionalCompany legt die Firma für die E-Mail-Adressenrichtlinie fest. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste übergeben. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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. Sie können in diesen Attributen zusätzliche Informationen speichern. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

ConditionalDepartment

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Der Parameter ConditionalDepartment legt die Abteilung für die E-Mail-Adressenrichtlinie fest. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste übergeben. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter 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 E-Mail-Adressenrichtlinie fest. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste übergeben. Sie müssen den Parameter IncludedRecipients verwenden, wenn Sie einen Conditional-Parameter verwenden. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

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.

DisabledEmailAddressTemplates

Optional

Microsoft.Exchange.Data.ProxyAddressTemplateCollection

Der Parameter DisabledEmailAddressTemplates gibt die Proxyadressen an, die in einer Richtlinie für E-Mail-Adressen enthalten und aktiviert sind. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste übergeben.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der Daten aus Active Directory abruft, fügen Sie dem Befehl den Parameter DomainController hinzu.

EnabledEmailAddressTemplates

Optional

Microsoft.Exchange.Data.ProxyAddressTemplateCollection

Der Parameter EnabledEmailAddressTemplates gibt die Proxyadressen an, die in einer Richtlinie für E-Mail-Adressen enthalten und aktiviert sind. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste übergeben.

EnabledPrimarySMTPAddressTemplate

Optional

System.String

Der Parameter EnabledPrimarySMTPAddressTemplate gibt die Proxyadressen an, die in einer Richtlinie für E-Mail-Adressen enthalten und aktiviert sind. Sie können mehrere Werte in Form einer durch Trennzeichen getrennten Liste übergeben.

ForceUpgrade

Optional

System.Management.Automation.SwitchParameter

Mithilfe des ForceUpgrade-Parameters kann die folgende Bestätigung unterdrückt werden: "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 wird angezeigt, wenn Sie eine E-Mail-Adressrichtlinie aktualisieren, die in Microsoft Exchange Server 2003 oder Exchange 2000 Server erstellt wurde. Eine E-Mail-Adressrichtlinie aus Exchange 2003 oder Exchange 2000 kann erst mithilfe der Exchange-Verwaltungskonsole verwaltet werden, nachdem die Version des Objekts aktualisiert und der Empfängerfilter mithilfe des Parameters RecipientFilter oder IncludedRecipients geändert wurde.

IncludedRecipients

Optional

System.Nullable

Der Parameter IncludedRecipients filtert die Empfängertypen, aus denen die globale Adressliste 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.

Dieser Parameter muss verwendet werden, wenn einer der Conditional-Parameter verwendet wird. Dieser Parameter kann nicht zusammen mit dem Parameter RecipientFilter verwendet werden.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicy

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 die Richtlinie für E-Mail-Adressen an.

Priority

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority

Mit dem Parameter Priority wird die aktuelle Priorität im Bezug auf die als Argument für diesen Parameter angegebene Priorität erhöht.

RecipientFilter

Optional

System.String

Der Parameter RecipientFilter filtert die Empfänger, die in einer bestimmten Richtlinie für E-Mail-Adressen enthalten sind. Der Parameter RecipientFilter kann nicht verwendet werden, wenn einer der folgenden Parameter angegeben wurde:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

Ausnahmen

Ausnahmen Beschreibung

Beispiel

Der folgende Code ist ein Beispiel für den Befehl Set-EmailAddressPolicy, in dem der Name der Richtlinie für E-Mail-Adressen von EMAIL_ADDRESS_POLICY01 in EMAILADDRESSPOLICY02 geändert wurde.

Set-EmailAddressPolicy -Identity EMAIL_ADDRESS_POLICY01 -Name EMAIL_ADDRESS_POLICY02