New-MailUser (RTM)

  • [アーティクル]

 

適用先: Exchange Server 2007

トピックの最終更新日: 2007-06-05

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

構文

New-MailUser -Name <String> -ExternalEmailAddress <ProxyAddress> -OrganizationalUnit <OrganizationalUnitIdParameter> -Password <SecureString> -UserPrincipalName <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>]

解説

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) を指定します。

OrganizationalUnit

必須

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit パラメータには、新しいユーザーを追加する組織単位を指定します (たとえば、redmond.contoso.com/contacts)。

Password

必須

System.Security.SecureString

Password パラメータには、メール ユーザーが自分のアカウントをセキュリティで保護するために使用するパスワードを指定します。

UserPrincipalName

必須

System.String

UserPrincipalName パラメータには、システム ユーザーの名前を電子メール アドレスの形式で指定します (たとえば、ted@contoso.com)。

Alias

省略可能

System.String

Alias パラメータには、ユーザーのエイリアスを指定します。エイリアスには、文字、数字、および次の区切り文字と記号を含めることができます。

  • !
  • #
  • $
  • %
  • ^
  • &
  • *
  • +
  • -
  • .
  • /
  • =
  • ?
  • _
  • {
  • }
  • |
  • ~

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 に変更する必要もあります。

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 に設定します。

入力の種類

戻り値の種類

エラー

エラー 説明

 

例外

例外 説明

 

例

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

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

2 番目のコマンドは、Ted Bremer という名前の、メールが有効な新しいユーザー オブジェクトを作成し、Password パラメータを使用して、新しく作成したパスワードをこのオブジェクトに割り当てます。Ted は Tailspin Toys の従業員ですが、Contoso の従業員と密接な協力関係にあるため、contoso.com の電子メール アドレスが与えられています。Ted のメールボックスは、Contoso の Exchange Server にはありません。Ted の contoso.com の電子メール アドレスに送信された電子メール メッセージは、Ted の外部の電子メール アドレスである 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 を参照してください。