New-AddressRewriteEntry

  • 项目

 

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

上一次修改主题： 2010-10-20

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

语法

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

详细说明

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

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

note注意：
只能使用一个电子邮件地址。无法将多个电子邮件地址映射到一个电子邮件地址。

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

参数

参数 必需 类型 说明

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

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

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 参数中包含的多个域名。有关如何在多值属性中添加值或从中删除值的详细信息，请参阅修改多值属性。

OutboundOnly

可选

System.Boolean

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

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

TemplateInstance

可选

System.Management.Automation.PSObject

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

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

 

异常

异常 说明

 

示例

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

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

  • 重写 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 -ExceptionList research.contoso.com,corp.contoso.com