> 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 です。単一のオブジェクトに対してトリガーされるのではなく、繰り返しのスケジュールで実行されるように設計されています。詳細は [スケジューリング](/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. 候補一覧を確認してから、削除モードに切り替えてください。

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

* `削除モード` の既定値は *WhatIf（レポートのみ）*。そのモードでは削除は行われません。
* *Autopilot デバイスを削除* は Autopilot の識別情報のみを削除します。 *Autopilot デバイスと Entra デバイスを削除* は対応する Entra デバイス オブジェクトも追加で削除します。そうしないと、Autopilot の識別情報がなくなった後も古いレコードとして残ってしまいます。2 番目のモードでは、 `Device.ReadWrite.All` 権限が必要です。
* `孤立デバイスのクリーンアップ` および `未登録デバイスのクリーンアップ` は独立しており、どちらか一方または両方を有効にできます。 `未登録経過日数` は未登録チェックにのみ適用されます。
* `GroupTagFilter`, `メーカー フィルター` および `モデル フィルター` は任意です。フィルターを空欄にすると、その次元のすべての値を評価します。複数のフィルターが設定されている場合は AND で組み合わされるため、対象に残るにはデバイスが設定済みのすべてのフィルターに一致する必要があります。 `GroupTagFilter` グループ タグと完全一致します（大文字小文字を区別しません）； `メーカー フィルター` および `モデル フィルター` 大文字小文字を区別しない部分文字列として一致します。たとえば、「Dell」は「Dell Inc.」に、「Surface」は「Surface Laptop 3」に一致します。
* `除外シリアル番号` は 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.3.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 デバイスを検索し、「Autopilot デバイスと Entra デバイスを削除」モードで削除します*
  * DeviceManagementManagedDevices.Read.All
    * *Intune で管理されている Windows デバイスを読み取り、Intune に存在しなくなった Autopilot のシリアル番号を見つけます*
  * DeviceManagementServiceConfig.ReadWrite.All
    * *windowsAutopilotDeviceIdentities を列挙し、古くなった Autopilot の識別情報を削除します*
  * Mail.Send *(オプション — 機能: メール レポート)*
    * *EmailTo が設定されている場合、Send-RjReportEmail を使ってクリーンアップ レポートのメールを送信します*
  * Organization.Read.All
    * */organization を読み取り、レポート出力とメールに Tenant の表示名を表示します*

### パラメーター

#### 削除モード

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

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

#### GroupTagFilter

カンマ区切りで指定されたこれらの Autopilot グループ タグのいずれかに完全一致するデバイスのみ。すべて対象にするには空欄のままにしてください。

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

#### メーカー フィルター

カンマ区切りで、これらのメーカーのみを対象にします。Dell は Dell Inc. にも一致します。すべて対象にする場合は空欄にしてください。

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

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

カンマ区切りで、これらのモデルのみを対象にします。Surface は Surface Laptop 3 にも一致します。すべて対象にする場合は空欄にしてください。

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

#### 除外シリアル番号

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

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

#### 孤立デバイスのクリーンアップ

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

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

#### 孤立判定までの日数

デバイスは、Intune への最後の接触がこの日数より古い場合にのみ孤立デバイスと見なされるため、最近アクティブなデバイスは安全です。

| プロパティ   | 値       |
| ------- | ------- |
| 必須      | false   |
| 既定値     | 90      |
| 種類      | Int32   |
| ポータル表示名 | 孤立後（日数） |

#### 未登録デバイスのクリーンアップ

一度も Intune に接続しておらず、「未登録後（日数）」より古いデバイスの登録を削除します。

| プロパティ   | 値                    |
| ------- | -------------------- |
| 必須      | false                |
| 既定値     | False                |
| 種類      | ブール値                 |
| ポータル表示名 | 未登録デバイスをクリーンアップしますか? |

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

| ポータル オプション            | 値     |
| --------------------- | ----- |
| はい、古くなった未登録デバイスを削除します | true  |
| いいえ                   | false |

#### 未登録経過日数

作成日から数えてこの日数より古い未登録レコードは削除されます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | 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 |

#### コンテナー名

レポート ファイルがアップロードされるストレージ コンテナーです。runbook ごとに設定します。

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

#### リソース グループ名

レポート アップロード用のストレージ アカウントのリソース グループです。Tenant 設定 RJReport.StorageAccount.ResourceGroup から取得されます。

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

#### Storage Account 名

レポート アップロード用の Storage Account です。Tenant 設定 RJReport.StorageAccount.StorageAccountName から取得されます。

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

#### LinkExpiryDays

ダウンロード リンクが有効なままの期間（日数）です。Tenant 設定 RJReport.StorageAccount.LinkExpiryDays から取得されます。

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

[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/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.