> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/mail/add-mail-contact.md).

# メール連絡先を追加

### 説明

このランブックは、New-MailContact コマンドレットを使用して、新しい Exchange Online のメール連絡先（外部連絡先）を作成します。必要に応じて、連絡先の名、姓、メールエイリアスを設定し、グローバル アドレス一覧に表示するかどうかを制御できます。すべての名前は、明示的に設定されていない場合、指定された表示名を既定値として使用します。

### 場所

組織 → メール → メール連絡先の追加

**Runbook の完全名**

rjgit-org\_mail\_add-mail-contact

### 詳細

| プロパティ    | 値                                                                                |
| -------- | -------------------------------------------------------------------------------- |
| バージョン    | 1.0.1                                                                            |
| 必要なモジュール | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>ExchangeOnlineManagement (>= 3.9.2)</p> |
| スケジュール可能 | いいえ                                                                              |

### アクセス許可

#### アプリケーションのアクセス許可

* **種類**：Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *アプリ専用の Exchange Online セッションで New-/Set-MailContact および Get-MailContact/Get-Recipient の事前チェックを実行します*

#### RBAC ロール

* Exchange 管理者
  * *マネージド ID のアプリ専用 Exchange Online セッションがメール連絡先を作成するために必要です*

### パラメーター

#### ExternalEmailAddress

メール連絡先の外部 SMTP メール アドレスです。これは、連絡先との通信に使用される主要なメール アドレスです。

| プロパティ   | 値          |
| ------- | ---------- |
| 必須      | はい         |
| 既定値     |            |
| 種類      | 文字列        |
| ポータル表示名 | 外部メール アドレス |

#### DisplayName

Exchange Online およびグローバル アドレス一覧でメール連絡先に表示される表示名です。

| プロパティ   | 値   |
| ------- | --- |
| 必須      | はい  |
| 既定値     |     |
| 種類      | 文字列 |
| ポータル表示名 | 表示名 |

#### 名前

管理と識別に使用される一意の連絡先名です。空のままにすると、DisplayName の値が既定になります。

| プロパティ   | 値                  |
| ------- | ------------------ |
| 必須      | いいえ                |
| 既定値     |                    |
| 種類      | 文字列                |
| ポータル表示名 | 連絡先名（省略可 - 表示名が既定） |

#### FirstName

連絡先の名です。指定されない場合、このフィールドは空のままになります。

| プロパティ   | 値      |
| ------- | ------ |
| 必須      | いいえ    |
| 既定値     |        |
| 種類      | 文字列    |
| ポータル表示名 | 名（省略可） |

#### LastName

連絡先の姓です。指定されない場合、このフィールドは空のままになります。

| プロパティ   | 値      |
| ------- | ------ |
| 必須      | いいえ    |
| 既定値     |        |
| 種類      | 文字列    |
| ポータル表示名 | 姓（省略可） |

#### エイリアス

メール連絡先のメール ニックネーム（エイリアス）です。指定されない場合、システムが表示名から自動的に生成します。

| プロパティ   | 値              |
| ------- | -------------- |
| 必須      | いいえ            |
| 既定値     |                |
| 種類      | 文字列            |
| ポータル表示名 | メール エイリアス（省略可） |

#### HideFromAddressLists

true に設定すると、メール連絡先はグローバル アドレス一覧およびその他のアドレス一覧から非表示になります。false の場合、連絡先はすべてのユーザーに表示されます。既定値は false です。

| プロパティ   | 値                 |
| ------- | ----------------- |
| 必須      | いいえ               |
| 既定値     | False             |
| 種類      | ブール値              |
| ポータル表示名 | グローバル アドレス一覧から非表示 |

[Runbook Reference の概要に戻る](/ja/zi-dong-hua/runbooks/runbook-references.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/mail/add-mail-contact.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.