通过

New-AddressRewriteEntry (RTM)

  • 项目

 

适用于： Exchange Server 2007

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

使用 New-AddressRewriteEntry cmdlet 可以新建地址重写条目，以便重写在电子邮件组织之间往来的电子邮件中的发件人和收件人电子邮件地址。

语法

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

详细说明

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

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

参数

参数 必需 类型 说明

ExternalAddress

必需

System.String

此参数指定在重写内部电子邮件地址或域名时所使用的外部电子邮件地址或域名。如果在 InternalAddress 中指定电子邮件地址，则在 ExternalAddress 中指定的值也必须是电子邮件地址。如果在 InternalAddress 中指定域名或包含通配符的域名，则必须在 ExternalAddress 中指定域名。可以按下列两种格式输入地址或域名：

  • 电子邮件地址   通过使用指定的地址来重写单个内部电子邮件地址。例如，david@northwindtraders.com。

  • 域名   通过使用指定的外部域名，重写在 InternalAddress 中包括的所有内部电子邮件地址。例如，northwindtraders.com。

note注意：
不能与 ExternalAddress 参数一起使用星号字符。

InternalAddress

必需

System.String

此参数指定要重写的内部电子邮件地址或域名。可以按下列三种格式输入地址或域名：

  • 单个电子邮件地址   只重写指定的地址。例如，david@contoso.com。

  • 域名   重写与指定的域名关联的所有电子邮件地址。例如，contoso.com。

  • 带星号的域名   重写与指定的域名关联的所有电子邮件地址，以及所有子域。例如，*.contoso.com。

Name

必需

System.String

此参数使管理员能够修改此地址重写条目的唯一名称。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定用于将此配置更改写入 Active Directory 目录服务域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。在边缘传输服务器上不支持 DomainController 参数。边缘传输服务器角色只会写入本地 ADAM 实例。

ExceptionList

可选

Microsoft.Exchange.Data.MultiValuedProperty

当 InternalAddress 参数包含的值指定了多个域名时，此参数用于指定不应当重写的域名。可以使用逗号分隔 ExceptionList 参数中包含的多个域名。

OutboundOnly

可选

System.Boolean

此参数指定选择两种情况之一：只有当电子邮件离开 Exchange 2007 组织时才应当重写电子邮件地址，或者是，当双向发送邮件时才应当重写地址。此参数的两个可能的值是 $true 或 $false。默认值为 $false。

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

TemplateInstance

可选

System.Management.Automation.PSObject

将现有对象提供给此参数时，命令将使用该对象的配置在本地服务器或目标服务器上创建对象的相同副本。

输入类型

返回类型

错误

错误 说明

 

异常

异常 说明

 

示例

下列示例显示三种不同的方案：

  • 重写单个电子邮件地址。重写双向电子邮件。

  • 重写 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