New-AddressRewriteEntry
此 Cmdlet 只能在內部部署 Exchange 的 Edge Transport Server 上使用或生效。
使用 New-AddressRewriteEntry Cmdlet 建立地址修正專案，以重寫透過 Edge Transport Server 傳送至組織或從組織傳送之郵件中的寄件者和收件者電子郵件地址。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
New-AddressRewriteEntry
[-Name] <String>
-ExternalAddress <String>
-InternalAddress <String>
[-Confirm]
[-DomainController <Fqdn>]
[-ExceptionList <MultiValuedProperty>]
[-OutboundOnly <Boolean>]
[-WhatIf]
[<CommonParameters>] Description
在 Edge Transport Server 上，您必須是本機系統管理員群組的成員才能執行此 Cmdlet。
範例
範例 1
New-AddressRewriteEntry -Name "Address rewrite entry for david@contoso.com" -InternalAddress david@contoso.com -ExternalAddress david@northwindtraders.com此範例會建立地址修正專案，以在輸出郵件中將電子郵件地址 david@contoso.com 重寫為 david@northwindtraders.com 。 因為 OutboundOnly 參數未設定為 $true，所以傳送至 david@northwindtraders.com 的輸入郵件會重寫回 david@contoso.com 。
範例 2
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com email addresses" -InternalAddress contoso.com -ExternalAddress northwindtraders.com此範例會建立地址修正專案，將 contoso.com 網域中的所有電子郵件地址重寫為在輸出郵件中 northwindtraders.com。 因為 OutboundOnly 參數未設定為 $true，所以傳送給 northwindtraders.com 收件者的輸入郵件會重寫回 contoso.com。
範例 3
New-AddressRewriteEntry -Name "Address rewrite entry for contoso.com and all subdomain email addresses" -InternalAddress *.contoso.com -ExternalAddress northwindtraders.com -ExceptionList research.contoso.com,corp.contoso.com -OutboundOnly $true此範例會建立地址修正專案，將 contoso.com 網域中的所有電子郵件地址和所有子域重寫為 northwindtraders.com。 不過，不會重寫 research.contoso.com 和 corp.contoso.com 中的電子郵件地址。 因為此地址修正專案會影響網域，且所有子域 (*.contoso.com) ，所以地址修正只會在輸出郵件上發生。
參數
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 例如，具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停，可強制您在繼續之前確認命令。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (例如，New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
Edge Transport Server 不支援 DomainController 參數。 Edge Transport Server 會使用 Active Directory 輕量型目錄服務 (AD LDS) 的本機執行個體來讀寫資料。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExceptionList
ExceptionList 參數指定當 InternalAddress 參數包含要重寫網域中位址的萬用字元，以及所有子域 (*.contoso.com) 時，不應該重寫的電子郵件地址網域。 您可以在 ExceptionList 參數中輸入多個網域值，並以逗號分隔。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalAddress
ExternalAddress 參數會指定您想要的最終電子郵件地址。 如果 InternalAddress 參數指定單一電子郵件地址 () chris@contoso.com ，則 ExternalAddress 參數也必須指定單一電子郵件地址 (support@contoso.com) 。 如果 InternalAddress參數會指定單一網域 (contoso.com) 或網域和所有子網域 (*.contoso.com)，則 ExternalAddress參數必須指定單一網域 (fabrikam.com)。
萬用字元 (*) 不能與 ExternalAddress 參數搭配使用。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalAddress
InternalAddress 參數會指定您想要變更的原始電子郵件地址。 您可以使用下列值：
- 單一電子郵件地址： david@contoso.com
- 單一網域：contoso.com 或 sales.contoso.com
- 網域和所有子域：*.contoso.com
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Name
Name 參數會指定此地址修正項目的唯一名稱。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-OutboundOnly
OutboundOnly 參數會啟用或停用僅輸出地址修正。 這個參數的有效輸入是 $true 或 $false。 值 $true 表示僅在輸出電子郵件中進行地址修正。 值 $false 表示同時在輸出電子郵件和輸入電子郵件上進行地址修正 (修正的電子郵件地址會變更回輸入電子郵件中的原始電子郵件地址)。 預設值為 $false。
如果 InternalAddress 參數包含萬用字元來修正網域和所有子網域 (*.contoso.com) 中的地址，則必須將此參數設定為 $true。
而且，當您設定僅限輸出地址修正時，則需要將修正的電子郵件地址設定為受影響收件者上的 Proxy 位址。 例如，如果 laura@sales.contoso.com 將 重寫為 laura@contoso.com ，則 Proxy 位址 laura@contoso.com 必須設定在 Mail 的信箱上。 這允許正確地傳遞回覆和輸入郵件。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
WhatIf 參數會模擬命令的動作。 使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。