New-AddressRewriteEntry
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:
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:
|
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 Hinweis Dieser Parameter kann nicht auf |
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