Set-MailUser
適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
トピックの最終更新日: 2010-10-21
Set-MailUser コマンドレットを使用して、Active Directory ディレクトリ サービス内の既存のユーザーのメール関連属性を変更します。
構文
set-MailUser -Identity <MailUserIdParameter> [-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>] [-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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
set-MailUser [-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 <MailUser>] [-MacAttachmentFormat <BinHex | 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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
解説
Active Directory 内のメールが有効なユーザーのメール関連属性を変更するには、Set-MailUser コマンドレットを使用します。
Set-MailUser コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。
- Exchange 受信者管理者の役割
Microsoft Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
.gif "note") 注 : |
|---|
| ユーザー属性の一部は Set-MailUser コマンドレットでは変更できません。メール関連ではないその他のユーザー属性は、Set-User コマンドレットで設定できます。 |
パラメータ
| パラメータ | 必須かどうか | 種類 | 説明 | ||
|---|---|---|---|---|---|
Identity |
必須 |
Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter |
Identity パラメータには、次のいずれかの値を指定します。
|
||
AcceptMessagesOnlyFrom |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
AcceptMessagesOnlyFrom パラメータには、このメール ユーザーに電子メール メッセージを送信できるメールボックス ユーザー、メール ユーザー、およびメール連絡先を指定します。このパラメータの有効な受信者として Microsoft Exchange を指定することもできます。Microsoft Exchange 受信者からのメッセージのみを受け付けるようにメール ユーザーを構成すると、システム生成メッセージのみを受信するようになります。 AcceptMessagesOnlyFrom パラメータには、有効な送信者の次のいずれかの値を指定できます。
既定では、このパラメータは空白になっています。この既定値を使用すると、メール ユーザーはすべての送信者からメッセージを受け付けることができます。 |
||
AcceptMessagesOnlyFromDLMembers |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
AcceptMessagesOnlyFromDLMembers パラメータには、このメール ユーザーに電子メール メッセージを送信することを許可するメンバが含まれる配布グループを指定します。許可する配布グループには次のいずれかの値を指定できます。
既定では、このパラメータは空白になっています。この既定値を使用すると、メール ユーザーはすべての送信者からメッセージを受け付けることができます。 |
||
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 パラメータに複数の値を指定するには、値をコンマで区切ります。
|
||
EmailAddressPolicyEnabled |
省略可能 |
System.Boolean |
EmailAddressPolicyEnabled パラメータでは、定義済みの電子メール アドレス ポリシーに基づいてメールボックスの電子メール アドレスを自動的に更新するかどうかを指定します。このパラメータが $true に設定されている場合、PrimarySmtpAddress パラメータや WindowsEmailAddress パラメータを変更することはできません。 |
||
Extensions |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
このパラメータには、ユーザーに対して 1 つ以上の内線番号を指定します。このパラメータを設定する場合、ダイヤル プラン内のすべての内線番号は一意である必要があります。 |
||
ExternalEmailAddress |
省略可能 |
Microsoft.Exchange.Data.ProxyAddress |
ExternalEmailAddress パラメータには、組織の外部の電子メール アドレスを指定します。このユーザーに送信された電子メール メッセージは、この外部アドレスに送信されます。 |
||
GrantSendOnBehalfTo |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter |
GrantSendOnBehalfTo パラメータには、このユーザーの代わりにメッセージを送信できる受信者の識別名 (DN) を指定します。 |
||
HiddenFromAddressListsEnabled |
省略可能 |
System.Boolean |
HiddenFromAddressListsEnabled パラメータでは、ユーザーをアドレス一覧に表示するかどうかを指定します。既定値は $false です。 |
||
IgnoreDefaultScope |
省略可能 |
System.Management.Automation.SwitchParameter |
IgnoreDefaultScope パラメータを指定すると、Exchange 管理シェルの受信者の範囲の既定の設定が無視され、範囲としてフォレスト全体が使用されます。これにより、現在既定の範囲にない Active Directory オブジェクトにアクセスすることができます。IgnoreDefaultScope パラメータを使用すると、次の制限が発生します。
|
||
Instance |
省略可能 |
Microsoft.Exchange.Data.Directory.Management.MailUser |
Instance パラメータを使用すると、オブジェクト全体をコマンドに渡して処理することができます。オブジェクト全体をコマンドに渡す必要があるスクリプトで主に使用されます。 |
||
MacAttachmentFormat |
省略可能 |
Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat |
MacAttachmentFormat パラメータには、メール ユーザーに送信するメッセージに対する Apple Macintosh オペレーティング システムの添付ファイル形式を指定します。このパラメータの有効な値は次のとおりです。
既定では、このパラメータは BinHex に設定されています。 MacAttachmentFormat パラメータに使用できる値は、MessageFormat パラメータに依存します。MessageFormat パラメータが Text に設定されている場合、このパラメータには BinHex 値のみを使用できます。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 パラメータは、使用できる文字が限定されている場合にオブジェクトの代替説明を表示するために使用されます。使用できる文字は、以下の文字に限定されています。 abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:? |
||
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) を指定します。 |
||
UseRusServer |
省略可能 |
System.String |
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 では使用されません。 |
.gif "important")
重要 :入力の種類
戻り値の種類
エラー
| エラー | 説明 |
|---|---|
|
例外
| 例外 | 説明 |
|---|---|
|
例
この例では、Set-MailUser コマンドを使用して、メールが有効なユーザー John Peoples の電子メール送信先になる組織外部の電子メール アドレスを設定しています。
Set-MailUser john -ExternalEmailAddress john@tailspintoys.com
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。