New-AddressRewriteEntry

 

適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間： 2010-10-20

New-AddressRewriteEntry 指令程式可用來建立新的地址修正項目，此項目可修正來回傳送於電子郵件組織中之電子郵件的寄件者及收件者電子郵件地址。

語法

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

詳細描述

在 Microsoft Exchange Server 2007 中，地址修正可讓您修改在 Exchange 2007 組織中來往之郵件上的寄件者及收件者地址。您可以在已安裝 Edge Transport server role 的電腦上，在接收連接器及傳送連接器上設定地址修正代理程式。

若要在已安裝 Edge Transport server role 的電腦上執行 New-AddressRewriteEntry 指令程式，您必須使用該電腦之本機 Administrators 群組成員的帳戶進行登入。

附註：
您只能使用一個電子郵件地址。您無法將多個電子郵件地址對應至一個電子郵件地址。

如需管理 Exchange 2007 所需之權限、委派角色以及權利的相關資訊，請參閱權限考量。

參數

參數	必要	類型	描述
ExternalAddress	必要	System.String	此參數可指定當您修正內部電子郵件地址或網域名稱時，要使用的外部電子郵件地址或網域名稱。如果在 InternalAddress中指定了電子郵件地址，則在 ExternalAddress 中指定的值就必須是電子郵件地址。如果在 InternalAddress中指定了網域名稱或具有萬用字元的網域名稱，則必須在 ExternalAddress 中指定網域名稱。您可以用下列兩種格式輸入地址或網域名稱： 電子郵件地址   使用指定的地址來修正單一內部電子郵件地址。例如，david@northwindtraders.com。 網域名稱   使用指定的外部網域名稱修正 InternalAddress中包含的所有內部電子郵件地址。例如，northwindtraders.com。 附註： 星號字元不可以與 ExternalAddress 參數搭配使用。
InternalAddress	必要	System.String	此參數可指定要修正的內部電子郵件地址或網域名稱。您可以用下列三種格式輸入地址或網域名稱： 單一電子郵件地址   只修正指定的地址。例如，david@contoso.com。 網域名稱   修正與指定網域名稱相關的所有電子郵件地址。例如，contoso.com。 帶星號的網域名稱   修正與指定網域名稱及所有子網域相關的所有電子郵件地址。例如，*.contoso.com。
Name	必要	System.String	此參數可以讓系統管理員修改此地址修正項目的唯一名稱。
Confirm	選用	System.Management.Automation.SwitchParameter	Confirm 參數會使得命令暫停處理，並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。
DomainController	選用	Microsoft.Exchange.Data.Fqdn	若要指定將此組態變更寫入至 Active Directory 目錄服務之網域控制站的網域全名 (FQDN)，請在命令中加入 DomainController 參數。Edge Transport Server 不支援 DomainController 參數。Edge Transport server role 只會寫入至本機 ADAM 執行個體。
ExceptionList	選用	Microsoft.Exchange.Data.MultiValuedProperty	在 InternalAddress 參數含有指定多個網域名稱的值時，此參數指定不應該寫入的網域名稱。您可以使用逗號分隔 ExceptionList 參數所包含的多個網域名稱。如需如何從多重值內容中新增值或移除值的相關資訊，請參閱修改多重值內容。
OutboundOnly	選用	System.Boolean	此參數可指定是否只有在電子郵件訊息離開 Exchange 2007 組織時才需要修正電子郵件地址，或是在郵件以兩種方向傳送時都要進行地址修正。此參數的兩個可能值是 $true 或 $false。預設值為 $false。 附註： 如果在 InternalAddress指定的值包含萬用字元，則不能將此參數設為 $false。
TemplateInstance	選用	System.Management.Automation.PSObject	提供現有物件給此參數時，命令會使用該物件組態，在本機或目標伺服器上建立物件的相同副本。如需相關資訊，請參閱範本。
WhatIf	選用	System.Management.Automation.SwitchParameter	WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。您不需要為 WhatIf 參數指定任何值。

輸入類型

傳回類型

錯誤

錯誤	描述

例外狀況

例外狀況	描述

範例

下列範例顯示三個不同的案例：

• 修正單一電子郵件地址。兩種方向的電子郵件訊息都會修正。

• 修正 contoso.com 網域的所有電子郵件地址。兩種方向的電子郵件訊息都會修正。

• 修正 contoso.com 網域及所有子網域的所有電子郵件地址，除了 research.contoso.com 及 corp.contoso.com 之外。只會修正輸出的電子郵件訊息。

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