New-MailUser

  • 项目

 

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

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

使用 New-MailUser cmdlet 可以创建启用邮件的新用户。

语法

New-MailUser -Name <String> -ExternalEmailAddress <ProxyAddress> -Password <SecureString> -UserPrincipalName <String> [-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>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

详细说明

New-MailUser cmdlet 在 Active Directory 目录服务中创建启用邮件的新用户对象。

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

  • Exchange 收件人管理员角色

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

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

note注意：
并非所有用户属性都可以使用 New-MailUser cmdlet 进行设置。可以使用 Set-User cmdlet 进行其他设置。

参数

参数 必需 类型 说明

ExternalEmailAddress

必需

Microsoft.Exchange.Data.ProxyAddress

ExternalEmailAddress 参数指定一个组织之外的电子邮件地址。将发送到启用邮件用户的电子邮件发送到此外部地址。

Name

必需

System.String

Name 参数指定启用邮件用户的公用名 (CN)。

Password

必需

System.Security.SecureString

Password 参数指定邮件用户用以保护他或她的帐户的密码。

UserPrincipalName

必需

System.String

UserPrincipalName 参数使用电子邮件地址格式定义系统用户的名称（例如，ted@contoso.com）。

Alias

可选

System.String

Alias 参数指定用户的别名。别名可以包含字母、数字以及下列标点符号和符号：

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。

DisplayName

可选

System.String

DisplayName 参数指定将显示在邮件用户的 Microsoft Outlook 中的名称。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

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

FirstName

可选

System.String

FirstName 参数指定邮件用户的名。

Initials

可选

System.String

Initials 参数指定邮件用户的缩写。

LastName

可选

System.String

LastName 参数指定邮件用户的姓。

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

OrganizationalUnit 参数指定在其中添加新用户的组织单位（例如，redmond.contoso.com/contacts）。

PrimarySmtpAddress

可选

Microsoft.Exchange.Data.SmtpAddress

使用此参数指定邮件用户的主 SMTP 地址。默认情况下，基于默认电子邮件地址策略生成主 SMTP 地址。如果使用此参数指定主 SMTP 地址，cmdlet 将邮件用户的 EmailAddressPolicyEnabled 属性设置为 $false，并且不会基于电子邮件地址策略自动更新此邮件用户的电子邮件地址。

ResetPasswordOnNextLogon

可选

System.Boolean

如果将 ResetPasswordOnNextLogon 参数设置为 $true，则用户在下次登录时必须更改密码。

SamAccountName

可选

System.String

SamAccountName 参数定义用来支持运行旧版操作系统（例如，Microsoft Windows NT 4.0、Windows 98、Windows 95 和 LAN Manager）的客户端和服务器的登录名。此属性包含的字符必须少于 20 个。帐户名可以使用字母、数字以及下列标点符号和符号：

  • !

  • #

  • $

  • %

  • ^

  • &

  • -

  • .

  • _

  • {

  • }

  • |

  • ~

TemplateInstance

可选

System.Management.Automation.PSObject

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

UsePreferMessageFormat

可选

System.Boolean

UsePreferMessageFormat 参数指定为邮箱配置的邮件格式设置是否将覆盖为域配置的全局设置。将此参数设置为 $true 可以使为邮箱配置的邮件格式设置覆盖任何全局设置。

UseRusServer

可选

System.String
note注意：
此参数仅在 Exchange 2007 SP2 中可用。

UseRusServer 参数指示该命令使用运行地址列表服务的邮箱服务器获取并设置邮箱和 Active Directory 用户属性。

地址列表服务是 Exchange 系统助理服务的一个组件。地址列表服务创建和维护 Active Directory 中 Exchange 特定的属性值。通过使用特定信息（如地址列表成员身份和电子邮件地址），您可以使用地址列表服务来更新域中的收件人对象。

WhatIf

可选

System.Management.Automation.SwitchParameter

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

输入类型

返回类型

错误

错误 说明

 

异常

异常 说明

 

示例

以下示例由两个命令组成。

在第一个命令中，会创建类型 System.Security.SecureString 的一个密码 $password。执行该命令时，会显示“输入密码”提示。用户输入的字符串变为新的密码字符串 $password。

第二个命令会使用与 Password 参数相同的方式创建一个名称为 Ted Bremer 的新的启用邮件的用户对象并向该对象分配新创建的密码。Ted 是 Tailspin Toys 的一名员工，但因为他要与 Contoso 公司的员工一起密切合作，所以给他分配了一个在 contoso.com 的电子邮件地址。Ted 在 Contoso 的 Exchange Server 上并没有邮箱。发送到 Ted 的 contoso.com 电子邮件地址的电子邮件会被发送到他的外部电子邮件地址 ted@tailspintoys.com。

$password = Read-Host "Enter password" -AsSecureString
New-MailUser -Name "Ted Bremer" -Password $password -ExternalEmailAddress ted@tailspintoys.com -UserPrincipalName ted@contoso.com -OrganizationalUnit contoso.com