Set-AddressRewriteEntry

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2007-08-28

使用 Set-AddressRewriteEntry cmdlet 可以修改现有地址重写条目，这些地址重写条目重写发送给电子邮件组织或从电子邮件组织发送的电子邮件中的发件人和收件人的电子邮件地址。

语法

set-addressrewriteentry -Identity <AddressRewriteEntryIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>] [-WhatIf [<SwitchParameter>]]

set-addressrewriteentry [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-Instance <AddressRewriteEntry>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>] [-WhatIf [<SwitchParameter>]]

详细说明

在 Microsoft Exchange Server 2007 中，地址重写允许您修改在传入和传出 Exchange 2007 组织的邮件中的发件人地址和收件人地址。可以在安装了边缘传输服务器角色的计算机上的接收连接器和发送连接器上配置地址重写代理。

若要在安装了边缘传输服务器角色的计算机上运行 Set-AddressRewriteEntry cmdlet，必须使用作为该计算机上的本地 Administrators 组成员的帐户进行登录。

有关管理 Exchange 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。

参数

参数	必需	类型	说明
Identity	必需	Microsoft.Exchange.Management.MessagingPolicies.AddressRewrite.AddressRewriteEntryIdParameter	此参数指定要修改的地址重写条目。Identity 参数将接受 GUID 或唯一的地址重写名称。
Confirm	可选	System.Management.Automation.SwitchParameter	Confirm 参数将导致命令暂停处理，并且需要您在继续处理之前确认该命令将执行的操作。您不必使用 Confirm 参数指定值。
DomainController	可选	Microsoft.Exchange.Data.Fqdn	若要指定将此配置更改写入 Active Directory 目录服务域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。边缘传输服务器不支持 DomainController 参数。边缘传输服务器角色只会写入本地 ADAM 实例。
ExceptionList	可选	Microsoft.Exchange.Data.MultiValuedProperty	当 InternalAddress 参数包含的值指定了多个域名时，此参数用于指定不应当重写的域名。可以使用逗号分隔 ExceptionList 参数中包含的多个域名。有关如何在多值属性中添加或删除值的详细信息，请参阅修改多值属性。
ExternalAddress	可选	System.String	此参数使管理员可以修改在重写内部电子邮件地址或域名时使用的外部电子邮件地址或域名。如果在 InternalAddress 中指定了电子邮件地址，则在 ExternalAddress 中指定的值必须同样是电子邮件地址。如果在 InternalAddress 中指定了域名或包含通配符的域名，则必须在 ExternalAddress 中指定域名。可以使用以下两种格式输入地址或域名： 电子邮件地址   使用指定地址重写单个内部电子邮件地址。例如，david@northwindtraders.com。 域名   使用指定外部域名重写 InternalAddress 中包含的所有内部电子邮件地址。例如，northwindtraders.com。 注意： ExternalAddress 参数不能使用星号。
Instance	可选	Microsoft.Exchange.Data.Directory.SystemConfiguration.AddressRewriteEntry	使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。
InternalAddress	可选	System.String	此参数使管理员可以修改将重写的内部电子邮件地址或域名。可以使用以下三种格式输入地址或域名： 单个电子邮件地址   只重写指定地址。例如，david@contoso.com。 域名   重写与指定域名关联的所有电子邮件地址。例如，contoso.com。 包含星号的域名   重写与指定域名以及所有子域关联的所有电子邮件地址。例如，*.contoso.com。
Name	可选	System.String	此参数使管理员可以修改该地址重写条目的唯一名称。
OutboundOnly	可选	System.Boolean	此参数使管理员可以修改是只在电子邮件离开 Exchange Server 2007 组织时才重写电子邮件地址，还是在邮件双向发送时均应重写地址。此参数两个可能的值是 $true 或 $false。默认值为 $false。 注意： 如果在 InternalAddress 中指定的值包含通配符，则不能将此参数设置为 $false。
WhatIf	可选	System.Management.Automation.SwitchParameter	WhatIf 参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。您不必使用 WhatIf 参数指定值。

输入类型

返回类型

错误

错误	说明

异常

异常	说明

示例

以下示例显示如何修改现有的地址重写条目。第一个示例设置要重写的内部域名。同时，更改此条目的描述性名称，以反映要重写的新域名。

第二个示例将 OutboundOnly 参数设置为 $true。该操作通知地址重写代理只重写来自 Exchange 2007 组织的出站电子邮件上的地址。

要点：
OutboundOnly 参数设置为 $true 的地址重写条目所影响的内部发件人必须已配置了与重写电子邮件地址匹配的代理地址。

Set-AddressRewriteEntry "Address rewrite entry for contoso.com" -Name "Address rewrite entry for northwindtraders.com" -InternalAddress northwindtraders.com 
Set-AddressRewriteEntry "Address rewrite entry for all contoso.com e-mail addresses" -OutboundOnly:$true