> 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/device/general/wipe-device.md).

# デバイスを初期化

この Windows または macOS デバイスを初期化し、その記録をクリーンアップします

### 説明

この Windows または macOS デバイスをワイプします。必要に応じて、残りの項目もクリーンアップできます: Intune レコード、Autopilot 登録、Entra ID オブジェクトを削除または無効化できます。Windows では、保護付きワイプと、再登録後の準拠猶予期間を長くする設定を選べます。macOS では、リカバリーコードと OS の消去方法を選べます。ワイプするとデバイス上のすべてのデータが削除され、元に戻せません。Microsoft Defender for Endpoint がデバイスを中リスクまたは高リスクと評価した場合は、ワイプをスキップできます。

### デバイスがリスク状態でない場合のみワイプする

次の場合、 *デバイスがリスク状態でない場合のみワイプ* (`skipWipeIfAtRisk`）が有効な場合、runbook はデバイスのリスク スコアを Microsoft Defender for Endpoint で確認し、いかなるデバイス オブジェクトにも触れる前に実行します。参照では Entra のデバイス ID を使用し、これは次の **Defender の状態を確認** runbook が実行します。チェックは既定でオフで、ワイプが要求された場合にのみ実行されます。次の場合はスキップされます。 *デバイスをワイプしない* が選択された場合。

考えられる結果:

* **リスクの上昇なし** (リスク スコア `なし`, `情報` または `低`）: ワイプと選択したクリーンアップ操作は通常どおり実行されます。
* **リスク スコア `中` または `高`**：runbook はワイプ、除外グループへのメンバーシップ、Entra の変更、および Intune/Autopilot の削除を行う前に警告を出して停止します。リスク スコアが高いデバイスはセキュリティ インシデントに関与している可能性があり、ワイプするとフォレンジック データ（ログなど）を失うおそれがあります。まずセキュリティ チームと調整してください。それでもデバイスをワイプするには、このオプションを無効にして runbook を実行します。
* **Defender for Endpoint でデバイスが見つかりません**：リスク スコアを判定できません。runbook はこれを記録してワイプを続行するため、Defender にオンボードされていないデバイスはブロックされません。
* **Defender クエリに失敗**：runbook はワイプせずに停止するため、一時的な API の問題で保護が回避されることはありません。

#### 既定でチェックを有効にする

すべてのワイプでチェックを強制するには、パラメーターを事前設定して非表示にし、ポータルからオフにできないようにします。

この JSON 構成は次のとおりです:

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "skipWipeIfAtRisk": {
            "Default": true,
            "Hide": true
        }
    }
}
```

### デバイスをコンプライアンス除外グループに追加

次の場合、 *デバイスをコンプライアンス除外グループに追加* (`addToExclusionGroup`）が有効な場合、ワイプされた Windows デバイスはコンプライアンス除外グループに追加されます。そのグループ内のデバイスは、Autopilot で再登録された後に、より長いコンプライアンス猶予期間を受けます（これは、 **デバイスのオンボード除外を確認** runbook に対応しています）。

既定では、グループはその **表示名** (`exclusionGroupName`）。表示名は一意であるとは限らないため、代わりに次の方法でグループを固定できます **オブジェクト ID** (`exclusionGroupId`）。Object ID が指定されている場合、 **常に上書きします** 表示名を上書きするため、名前の競合が原因で誤ったグループが使われることはありません。 `exclusionGroupId` は既定で非表示で、runbook のカスタマイズで設定することを想定しています。

グループは事前のプレフライト チェックで解決および検証されます。構成されたグループが存在しない場合、runbook は中止されます **前に** いずれのワイプ/削除/無効化操作も行う前に中止されるため、中途半端な状態が残ることはありません。グループへの追加は、Windows 以外のデバイスの場合、およびデバイスが Entra ID から削除される場合はスキップされます（`removeAADDevice`).

#### Object ID でグループを固定する（推奨）

グループの Object ID を事前設定し、スイッチを有効にして、フィールドを非表示のままにします。これにより、表示名の重複によるあいまいさを避けられます。

この JSON 構成は次のとおりです:

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "addToExclusionGroup": {
            "Default": true
        },
        "exclusionGroupId": {
            "Default": "00000000-0000-0000-0000-000000000000",
            "Hide": true
        },
        "exclusionGroupName": {
            "Hide": true
        }
    }
}
```

置き換えます `00000000-0000-0000-0000-000000000000` グループの Object ID を指定します（EntraID > Groups > *対象のグループ* > **オブジェクト ID**).

#### 表示名でグループを固定する

