次の方法で共有


Set-MailUser (RTM)

 

適用先: Exchange Server 2007

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

Set-MailUser コマンドレットを使用して、Active Directory ディレクトリ サービス内の既存のユーザーのメール関連属性を変更します。

構文

set-MailUser -Identity <MailUserIdParameter> [-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>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UserPrincipalName <String>] [-WindowsEmailAddress <SmtpAddress>]

set-MailUser [-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 <MailUser>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UserPrincipalName <String>] [-WindowsEmailAddress <SmtpAddress>]

解説

Active Directory 内のメールが有効なユーザーのメール関連属性を変更するには、Set-MailUser コマンドレットを使用します。

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

  • Exchange 受信者管理者の役割

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

note注 :
ユーザー属性の一部は Set-MailUser コマンドレットでは変更できません。メール関連ではないその他のユーザー属性は、Set-User コマンドレットで設定できます。

パラメータ

パラメータ 必須 種類 説明

Identity

必須

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

Identity パラメータには、次のいずれかの値を指定します。

  • ADObjectID
  • GUID
  • 識別名 (DN)
  • ドメイン\SAM アカウント名
  • ユーザー プリンシパル名 (UPN)
  • 従来の DN
  • 電子メール アドレス
  • ユーザー エイリアス
  • Instance パラメータを指定した場合、Identity パラメータは使用できません。

AcceptMessagesOnlyFrom

省略可能

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

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

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

AcceptMessagesOnlyFromDLMembers

省略可能

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

  • 識別名 (DN)
  • 正規名
  • GUID
  • Name
  • 表示名
  • 従来の 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 パラメータでは、定義済みの電子メール アドレス ポリシーに基づいてメールボックスの電子メール アドレスを自動的に更新するかどうかを指定します。このパラメータが $true に設定されている場合、PrimarySmtpAddress パラメータや WindowsEmailAddress パラメータを変更することはできません。

Extensions

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータは、ユーザーに対して 1 つ以上の内線番号を指定します。このパラメータを設定する場合、ダイヤル プラン内のすべての内線番号は一意である必要があります。

ExternalEmailAddress

省略可能

Microsoft.Exchange.Data.ProxyAddress

ExternalEmailAddress パラメータには、組織の外部の電子メール アドレスを指定します。このユーザーに送信された電子メール メッセージは、この外部アドレスに送信されます。

GrantSendOnBehalfTo

省略可能

Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter[]

GrantSendOnBehalfTo パラメータには、このユーザーの代わりにメッセージを送信できる受信者の識別名 (DN) を指定します。

HiddenFromAddressListsEnabled

省略可能

System.Boolean

HiddenFromAddressListsEnabled パラメータでは、ユーザーをアドレス一覧に表示するかどうかを指定します。既定値は $false です。

Instance

省略可能

Microsoft.Exchange.Data.Directory.Management.MailUser

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)。

指定しない場合、サイズは制限されません。

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 アドレスを指定します。

RecipientLimits

省略可能

Microsoft.Exchange.Data.Unlimited

RecipientLimits パラメータには、このユーザーが送信するメッセージの最大受信者数を指定します。

RejectMessagesFrom

省略可能

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

RejectMessagesFrom パラメータに受信者を指定すると、その受信者からのメッセージを拒否します。

RejectMessagesFromDLMembers

省略可能

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

RejectMessagesFromDLMembers パラメータに配布リストのメンバを指定すると、そのメンバからのメッセージを拒否します。

RequireSenderAuthenticationEnabled

省略可能

System.Boolean

RequireSenderAuthenticationEnabled パラメータでは、認証された受信者からのメッセージのみを受け付けるかどうかを指定します。既定値は $false です。

SamAccountName

省略可能

System.String

SamAccountName パラメータには、Microsoft Windows NT 4.0、Windows 98、Windows 95、LAN Manager など、古いバージョンのオペレーティング システムを実行しているクライアントとサーバーをサポートするために使用するログオン名を指定します。この属性は 20 文字未満にする必要があります。アカウント名には、文字、数字、および次の区切り文字と記号を含めることができます。

  • !
  • #
  • $
  • %
  • ^
  • &
  • -
  • .
  • _
  • {
  • }
  • |
  • ~

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

UserPrincipalName

省略可能

System.String

UserPrincipalName パラメータには、このユーザーのユーザー プリンシパル名 (UPN) を指定します。

WindowsEmailAddress

省略可能

Microsoft.Exchange.Data.SmtpAddress

WindowsEmailAddress パラメータでは、このメールボックスの Windows 電子メール アドレスを指定します。このアドレスは Exchange では使用されません。

入力の種類

戻り値の種類

エラー

エラー 説明

 

例外

例外 説明

 

この例では、Set-MailUser コマンドを使用して、メールが有効なユーザー John Peoples の電子メール送信先になる組織外部の電子メール アドレスを設定しています。

Set-MailUser john -ExternalEmailAddress john@tailspintoys.com

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