New-MailContact (RTM)

  • [アーティクル]

 

適用先: Exchange Server 2007

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

New-MailContact コマンドを使用すると、メールが有効な新しい連絡先を作成できます。

構文

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

解説

New-MailContact コマンドは、Microsoft Active Directory に新しいメール連絡先オブジェクトを作成し、作成したメール連絡先のメールを有効にします。

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

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

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

パラメータ

パラメータ 必須 種類 説明

ExternalEmailAddress

必須

Microsoft.Exchange.Data.ProxyAddress

送信先の電子メール アドレスです。

Name

必須

System.String

メール連絡先の共通名です。

OrganizationalUnit

必須

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

新しい連絡先が追加される組織単位です。たとえば、redmond.contoso.com/contacts です。

Alias

省略可能

System.String

メール連絡先のエイリアスです。

DisplayName

省略可能

System.String

Microsoft Outlook に表示されるメール連絡先の名前です。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

この構成の変更を Active Directory に書き込むドメイン コントローラの完全修飾ドメイン名を指定するには、コマンドに DomainController パラメータを含めます。

FirstName

省略可能

System.String

メール連絡先の名です。

Initials

省略可能

System.String

メール連絡先のイニシャルです。

LastName

省略可能

System.String

メール連絡先の姓です。

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

TemplateInstance

省略可能

System.Management.Automation.PSObject

このパラメータに既存のオブジェクトを指定した場合、このコマンドはそのオブジェクトの構成を使用して、ローカルまたはターゲット サーバーにそのオブジェクトの完全なコピーを作成します。

UsePreferMessageFormat

省略可能

System.Boolean

このパラメータを TRUE に設定すると、このユーザーに送信されるメールのグローバル設定は受信者優先メッセージ形式の設定に変更されます。

入力の種類

戻り値の種類

エラー

エラー 説明

例外

例外 説明

例

次の例は、New-MailContact コマンドを使用して、メールが有効な新しい連絡先を作成しています。

New-MailContact -Name "Ted Bremer" -ExternalEmailAddress "ted@tailspintoys.com" -OrganizationalUnit "Marketing"

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