> 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 デバイスをクリーンアップ（スケジュール済み）

孤立した、かつ一度も登録されていない Autopilot 登録を削除

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

### 説明

Windows Autopilot 登録をクリーンアップします。シリアル番号がもはやどの Intune デバイスにも一致しないデバイス（孤立したデバイス）、および必要に応じて、一度も登録されておらず一定日数より古いデバイスを対象とします。既定では、削除する場合に何が削除されるかをレポートするだけです。削除は明示的に有効化する必要があり、一致する Entra ID デバイス オブジェクトを含めることもできます。レポートはメールで送信するか、ダウンロード リンクとして提供できます。

### 削除は元に戻せません

* Autopilot デバイス ID を削除すると、Windows Autopilot から完全に削除されます。Autopilot レコードにソフト削除やごみ箱はありません。
* ハードウェア ハッシュが再度アップロードされるまで、物理デバイスは Autopilot に再参加できません。
* Entra デバイス オブジェクトの削除も同様に永続的です。本当に使われなくなったレコード、つまりデバイスが二度と登録されない場合にのみ実行してください。

### 推奨される最初の実行

1. 削除モードで実行 *WhatIf（レポートのみ）*、これは既定値であり、出力またはメールで送信された CSV を確認してください。
2. 識別されたデバイスが本当に孤立しているか、一度も登録されていないことを確認してください。
3. 候補リストを確認してから、削除モードに切り替えてください。

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

* `DeleteMode` は次を既定値とします *WhatIf（レポートのみ）*。このモードでは削除は発生しません。
* *Autopilot デバイスを削除* は Autopilot ID のみを削除します。 *Autopilot および Entra デバイスを削除* は、さらに一致する Entra デバイス オブジェクトも削除します。そうしないと、Autopilot ID が削除されたあとに古いレコードとして残ってしまいます。2 つ目のモードには `Device.ReadWrite.All` 権限。
* `CleanupOrphanedDevices` と `CleanupNeverEnrolledDevices` は相互に独立しています。どちらか一方、または両方を有効にできます。 `NeverEnrolledAgeDays` は、一度も登録されていないデバイスのチェックにのみ適用されます。
* `GroupTagFilter`, `ManufacturerFilter` と `ModelFilter` は省略可能です。各ディメンションのすべての値を評価するには、そのフィルターを空にしてください。複数のフィルターが設定されている場合は AND で結合されるため、対象に残るにはデバイスが設定済みのすべてのフィルターに一致する必要があります。 `GroupTagFilter` グループ タグと大文字小文字を区別せずに完全一致します。 `ManufacturerFilter` と `ModelFilter` は大文字小文字を区別しない部分文字列として一致するため、"Dell" は "Dell Inc." に一致し、"Surface" は "Surface Laptop 3" に一致します。
* `ExcludeSerialNumbers` は AND フィルターの後に除外として適用されます。リストに含まれるシリアル番号を持つデバイス（完全一致、大文字小文字を区別しない）は、他のフィルターに関係なく対象外になります。何も除外しない場合は空のままにしてください。

### メール送信に関する設定

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

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

詳細については、 [RealmJoin Report Settings のドキュメント](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).

### 場所

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

**完全な Runbook 名**

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

### 詳細

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

### アクセス許可

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

* **型**: 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

WhatIf は候補のみを報告します。Delete Autopilot device は Autopilot 登録を削除します。Delete Autopilot and Entra device は一致する Entra ID デバイス オブジェクトも削除します。

| プロパティ    | 値              |
| -------- | -------------- |
| 必須       | false          |
| 既定値      | WhatIf（レポートのみ） |
| 型        | 文字列            |
| ポータルの表示名 | 削除モード          |

#### GroupTagFilter

コンマ区切りで、これらの Autopilot グループ タグのいずれか 1 つだけを持つデバイスを、完全一致で対象にします。すべてを対象にするには空のままにしてください。

| プロパティ    | 値             |
| -------- | ------------- |
| 必須       | false         |
| 既定値      |               |
| 型        | 文字列           |
| ポータルの表示名 | グループ タグ フィルター |

#### ManufacturerFilter

コンマ区切りで指定したメーカーのみ。Dell は Dell Inc. にも一致します。すべて対象にするには空欄のままにします。

| プロパティ    | 値        |
| -------- | -------- |
| 必須       | false    |
| 既定値      |          |
| 型        | 文字列      |
| ポータルの表示名 | 製造元フィルター |

#### ModelFilter

コンマ区切りで指定したモデルのみ。Surface は Surface Laptop 3 にも一致します。すべて対象にするには空欄のままにします。

