New-MailUser

  • [アーティクル]

 

適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

トピックの最終更新日: 2009-05-12

New-MailUser コマンドレットを使用して、メールが有効な新しいユーザーを作成します。

構文

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 コマンドレットは、Active Directory ディレクトリ サービスに、メールが有効な新しいユーザー オブジェクトを作成します。

New-MailUser コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。

  • Exchange 受信者管理者の役割
  • 該当する Active Directory コンテナのアカウント オペレータの役割

Microsoft Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。

note注 :
ユーザー属性の中には New-MailUser コマンドレットでは設定できないものがあります。追加の設定は、Set-User コマンドレットで行うことができます。

パラメータ

パラメータ 必須かどうか 種類 説明

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 アドレスを指定すると、メール ユーザーの 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 System Attendant サービスのコンポーネントです。アドレス一覧サービスは、Active Directory において Exchange 固有の属性値を作成および管理します。アドレス一覧サービスを使用すると、アドレス一覧メンバシップや電子メール アドレスなどの特定の情報を使用して、ドメイン内の受信者オブジェクトを更新できます。

WhatIf

省略可能

System.Management.Automation.SwitchParameter

WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータに値を指定する必要はありません。

入力の種類

戻り値の種類

エラー

エラー 説明

 

例外

例外 説明

 

例

次の例は 2 つのコマンドから構成されています。

最初のコマンドでは、System.Security.SecureString の種類のパスワード $password が作成されます。このコマンドが実行されると、パスワードの入力を求めるプロンプトが表示されます。ユーザーが入力した文字列が、新しいパスワード文字列 $password になります。

2 番目のコマンドは、Ted Bremer という名前の、メールが有効な新しいユーザー オブジェクトを作成し、Password パラメータを使用して、新しく作成したパスワードをこのオブジェクトに割り当てます。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

参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。