Set-MailContact (RTM)
適用先: Exchange Server 2007
トピックの最終更新日: 2007-06-05
Set-MailContact コマンドレットを使用して、Active Directory ディレクトリ サービスでメールが有効な既存の連絡先を変更します。
構文
Set-MailContact -Identity <MailContactIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-MacAttachmentFormat <BinHex | UuEncode | 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>] [-WindowsEmailAddress <SmtpAddress>]
Set-MailContact [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-Instance <MailContact>] [-MacAttachmentFormat <BinHex | UuEncode | 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>] [-WindowsEmailAddress <SmtpAddress>]
解説
Set-MailContact コマンドレットでは、変更する連絡先の ID と属性を指定して、Active Directory 内でメールが有効な既存の連絡先に変更を加えます。
Set-MailContact コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。
- Exchange 受信者管理者の役割
Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
| パラメータ | 必須かどうか | 種類 | 説明 |
|---|---|---|---|
Identity |
必須 |
Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter |
Identity パラメータには、次のいずれかの値を指定します。
|
AcceptMessagesOnlyFrom |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
AcceptMessagesOnlyFrom パラメータには、このメール連絡先に電子メール メッセージを送信できる受信者を指定します。有効な送信者には次のいずれかの値を指定できます。
既定では、このパラメータは空白になっています。この既定値を使用すると、メール連絡先はすべての受信者からメッセージを受け付けることができます。 |
AcceptMessagesOnlyFromDLMembers |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
AcceptMessagesOnlyFromDLMembers パラメータには、このメール連絡先に電子メール メッセージを送信することを許可する配布グループを指定します。許可する配布グループには次のいずれかの値を指定できます。
既定では、このパラメータは空白になっています。 |
Alias |
省略可能 |
System.String |
Alias パラメータには、メールが有効な連絡先のエイリアスを指定します。エイリアスには、文字、数字、および次の区切り文字と記号を含めることができます。
|
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 パラメータには、配布リストのプロキシ電子メール アドレスを指定します。 |
EmailAddressPolicyEnabled |
省略可能 |
System.Boolean |
EmailAddressPolicyEnabled パラメータでは、定義済みの電子メール アドレス ポリシーに基づいてメールボックスの電子メール アドレスを自動的に更新するかどうかを指定します。 |
Extensions |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
このパラメータには、連絡先に対して 1 つ以上の内線番号を指定します。このパラメータを設定する場合、ダイヤル プラン内のすべての内線番号は一意である必要があります。 |
ExternalEmailAddress |
省略可能 |
Microsoft.Exchange.Data.ProxyAddress |
ExternalEmailAddress パラメータには、受信者の外部電子メール アドレスを指定します。 |
GrantSendOnBehalfTo |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter[] |
GrantSendOnBehalfTo パラメータには、この連絡先の代わりにメッセージを送信できる受信者の識別名 (DN) を指定します。 |
HiddenFromAddressListsEnabled |
省略可能 |
System.Boolean |
HiddenFromAddressListsEnabled パラメータでは、連絡先をアドレス一覧に表示するかどうかを指定します。値が $true の場合、連絡先はアドレス一覧に表示されません。既定値は $false です。 |
Instance |
省略可能 |
Microsoft.Exchange.Data.Directory.Management.MailContact |
Instance パラメータを使用すると、オブジェクト全体をコマンドに渡して処理することができます。オブジェクト全体をコマンドに渡す必要があるスクリプトで主に使用されます。 |
MacAttachmentFormat |
省略可能 |
Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat |
MacAttachmentFormat パラメータには、メール連絡先に送信されるメッセージの、Apple Macintosh オペレーティング システムの添付ファイルの形式を指定します。このパラメータの有効な値は次のとおりです。
既定では、このパラメータは BinHex に設定されています。 MacAttachmentFormat パラメータに使用できる値は、MessageFormat パラメータに依存します。MessageFormat パラメータが Text に設定されている場合、このパラメータには BinHex または UUENCODE 値のみが使用できます。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 パラメータには、メール連絡先に送信されるメッセージのメッセージ本文の形式を指定します。このパラメータの有効な値は次のとおりです。
既定では、このパラメータは TextAndHtml に設定されています。 MessageFormat パラメータと MessageBodyFormat パラメータは相互に依存します。MessageFormat パラメータが Mime に設定されている場合、MessageBodyFormat パラメータは任意の値に設定可能です。ただし、MessageFormat パラメータが Text に設定されている場合、MessageBodyFormat パラメータは Text にのみ設定することができます。そのため、このパラメータを Html または TextAndHtml に設定する必要がある場合は、MessageFormat パラメータも Mime に設定する必要があります。 |
MessageFormat |
省略可能 |
Microsoft.Exchange.Data.Directory.Recipient.MessageFormat |
MessageFormat パラメータには、メール連絡先に送信されるメッセージのメッセージ形式を指定します。 このパラメータの有効な値は次のとおりです。
既定では、このパラメータは 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 に設定します。 |
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 を参照してください。