通过

New-MailContact (RTM)

  • 项目

 

适用于： Exchange Server 2007

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

可以使用 New-MailContact 命令创建新的、已启用邮件的联系人。

语法

New-MailContact -Name <String> -ExternalEmailAddress <ProxyAddress> -OrganizationalUnit <OrganizationalUnitIdParameter> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>]

详细说明

New-MailContact 命令可在 Microsoft Active Directory 中新建邮件联系人对象并为该邮件联系人启用邮件。

若要运行 New-MailContact cmdlet，必须为您使用的帐户委派下列角色：

  • Exchange 收件人管理员角色

  • 帐户操作员角色（对于适用的 Active Directory 容器）

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

参数

参数 必需 类型 说明

ExternalEmailAddress

必需

Microsoft.Exchange.Data.ProxyAddress

目标电子邮件地址。

Name

必需

System.String

邮件联系人的公用名。

OrganizationalUnit

必需

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

将新联系人添加到的组织单位。例如 redmond.contoso.com/contacts。

Alias

可选

System.String

邮件联系人的别名。

DisplayName

可选

System.String

将在 Microsoft Outlook 中为邮件联系人显示的名称。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定将此配置更改写入 Active Directory 的域控制器的完全限定的域名，请在命令中包含 DomainController 参数。

FirstName

可选

System.String

邮件联系人的名。

Initials

可选

System.String

邮件联系人的缩写。

LastName

可选

System.String

邮件联系人的姓。

MacAttachmentFormat

可选

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

MacAttachmentFormat 参数指定要发送到邮件联系人的邮件的 Apple Macintosh 操作系统附件格式。此参数的有效值是：

  • BinHex

  • UUENCODE

  • AppleSingle

  • AppleDouble

默认情况下，此参数设置为 BinHex。

MacAttachmentFormat 参数可接受的值取决于 MessageFormat 参数。如果 MessageFormat 参数设置为 Text，则只能将 BinHex 或 UUENCODE 用作此参数的值。如果 MessageFormat 参数设置为 Mime，则只能将 BinHex、AppleSingle 或 AppleDouble 用作此参数的值。

MessageBodyFormat

可选

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

MessageBodyFormat 参数指定要发送到邮件联系人的邮件的邮件正文格式。此参数的有效值是：

  • Text

  • Html

  • TextAndHtml

默认情况下，此参数设置为 TextAndHtml。

MessageFormat 和 MessageBodyFormat 参数相互依赖。如果 MessageFormat 参数设置为 Mime，MessageBodyFormat 参数可以设置为任意有效值。但是，如果 MessageFormat 参数设置为 Text，MessageBodyFormat 参数只能设置为 Text。因此，如果要将此参数设置为 Html 或 TextAndHtml，就必须将 MessageFormat 参数设置为 Mime。

MessageFormat

可选

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

MessageFormat 参数指定发送到邮件联系人的邮件的邮件正文格式。

此参数的有效值是：

  • Text

  • Mime

默认情况下，此参数设置为 Mime。

MessageFormat 和 MessageBodyFormat 参数相互依赖。如果 MessageFormat 参数设置为 Mime，MessageBodyFormat 参数可以设置为任意有效值。但是，如果 MessageFormat 参数设置为 Text，MessageBodyFormat 参数只能设置为 Text。因此，如果要将 MessageFormat 参数从 Mime 更改为 Text，就必须将 MessageBodyFormat 参数更改为 Text。

TemplateInstance

可选

System.Management.Automation.PSObject

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

UsePreferMessageFormat

可选

System.Boolean

设置为 true 时，对于发送到此用户的邮件，此参数指定收件人首选邮件格式设置将覆盖全局设置。

输入类型

返回类型

错误

错误 说明

异常

异常 说明

示例

在下例中，使用 New-MailContact 命令创建新的、已启用邮件的联系人。

New-MailContact -Name "Ted Bremer" -ExternalEmailAddress "ted@tailspintoys.com" -OrganizationalUnit "Marketing"