New-MailContact

 

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

上一次修改主题： 2009-05-14

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

语法

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

详细说明

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

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

• Exchange 收件人管理员角色

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

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

参数

参数	必需	类型	说明
ExternalEmailAddress	必需	Microsoft.Exchange.Data.ProxyAddress	目标电子邮件地址。
Name	必需	System.String	邮件联系人的公用名。
Alias	可选	System.String	邮件联系人的别名。
Confirm	可选	System.Management.Automation.SwitchParameter	Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。
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。
OrganizationalUnit	可选	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	将新联系人添加到的组织单位。例如 redmond.contoso.com/contacts。
PrimarySmtpAddress	可选	Microsoft.Exchange.Data.SmtpAddress	使用此参数可指定邮件联系人的主 SMTP 地址。默认情况下，基于默认电子邮件地址策略生成主 SMTP 地址。通过使用此参数指定主 SMTP 地址，cmdlet 会将邮件联系人的 EmailAddressPolicyEnabled 属性设置为 $false，此邮件联系人的电子邮件地址将不会基于电子地址策略自动更新。
TemplateInstance	可选	System.Management.Automation.PSObject	将现有对象提供给此参数时，该命令将使用该对象的配置在本地服务器或目标服务器上创建完全重复的对象。
UsePreferMessageFormat	可选	System.Boolean	设置为 true 时，对于发送到此用户的邮件，此参数指定收件人首选邮件格式设置将覆盖全局设置。
UseRusServer	可选	System.String	注意： 此参数仅在 Exchange 2007 SP2 中可用。 UseRusServer 参数指示该命令使用运行地址列表服务的邮箱服务器获取并设置邮箱和 Active Directory 用户属性。 地址列表服务是 Exchange 系统助理服务的一个组件。地址列表服务创建和维护 Active Directory 中 Exchange 特定的属性值。通过使用特定信息（如地址列表成员身份和电子邮件地址），您可以使用地址列表服务来更新域中的收件人对象。
WhatIf	可选	System.Management.Automation.SwitchParameter	WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误	说明

异常

异常	说明

示例

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

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