> 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 の消去方法を選べます。ワイプするとデバイス上のすべてのデータが削除され、元に戻すことはできません。Defender for Endpoint がデバイスを中程度または高リスクと評価した場合、ワイプをスキップできます。

### デバイスがリスクにさらされていない場合のみワイプ

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

考えられる結果:

* **高リスクなし** (リスク スコア `なし`, `情報` または `低`): ワイプと選択されたクリーンアップ アクションは通常どおり実行されます。
* **リスク スコア `中` または `高`**: runbook は、ワイプ、除外グループのメンバーシップ、Entra ID の変更、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`）。表示名は一意であることが保証されないため、代わりにグループを次で固定できます: **Object 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 > *グループ* > **Object 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 ID デバイスを解決し、レポート用に登録済みの所有者を読み取ります*
  * GroupMember.ReadWrite.All
    * *addToExclusionGroup が有効な場合、デバイスを除外グループに追加します*
* **種類**: WindowsDefenderATP
  * Machine.Read.All *(任意 — 機能: Defender リスク チェック)*
    * *skipWipeIfAtRisk のプレフライトでデバイスの Defender リスク スコアを読み取ります*

#### RBAC ロール

* Cloud Device Administrator
  * */devices/{id} 経由で Entra ID デバイス オブジェクトを無効化および削除するために必要です*

### パラメーター

#### 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 のカスタマイズで事前設定された object ID が優先されます。

| プロパティ   | 値                                                                              |
| ------- | ------------------------------------------------------------------------------ |
| 必須      | false                                                                          |
| 既定値     | cfg - Intune - Windows - Compliance for unenrolled Autopilot devices (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 リファレンスの概要に戻る](/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.