New-MailContact
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターと設定は、1 つの環境または他の環境に限定される場合があります。
New-MailContact コマンドレットは、メール連絡先を作成するために使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
New-MailContact
-Name <String>
-ExternalEmailAddress <ProxyAddress>
[-Alias <String>]
[-ArbitrationMailbox <MailboxIdParameter>]
[-Confirm]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-FirstName <String>]
[-Initials <String>]
[-LastName <String>]
[-MacAttachmentFormat <MacAttachmentFormat>]
[-MessageBodyFormat <MessageBodyFormat>]
[-MessageFormat <MessageFormat>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-PrimarySmtpAddress <SmtpAddress>]
[-SendModerationNotifications <TransportModerationNotificationFlags>]
[-UsePreferMessageFormat <Boolean>]
[-WhatIf]
[<CommonParameters>]
説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
New-MailContact -Name "Chris Ashton" -ExternalEmailAddress "chris@tailspintoys.com"
この例では、Chris Ashton という名前の新しいメール連絡先を作成します。
パラメーター
-Alias
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
Alias パラメーターは、受信者の Exchange エイリアス (メール ニックネームとも呼ばれる) を指定します。 この値は、受信者を、メールが有効なオブジェクトとして識別します。同じ受信者の複数の電子メール アドレス (プロキシ アドレスとも呼ばれる) と混同しないようにしてください。 受信者は Alias 値を 1 つだけ持つことができます。 最大の長さは 64 文字です。
エイリアス値には、文字、数字、および次の文字を含めることができます。
- !、#、%、*、+、-、/、=、?、^、_、~。
- $、&、'、`、{、}、| はエスケープするか (例:
-Alias what`'snew)、値全体が単一引用符で囲まれている必要があります (例:-Alias 'what'snew')。 & 文字は、Microsoft Entra Connect 同期のエイリアス値ではサポートされていません。 - ピリオド (.) は、その他の有効な文字で囲む必要があります (たとえば、
help.desk)。 - Unicode 文字 U+00A1 から U+00FF。
電子メール アドレスを指定せずに受信者を作成した場合、指定したエイリアス値がプライマリ電子メール アドレス (alias@___domain) の生成に使用されます。 サポートされている Unicode 文字は、最も適した US-ASCII テキスト文字にマッピングされます。 たとえば、U+00F6 (ö) はプライマリ電子メール アドレスで oe に変更されます。
受信者の作成時に Alias パラメーターを使用しない場合、次のように別の必須パラメーターの値が Alias プロパティの値として使用されます。
- ユーザー アカウントのある受信者 (たとえば、ユーザー メールボックスやメール ユーザー): MicrosoftOnlineServicesID または UserPrincipalName パラメーターの左側が使用されます。 たとえば、helpdesk@contoso.onmicrosoft.com はエイリアスのプロパティの値
helpdeskになります。 - ユーザー アカウントのない受信者 (たとえば、会議室メールボックス、メール連絡先、配布グループ): Name パラメーターの値が使用されます。 スペースは削除されます。サポートされていない文字は疑問符 (?) に変換されます。
既存の受信者の Alias の値を変更した場合、プライマリ電子メール アドレスは、受信者が電子メール アドレス ポリシーに従う必要がある (受信者に対して EmailAddressPolicyEnabled プロパティが True になっている) 環境でのみ自動的に更新されます。
Alias パラメーターは、メール連絡先またはメール ユーザーのプライマリ電子メール アドレスを生成したり更新したりすることはありません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ArbitrationMailbox
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ArbitrationMailbox パラメーターは、この受信者のモデレート処理を管理するために使用される調停メールボックスを指定します。 調停メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- ドメイン\ユーザー名
- 電子メール アドレス
- GUID
- LegacyExchangeDN
- SamAccountName
- ユーザー ID またはユーザー プリンシパル名 (UPN)
パラメーターのプロパティ
| 型: | MailboxIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DisplayName
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
DisplayName パラメーターは、メール連絡先の表示名を指定します。 この表示名が Exchange 管理センター、アドレス一覧に表示されます。 最大の長さは 256 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
DisplayName パラメーターを使用しなかった場合は、Name パラメーターの値が表示名として使用されます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExternalEmailAddress
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
ExternalEmailAddress パラメーターは、メール連絡先またはメール ユーザーのターゲット メール アドレスを指定します。 既定では、この値はメール連絡先またはメール ユーザーのプライマリ メール アドレスとして使用されます。
オンプレミス環境では、PrimarySMTPAddress パラメーターを使用して、プライマリ メール アドレスを別の値に設定できます。 既定では、この値はメール連絡先またはメール ユーザーのプライマリ電子メール アドレスとして使用されます。
パラメーターのプロパティ
| 型: | ProxyAddress |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FirstName
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
FirstName パラメーターには、ユーザーの名を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Initials
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
Initials パラメーターには、ユーザーのミドル ネームのイニシャルを指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LastName
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
LastName パラメーターには、ユーザーの姓を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MacAttachmentFormat
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
MacAttachmentFormat パラメーターは、メール連絡先またはメール ユーザーに送信されるメッセージに使用する Apple Macintosh オペレーティング システムの添付ファイル形式を指定します。 有効な値は次のとおりです。
- BinHex (既定値)
- UuEncode
- AppleSingle
- AppleDouble
MacAttachmentFormat パラメーターと MessageFormat パラメーターは相互依存です。
- MessageFormat は Text です。MacAttachmentFormat には BinHex または UuEncode を指定できます。
- MessageFormat は Mime です。MacAttachmentFormat には、BinHex、AppleSingle、または AppleDouble を指定できます。
パラメーターのプロパティ
| 型: | MacAttachmentFormat |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MessageBodyFormat
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
MessageBodyFormat パラメーターは、メール連絡先またはメール ユーザーに送信されるメッセージのメッセージ本文の形式を指定します。 有効な値は次のとおりです。
- テキスト
- HTML
- TextAndHtml (既定値)
MessageFormat パラメーターと MessageBodyFormat パラメーターは相互に依存しています。
- MessageFormat は Mime です。MessageBodyFormat には、Text、Html、または TextAndHtml を指定できます。
- MessageFormat は Text です。MessageBodyFormat には Text のみを指定できます。
パラメーターのプロパティ
| 型: | MessageBodyFormat |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MessageFormat
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
MessageBodyFormat パラメーターは、メール連絡先またはメール ユーザーに送信されるメッセージのメッセージ本文の形式を指定します。 有効な値は次のとおりです。
- テキスト
- HTML
- TextAndHtml (既定値)
MessageFormat パラメーターと MessageBodyFormat パラメーターは相互に依存しています。
- MessageFormat は Mime です。MessageBodyFormat には、Text、Html、または TextAndHtml を指定できます。
- MessageFormat は Text です。MessageBodyFormat には Text のみを指定できます。
パラメーターのプロパティ
| 型: | MessageFormat |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ModeratedBy
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
ModeratedBy パラメーターは、このメール連絡先の 1 つ以上のモデレーターを指定します。 モデレーターは、メッセージが配信される前にメール連絡先に送信されるメッセージを承認します。 モデレーターは、メールボックス、メール ユーザー、または組織内のメール連絡先である必要があります。 モデレーターを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- 電子メール アドレス
- GUID
Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
ModerationEnabled パラメーターを値 $true に設定した場合は、このパラメーターを使用して 1 つ以上のモデレーターを指定する必要があります。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ModerationEnabled
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
ModerationEnabled パラメーターは、この受信者に対してモデレートを有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: 受信者に対してモデレートを有効にします。 この受信者に送信されるメッセージは、そのメッセージが配信される前に、モデレーターによって承認される必要があります。
- $false: 受信者に対してモデレートを無効にします。 この受信者に送信されるメッセージは、モデレーターの承認なしで配信されます。 この値が既定値です。
モデレーターを指定するには、ModeratedBy パラメーターを使用します。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
Name パラメーターは、メール連絡先の一意の名前を指定します。 最大の長さは 64 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
DisplayName パラメーターを使用しなかった場合は、この値が DisplayName プロパティとして使用されます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OrganizationalUnit
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
OrganizationUnit パラメーターは、新しい連絡先が作成される Active Directory 内の場所を指定します。
このパラメーターの有効な入力値は、Get-OrganizationalUnit コマンドレットによって返される組織単位 (OU) またはドメインです。 OU またはドメインを一意に識別する、任意の値を使用できます。 以下に例を示します。
- 名前
- 識別名 (DN)
- 識別名 (DN)
- GUID
パラメーターのプロパティ
| 型: | OrganizationalUnitIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PrimarySmtpAddress
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
PrimarySmtpAddress パラメーターは、受信者の返信用プライマリ メール アドレスを指定します。
既定で、プライマリ アドレスは ExternalEmailAddress パラメーター値と同じになります。
PrimarySmtpAddress パラメーターを使用して、プライマリ メール アドレスを指定する場合、コマンドによってメール連絡先の EmailAddressPolicyEnabled プロパティが False に設定され、メール連絡先の電子メール アドレスは電子メール アドレス ポリシーによって今後自動更新されなくなります。 フォレスト間設定を行っている場合を除いて、プライマリ電子メール アドレスを ExternalEmailAddress の値以外に設定しないことをお勧めします。
パラメーターのプロパティ
| 型: | SmtpAddress |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SendModerationNotifications
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
SendModerationNotifications パラメーターは、モデレート通知メッセージを送信するタイミングを指定します。有効な値は次のとおりです。 有効な値は次のとおりです。
- Always: メッセージが承認されない場合、すべての送信者に通知する。 この値が既定値です。
- Internal: メッセージが承認されない場合、組織内の送信者に通知する。
- Never: メッセージが承認されない場合、だれにも通知しない。
このパラメーターは、モデレートが有効な場合にのみ、意味があります (ModerationEnabled パラメーターに値 $true が指定されている)。
パラメーターのプロパティ
| 型: | TransportModerationNotificationFlags |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UsePreferMessageFormat
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
UsePreferMessageFormat は、メール ユーザーまたはメール連絡先に対して構成されたメッセージ形式の設定が、リモート ドメイン用に構成されたグローバル設定またはメッセージ送信者によって構成されたグローバル設定をオーバーライドするかどうかを指定します。 有効な値は次のとおりです。
- $true: メール ユーザーまたはメール連絡先に送信されるメッセージは、メール ユーザーまたはメール連絡先用に構成されたメッセージ形式を使用します。
- $false: メール ユーザーまたはメール連絡先に送信されるメッセージは、リモート ドメイン (既定のリモート ドメインまたは特定のリモート ドメイン) 用に構成されているか、メッセージ送信者によって構成されたメッセージ形式を使用します。 この値が既定値です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。