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 パラメータには、次のいずれかの値を指定します。

  • ADObjectID
  • GUID
  • 識別名 (DN)
  • ドメイン\SAM アカウント名
  • ユーザー プリンシパル名 (UPN)
  • 従来の DN
  • 電子メール アドレス
  • 連絡先のエイリアス

AcceptMessagesOnlyFrom

省略可能

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

AcceptMessagesOnlyFrom パラメータには、このメール連絡先に電子メール メッセージを送信できる受信者を指定します。有効な送信者には次のいずれかの値を指定できます。

  • 識別名 (DN)
  • 正規名
  • GUID
  • 名前
  • 表示名
  • エイリアス
  • 従来の Exchange DN
  • プライマリ SMTP (簡易メール転送プロトコル) 電子メール アドレス

既定では、このパラメータは空白になっています。この既定値を使用すると、メール連絡先はすべての受信者からメッセージを受け付けることができます。

AcceptMessagesOnlyFromDLMembers

省略可能

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

AcceptMessagesOnlyFromDLMembers パラメータには、このメール連絡先に電子メール メッセージを送信することを許可する配布グループを指定します。許可する配布グループには次のいずれかの値を指定できます。

  • 識別名 (DN)
  • 正規名
  • GUID
  • 名前
  • 表示名
  • 従来の Exchange DN
  • プライマリ SMTP 電子メール アドレス

既定では、このパラメータは空白になっています。

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
  • UUENCODE
  • AppleSingle
  • AppleDouble

既定では、このパラメータは 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 パラメータには、メール連絡先に送信されるメッセージのメッセージ本文の形式を指定します。このパラメータの有効な値は次のとおりです。

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

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 を参照してください。