New-MailContact

 

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

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

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

構文

New-MailContact -Name <String> -ExternalEmailAddress <ProxyAddress> [-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>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

解説

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

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

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

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

パラメータ

パラメータ	必須	種類	説明
ExternalEmailAddress	必須	Microsoft.Exchange.Data.ProxyAddress	送信先の電子メール アドレスです。
Name	必須	System.String	メール連絡先の共通名です。
Alias	省略可能	System.String	メール連絡先のエイリアスです。
Confirm	省略可能	System.Management.Automation.SwitchParameter	Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには、コマンドの処理内容を確認する必要があります。Confirm パラメータで値を指定する必要はありません。
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 に変更する必要もあります。
OrganizationalUnit	省略可能	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	新しい連絡先が追加される組織単位です。たとえば、redmond.contoso.com/contacts です。
PrimarySmtpAddress	省略可能	Microsoft.Exchange.Data.SmtpAddress	メール連絡先のプライマリ SMTP アドレスを指定するには、このパラメータを使用します。既定では、プライマリ SMTP アドレスは、既定の電子メール アドレス ポリシーに基づいて生成されます。このパラメータを使用してプライマリ SMTP アドレスを指定した場合、コマンドレットは、メール連絡先の EmailAddressPolicyEnabled 属性を $false に設定します。また、このメール連絡先の電子メール アドレスが、電子メール アドレス ポリシーに基づいて自動的に更新されることはありません。
TemplateInstance	省略可能	System.Management.Automation.PSObject	このパラメータに既存のオブジェクトを指定した場合、このコマンドはそのオブジェクトの構成を使用して、ローカルまたはターゲット サーバーにそのオブジェクトの完全なコピーを作成します。
UsePreferMessageFormat	省略可能	System.Boolean	このパラメータを TRUE に設定すると、このユーザーに送信されるメールのグローバル設定は受信者優先メッセージ形式の設定に変更されます。
UseRusServer	省略可能	System.String	注 : このパラメータは Exchange 2007 SP2 でのみ使用できます。 UseRusServer パラメータを指定すると、このコマンドで、アドレス一覧サービスを実行している指定のメールボックス サーバーを使用してメールボックスと Active Directory ユーザー属性が取得され、それらが設定されるようになります。 アドレス一覧サービスは、Exchange System Attendant サービスのコンポーネントです。アドレス一覧サービスは、Active Directory において Exchange 固有の属性値を作成および管理します。アドレス一覧サービスを使用すると、アドレス一覧メンバシップや電子メール アドレスなどの特定の情報を使用して、ドメイン内の受信者オブジェクトを更新できます。
WhatIf	省略可能	System.Management.Automation.SwitchParameter	WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータで値を指定する必要はありません。

入力の種類

戻り値の種類

エラー

エラー	説明

例外

例外	説明

例

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

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

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