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 の管理に必要な権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
.gif "note") 注 : |
|---|
| ユーザー属性の一部は Set-MailUser コマンドレットでは変更できません。メール関連ではないその他のユーザー属性は、Set-User コマンドレットで設定できます。 |
パラメータ
| パラメータ | 必須 | 種類 | 説明 |
|---|---|---|---|
Identity |
必須 |
Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter |
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 パラメータでは、定義済みの電子メール アドレス ポリシーに基づいてメールボックスの電子メール アドレスを自動的に更新するかどうかを指定します。このパラメータが $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 に設定されています。 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 パラメータには、メール ユーザーに送信するメッセージに対するメッセージ本文の形式を指定します。このパラメータの有効な値は次のとおりです。
既定では、このパラメータは 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 アドレスを指定します。 |
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 を参照してください。