> 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/org/devices/cleanup-autopilot-devices_scheduled.md).

# Autopilot デバイスのクリーンアップ（スケジュール済み）

孤立した古い Windows Autopilot デバイス登録をクリーンアップします

{% hint style="info" %}
これはスケジュール実行の runbook です。単一のオブジェクトでトリガーされるのではなく、繰り返しスケジュールで実行されるように設計されています。詳細は [スケジューリング](/ja/zi-dong-hua/runbooks/scheduling.md) runbook のスケジュールの構成方法についてご覧ください。
{% endhint %}

### 説明

このスケジュール済み runbook は、Windows Autopilot デバイス登録の定期メンテナンスを実行し、シリアル番号がもはやいずれの Intune 管理デバイスにも一致しない孤立デバイスを特定して削除するほか、構成可能な経過日数のしきい値を超えた一度も登録されていない Autopilot デバイスを必要に応じて削除します。runbook は既定で WhatIf モードで動作するため安全にレポートを行え、また、削除される予定だった、または削除済みのデバイスを一覧化した CSV および/または Excel (xlsx) 添付ファイル付きのメール要約を任意で送信できます。レポート ファイルは Azure Storage Account にアップロードすることもでき、時間制限付きのダウンロード リンクが返されます。ReportFileFormat パラメーターは、生成して配信するファイル形式（CSV のみ、CSV と XLSX、または XLSX のみ）を制御します。CSV 添付ファイルがメール サイズ制限を超え、かつ「CSV & XLSX」が選択されている場合、メールは Excel ブックのみを送信するようにフォールバックします。

### メール送信に関するセットアップ

メール レポートの送信は任意であり、受信者（`EmailTo`) が指定された場合にのみ行われます。送信者アドレスは `RJReport.EmailSender` テナント設定から取得されます。

この runbook は Microsoft Graph API を使用してメールを送信します。Graph API 経由でメールを送信するには、runbook のカスタマイズで既存のメールアドレスを構成する必要があります。

以下を参照してください [RealmJoin レポート設定ドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) 利用可能なすべての設定の詳細について。

#### メールのブランド設定

レポートメールは、任意の `RJReport.Branding.*` テナント設定に従います:

* **ヘッダーおよびフッター画像** – 公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB
* **フッターリンク** – フッター画像のリンク先
* **アクセント色とテキスト色** – 6 桁の 16 進数値、例: `#0052cc`

これらの設定が構成されていない場合、既定の RealmJoin のグラフィックと色が使用されます。ダウンロードまたは検証できない画像や無効な色の値が、レポートメールを妨げることはありません。代わりに対応する既定値が使用されます。

