Enable-MailContact

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

メールがまだ有効ではない既存の連絡先に電子メール機能を追加には、Enable-MailContact コマンドレットを使用します。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Enable-MailContact
      [-Identity] <ContactIdParameter>
      -ExternalEmailAddress <ProxyAddress>
      [-Alias <String>]
      [-Confirm]
      [-DisplayName <String>]
      [-DomainController <Fqdn>]
      [-MacAttachmentFormat <MacAttachmentFormat>]
      [-MessageBodyFormat <MessageBodyFormat>]
      [-MessageFormat <MessageFormat>]
      [-PrimarySmtpAddress <SmtpAddress>]
      [-UsePreferMessageFormat <Boolean>]
      [-WhatIf]
      [<CommonParameters>]

説明

Enable-MailContact コマンドレットは、Exchange で必要な電子メール属性を追加することで、既存の連絡先をメールで有効にします。メール連絡先はその他の *-MailContact コマンドレットでも認識されます。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Enable-MailContact -Identity Roland -ExternalEmailAddress "roland@tailspintoys.com"

この例では、メールが有効でない既存の連絡先のメールが有効になります。

パラメーター

-Alias

Alias パラメーターは、受信者の Exchange エイリアス (メールニックネームとも呼ばれる) を指定します。この値は、受信者を、メールが有効なオブジェクトとして識別します。同じ受信者の複数の電子メールアドレス (プロキシアドレスとも呼ばれる) と混同しないようにしてください。受信者は Alias 値を 1 つだけ持つことができます。最大の長さは 64 文字です。

Alias 値には、文字、数字、および次の文字を含めることができます。