| プロパティ    | 値         |
| -------- | --------- |
| 必須       | false     |
| 既定値      |           |
| 型        | 文字列       |
| ポータルの表示名 | モデル フィルター |

#### ExcludeSerialNumbers

コンマ区切りで、決して処理されないシリアル番号です。何も除外しない場合は空のままにしてください。

| プロパティ    | 値          |
| -------- | ---------- |
| 必須       | false      |
| 既定値      |            |
| 型        | 文字列        |
| ポータルの表示名 | 除外するシリアル番号 |

#### CleanupOrphanedDevices

かつて Intune に接続したものの、現在は存在しないデバイスの登録を削除します。

| プロパティ    | 値                     |
| -------- | --------------------- |
| 必須       | false                 |
| 既定値      | True                  |
| 型        | ブール値                  |
| ポータルの表示名 | 孤立したデバイスをクリーンアップしますか？ |

#### OrphanedLastContactedDays

デバイスが孤立していると見なされるのは、Intune への最終接続がこの日数より前の場合のみです。そのため、最近アクティブだったデバイスは安全です。

| プロパティ    | 値         |
| -------- | --------- |
| 必須       | false     |
| 既定値      | 90        |
| 型        | Int32     |
| ポータルの表示名 | 孤立判定までの日数 |

#### CleanupNeverEnrolledDevices

一度も Intune に接続せず、「Never-enrolled after (days)」より古いデバイスの登録を削除します。

| プロパティ    | 値                            |
| -------- | ---------------------------- |
| 必須       | false                        |
| 既定値      | False                        |
| 型        | ブール値                         |
| ポータルの表示名 | 一度も登録されていないデバイスをクリーンアップしますか？ |

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

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

#### NeverEnrolledAgeDays

作成日から数えてこの日数より古い、一度も登録されていない登録は削除されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | 90                       |
| 型        | Int32                    |
| ポータルの表示名 | 未登録後の日数                  |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### EmailTo

クリーンアップ レポートをこれらの宛先に、コンマ区切りで送信します。メールを送信しない場合は空のままにしてください。

| プロパティ    | 値            |
| -------- | ------------ |
| 必須       | false        |
| 既定値      |              |
| 型        | 文字列          |
| ポータルの表示名 | 受信者のメール アドレス |

#### EmailFrom

レポート メールの送信者アドレス。テナント設定 RJReport.EmailSender から取得されます。

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

#### BrandingHeaderImageUrl

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

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

#### BrandingFooterImageUrl

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

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

#### BrandingFooterLink

レポート メールのフッター画像の背後にあるリンク先。テナント設定 RJReport.Branding.FooterLink から取得されます。空の場合は realmjoin.com が使用されます。

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

#### BrandingAccentColor

レポート メールのアクセント色を 6 桁の 16 進値で指定します。テナント設定 RJReport.Branding.AccentColor から取得されます。空または無効な場合は RealmJoin の既定値が使用されます。

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

#### BrandingTextColor

レポート メールのテキスト色を 6 桁の 16 進値で指定します。テナント設定 RJReport.Branding.TextColor から取得されます。空または無効な場合は RealmJoin の既定値が使用されます。

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

#### ReportFileFormat

レポートを CSV、Excel ブック、またはその両方で配信します。

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

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

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

#### CreateDownloadLink

レポートもアップロードし、数日後に期限切れになるダウンロード リンクを返します。

| プロパティ    | 値                  |
| -------- | ------------------ |
| 必須       | false              |
| 既定値      | False              |
| 型        | ブール値               |
| ポータルの表示名 | ダウンロード リンクを作成しますか? |

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

| ポータル オプション                      | 値     |
| ------------------------------- | ----- |
| はい - レポートをアップロードし、ダウンロード リンクを返す | true  |
| いいえ - ダウンロード リンクを作成しない          | false |

#### ContainerName

レポート ファイルをアップロードする Storage container。runbook ごとに設定します。

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

#### ResourceGroupName

レポート アップロード用の Storage Account のリソース グループ。テナント設定 RJReport.StorageAccount.ResourceGroup から取得します。

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

#### StorageAccountName

レポート アップロード用の Storage Account。テナント設定 RJReport.StorageAccount.StorageAccountName から取得します。

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

#### SubscriptionId

レポート アップロード用の Storage Account のサブスクリプション ID。テナント設定 RJReport.StorageAccount.SubscriptionId から取得します。空の場合は、管理対象 ID がサインインするサブスクリプションが使用されます。

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

#### LinkExpiryDays

ダウンロード リンクの有効期間（日数）。テナント設定 RJReport.StorageAccount.LinkExpiryDays から取得します。

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

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