セットアップ手順と画像要件: [メールのブランド設定](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### 場所

Organization → Devices → Cleanup Autopilot Devices (Scheduled)

**完全な runbook 名**

rjgit-org\_devices\_cleanup-autopilot-devices\_scheduled

### 詳細

| プロパティ    | 値                                                                                                                 |
| -------- | ----------------------------------------------------------------------------------------------------------------- |
| バージョン    | 1.3.0                                                                                                             |
| 必要なモジュール | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>Microsoft.Graph.Authentication (>= 2.39.0)<br>Az.Accounts (>= 5.5.2)</p> |
| スケジュール可能 | はい                                                                                                                |

### 注記

前提条件:

* Azure Automation のマネージド ID は、次の Microsoft Graph アプリケーション権限を保持している必要があります: DeviceManagementManagedDevices.Read.All、DeviceManagementServiceConfig.ReadWrite.All、Organization.Read.All、Device.ReadWrite.All（Device.ReadWrite.All は「Delete Autopilot and Entra device」モードを使用する場合のみ）、および Mail.Send（Mail.Send はメール レポートが有効な場合のみ）。
* 最初のスケジュール実行の前に権限を付与してください。

警告 - 削除は元に戻せません:

* Autopilot デバイス ID を削除すると、Windows Autopilot から完全に削除されます。
* 物理デバイスは、ハードウェア ハッシュが再アップロードされるまで Autopilot に再登録できません。
* Autopilot レコードにはソフト削除やごみ箱はありません。
* Entra (Azure AD) デバイス オブジェクトの削除も同様に完全です。本当に不要になったレコードに対してのみ実行してください（そのデバイスは今後二度と登録されません）。

推奨される初回実行手順:

* Delete mode = "WhatIf (report only)"（既定）で実行し、出力またはメールで送信された CSV を確認します。
* 特定されたデバイスが本当に孤立しているか、一度も登録されていないことを確認します。
* 候補リストを確認した後にのみ、削除モードへ切り替えます。

パラメーターの相互作用:

* DeleteMode の既定値は "WhatIf (report only)" で、そのモードでは削除は行われません。
* 「Delete Autopilot device」は Autopilot ID のみを削除します。「Delete Autopilot and Entra device」は、対応する Entra (Azure AD) デバイス オブジェクトも追加で削除します。Autopilot ID が削除されると、これが残っている場合は古い/不要なレコードとして残ってしまうためです。
* CleanupOrphanedDevices と CleanupNeverEnrolledDevices は独立しています。どちらか一方、または両方を有効にできます。NeverEnrolledAgeDays は一度も登録されていないデバイスのチェックにのみ適用されます。
* GroupTagFilter、ManufacturerFilter、ModelFilter はいずれも任意です。各項目のすべての値を評価するには、そのフィルターを空欄のままにしてください。複数のフィルターが設定されている場合は AND で組み合わされます。範囲内に残るには、デバイスが入力されたすべてのフィルターに一致する必要があります。GroupTagFilter はグループ タグに完全一致（大文字小文字を区別しない）します。ManufacturerFilter と ModelFilter は大文字小文字を区別しない部分一致で、たとえば "Dell" は "Dell Inc." に一致し、"Surface" は "Surface Laptop 3" に一致します。
* ExcludeSerialNumbers は AND フィルターの後に除外として適用されます。シリアル番号がリスト内にあるデバイスは、他のフィルターに関係なく、完全一致（大文字小文字を区別しない）で範囲から除外されます。除外しない場合は空欄にしてください。

### アクセス許可

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

* **種類**: Microsoft Graph
  * Device.ReadWrite.All
    * *deviceId を使って Entra デバイスを検索し、「Delete Autopilot and Entra device」モードで削除します*
  * DeviceManagementManagedDevices.Read.All
    * *Intune 管理対象の Windows デバイスを読み取り、Intune にもはや存在しない Autopilot シリアルを見つけます*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *windowsAutopilotDeviceIdentities を一覧表示し、古い Autopilot ID を削除します*
  * Mail.Send *(オプション — 機能: メール レポート)*
    * *EmailTo が構成されている場合、Send-RjReportEmail を使用してクリーンアップ レポートのメールを送信します*
  * Organization.Read.All
    * */organization を読み取り、レポート出力とメールにテナントの表示名を表示します*

### パラメーター

#### DeleteMode

runbook が特定したクリーンアップ候補に対して何を行うかを制御します。"WhatIf (report only)" は削除を行わず、候補を報告するだけです（既定、安全）。"Delete Autopilot device" は Autopilot デバイス ID を削除します。"Delete Autopilot and Entra device" は Autopilot ID と対応する Entra (Azure AD) デバイス オブジェクトを削除します。これらは Autopilot ID がなくなると古いレコードとして残るためです。

| プロパティ   | 値                    |
| ------- | -------------------- |
| 必須      | いいえ                  |
| 既定値     | WhatIf (report only) |
| 種類      | 文字列                  |
| ポータル表示名 | 削除モード                |

#### GroupTagFilter

クリーンアップ範囲を制限するための、カンマ区切りの Autopilot グループ タグです。完全一致（大文字小文字を区別しない）で照合されます。グループ タグに関係なくすべての Autopilot デバイスを処理するには、空欄のままにしてください。

| プロパティ   | 値                                                |
| ------- | ------------------------------------------------ |
| 必須      | いいえ                                              |
| 既定値     |                                                  |
| 種類      | 文字列                                              |
| ポータル表示名 | Autopilot グループ タグ フィルター（カンマ区切りの完全一致、すべて対象の場合は空欄） |

#### 製造元フィルター

クリーンアップ範囲を制限するための、カンマ区切りのデバイス製造元です。大文字小文字を区別しない部分一致で照合されるため、"Dell" は "Dell Inc." に一致します。他のフィルターとは AND で組み合わされます。すべての製造元を処理するには、空欄のままにしてください。

| プロパティ   | 値                                      |
| ------- | -------------------------------------- |
| 必須      | いいえ                                    |
| 既定値     |                                        |
| 種類      | 文字列                                    |
| ポータル表示名 | 製造元フィルター（カンマ区切り、部分文字列一致、すべて対象にする場合は空欄） |

#### モデルフィルター

クリーンアップ範囲を制限するための、カンマ区切りのデバイス モデルです。大文字小文字を区別しない部分一致で照合されるため、"Surface" は "Surface Laptop 3" に一致します。他のフィルターとは AND で組み合わされます。すべてのモデルを処理するには、空欄のままにしてください。

| プロパティ   | 値                                      |
| ------- | -------------------------------------- |
| 必須      | いいえ                                    |
| 既定値     |                                        |
| 種類      | 文字列                                    |
| ポータル表示名 | モデルフィルター（カンマ区切り、部分文字列一致、すべて対象にする場合は空欄） |

#### ExcludeSerialNumbers

クリーンアップから除外する、カンマ区切りのシリアル番号です。完全一致（大文字小文字を区別しない）で照合されます。この一覧にあるシリアル番号のデバイスは、他のフィルターに関係なく、範囲から除外されます。除外しない場合は空欄にしてください。

| プロパティ   | 値                                |
| ------- | -------------------------------- |
| 必須      | いいえ                              |
| 既定値     |                                  |
| 種類      | 文字列                              |
| ポータル表示名 | 除外するシリアル番号（カンマ区切りの完全一致、なしの場合は空欄） |

#### CleanupOrphanedDevices

有効にすると、過去に Intune と通信したことはあるものの、シリアル番号が Intune 管理デバイス内で見つからなくなった Autopilot デバイス（管理デバイス レコードが削除されたもの）を削除します。

| プロパティ   | 値                             |
| ------- | ----------------------------- |
| 必須      | いいえ                           |
| 既定値     | True                          |
| 種類      | ブール値                          |
| ポータル表示名 | 孤立した Autopilot デバイスをクリーンアップする |

#### OrphanedLastContactedDays

孤立デバイスの経過日数のしきい値です。Autopilot デバイスは、Intune との最後の通信がこの日数を超えて前であり、かつシリアル番号が Intune に存在しなくなった場合にのみ、孤立デバイスとして扱われます。これにより、最近 Intune と通信したデバイスが削除されるのを防ぎます。

| プロパティ   | 値                   |
| ------- | ------------------- |
| 必須      | いいえ                 |
| 既定値     | 90                  |
| 種類      | Int32               |
| ポータル表示名 | 孤立デバイスの最終接続しきい値（日数） |

#### CleanupNeverEnrolledDevices

有効にすると、一度も登録されていない Autopilot デバイス（Intune と一度も通信していないデバイス）を削除します。

| プロパティ   | 値                                    |
| ------- | ------------------------------------ |
| 必須      | いいえ                                  |
| 既定値     | False                                |
| 種類      | ブール値                                 |
| ポータル表示名 | 一度も登録されていない Autopilot デバイスをクリーンアップする |

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

| ポータル オプション                  | 値 |
| --------------------------- | - |
| はい - 経過した一度も登録されていないデバイスを削除 |   |
| いいえ                         |   |

#### NeverEnrolledAgeDays

一度も登録されていないデバイスの経過日数のしきい値です。Device 作成日で測定されます。

| プロパティ     | 値                            |
| --------- | ---------------------------- |
| 必須        | いいえ                          |
| 既定値       | 90                           |
| 種類        | Int32                        |
| ポータル表示名   | 一度も登録されていないデバイスの経過日数しきい値（日数） |
| ポータルでは非表示 | はい（runbook のカスタマイズで事前設定）     |

#### EmailTo

クリーンアップ要約レポートの任意のメール受信者アドレスです。結果を runbook ログにのみ書き込む場合は空欄にしてください。

| プロパティ   | 値                    |
| ------- | -------------------- |
| 必須      | いいえ                  |
| 既定値     |                      |
| 種類      | 文字列                  |
| ポータル表示名 | クリーンアップ要約のメール受信者（任意） |

#### EmailFrom

要約レポートの送信元メール アドレスです。これは Runbook Customizations を通じて構成されます。

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

#### BrandingHeaderImageUrl

レポートメール用のカスタムヘッダー画像（PNG/JPEG/GIF、最大 200 KB）の任意の公開 HTTPS URL。RJReport.Branding.HeaderImageUrl テナント設定から取得されます。空の場合は既定の RealmJoin ヘッダー画像が使用されます。

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

#### BrandingFooterImageUrl

レポートメール用のカスタムフッター画像（PNG/JPEG/GIF、最大 200 KB）の任意の公開 HTTPS URL。RJReport.Branding.FooterImageUrl テナント設定から取得されます。空の場合は既定の RealmJoin フッター画像が使用されます。

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

#### BrandingFooterLink

フッター画像がリンクする任意の URL。RJReport.Branding.FooterLink テナント設定から取得されます。空の場合は既定のリンク（<https://www.realmjoin.com）が使用されます。>

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

#### BrandingAccentColor

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

#### BrandingTextColor

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

#### ReportFileFormat

生成および配信されるレポートファイル形式を制御します: 「CSV のみ」、「CSV と XLSX」（既定）または「XLSX のみ」。

| プロパティ   | 値          |
| ------- | ---------- |
| 必須      | いいえ        |
| 既定値     | CSV と XLSX |
| 種類      | 文字列        |
| ポータル表示名 | レポートファイル形式 |

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

| ポータル オプション | 値 |
| ---------- | - |
| CSV と XLSX |   |
| CSV のみ     |   |
| XLSX のみ    |   |

#### CreateDownloadLink

有効にすると、レポート ファイルは Azure Storage Account にアップロードされ、期限付きのダウンロード リンクが返されます。既定では無効です。

| プロパティ   | 値                                         |
| ------- | ----------------------------------------- |
| 必須      | いいえ                                       |
| 既定値     | False                                     |
| 種類      | ブール値                                      |
| ポータル表示名 | ファイルのダウンロードリンクを作成しますか（レポートをストレージにアップロード）？ |

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

| ポータル オプション                       | 値   |
| -------------------------------- | --- |
| はい - レポートをアップロードしてダウンロードリンクを返します | はい  |
| いいえ - ダウンロードリンクを作成しません           | いいえ |

#### ContainerName

アップロードに使用するストレージ コンテナー名。runbook ごとに構成されます（グローバルな RJReport 設定ではありません）。

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

#### ResourceGroupName

Storage Account を含むリソース グループ。RJReport のテナント設定から取得されます。

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

#### StorageAccountName

アップロードに使用する Storage Account 名。RJReport のテナント設定から取得されます。

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

#### LinkExpiryDays

生成されたダウンロードリンクの有効期限が切れるまでの日数。RJReport のテナント設定から取得されます。

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

[Runbook Reference の概要に戻る](/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/devices/cleanup-autopilot-devices_scheduled.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.