> 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日間のみ復元できます。

### Tenant 設定でオフボーディング ポリシーを事前設定します

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

```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",
                "SubscriptionId": "00000000-0000-0000-0000-000000000000",
                "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`: グループ メンバーシップをレポート用 Storage Account にエクスポートします（参照 `RJReport.StorageAccount`）し、グループとライセンスの変更前にダウンロード リンクを返します。
* `licensesMode`: `0` 直接割り当てられたライセンスは保持し、 `2` それらをすべて削除します。
* `groupsMode`: `0` グループは保持し、 `1` で始まるグループを削除します `groupsToRemovePrefix`, `2` すべてのグループを削除します。どちらの場合も `1` と `2` 追加するか保持する `groupToAdd`.
* `replaceManagerReferences`, `replaceSponsorReferences`: ユーザーの直属の部下とスポンサーシップを後任者に引き継ぎます。

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

### 場所

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

**完全な Runbook 名**

rjgit-user\_general\_offboard-user-permanently

### 詳細

| プロパティ    | 値                                                                                                                                                         |
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| バージョン    | 1.3.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: ターゲット Storage Account 上の Automation Account のマネージド ID に対する 'Reader and Data Access' ロール - アップロードでは listKeys を通じてアカウント キーを取得します（exportGroupMemberships を使用する場合のみ必要）

#### RBAC ロール

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

### パラメーター

#### ユーザー名

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

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | true                     |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### UserTypeSelector

選択したユーザー タイプでのみ実行されます: すべてのユーザー、メンバーのみ、またはゲストのみ。一致しない場合、変更の前に実行は停止します。

| プロパティ    | 値           |
| -------- | ----------- |
| 必須       | false       |
| 既定値      | 0           |
| 型        | Int32       |
| ポータルの表示名 | ユーザー タイプを制限 |

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

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

#### DeleteUser

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

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

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

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

#### DisableUser

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

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

#### RevokeAccess

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

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

#### exportGroupMemberships

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

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | False                    |
| 型        | ブール値                     |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ContainerName

エクスポートのアップロード先となる Storage container。runbook ごとに設定します。

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

#### ResourceGroupName

レポート アップロード用の Storage Account のリソース グループ。テナント設定 RJReport.StorageAccount.ResourceGroup から取得します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### StorageAccountName

レポート アップロード用の Storage Account。テナント設定 RJReport.StorageAccount.StorageAccountName から取得します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### SubscriptionId

レポート アップロード用の Storage Account のサブスクリプション ID。テナント設定 RJReport.StorageAccount.SubscriptionId から取得します。空の場合は、管理対象 ID がサインインするサブスクリプションが使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### LinkExpiryDays

ダウンロード リンクの有効期間（日数）。テナント設定 RJReport.StorageAccount.LinkExpiryDays から取得します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | 6                        |
| 型        | Int32                    |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ChangeLicensesSelector

「Remove all」は、直接割り当てられたライセンスをすべて削除します。グループから継承されたライセンスは残ります。

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

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

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

#### ChangeGroupsSelector

「Remove groups with the prefix」はプレフィックスで指定されたグループを削除し、「Remove all groups」はすべてのグループを削除します。どちらの場合も「Group to add or keep」のグループを追加または保持します。動的グループ、ロール割り当て可能グループ、およびオンプレミス グループはスキップされ、一覧に表示されます。

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

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

| ポータル オプション        | 値 |
| ----------------- | - |
| 割り当てられたグループを変更しない | 0 |
| プレフィックスでグループを削除   | 1 |
| すべてのグループを削除       | 2 |

#### GroupToAdd

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

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

#### GroupsToRemovePrefix

名前がこのテキストで始まるグループは削除されます。たとえばすべてのライセンス グループに対して LIC\_。これは「Remove groups with the prefix」でのみ使用されます。

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

#### RevokeGroupOwnership

「Remove or replace」はユーザーのグループ所有権を取り上げます。このユーザーが最後の所有者である場合は後任者が引き継ぎ、後任者がいない場合はそのグループが手動フォローアップ用に一覧表示されます。「Keep」は所有権をそのまま残します。

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

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

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

#### ManagerAsReplacementOwner

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

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

#### ReplacementOwnerName

マネージャーが使用されない、またはこのユーザーにマネージャーがいない場合に、所有権、直属の部下、スポンサーシップを引き継ぐ人物。

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

#### ReplaceManagerReferences

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

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

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

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

#### ReplaceSponsorReferences

このユーザーがスポンサーとして設定されているすべての場所で、その役割を後任者に置き換えます。通常はゲスト ユーザーです。後任者がいない場合、それらのユーザーは一覧表示のみされます。グループ経由で保持されているスポンサーシップはそのまま残ります。これは Tenant 内のすべてのユーザーをスキャンします。

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

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

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

[Runbook リファレンスの概要に戻る](https://docs.realmjoin.com/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.
