> 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-temporarily.md).

# ユーザーを一時的にオフボード

このユーザーを一時的にオフボードします

### 説明

このユーザーを一時的にオフボードします。例えば育児休暇やサバティカルの場合です。サインインはブロックされ、ライセンスとグループは調整され、グループのメンバーシップは変更前にエクスポートできます。グループの所有権、直属の部下、ゲストのスポンサーシップは代替者に引き継げます。アカウント自体は残ります。

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

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

```json
{
    "Settings": {
        "OffboardUserTemporarily": {
            "userTypeRestriction": 0,
            "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-temporarily": {
            "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` ゲストのみです。不一致のユーザーがいると、変更の前に実行が停止します。
* `disableUser`, `revokeAccess`: サインインをブロックし、ユーザーのセッションを終了します。
* `exportGroupMemberships`: グループのメンバーシップをレポート用 Storage Account にエクスポートし（ `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-temporarily

### 詳細

| プロパティ    | 値                                                                                                                                                         |
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| バージョン    | 1.1.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: Automation Account のマネージド ID に対して、対象のストレージ アカウントに「Reader and Data Access」ロールが必要です。アップロードでは listKeys を使用してアカウント キーを取得します（exportGroupMemberships を使用する場合のみ必要です）

#### RBAC ロール

* ユーザー管理者
  * *ロールを持つユーザーに対しても、ユーザーの書き込みが成功するために必要です*
* Exchange 管理者
  * *アプリ専用の Exchange Online セッションが配布グループのメンバーシップを削除するために必要です*

### パラメーター

#### UserName

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

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

#### UserTypeSelector

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

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

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

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

#### DisableUser

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

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

#### RevokeAccess

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

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

#### exportGroupMemberships

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

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

#### コンテナー名

エクスポートがアップロードされる Storage コンテナー。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 のカスタマイズで事前設定) |

#### 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    |
| 既定値     | False    |
| 種類      | ブール値     |
| ポータル表示名 | グループの所有権 |

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

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

#### ManagerAsReplacementOwner

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

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

#### ReplacementOwnerName

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

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

#### ReplaceManagerReferences

このユーザーに直属するすべての人のマネージャーを代替者に設定します。代替者がいない場合、それらのユーザーは一覧表示されるだけです。

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

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

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

#### ReplaceSponsorReferences

このユーザーがスポンサーとして設定されているあらゆる場所で、このユーザーをスポンサーから置き換えます。通常はゲスト ユーザーで行われます。代替者がいない場合、それらのユーザーは一覧表示されるだけです。グループ経由のスポンサーシップは保持されます。これは Tenant のすべてのユーザーをスキャンします。

| プロパティ   | 値         |
| ------- | --------- |
| 必須      | 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-temporarily.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.