New-Mailbox (RTM)

適用版本： Exchange Server 2007

上次修改主題的時間： 2008-03-13

使用 New-Mailbox 指令程式，可以在 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 指令程式，必須對您使用的帳戶委派下列項目：

• 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 別名
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	LastName 參數可指定所建立之使用者的姓氏。
LinkedCredential	選用	System.Management.Automation.PSCredential	LinkedCredential 參數指定要用來存取 LinkedDomainController 參數所指定之網域控制站的認證。此參數是選擇性的，即使您要啟用連結的信箱亦然。
ManagedFolderMailboxPolicy	選用	Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter	ManagedFolderMailboxPolicy 參數指定要針對所建立信箱啟用之受管理的資料夾信箱原則。
ManagedFolderMailboxPolicyAllowed	選用	System.Management.Automation.SwitchParameter	ManagedFolderMailboxPolicyAllowed 參數會略過警告，而此警告說明使用 Outlook 2007 之前之 Microsoft Outlook 版本的電子郵件用戶端不支援通訊記錄管理功能。將受管理的資料夾信箱原則指派給使用 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，並建立此使用者的信箱。信箱是位在 Storage Group 1 的 Mailbox Database 1 中。必須在下次登入時重設密碼。為了設定密碼的初始值，此範例會建立變數 $password、提示您輸入密碼，並將該密碼指派給變數作為 SecureString 物件。

第二個範例顯示如何在 Active Directory 中建立使用者，以及建立會議室的資源信箱。資源信箱是位在 Storage Group 1 的 Mailbox Database 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