> 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/general/offboard-user-permanently.md).

# ユーザーを完全にオフボード

このユーザーを完全にオフボードします

### 説明

このユーザーを完全にオフボードします。アクセスは取り消され、アカウントは無効化または削除され、ライセンスとグループは調整され、グループ メンバーシップは変更前にエクスポートできます。グループ所有権、直属の部下、ゲストのスポンサー関係は、後任者に引き継げます。削除されたアカウントは30日間のみ復元できます。

### テナント設定でオフボーディング ポリシーを事前設定する

このランブックのほとんどのスイッチはテナント設定で制御されるため、組織はオフボーディング ポリシーを一度設定し、対応するフィールドをオペレーターから非表示にできます。以下の例では、すべてのスイッチを事前設定してフィールドを非表示にしています。オペレーターが各実行ごとに判断すべきフィールドだけを残してください。

```json
{
    "Settings": {
        "OffboardUserPermanently": {
            "userTypeRestriction": 0,
            "deleteUser": true,
            "disableUser": true,
            "revokeAccess": true,
            "exportGroupMemberships": true,
            "licensesMode": 0,
            "groupsMode": 0,
            "groupToAdd": "",
            "groupsToRemovePrefix": "",
            "replaceManagerReferences": true,
            "replaceSponsorReferences": true
        },
        "RJReport": {
            "StorageAccount": {
                "ResourceGroup": "rj-test-runbooks-01",
                "StorageAccountName": "rjrbexports01",
                "LinkExpiryDays": 6
            }
        }
    },
    "Runbooks": {
        "rjgit-user_general_offboard-user-permanently": {
            "ParameterList": [
                { "Name": "UserTypeSelector", "Hide": true },
                { "Name": "DisableUser", "Hide": true },
                { "Name": "RevokeAccess", "Hide": true },
                { "Name": "ChangeLicensesSelector", "Hide": true },
                { "Name": "ChangeGroupsSelector", "Hide": true },
                { "Name": "GroupToAdd", "Hide": true },
                { "Name": "GroupsToRemovePrefix", "Hide": true },
                { "Name": "CallerName", "Hide": true }
            ]
        }
    }
}
```

設定の意味:

* `userTypeRestriction`: `0` すべてのユーザー種別を許可します、 `1` メンバーのみ、 `2` ゲストのみです。条件に合わないユーザーがいると、変更前に処理が停止します。
* `deleteUser`: アカウントを削除する（`true`）または保持する（`false`).
* `disableUser`, `revokeAccess`: サインインをブロックし、ユーザーのセッションを終了します。
* `exportGroupMemberships`: グループ メンバーシップをレポート用ストレージ アカウントにエクスポートし（ `RJReport.StorageAccount`）に保存し、グループとライセンスが変更される前にダウンロード リンクを返します。
* `licensesMode`: `0` 直接割り当てられたライセンスを保持します、 `2` それらをすべて削除します。
* `groupsMode`: `0` グループを保持します、 `1` で始まるグループを削除します `groupsToRemovePrefix`, `2` 、すべてのグループを削除します。どちらの場合も `1` および `2` 追加または保持 `groupToAdd`.
* `replaceManagerReferences`, `replaceSponsorReferences`: ユーザーの直属の部下とスポンサー関係を後任者に引き継ぎます。

