Set-MailContact

 

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

トピックの最終更新日: 2011-01-26

Set-MailContact コマンドレットを使用して、Active Directory ディレクトリ サービスでメールが有効な既存の連絡先を変更します。

構文

Set-MailContact -Identity <MailContactIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-MailContact [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <MailContact>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

解説

Set-MailContact コマンドレットでは、変更する連絡先の ID と属性を指定して、Active Directory 内でメールが有効な既存の連絡先に変更を加えます。

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

• Exchange 受信者管理者の役割

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

パラメータ

パラメータ	必須かどうか	種類	説明
Identity	必須	Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter	Identity パラメータには、次のいずれかの値を指定します。 ADObjectID GUID 識別名 (DN) ドメイン\SAM アカウント名 ユーザー プリンシパル名 (UPN) 従来の DN 電子メール アドレス 連絡先のエイリアス
AcceptMessagesOnlyFrom	省略可能	Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]	AcceptMessagesOnlyFrom パラメータには、このメール連絡先に電子メール メッセージを送信できるメールボックス ユーザー、メール ユーザー、およびメール連絡先を指定します。このパラメータの有効な受信者として Microsoft Exchange を指定することもできます。Microsoft Exchange 受信者からのメッセージのみを受け付けるようにメール連絡先を構成すると、システム生成メッセージのみを受信するようになります。 AcceptMessagesOnlyFrom パラメータには、有効な送信者の次のいずれかの値を指定できます。 識別名 (DN) 正規名 GUID 名前 表示名 エイリアス Exchange DN プライマリ SMTP 電子メール アドレス 既定では、このパラメータは空白になっています。この既定値を使用すると、メール連絡先はすべての送信者からメッセージを受け付けることができます。
AcceptMessagesOnlyFromDLMembers	省略可能	Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]	AcceptMessagesOnlyFromDLMembers パラメータには、このメール連絡先に電子メール メッセージを送信することを許可するメンバが含まれる配布グループを指定します。許可する配布グループには次のいずれかの値を指定できます。 識別名 (DN) 正規名 GUID 名前 表示名 従来の Exchange DN プライマリ SMTP 電子メール アドレス 既定では、このパラメータは空白になっています。この既定値を使用すると、メール連絡先はすべての送信者からメッセージを受け付けることができます。
Alias	省略可能	System.String	Alias パラメータには、メールが有効な連絡先のエイリアスを指定します。エイリアスには、文字、数字、および次の区切り文字と記号を含めることができます。 ! # $ % ^ & * + - . / = ? _ { } | ~
Confirm	省略可能	System.Management.Automation.SwitchParameter	Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには、コマンドの処理内容を確認する必要があります。Confirm パラメータに値を指定する必要はありません。
CreateDTMFMap	省略可能	System.Boolean	このパラメータには、連絡先のデュアル トーン多重周波数 (DTMF) マップを作成することを指定します。
CustomAttribute1	省略可能	System.String	CustomAttribute1 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute10	省略可能	System.String	CustomAttribute10 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute11	省略可能	System.String	CustomAttribute11 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute12	省略可能	System.String	CustomAttribute12 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute13	省略可能	System.String	CustomAttribute13 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute14	省略可能	System.String	CustomAttribute14 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute15	省略可能	System.String	CustomAttribute15 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute2	省略可能	System.String	CustomAttribute2 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute3	省略可能	System.String	CustomAttribute3 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute4	省略可能	System.String	CustomAttribute4 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute5	省略可能	System.String	CustomAttribute5 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute6	省略可能	System.String	CustomAttribute6 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute7	省略可能	System.String	CustomAttribute7 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute8	省略可能	System.String	CustomAttribute8 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
CustomAttribute9	省略可能	System.String	CustomAttribute9 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。
DisplayName	省略可能	System.String	DisplayName パラメータには、ユーザーの表示名を指定します。
DomainController	省略可能	Microsoft.Exchange.Data.Fqdn	この構成の変更を Active Directory に書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドに DomainController パラメータを含めます。
EmailAddresses	省略可能	Microsoft.Exchange.Data.ProxyAddressCollection	EmailAddresses パラメータを使用して、メール連絡先の電子メール エイリアスを指定できます。すべての有効な Microsoft Exchange 2007 電子メール アドレスの種類を使用できます。EmailAddresses パラメータに複数の値を指定するには、値をコンマで区切ります。 重要 : Exchange 2007 は、カスタム アドレスが正しい形式かどうかを検証しません。指定するカスタム アドレスが、そのアドレスの種類の書式要件に従っていることを確認する必要があります。X.400 アドレスは Exchange 2007 のカスタム アドレスと見なされるので、それらも検証されません。このため、X.400 アドレスを指定する場合は、正しい構文を使用する必要があります。
EmailAddressPolicyEnabled	省略可能	System.Boolean	EmailAddressPolicyEnabled パラメータでは、定義済みの電子メール アドレス ポリシーに基づいてメールボックスの電子メール アドレスを自動的に更新するかどうかを指定します。
Extensions	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	このパラメータには、連絡先に対して 1 つ以上の内線番号を指定します。このパラメータを設定する場合、ダイヤル プラン内のすべての内線番号は一意である必要があります。
ExternalEmailAddress	省略可能	Microsoft.Exchange.Data.ProxyAddress	ExternalEmailAddress パラメータには、受信者の外部電子メール アドレスを指定します。
GrantSendOnBehalfTo	省略可能	Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter	GrantSendOnBehalfTo パラメータには、この連絡先の代わりにメッセージを送信できる受信者の識別名 (DN) を指定します。
HiddenFromAddressListsEnabled	省略可能	System.Boolean	HiddenFromAddressListsEnabled パラメータでは、連絡先をアドレス一覧に表示するかどうかを指定します。値が $true の場合、連絡先はアドレス一覧に表示されません。既定値は $false です。
IgnoreDefaultScope	省略可能	System.Management.Automation.SwitchParameter	IgnoreDefaultScope パラメータを指定すると、Exchange 管理シェルの受信者の範囲の既定の設定が無視され、範囲としてフォレスト全体が使用されます。これにより、現在既定の範囲にない Active Directory オブジェクトにアクセスすることができます。IgnoreDefaultScope パラメータを使用すると、次の制限が発生します。 DomainController パラメータは使用できません。このコマンドでは、適切なグローバル カタログ サーバーを自動的に使用します。 Identity パラメータの DN しか使用できません。エイリアスや GUID などの他の形式の ID は使用できません。
Instance	省略可能	Microsoft.Exchange.Data.Directory.Management.MailContact	Instance パラメータを使用すると、オブジェクト全体をコマンドに渡して処理することができます。オブジェクト全体をコマンドに渡す必要があるスクリプトで主に使用されます。
MacAttachmentFormat	省略可能	Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat	MacAttachmentFormat パラメータには、メール連絡先に送信するメッセージに対する Apple Macintosh オペレーティング システムの添付ファイル形式を指定します。このパラメータの有効な値は次のとおりです。 BinHex AppleSingle AppleDouble 既定では、このパラメータは BinHex に設定されています。 MacAttachmentFormat パラメータに使用できる値は、MessageFormat パラメータに依存します。MessageFormat パラメータが Text に設定されている場合、このパラメータには BinHex 値のみを使用できます。MessageFormat パラメータが Mime に設定されている場合、このパラメータには BinHex、AppleSingle または AppleDouble 値のみが使用できます。
MaxReceiveSize	省略可能	Microsoft.Exchange.Data.Unlimited	MaxReceiveSize パラメータには、受信できる電子メール メッセージの最大サイズを指定します (1 ～ 2,097,151 KB)。 値が指定されていない場合、制限値は最大値に設定されます。
MaxRecipientPerMessage	省略可能	Microsoft.Exchange.Data.Unlimited	MaxRecipientPerMessage パラメータには、このメール連絡先が送信するメッセージの最大受信者数を指定します。
MaxSendSize	省略可能	Microsoft.Exchange.Data.Unlimited	MaxSendSize パラメータには、送信できる電子メール メッセージの最大サイズを指定します (1 ～ 2,097,151 KB)。 値が指定されていない場合、制限値は最大値に設定されます。
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 に変更する必要もあります。
Name	省略可能	System.String	Name パラメータには、メールが有効な連絡先の名前を指定します。
PrimarySmtpAddress	省略可能	Microsoft.Exchange.Data.SmtpAddress	PrimarySmtpAddress パラメータには、プライマリ SMTP 電子メール アドレスを指定します。
RejectMessagesFrom	省略可能	Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]	RejectMessagesFrom パラメータに受信者を指定すると、その受信者からのメッセージを拒否します。
RejectMessagesFromDLMembers	省略可能	Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]	RejectMessagesFromDLMembers パラメータに配布リストのメンバを指定すると、そのメンバからのメッセージを拒否します。
RequireSenderAuthenticationEnabled	省略可能	System.Boolean	RequireSenderAuthenticationEnabled パラメータでは、認証された受信者からのメッセージのみを受け付けるかどうかを指定します。既定値は $false です。
SecondaryAddress	省略可能	System.String	このパラメータには、UM が有効な連絡先が使用するセカンダリ アドレスを指定します。
SecondaryDialPlan	省略可能	Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter	このパラメータには、使用するセカンダリ UM ダイヤル プランを指定します。このパラメータは、セカンダリ プロキシ アドレスを作成するために指定します。
SimpleDisplayName	省略可能	System.String	SimpleDisplayName パラメータは、使用できる文字が限定されている場合にオブジェクトの代替説明を表示するために使用されます。使用できる文字は、26 ～ 126 の範囲の ASCII 文字に限定されています。
UMDtmfMap	省略可能	Microsoft.Exchange.Data.MultiValuedProperty	このパラメータには、UM が有効な連絡先のユーザー定義 DTMF マップを作成するかどうかを指定します。
UseMapiRichTextFormat	省略可能	Microsoft.Exchange.Data.Directory.Recipient.UseMapiRichTextFormat	UseMapiRichTextFormat パラメータには、このメール連絡先のために、MAPI リッチ テキスト形式 (RTF) のメッセージをどのように処理するかを指定します。この連絡先に送信されたすべてのメッセージをテキスト形式に変換する場合は、このパラメータを Never に設定します。この連絡先には、メッセージを常に MAPI RTF 形式で送信する場合は、このパラメータを Always に設定します。メッセージを送信した MAPI クライアントで構成されている設定に基づいて形式を決定する場合は、このパラメータを UseDefaultSettings に設定します。
UsePreferMessageFormat	省略可能	System.Boolean	UsePreferMessageFormat パラメータでは、メール連絡先で構成されているメッセージ形式の設定を、リモート ドメインで構成されているグローバル設定より優先するかどうかを指定します。メール連絡先で構成されているメッセージ形式の設定を、すべてのグローバル設定より優先する場合は、このパラメータを $true に設定します。
UseRusServer	省略可能	System.String	注 : このパラメータは Exchange 2007 SP2 でのみ使用できます。 UseRusServer パラメータを指定すると、このコマンドで、アドレス一覧サービスを実行している指定のメールボックス サーバーを使用してメールボックスと Active Directory ユーザー属性が取得され、それらが設定されるようになります。 アドレス一覧サービスは、Exchange System Attendant サービスのコンポーネントです。アドレス一覧サービスは、Active Directory において Exchange 固有の属性値を作成および管理します。アドレス一覧サービスを使用すると、アドレス一覧メンバシップや電子メール アドレスなどの特定の情報を使用して、ドメイン内の受信者オブジェクトを更新できます。
WhatIf	省略可能	System.Management.Automation.SwitchParameter	WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータに値を指定する必要はありません。
WindowsEmailAddress	省略可能	Microsoft.Exchange.Data.SmtpAddress	WindowsEmailAddress パラメータでは、このメールボックスの Windows 電子メール アドレスを指定します。このアドレスは Exchange では使用されません。

入力の種類

戻り値の種類

エラー

エラー	説明

例外

例外	説明

例

この例では、Set-MailContact コマンドを使用して、John Peoples の外部電子メール アドレスを john@contoso.com に設定しています。

Set-MailContact -Identity "John Peoples" -ExternalEmailAddress "john@contoso.com"

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