> 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/user/mail/delegate-full-access.md).

# フル アクセスを委任

このユーザーのメールボックスへのフル アクセス権を付与または削除

### 説明

このユーザーのメールボックスへのフルアクセス権を 1 人以上に付与するか、そのアクセスを再度削除します。必要に応じて、代理人の Outlook でメールボックスが自動的に開きます。権限は変更の前後に表示され、1 人の代理人で失敗しても他の代理人は停止しません。

### 仕組み

各実行で、runbook は次を行います：

1. Automation アカウントのマネージド ID を使用して Exchange Online に接続します。
2. 選択されたメールボックス所有者（`UserName`）に実際にメールボックスがあることを確認します。ない場合、何も変更される前に実行が停止します。
3. 選択された各代理人をそのプライマリ SMTP アドレスに解決し、重複とメールボックス所有者自身を除外します。
4. 現在の **FullAccess** 委任をメールボックス上で読み取り、出力します（ *現状*).
5. 残りの各代理人に対して、1 人ずつ FullAccess を付与または削除します。
6. メールボックスの権限を再読み込みし、結果の状態と各実行のサマリーを出力します。

この runbook が対象とするのは、 **FullAccess** 選択した 1 つのメールボックス上の権限だけです。Send As、Send on Behalf、およびフォルダー レベルの権限には影響しません。

#### 代理人の選択

この **代理人アクセス先** フィールドは **複数選択** ユーザー ピッカーです。必要な数だけ代理人を選択できます。選択したすべての代理人に対し、同じ操作（*アクセスを付与* または *アクセスを削除*）と、フォームで指定した同じ AutoMapping 設定が 1 回の実行で適用されます。

ピッカーはメンバー アカウント（`userType eq 'Member'`）に制限されているため、ゲスト アカウントは表示されません。選択された各代理人は **ユーザー プリンシパル名**として渡されるため、最初のログ行の時点で、すでに生のオブジェクト ID ではなく UPN の一覧として表示されます。その後、各値は Exchange Online に対して解決され、事前チェックの段階以降はすべての出力に代理人のプライマリ SMTP アドレスが表示されます。

同じメールボックスに解決される 2 つのピッカー項目は重複排除され、メールボックス所有者に解決される代理人は警告付きで除外されます。メールボックスを自分自身に委任することはできません。

#### 変更される内容

* **アクセスを付与（`削除` = false）：** `Add-MailboxPermission` を `-AccessRights FullAccess` 付きで各代理人に対して実行します。
* **アクセスを削除（`削除` = true）：** `Remove-MailboxPermission` を `-AccessRights FullAccess -InheritanceType All` 付きで各代理人に対して実行します。

#### AutoMapping

**`AutoMapping`** は、アクセスを付与するときにのみ評価されます。ポータルでは *アクセスを削除* が選択されている場合、このフィールドは非表示になります。AutoMapping を有効にすると、Outlook は委任されたメールボックスを代理人のプロファイルに自動的に追加します。ただし、クライアントがそのマッピングを再作成した後であり、それにはしばらくかかる場合があります。既存の付与は、AutoMapping 値を変更するために書き換えられません。マッピングの動作を変更する必要がある場合は、委任を削除してから再度付与してください。

#### 設計上、冪等です

同じことが 2 回行われることはなく、すでに真であったというだけで失敗することもありません：

* すでに FullAccess を保持している代理人へのアクセス付与は *変更なし*として報告され、エラーにはなりません。
* FullAccess エントリを持たない代理人からのアクセス削除は *変更なし*として報告され、エラーにはなりません。
* 事前変更スナップショットで既存の権限エントリを分類できない場合、runbook は **表示されません** ショートカットを使わず、Exchange Online を呼び出してその応答に判断を委ねます。したがって、削除可能な委任が黙ってスキップされることはありません。

#### 部分的な結果

代理人は独立して処理されます：

* メールボックスを持たない代理人は **事前チェックでスキップされ、** スキップ済み *としてカウントされます。残りの代理人は引き続き処理されます。選択された代理人にメールボックスが 1 つもない場合、実行は停止します。*;
* 変更が **失敗した代理人は** 対象を絞った理由（ディレクトリ複製の遅延、マネージド ID に対する Exchange Online 権限不足、グループから継承された権限、または共有/ライセンスなしのメールボックス）とともに報告され、ループは残りに対して継続します。

すべての実行は、次の形式のサマリー行で終了します `要約: <変更済み>, <変更なし>, <失敗>, <スキップ済み（メールボックスなし）>`、その後にメールボックス上の結果の FullAccess 委任が続きます。

もし **いずれかの** 代理人が失敗した場合、runbook 自体は失敗を報告します。これは意図的です。複数選択ピッカーでは、部分的な成功をクリーンな実行として報告すると、アクセスを受け取れなかった代理人が隠れてしまうためです。

#### 制限事項

* **継承された権限は削除できません。** ロール グループまたは Security Group のメンバーシップから来る FullAccess 権限は *継承済み* として表示されますが、ここでは取り消せません。代わりにグループ メンバーシップまたはロール割り当てを調整してください。
* **管理されるのは、明示的な Allow の付与のみです。** 明示的な **Deny** エントリは透明性のためにメールボックス上に表示されますが、runbook がそれを追加または削除することはありません。

#### 前提条件

Automation アカウントのマネージド ID は、 `Connect-RjRbExchangeOnline` を介して Exchange Online に接続し、次を必要とします：

* その `Exchange.ManageAsApp` アプリケーション権限 *Office 365 Exchange Online*、および
* その **Exchange 管理者** ロール（または、それを含む同等の Exchange Online RBAC ロール `Add-MailboxPermission` および `Remove-MailboxPermission`).

runbook は Microsoft Graph を呼び出しません。ユーザー ピッカーはポータル側の注記にすぎないため、Graph のアプリケーション権限は不要です。

### 場所

ユーザー → メール → 委任フル アクセス

**完全な Runbook 名**

rjgit-user\_mail\_delegate-full-access

### 詳細

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

### 権限

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

* **種類**： Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *アプリ専用の Exchange Online セッションで FullAccess メールボックス委任を管理します*

#### RBAC ロール

* Exchange 管理者
  * *FullAccess 権限を管理するアプリ専用の Exchange Online セッションに必要です*

### パラメーター

#### UserName

Runbook が対象とするユーザーのユーザー プリンシパル名。ポータルで選択されたユーザーから設定されます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | true                      |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### delegateTo

フルアクセスの付与または削除の対象となる人です。複数まとめて選択できます。

| プロパティ   | 値         |
| ------- | --------- |
| 必須      | true      |
| 既定値     |           |
| 種類      | String\[] |
| ポータル表示名 | 代理人アクセス先  |

#### 削除

付与で選択した人にフルアクセスを付与し、削除でそれを削除します。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | false |
| 既定値     | False |
| 種類      | ブール値  |
| ポータル表示名 | アクション |

**ポータルのオプション**

| ポータル オプション | 値     |
| ---------- | ----- |
| アクセスを付与    | false |
| アクセスを削除    | true  |

#### AutoMapping

メールボックスを代理人の Outlook に自動的に表示します。アクセスを削除したときには効果はありません。

| プロパティ   | 値                             |
| ------- | ----------------------------- |
| 必須      | false                         |
| 既定値     | False                         |
| 種類      | ブール値                          |
| ポータル表示名 | Outlook でメールボックスを自動的にマップしますか？ |

[Runbook リファレンスの概要に戻る](/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/user/mail/delegate-full-access.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.