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