Set-AddressRewriteEntry (RTM)

 

适用于: Exchange Server 2007

上一次修改主题: 2007-06-07

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

语法

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

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

详细说明

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

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

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Management.MessagingPolicies.AddressRewrite.AddressRewriteEntryIdParameter

此参数指定要修改的地址重写条目。Identity 参数将接受 GUID 或唯一的地址重写名称。

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

note注意:
不能与 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

note注意:
如果在 InternalAddress 中指定的值包含通配符,则不能将此参数设置为 $false

输入类型

返回类型

错误

错误 说明

 

异常

异常 说明

 

示例

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

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

important要点:
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