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，否则，默认情况下将出现警告。 注意： 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