!、#、%、*、+、-、/、=、?、^、_、~。
$、 &、'、'、{、}、|は、エスケープする必要があります (たとえば -Alias what`'snew) か、単一引用符で囲まれた値全体 (例: -Alias 'what'snew')。この & 文字は、Azure AD Connect 同期の Alias 値ではサポートされていません。
ピリオド (.) は、他の有効な文字 (例: help.desk) で囲む必要があります。
Unicode 文字 U+00A1 から U+00FF。

メールアドレスを指定せずに受信者を作成すると、指定した Alias 値を使用してプライマリメールアドレス (alias@domain) が生成されます。サポートされている Unicode 文字は、最も適した US-ASCII テキスト文字にマッピングされます。たとえば、U+00F6 (ö) はプライマリメールアドレスでに oe 変更されます。

受信者の作成時に Alias パラメーターを使用しない場合、次のように別の必須パラメーターの値が Alias プロパティの値として使用されます。

ユーザーアカウントのある受信者 (たとえば、ユーザーメールボックスやメールユーザー): MicrosoftOnlineServicesID または UserPrincipalName パラメーターの左側が使用されます。たとえば、 helpdesk@contoso.onmicrosoft.com Alias プロパティ値 helpdeskになります。
ユーザーアカウントのない受信者 (会議室メールボックス、メール連絡先、配布グループなど): Name パラメーターの値が使用されます。スペースは削除されます。サポートされていない文字は疑問符 (?) に変換されます。

既存の受信者の Alias の値を変更した場合、プライマリ電子メールアドレスは、受信者が電子メールアドレスポリシーに従う必要がある (受信者に対して EmailAddressPolicyEnabled プロパティが True になっている) 環境でのみ自動的に更新されます。

Alias パラメーターは、メール連絡先またはメールユーザーのプライマリ電子メールアドレスを生成したり更新したりすることはありません。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DisplayName

DisplayName パラメーターは、メール連絡先の表示名を指定します。表示名は、Exchange 管理センターとアドレス一覧に表示されます。最大の長さは 256 文字です。値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメインコントローラーを指定します。ドメインコントローラーは、完全修飾ドメイン名 (FQDN) で識別します。たとえば、dc01.contoso.com です。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExternalEmailAddress

ExternalEmailAddress パラメーターは、メール連絡先またはメールユーザーのターゲットメールアドレスを指定します。既定では、この値はメール連絡先またはメールユーザーのプライマリメールアドレスとして使用されます。

オンプレミス環境では、PrimarySMTPAddress パラメーターを使用して、プライマリメールアドレスを別の値に設定できます。既定では、この値はメール連絡先またはメールユーザーのプライマリ電子メールアドレスとして使用されます。

Type:	ProxyAddress
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity パラメーターは、メールの有効化を行いたい連絡先を指定します。連絡先を一意に識別する任意の値を使用できます。例:

名前
識別名 (DN)
正規 DN
GUID

Type:	ContactIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MacAttachmentFormat

MacAttachmentFormat パラメーターは、メール連絡先またはメールユーザーに送信されるメッセージに使用する Apple Macintosh オペレーティングシステムの添付ファイル形式を指定します。有効な値は次のとおりです。

BinHex (既定値です)
Uuencode
AppleSingle
AppleDouble

MacAttachmentFormat パラメーターと MessageFormat パラメーターは相互依存です。

MessageFormat は Text です。MacAttachmentFormat には BinHex または UuEncode を指定できます。
MessageFormat は Mime です。MacAttachmentFormat には、BinHex、AppleSingle、または AppleDouble を指定できます。

Type:	MacAttachmentFormat
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MessageBodyFormat

MessageBodyFormat パラメーターは、メール連絡先またはメールユーザーに送信されるメッセージのメッセージ本文の形式を指定します。有効な値は次のとおりです。

テキスト
HTML
Html

MessageFormat パラメーターと MessageBodyFormat パラメーターは相互に依存しています。

MessageFormat は Mime です。MessageBodyFormat には、Text、Html、TextAndHtml を指定できます。
MessageFormat は Text です。MessageBodyFormat には Text のみを指定できます。

Type:	MessageBodyFormat
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MessageFormat

MessageFormat パラメーターは、メール連絡先またはメールユーザーに送信されるメッセージのメッセージ形式を指定します。有効な値は次のとおりです。

テキスト
Text

MessageFormat パラメーターと MessageBodyFormat パラメーターは相互に依存しています。

MessageFormat は Mime です。MessageBodyFormat には、Text、Html、TextAndHtml を指定できます。
MessageFormat は Text です。MessageBodyFormat には Text のみを指定できます。

このため、MessageFormat パラメーターを Mime から Text に変更する場合、MessageBodyFormat パラメーターも Text に変更する必要があります。

Type:	MessageFormat
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-PrimarySmtpAddress

PrimarySmtpAddress パラメーターは、受信者の返信用プライマリメールアドレスを指定します。

既定で、プライマリアドレスは ExternalEmailAddress パラメーター値と同じになります。

PrimarySmtpAddress パラメーターを使用して、プライマリメールアドレスを指定する場合、コマンドによってメール連絡先の EmailAddressPolicyEnabled プロパティが False に設定され、メール連絡先の電子メールアドレスは電子メールアドレスポリシーによって今後自動更新されなくなります。フォレスト間設定を行っている場合を除いて、プライマリ電子メールアドレスを ExternalEmailAddress の値以外に設定しないことをお勧めします。

Type:	SmtpAddress
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-UsePreferMessageFormat

UsePreferMessageFormat は、メールユーザーまたはメール連絡先に対して構成されたメッセージ形式の設定が、リモートドメイン用に構成されたグローバル設定またはメッセージ送信者によって構成されたグローバル設定をオーバーライドするかどうかを指定します。有効な値は次のとおりです。

$true: メールユーザーまたはメール連絡先に送信されるメッセージは、メールユーザーまたはメール連絡先用に構成されたメッセージ形式を使用します。
$false: メールユーザーまたはメール連絡先に送信されるメッセージは、リモートドメイン (既定のリモートドメインまたは特定のリモートドメイン) 用に構成されているか、メッセージ送信者によって構成されたメッセージ形式を使用します。これは既定の値です。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

WhatIf スイッチは、コマンドの操作をシミュレートします。このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。