Freigeben über

New-AddressRewriteEntry

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2010-10-20

Mit dem Cmdlet New-AddressRewriteEntry kann ein neuer Eintrag zum Umschreiben von Adressen erstellt werden, der E-Mail-Adressen von Absendern und Empfängern in E-Mail-Nachrichten umschreibt, die an und von einer E-Mail-Organisation gesendet werden.

Syntax

new-AddressRewriteEntry -Name <String> -ExternalAddress <String> -InternalAddress <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-OutboundOnly <$true | $false>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

In Microsoft Exchange Server 2007 ermöglicht das Umschreiben von Adressen 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 New-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.

Hinweis

Sie können nur 1 E-Mail-Adresse verwenden. Sie können nicht mehrere E-Mail-Adressen einer einzigen E-Mail-Adresse zuordnen.

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

ExternalAddress

Erforderlich

System.String

Dieser Parameter gibt die externe E-Mail-Adresse oder den Domänennamen an, die bzw. der beim Umschreiben einer internen E-Mail-Adresse oder eines Domänennamens verwendet wird. Wenn in InternalAddress eine E-Mail-Adresse angegeben ist, muss der in ExternalAddress angegebene Wert ebenfalls eine E-Mail-Adresse sein. Wenn in InternalAddress ein Domänenname oder ein Domänenname mit einem Platzhalterzeichen angegeben ist, muss in ExternalAddress ebenfalls 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.

InternalAddress

Erforderlich

System.String

Diese Parameter gibt die interne E-Mail-Adresse oder den Domänennamen an, die bzw. der umgeschrieben werden soll. 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, die dem angegebenen Domänennamen zugeordnet sind, umschreiben. Beispiel: contoso.com.

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

Name

Erforderlich

System.String

Dieser Parameter ermöglicht dem Administrator das Ändern des eindeutigen Namens dieses Eintrags 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.

OutboundOnly

Optional

System.Boolean

Dieser Parameter gibt an, ob E-Mail-Adressen nur dann umgeschrieben werden sollen, wenn E-Mail-Nachrichten die Exchange 2007-Organisation verlassen oder ob Adressen umgeschrieben werden sollten, 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.

TemplateInstance

Optional

System.Management.Automation.PSObject

Wenn ein vorhandenes Objekt an diesen Parameter übergeben wird, verwendet der Befehl die Konfiguration des Objekts zum Erstellen einer identischen Kopie des Objekts auf einem lokalen oder Zielserver. Weitere Informationen finden Sie unter Vorlagen.

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 drei verschiedene Szenarios:

  • Umschreiben einer einzelnen E-Mail-Adresse. E-Mail-Nachrichten in beide Richtungen werden umgeschrieben.

  • Umschreiben aller E-Mail-Adressen für die Domäne contoso.com. E-Mail-Nachrichten in beide Richtungen werden umgeschrieben.

  • Umschreiben aller E-Mail-Adressen für die Domäne contoso.com sowie für alle Unterdomänen, mit Ausnahme von research.contoso.com und corp.contoso.com. Nur ausgehende E-Mail-Nachrichten werden umgeschrieben.

New-AddressRewriteEntry -Name "Address rewrite entry for david@contoso.com" -InternalAddress david@contoso.com -ExternalAddress david@northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com e-mail addresses" -InternalAddress contoso.com -ExternalAddress northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com and subdomain e-mail addresses" -InternalAddress *.contoso.com -ExternalAddress northwindtraders.com -OutboundOnly:$true -ExceptionList research.contoso.com,corp.contoso.com