表示名で扱う方がよい場合（かつ Tenant 内で一意である場合）は、次を事前設定してください `exclusionGroupName` を設定し、 `exclusionGroupId` 空欄のままにして、その名前を使用します。

この JSON 構成は次のとおりです:

```json
"rjgit-device_general_wipe-device": {
    "parameters": {
        "addToExclusionGroup": {
            "Default": true
        },
        "exclusionGroupName": {
            "Default": "cfg - Intune - Windows - 未登録の Autopilot デバイスのコンプライアンス (devices)",
            "Hide": true
        }
    }
}
```

### macOS のワイプ オプション

macOS デバイスは Intune の消去アクションでワイプされます。適用されるオプションは 2 つだけです:

* **リカバリーコード（macOS）** (`macOsRecoveryCode`）：古い Mac ではワイプを受け入れるために 6 桁のリカバリーコードが必要ですが、新しいデバイスでは無視されます。このパラメーターはポータルで非表示になっており、runbook のカスタマイズで事前設定できます。
* **消去動作（macOS）** (`macOsObliterationBehavior`）： *すべてのコンテンツと設定を消去* （EACS）が実行できない場合に何をするかを決定します。 `既定` ユーザー データを消去し、失敗した場合は OS 全体の消去にフォールバックします。 `doNotObliterate` OS は決して消去しません。 `obliterateWithWarning` 警告を表示してから OS を消去します。 `常に` いずれの場合でも OS を消去します。

Windows 専用オプション（*保護付きワイプ*, *Autopilot データベース*, *コンプライアンス除外グループ*）は macOS デバイスでは無視されます。

### 場所

デバイス → 一般 → デバイスをワイプ

**完全な Runbook 名**

rjgit-device\_general\_wipe-device

### 詳細

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

### アクセス許可

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

* **型**: Microsoft Graph
  * DeviceManagementManagedDevices.PrivilegedOperations.All
    * *wipeDevice が選択されたときに Intune のワイプ アクションをトリガーします*
  * DeviceManagementManagedDevices.ReadWrite.All
    * *azureADDeviceId で Intune デバイスを検索し、removeIntuneDevice が設定されている場合は削除します*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *removeAutopilotDevice が設定されている場合、Autopilot ID を検索して削除します*
  * Device.Read.All
    * *Entra デバイスを解決し、レポート用に登録済みの所有者を読み取ります*
  * GroupMember.ReadWrite.All
    * *addToExclusionGroup が有効な場合、デバイスを除外グループに追加します*
* **型**: WindowsDefenderATP
  * Machine.Read.All *(オプション — 機能: Defender リスク チェック)*
    * *skipWipeIfAtRisk のプレフライトでデバイスの Defender リスク スコアを読み取ります*

#### RBAC ロール

* クラウド デバイス管理者
  * &#x20;*/devices/{id} を通じて Entra デバイス オブジェクトを無効化および削除するために必要です*

### パラメーター

#### DeviceId

この runbook が対象とするデバイスの Entra ID デバイス ID。ポータルによって、選択したデバイスから設定されます。

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

#### wipeDevice

完全ワイプはデバイス上のすべてのユーザー データと登録データを消去します。ワイプしない場合はデバイスに手を触れず、選択したクリーンアップ手順のみを実行します。

| プロパティ    | 値               |
| -------- | --------------- |
| 必須       | false           |
| 既定値      | True            |
| 型        | ブール値            |
| ポータルの表示名 | このデバイスをワイプしますか? |

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

| ポータル オプション                                     | 値     |
| ---------------------------------------------- | ----- |
| デバイスを完全にワイプする（Windows: ユーザー データまたは登録データを保持しない） | true  |
| デバイスをワイプしない                                    | false |

#### useProtectedWipe

途中でデバイスの電源がオフになってもワイプを試行し続けるため、電源オフで回避することはできません。Windows のみ。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | False                    |
| 型        | ブール値                     |
| ポータルの表示名 | 保護付きワイプを使用しますか?（Windows） |

#### removeIntuneDevice

Intune のデバイス レコードを削除します。デバイスがすでにワイプ済みまたは破棄済みの場合にのみ有効です。

| プロパティ    | 値                     |
| -------- | --------------------- |
| 必須       | false                 |
| 既定値      | False                 |
| 型        | ブール値                  |
| ポータルの表示名 | Intune からデバイスを削除しますか? |

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

| ポータル オプション                                    | 値     |
| --------------------------------------------- | ----- |
| Intune からデバイスを削除する（デバイスがすでにワイプ済みまたは破棄済みの場合のみ） | true  |
| Intune レコードを保持する                              | false |

#### removeAutopilotDevice

Autopilot データベースからデバイスを削除すると、Tenant を離れて別の場所に登録できるようになります。保持すると、この Tenant で後から再展開できます。Windows のみ。

| プロパティ    | 値                                  |
| -------- | ---------------------------------- |
| 必須       | false                              |
| 既定値      | False                              |
| 型        | ブール値                               |
| ポータルの表示名 | Autopilot データベースから削除しますか?（Windows） |

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

| ポータル オプション                             | 値     |
| -------------------------------------- | ----- |
| Autopilot から削除する（デバイスは Tenant を離れられます） | true  |
| デバイスを Autopilot に保持する                  | false |

#### removeAADDevice

ワイプ後に Entra ID デバイス オブジェクトを削除するかどうか。runbook のカスタマイズで事前設定します。

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

#### disableAADDevice

無効化するとデバイスからのサインインはブロックされますが、オブジェクトは Entra ID に残ります。保持すると Entra ID オブジェクトは変更されません。

| プロパティ    | 値                             |
| -------- | ----------------------------- |
| 必須       | false                         |
| 既定値      | False                         |
| 型        | ブール値                          |
| ポータルの表示名 | Entra ID デバイス オブジェクトを無効化しますか? |

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

| ポータル オプション           | 値     |
| -------------------- | ----- |
| Entra ID でデバイスを無効化する | true  |
| Entra ID デバイスを変更しない  | false |

#### skipWipeIfAtRisk

Microsoft Defender for Endpoint がデバイスを中リスクまたは高リスクと評価した場合、ワイプをスキップします。これにより、セキュリティ インシデントの一部である可能性があるデバイス上の証拠をそのまま保持できます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      | False                     |
| 型        | ブール値                      |
| ポータルの表示名 | デバイスがリスク状態でない場合のみワイプしますか? |

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

| ポータル オプション                          | 値     |
| ----------------------------------- | ----- |
| Defender のリスク スコアが中または高でない場合のみワイプする | true  |
| Defender のリスク スコアに関係なくワイプする         | false |

#### addToExclusionGroup

デバイスをコンプライアンス除外グループに追加し、Autopilot で再登録されたときにより長いコンプライアンス猶予期間を付与します。Windows のみ。

| プロパティ    | 値                               |
| -------- | ------------------------------- |
| 必須       | false                           |
| 既定値      | False                           |
| 型        | ブール値                            |
| ポータルの表示名 | コンプライアンス除外グループに追加しますか?（Windows） |

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

| ポータル オプション               | 値     |
| ------------------------ | ----- |
| デバイスをコンプライアンス除外グループに追加する | true  |
| 除外グループに追加しない             | false |

#### exclusionGroupName

デバイスが追加される除外グループの表示名。runbook のカスタマイズで事前設定されたオブジェクト ID が優先されます。

| プロパティ    | 値                                                               |
| -------- | --------------------------------------------------------------- |
| 必須       | false                                                           |
| 既定値      | cfg - Intune - Windows - 未登録の Autopilot デバイスのコンプライアンス (devices) |
| 型        | 文字列                                                             |
| ポータルの表示名 | コンプライアンス除外グループ名                                                 |

#### exclusionGroupId

除外グループの Object ID。runbook のカスタマイズで事前設定し、名前の衝突を避けるためにグループ名の代わりに使用します。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 型        | 文字列                       |
| ポータルの表示名 | コンプライアンス除外グループの Object ID |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定）  |

#### macOsRecoveryCode

ワイプにリカバリーコードが必要な古い Mac 用のリカバリーコードです。新しいデバイスでは無視されます。runbook のカスタマイズで事前設定します。

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

#### macOsObliterationBehavior

Mac の消去方法: まずユーザー データを消去し、失敗した場合は OS の消去にフォールバックする、OS を決して消去しない、OS を消去する前に警告する、または常に OS を消去する。

| プロパティ    | 値           |
| -------- | ----------- |
| 必須       | false       |
| 既定値      | 既定          |
| 型        | 文字列         |
| ポータルの表示名 | 消去動作（macOS） |

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

| ポータル オプション                                | 値                     |
| ----------------------------------------- | --------------------- |
| ユーザー データを消去する（EACS）、失敗した場合は OS を消去する      | 既定                    |
| ユーザー データを消去する（EACS）、OS は決して消去しない          | doNotObliterate       |
| ユーザー データを消去する（EACS）、それ以外の場合は警告して OS を消去する | obliterateWithWarning |
| 常に OS を消去する                               | 常に                    |

[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/device/general/wipe-device.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.
