New-Mailbox
適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
トピックの最終更新日: 2009-05-12
Active Directory ディレクトリ サービスにユーザーを新しく作成して、この新しいユーザーのメールボックスを有効にするには、New-Mailbox コマンドレットを使用します。
構文
New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Password <SecureString> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
New-Mailbox -Name <String> -Database <DatabaseIdParameter> -LinkedDomainController <String> -LinkedMasterAccount <UserIdParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-LinkedCredential <PSCredential>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Equipment <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Shared <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Room <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
解説
New-Mailbox コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。
- Exchange 受信者管理者の役割
- 該当する Active Directory コンテナのアカウント オペレータの役割
Microsoft Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
.gif "note") 注 : |
|---|
| 管理されたカスタム フォルダは、メッセージング レコード管理 (MRM) のプレミアム機能です。管理されたカスタム フォルダを含むポリシーを持つメールボックスには、Exchange Server Enterprise クライアント アクセス ライセンス (CAL) が必要です。 |
パラメータ
| パラメータ | 必須かどうか | 種類 | 説明 | ||
|---|---|---|---|---|---|
Database |
必須 |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Database パラメータには、どの Exchange データベースに新しいユーザーのメールボックスを格納するかを指定します。次の値を使用できます。
|
||
Equipment |
必須 |
System.Management.Automation.SwitchParameter |
Equipment パラメータには、このメールボックスがリソース メールボックスである場合に、リソースの種類が機材であることを指定します。このパラメータは、リソース メールボックスを作成している場合にのみ必要になります。 |
||
LinkedDomainController |
必須 |
System.String |
LinkedDomainController パラメータには、ユーザー アカウントが存在するフォレストのドメイン コントローラを指定します。このフォレストのドメイン コントローラは、LinkedMasterAccount パラメータで指定したアカウントのセキュリティ情報を取得するために使用されます。このパラメータは、リンクされたメールボックスを作成している場合にのみ必要になります。 |
||
LinkedMasterAccount |
必須 |
Microsoft.Exchange.Configuration.Tasks.UserIdParameter |
LinkedMasterAccount パラメータには、ユーザー アカウントが存在するフォレストのマスタ アカウントを指定します。マスタ アカウントは、メールボックスのリンク先となるアカウントです。マスタ アカウントには、このメールボックスへのアクセス許可が与えられます。このパラメータは、リンクされたメールボックスを作成している場合にのみ必要になります。次のいずれかの値を使用できます。
|
||
Name |
必須 |
System.String |
Name パラメータには、ユーザーの名前を指定します。これは、Active Directory ユーザーとコンピュータに表示される名前です。[ユーザー情報] タブの [受信者のプロパティ] にも表示されるユーザー名です。 |
||
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 パラメータには、作成しているユーザーの電子メール エイリアスを指定します。 エイリアスは、間にスペースを入れずピリオドで区切って文字の組み合わせを指定することができます。エイリアスに特殊文字を含めることはできません。 |
||
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには、コマンドの処理内容を確認する必要があります。Confirm パラメータで値を指定する必要はありません。 |
||
DisplayName |
省略可能 |
System.String |
DisplayName パラメータには、このメールボックスと共に新しく作成されるユーザーの表示名を指定します。DisplayName は、Exchange 管理コンソールの [受信者の構成] に表示される名前です。また、DisplayName は Active Directory ユーザーとコンピュータで、ユーザー [全般プロパティ◆As "General Property"◇] タブにも表示されます。 |
||
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 が使用されていないと、既定で警告が表示されます。
|
||
OrganizationalUnit |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
OrganizationalUnit パラメータには、ユーザーの作成先となるコンテナを指定します。 |
||
ResetPasswordOnNextLogon |
省略可能 |
System.Boolean |
ResetPasswordOnNextLogon パラメータに $true を設定すると、ユーザーが次回ログオンするときに 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 パラメータに既存のオブジェクトを指定した場合、このコマンドはオブジェクトの構成を使用して、ローカルまたはターゲット サーバーにそのオブジェクトの完全なコピーを作成します。 |
||
UseRusServer |
省略可能 |
System.String |
UseRusServer パラメータを指定すると、このコマンドで、アドレス一覧サービスを実行している指定のメールボックス サーバーを使用してメールボックスと Active Directory ユーザー属性が取得され、それらが設定されるようになります。 アドレス一覧サービスは、Exchange システム アテンダント サービスのコンポーネントです。アドレス一覧サービスは、Active Directory において Exchange 固有の属性値を作成および管理します。アドレス一覧サービスを使用すると、アドレス一覧メンバシップや電子メール アドレスなどの特定の情報を使用して、ドメイン内の受信者オブジェクトを更新できます。 |
||
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータで値を指定する必要はありません。 |
入力の種類
戻り値の種類
エラー
| エラー | 説明 |
|---|---|
|
例外
| 例外 | 説明 |
|---|---|
|
例
最初の例は、Active Directory に Chris Ashton というユーザーを作成し、このユーザーのメールボックスを作成する方法を示しています。メールボックスは Storage Group 1 の Mailbox Database 1 に配置します。パスワードは次回のログオン時に再設定する必要があります。パスワードの初期値を設定するために、この例では $password という変数を作成し、パスワードの入力を求めるメッセージを表示して、そのパスワードを SecureString オブジェクトとして変数に設定します。
2 番目の例は、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
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。