> 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 デバイスのクリーンアップ - 定期実行

{% 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 桁の hex 値、例: `#0052cc`）です。これらの設定が構成されていない場合は、既定の RealmJoin のグラフィックと色が使用されます。ダウンロードまたは検証できないブランド画像、または有効な hex カラーではない色の値があっても、レポートメールが送信されなくなることはありません。代わりに、該当する既定値が使用されます。

詳細については、 [RealmJoin レポート設定のドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) 設定の詳細については、

### 場所

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

**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 を読み取り、レポート出力とメールに Tenant の表示名を表示します*

### パラメーター

#### DeleteMode

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

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

#### GroupTagFilter

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

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

#### ManufacturerFilter

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

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

#### ModelFilter

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

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

#### ExcludeSerialNumbers

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

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

#### CleanupOrphanedDevices

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

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

#### OrphanedLastContactedDays

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

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

#### CleanupNeverEnrolledDevices

有効にすると、未登録の Autopilot デバイス（Intune に一度も接続していないデバイス）を削除します。

| プロパティ   | 値                           |
| ------- | --------------------------- |
| 必須      | いいえ                         |
| 既定値     | False                       |
| 種類      | ブール値                        |
| ポータル表示名 | 未登録の Autopilot デバイスをクリーンアップ |

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

| ポータルオプション           | 値 |
| ------------------- | - |
| はい - 経過した未登録デバイスを削除 |   |
| いいえ                 |   |

#### NeverEnrolledAgeDays

未登録デバイスの経過日数しきい値です。デバイス作成日を基準に測定されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      | 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 の Tenant 設定から取得されます。

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

#### StorageAccountName

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

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

#### LinkExpiryDays

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

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | いいえ                      |
| 既定値      | 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.