Remove-AddressRewriteEntry
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-07-27
Mit dem Cmdlet Remove-AddressRewriteEntry können Sie einen vorhandenen Eintrag zur Adressumschreibung, der nicht mehr benötigt wird, entfernen.
Syntax
remove-addressrewriteentry -Identity <AddressRewriteEntryIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-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 Agents für das Umschreiben von Adressen für den Empfangsconnector und Sendeconnector auf einem Computer, auf dem die Serverfunktion Edge-Transport installiert ist.
Um das Cmdlet Remove-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 zu entfernenden Eintrag zum Umschreiben von Adressen an. Der Parameter Identity akzeptiert eine GUID oder den eindeutigen Namen des Eintrags zum Umschreiben von Adressen. Sie können die Parameterbeschriftung Identity weglassen. |
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. |
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 nicht auf Computern unterstützt, auf denen die Serverfunktion Edge-Transport installiert ist. Die Serverfunktion Edge-Transport schreibt nur in die lokale ADAM-Instanz. |
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
In den folgenden Beispielen wird gezeigt, wie vorhandene Einträge zum Umschreiben von Adressen, die nicht mehr benötigt werden, entfernt werden. Im ersten Beispiel wird dargestellt, wie ein bestimmter Eintrag zum Umschreiben von Adressen entfernt wird.
Das zweite Beispiel zeigt, wie eine Liste aller Einträge zum Umschreiben von Adressen angezeigt wird, die entfernt werden, wenn sie die Zeichenfolge "contoso.com" enthalten. Zum Entfernen mehrerer Einträge zum Umschreiben von Adressen müssen die Ergebnisse des Befehls Get-AddressRewriteEntry an den Befehl Remove-AddressRewriteEntry weitergeleitet werden. Mithilfe des Parameters WhatIf können die Aktionen simuliert werden, die der Befehl ausführen würde, ohne dabei tatsächlich die Änderungen zu übernehmen. Wenn der Parameter WhatIf dann entfernt und der Befehl erneut ausgeführt wird, werden die Einträge zum Umschreiben von Adressen entfernt.
Weitere Informationen zum Pipelining finden Sie unter Pipelining.
Remove-AddressRewriteEntry "Address rewrite entry for contoso.com"
Get-AddressRewriteEntry "*contoso.com" | Remove-AddressRewriteEntry -WhatIf:$true