ランブックのカスタマイズ方法の詳細については、 [ランブック カスタマイズ ガイド](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### 場所

ユーザー → 一般 → ユーザーを完全にオフボード

**完全な Runbook 名**

rjgit-user\_general\_offboard-user-permanently

### 詳細

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

### 権限

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

* **種類**: Microsoft Graph
  * User.ReadWrite.All
    * *サインインを無効化し、セッションを取り消し、ライセンスを削除し、マネージャーおよびスポンサー参照を置き換え、ユーザー オブジェクトを削除します*
  * Group.ReadWrite.All
    * *グループを読み取り、ユーザーのグループ所有権を移譲または削除します*
  * GroupMember.ReadWrite.All
    * *グループ クリーンアップ中にグループ メンバーシップを追加または削除します*
* **種類**： Office 365 Exchange Online
  * Exchange.ManageAsApp
    * *ユーザーを配布グループから削除するために使用するアプリ専用の Exchange Online セッションを開きます*

#### アクセス許可に関する注意

Azure Storage Account: 自動化アカウントのマネージド ID に対して対象 Storage Account で「Reader and Data Access」ロールが必要です。アップロードでは listKeys を使用してアカウント キーを取得します（exportGroupMemberships を使用する場合のみ必要です）

#### RBAC ロール

* ユーザー管理者
  * *アプリ専用 ID がサインインをブロックし、セッションを取り消し、ユーザーを削除できるようにするために必要です*
* Exchange 管理者
  * *アプリ専用の Exchange Online セッションが配布グループ メンバーシップを削除するために必要です*

### パラメーター

#### UserName

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

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

#### ユーザー種別セレクター

選択したユーザー種別のみに対して実行します。すべてのユーザー、メンバーのみ、またはゲストのみです。不一致の場合、変更前に処理が停止します。

| プロパティ   | 値           |
| ------- | ----------- |
| 必須      | false       |
| 既定値     | 0           |
| 種類      | Int32       |
| ポータル表示名 | ユーザー種別を制限する |

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

| ポータル オプション                | 値 |
| ------------------------- | - |
| すべてのユーザー種別を許可する（メンバーとゲスト） | 0 |
| メンバーのみ                    | 1 |
| ゲストのみ                     | 2 |

#### ユーザー削除

Delete はユーザー オブジェクトを削除します。Keep はアカウントをそのまま残します。その後どうなるかは他のスイッチに従います。

| プロパティ   | 値                |
| ------- | ---------------- |
| 必須      | false            |
| 既定値     | False            |
| 種類      | ブール値             |
| ポータル表示名 | アカウントを削除するか保持するか |

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

| ポータル オプション | 値     |
| ---------- | ----- |
| アカウントを削除する | true  |
| アカウントを保持する | false |

#### DisableUser

アカウントによるサインインをブロックします。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   | True  |
| 種類    | ブール値  |

#### アクセスの取り消し

ユーザーのアクティブなセッションを終了し、更新トークンを無効化します。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   | True  |
| 種類    | ブール値  |

#### exportGroupMemberships

ユーザーのグループ メンバーシップをファイルにエクスポートし、グループとライセンスが変更される前にダウンロード リンクを返します。テナント設定 OffboardUserPermanently.exportGroupMemberships から取得されます。

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

#### コンテナー名

エクスポートのアップロード先となるストレージ コンテナー。ランブックごとに設定します。

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

#### リソース グループ名

レポート アップロード用のストレージ アカウントのリソース グループです。Tenant 設定 RJReport.StorageAccount.ResourceGroup から取得されます。

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

#### Storage Account 名

レポート アップロード用の Storage Account です。Tenant 設定 RJReport.StorageAccount.StorageAccountName から取得されます。

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

#### LinkExpiryDays

ダウンロード リンクが有効なままの期間（日数）です。Tenant 設定 RJReport.StorageAccount.LinkExpiryDays から取得されます。

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

#### ライセンス変更セレクター

すべて削除すると、直接割り当てられたライセンスはすべて削除されます。グループから継承されたライセンスは残ります。

| プロパティ   | 値              |
| ------- | -------------- |
| 必須      | false          |
| 既定値     | 0              |
| 種類      | Int32          |
| ポータル表示名 | 直接割り当てられたライセンス |

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

| ポータル オプション             | 値 |
| ---------------------- | - |
| 割り当て済みライセンスを変更しない      | 0 |
| 直接割り当てられたライセンスをすべて削除する | 2 |

#### グループ変更セレクター

接頭辞付きグループを削除すると、その接頭辞で名付けられたグループが削除されます。すべてのグループを削除すると、すべてのグループが削除されます。どちらの場合も、「Group to add or keep」に指定したグループを追加または保持します。動的グループ、ロール割り当て可能グループ、オンプレミス グループはスキップされ、一覧表示されます。

| プロパティ   | 値            |
| ------- | ------------ |
| 必須      | false        |
| 既定値     | 0            |
| 種類      | Int32        |
| ポータル表示名 | グループ メンバーシップ |

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

| ポータル オプション       | 値 |
| ---------------- | - |
| 割り当て済みグループを変更しない | 0 |
| 接頭辞付きグループを削除する   | 1 |
| すべてのグループを削除する    | 2 |

#### 追加するグループ

オフボーディング後もユーザーに必要なグループです。たとえば、退職者用ライセンス グループです。存在しない場合は追加され、削除されることはありません。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### 削除対象グループの接頭辞

名前がこの文字列で始まるグループが削除されます。たとえば、すべてのライセンス グループなら LIC\_ です。「接頭辞付きグループを削除する」でのみ使用します。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### グループ所有権の取り消し

「削除または置換」は、ユーザーのグループ所有権を取り上げます。このユーザーが最後の所有者である場合は、後任者が引き継ぎます。後任者がいない場合は、そのグループが手動対応用に一覧表示されます。「保持」は所有権をそのまま残します。

| プロパティ   | 値       |
| ------- | ------- |
| 必須      | false   |
| 既定値     | True    |
| 種類      | ブール値    |
| ポータル表示名 | グループ所有権 |

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

| ポータル オプション         | 値     |
| ------------------ | ----- |
| ユーザーの所有権を保持する      | false |
| ユーザーの所有権を削除または置換する | true  |

#### 後任所有者としてマネージャーを使用

Entra ID のユーザーのマネージャーを後任の所有者、マネージャー、スポンサーとして使用します。マネージャーが設定されている場合は、「後任者」の代わりにそれが使用されます。

| プロパティ   | 値                   |
| ------- | ------------------- |
| 必須      | false               |
| 既定値     | True                |
| 種類      | ブール値                |
| ポータル表示名 | マネージャーを後任として使用しますか？ |

#### 後任所有者名

マネージャーを使わない場合、またはこのユーザーにマネージャーがいない場合に、所有権、直属の部下、スポンサー関係を引き継ぐ人。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### マネージャー参照の置き換え

このユーザーに報告している全員のマネージャーとして後任者を設定します。後任者がいない場合、それらのユーザーは一覧表示のみされます。

| プロパティ   | 値            |
| ------- | ------------ |
| 必須      | false        |
| 既定値     | False        |
| 種類      | ブール値         |
| ポータル表示名 | 直属の部下のマネージャー |

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

| ポータル オプション                 | 値     |
| -------------------------- | ----- |
| このユーザーを直属の部下のマネージャーとして保持する | false |
| 直属の部下のマネージャーとして後任者を設定する    | true  |

#### スポンサー参照の置き換え

このユーザーがスポンサーとして設定されている箇所で、そのユーザーをスポンサーとして置き換えます。通常はゲスト ユーザーで使われます。後任者がいない場合、それらのユーザーは一覧表示のみされます。グループ経由のスポンサー関係は保持されます。これはテナント内のすべてのユーザーをスキャンします。

| プロパティ   | 値         |
| ------- | --------- |
| 必須      | false     |
| 既定値     | False     |
| 種類      | ブール値      |
| ポータル表示名 | ゲストのスポンサー |

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

| ポータル オプション                     | 値     |
| ------------------------------ | ----- |
| このユーザーをスポンサーとして保持する            | false |
| このユーザーを（ゲスト）ユーザーのスポンサーとして置き換える | true  |

[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/general/offboard-user-permanently.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.