Set-AddressRewriteEntry

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2007-08-28

Verwenden Sie das Cmdlet Set-AddressRewriteEntry zum Ändern eines vorhandenen Eintrags zum Umschreiben von Adressen, der E-Mail-Absender- und -Empfängeradressen in E-Mail-Nachrichten erneut schreibt, die aus einer bzw. an eine E-Mail-Organisation gesendet werden.

Syntax

set-addressrewriteentry -Identity <AddressRewriteEntryIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>] [-WhatIf [<SwitchParameter>]]

set-addressrewriteentry [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-Instance <AddressRewriteEntry>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

In Microsoft Exchange Server 2007 ermöglicht die Adressumschreibung die Änderung der Adressen von Absendern und Empfängern für Nachrichten, die in einer Exchange 2007-Organisation ein- und ausgehen. Sie konfigurieren Adressumschreibungs-Agents für den Empfangsconnector und Sendeconnector auf einem Computer, auf dem die Serverfunktion Edge-Transport installiert ist.

Um das Cmdlet Set-AddressRewriteEntry auf einem Computer ausführen zu können, auf dem die Serverfunktion Edge-Transport installiert ist, müssen Sie sich mit einem Konto anmelden, das Mitglied der lokalen Gruppe Administratoren auf diesem Computer ist.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Microsoft.Exchange.Management.MessagingPolicies.AddressRewrite.AddressRewriteEntryIdParameter

Dieser Parameter gibt den Eintrag für das Umschreiben von Adressen an, der geändert werden soll. Der Parameter Identity akzeptiert eine GUID oder den eindeutigen Namen für das Umschreiben von Adressen.

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 den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu. Der Parameter DomainController wird auf Edge-Transport-Servern nicht unterstützt. Die Serverfunktion Edge-Transport schreibt nur in die lokale ADAM-Instanz.

ExceptionList

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Dieser Parameter gibt die Domänennamen an, die nicht umgeschrieben werden sollten, wenn der Parameter InternalAddress einen Wert enthält, der mehrere Domänennamen angibt. Sie können mehrere Domänennamen, die im Parameter ExceptionList enthalten sind, durch Kommas trennen. Weitere Informationen zum Hinzufügen oder Entfernen von Werten zu/aus mehrwertigen Eigenschaften finden Sie unter Ändern von mehrwertigen Eigenschaften.

ExternalAddress

Optional

System.String

Dieser Parameter ermöglicht dem Administrator das Ändern der externen E-Mail-Adresse oder des Domänennamens, die bzw. der beim Umschreiben einer internen E-Mail-Adresse oder eines Domänennamens verwendet wird. Wenn im Parameter InternalAddress eine E-Mail-Adresse angegeben wird, muss der in ExternalAddress angegebene Wert ebenfalls eine E-Mail-Adresse sein. Wenn ein Domänenname oder ein Domänenname mit einem Platzhalterzeichen im Parameter InternalAddress angegeben wird, muss in ExternalAddress ein Domänenname angegeben werden. Adressen und Domänennamen können in den folgenden zwei Formaten eingegeben werden:

  • E-Mail-Adresse   Eine einzelne interne E-Mail-Adresse unter Verwendung der angegebenen Adresse umschreiben. Beispiel: david@northwindtraders.com.

  • Domänenname   Alle internen E-Mail-Adressen, die in InternalAddress enthalten sind, unter Verwendung des angegebenen externen Domänennamens umschreiben. Beispiel: northwindtraders.com.

Hinweis

Das Sternchenzeichen darf nicht mit dem Parameter ExternalAddress verwendet werden.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AddressRewriteEntry

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

InternalAddress

Optional

System.String

Dieser Parameter ermöglicht dem Administrator das Ändern der internen E-Mail-Adresse oder des Domänennamens, die bzw. der umgeschrieben wird. Adressen und Domänennamen können in den folgenden drei Formaten eingegeben werden:

  • Einzelne E-Mail-Adresse   Nur die angegebene Adresse umschreiben. Beispiel: david@contoso.com.

  • Domänenname   Alle E-Mail-Adressen umschreiben, die dem angegebenen Domänennamen zugeordnet sind. Beispiel: contoso.com.

  • Domänenname mit Sternchen   Alle E-Mail-Adressen, die dem angegebenen Domänennamen zugeordnet sind, sowie alle Unterdomänen umschreiben. Beispiel: *.contoso.com.

Name

Optional

System.String

Dieser Parameter ermöglicht dem Administrator das Ändern des eindeutigen Namens dieses Eintrags für das Umschreiben von Adressen.

OutboundOnly

Optional

System.Boolean

Mit diesem Parameter kann der Administrator ändern, ob E-Mail-Adressen nur dann umgeschrieben werden, wenn E-Mail-Nachrichten die Exchange Server 2007-Organisation verlassen, oder ob die Adressen umgeschrieben werden, wenn Nachrichten in beide Richtungen gesendet werden. Die beiden möglichen Werte für diesen Parameter sind $true oder $false. Der Standardwert ist $false.

Hinweis

Dieser Parameter kann nicht auf $false festgelegt werden, wenn der in InternalAddress angegebene Wert ein Platzhalterzeichen enthält.

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

Die folgenden Beispiele zeigen, wie ein vorhandener Eintrag zum Umschreiben von Adressen geändert wird. Das erste Beispiel legt den internen Domänennamen fest, der geschrieben werden soll. Der beschreibende Name für diesen Eintrag wird ebenfalls geändert, damit er dem neuen Domänennamen entspricht, der umgeschrieben wird.

Das zweite Beispiel legt für den Parameter OutboundOnly den Wert $true fest. Diese Aktion informiert den Adressumschreibungs-Agent, dass Adressen nur für ausgehende E-Mail-Nachrichten aus der Exchange 2007-Organisation umgeschrieben werden sollen.

Wichtig

Interne Absender, die von einem Eintrag für das Umschreiben von Adressen betroffen sind, bei dem der Parameter OutboundOnly auf $true festgelegt wurde, müssen eine konfigurierte Proxyadresse besitzen, die der umgeschriebenen E-Mail-Adresse entspricht.

Set-AddressRewriteEntry "Address rewrite entry for contoso.com" -Name "Address rewrite entry for northwindtraders.com" -InternalAddress northwindtraders.com 
Set-AddressRewriteEntry "Address rewrite entry for all contoso.com e-mail addresses" -OutboundOnly:$true