New-Mailbox (RTM)

 

适用于: Exchange Server 2007

上一次修改主题: 2008-03-13

使用 New-Mailbox cmdlet 可以在 Active Directory 目录服务中新建用户,并对此新用户启用邮箱。

语法

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -Password <SecureString> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -LinkedDomainController <String> -LinkedMasterAccount <UserIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-LinkedCredential <PSCredential>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -Room <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Equipment <SwitchParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -Shared <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]

详细说明

若要运行 New-Mailbox cmdlet,必须为您使用的帐户委派以下角色:

  • Exchange 收件人管理员角色

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

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

参数

参数 必需 类型 说明

Database

必需

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Database 参数指定将包含新用户邮箱的 Exchange 数据库。可以使用下列值:

  • 数据库的 GUID

  • 数据库名称

  • 服务器名称\数据库名称

  • 服务器名称\存储组\数据库名称

Equipment

必需

System.Management.Automation.SwitchParameter

如果此邮箱是资源邮箱,则 Equipment 参数指定资源的类型是设备。只有在创建资源邮箱时,此参数才是必需的。

LinkedDomainController

必需

System.String

LinkedDomainController 参数指定用户帐户所在林中的域控制器。此林中的域控制器用于获取 LinkedMasterAccount 参数指定帐户的安全信息。只有在创建链接邮箱时,此参数才是必需的。

LinkedMasterAccount

必需

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

LinkedMasterAccount 参数指定用户帐户所在林中的主帐户。主帐户是邮箱所链接的帐户。主帐户将授予对邮箱的访问权限。只有在创建链接邮箱时,此参数才是必需的。可以使用下列值之一:

  • GUID

  • 可分辨名称 (DN)

  • 域\帐户

  • 用户主要名称 (UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

Name

必需

System.String

Name 参数指定用户的名称。这是出现在 Active Directory 用户和计算机中的名称。这也是出现在“用户信息”选项卡上的“收件人属性”中的用户名。

OrganizationalUnit

必需

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 参数指定将在其中创建用户的容器。

Password

必需

System.Security.SecureString

Password 参数指定新建用户的初始密码。如果创建链接邮箱、资源邮箱或共享邮箱,则此参数不是必需的,因为这些邮箱类型的用户帐户将被禁用。

Room

必需

System.Management.Automation.SwitchParameter

如果此邮箱是资源邮箱,则 Room 参数指定资源的类型是会议室。只有在创建资源邮箱时,此参数才是必需的。

Shared

必需

System.Management.Automation.SwitchParameter

Shared 参数指定要创建共享邮箱。共享邮箱是多个用户可以登录的邮箱。此邮箱不与任何可以登录的用户关联,而与禁用的用户帐户关联。

只有在创建共享邮箱时,此参数才是必需的。

UserPrincipalName

必需

System.String

UserPrincipalName 参数指定此邮箱的用户主要名称 (UPN)。这是用户的登录名。UPN 由用户名和后缀组成。通常,后缀是用户帐户所在的域名。

ActiveSyncMailboxPolicy

可选

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

ActiveSyncMailboxPolicy 参数指定要为创建的邮箱启用的邮箱策略。如果不指定此参数,则使用默认的邮箱策略。

Alias

可选

System.String

Alias 参数指定正在创建用户的电子邮件别名。

别名可以是以句点分隔并且中间没有空格的字符组合。不要在别名中使用特殊字符。

DisplayName

可选

System.String

DisplayName 参数指定为此邮箱创建的新用户的显示名称。DisplayName 是 Exchange 管理控制台中“收件人配置”下出现的名称。DisplayName 也出现在 Active Directory 用户和计算机中的用户“属性常规”选项卡上。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

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

FirstName

可选

System.String

FirstName 参数指定所创建的用户名。

Initials

可选

System.String

Initials 参数指定所创建用户的缩写。

LastName

可选

System.String

FirstName 参数指定所创建用户的姓。

LinkedCredential

可选

System.Management.Automation.PSCredential

LinkedCredential 参数指定用于访问由 LinkedDomainController 参数指定的域控制器的凭据。即使启用的是链接邮箱,此参数也是可选的。

ManagedFolderMailboxPolicy

可选

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

ManagedFolderMailboxPolicy 参数指定要为创建的邮箱启用的托管文件夹邮箱策略。

ManagedFolderMailboxPolicyAllowed

可选

System.Management.Automation.SwitchParameter

ManagedFolderMailboxPolicyAllowed 参数忽略使用的 Microsoft Outlook 版本早于 Outlook 2007 的电子邮件客户端不支持邮件记录管理功能的警告。使用 ManagedFolderMailboxPolicy 参数为邮箱分配托管文件夹邮箱策略时,除非使用 ManagedFolderMailboxPolicyAllowed,否则,默认情况下将出现警告。

note注意:
Outlook 2003 Service Pack 3 客户端是受支持的,但提供的邮件记录管理功能有限。

ResetPasswordOnNextLogon

可选

System.Boolean

如果设置为 $true, ResetPasswordOnNextLogon 参数指定必须在用户下一次登录时重置 Password 参数中的密码。

SamAccountName

可选

System.String

SamAccountName 参数指定用于支持运行旧版操作系统(例如,Microsoft Windows NT 4.0、Windows 95、Windows 98 和 LAN Manager)的客户端和服务器的登录名。为了支持旧版客户端,此属性必须少于 20 个字符。

如果不指定此参数,Active Directory 将基于用户主要名称自动创建 SAMAccountName。

TemplateInstance

可选

System.Management.Automation.PSObject

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

输入类型

返回类型

错误

错误 说明

 

异常

异常 说明

 

示例

第一个示例显示如何在 Active Directory 中创建用户 Chris Ashton,并为该用户创建邮箱。邮箱位于 Mailbox Database 1 中的 Storage Group 1 上。在下一次登录时,必须重置密码。为了设置密码的初始值,此示例创建变量 $password,并提示您输入密码,然后将该密码作为 SecureString 对象指定给此变量。

第二个示例显示如何在 Active Directory 中创建用户,并为会议室创建资源邮箱。资源邮箱位于 Mailbox Database 1 中的 Storage Group 1 上。在下一次登录时,必须重置密码。由于未指定初始密码的值,Exchange 命令行管理程序将提示输入该值。

$password = Read-Host "Enter password" -AsSecureString
New-mailbox -UserPrincipalName chris@contoso.com -alias chris -database "Storage Group 1\Mailbox Database 1" -Name ChrisAshton -OrganizationalUnit Users -password $password -FirstName Chris -LastName Ashton -DisplayName "Chris Ashton" -ResetPasswordOnNextLogon $true

New-Mailbox -UserPrincipalName confmbx@contoso.com -alias confmbx -name ConfRoomMailbox -database "Storage Group 1\Mailbox Database 1" -OrganizationalUnit Users -Room -ResetPasswordOnNextLogon $true