> 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/delete-stale-devices_scheduled.md).

# 古いデバイスを削除（スケジュール済み）

長期間非アクティブな Intune デバイスを削除

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

### 説明

Intune デバイスのうち、指定した日数の間チェックインしていないものを、プラットフォームで絞り込み、必要に応じてグループ メンバーシップでも絞り込みます。含めるグループは、そのユーザーのデバイスに実行対象を限定します。除外グループは、そのユーザーのデバイスと、そのグループ自体に属するデバイスを保護します。既定では、削除される内容のみを一覧表示します。削除は明示的にオンにする必要があります。レポートはメールで送信するか、ダウンロード リンクとして提供できます。

### 一般的な使用例

この runbook は、非アクティブ状態に基づいて Intune から管理対象デバイスを削除するため、注意して使用してください。

* Intune での古いデバイス レコードの定期的なクリーンアップ
* 実際の削除を有効にする前のシミュレーション実行（レポートのみモード）
* メール レポートによる監査証跡付きのスケジュール済みライフサイクル管理

### 非アクティブしきい値

*アクティビティがない日数* 1 ～ 3650 日を受け入れます。デバイスの最後のチェックインが少なくともその日数前である場合、そのデバイスは古いものとして扱われます。

### ユーザー範囲フィルター

runbook では、削除が有効な場合の追加の安全策として、必要に応じてグループ フィルターを使用できます。ネストされたグループのメンバーも対象になります。

* **含めるグループ** - 所属しているプライマリ ユーザーを持つデバイスのみが対象です。プライマリ ユーザーを持たないデバイス、およびプライマリ ユーザーが Entra ID から削除されたデバイスは除外されます。
* **除外グループ** - 所属しているプライマリ ユーザーを持つデバイスはスキップされます。Entra ID のデバイス オブジェクト自体がそのグループのメンバーであるデバイスもスキップされます。そのため、「Intune - do not delete」のようなデバイス グループは、そのデバイスを保護します。削除済みユーザーのデバイスは対象のままです。

グループ メンバーシップは、Intune に記録されているプライマリ ユーザーのオブジェクト ID に対して確認されるため、ユーザー プリンシパル名が変更されてもフィルターには影響しません。

グループが設定されている場合は常に適用されます。runbook が API 経由で起動された場合や、次の設定なしでスケジュールによって起動された場合も同様です。 *プライマリ ユーザーのグループでフィルターしますか?* 選択。 *はい、グループ メンバーシップでフィルター* グループを選択しないと、何も削除される前に実行は停止します。

フィルターはクローズドで失敗します:

* 選択したグループを読み取れない場合、または含めるグループにユーザーが含まれていない場合、実行はエラーで停止し、デバイスは削除されません。
* Intune がデバイスのプライマリ ユーザーを記録しているが、ユーザー オブジェクト ID がない場合、そのデバイスは削除されません。次のステータスで一覧表示されます。 *スキップ済み: プライマリ ユーザーを解決できませんでした* 手動レビュー用に。

### ダウンロード リンク

ダウンロード リンクへのアップロードが失敗した場合でも、メール レポートと出力データは配信されるため、削除されたデバイスの一覧が失われることはありません。その後、ジョブは失敗として終了します。

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

メール レポートの送信は任意であり、受信者（`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).

### 場所

組織 → デバイス → 古いデバイスの削除（スケジュール済み）

**完全な Runbook 名**

rjgit-org\_devices\_delete-stale-devices\_scheduled

### 詳細

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

### アクセス許可

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

* **型**: Microsoft Graph
  * DeviceManagementManagedDevices.ReadWrite.All
    * *古い Intune デバイスを一覧表示し、DELETE /deviceManagement/managedDevices/{id}  মাধ্যমে削除します*
  * Directory.Read.All
    * *include/exclude グループのメンバー、プライマリ ユーザーの詳細、Tenant 名を読み取ります*
  * Mail.Send *（任意 — 機能: メール レポート）*
    * *EmailTo が構成されている場合、Send-RjRbReportEmail を使用してレポート メールを送信します*
  * Organization.Read.All *（任意 — 機能: メール レポート）*
    * *メールの件名、メール本文、レポート ファイル名のために Tenant の表示名を読み取ります*

### パラメーター

#### 日数

少なくともこの日数チェックインしていないデバイスは古いものと見なされます。指定可能なのは 1 ～ 3650 日です。

| プロパティ    | 値            |
| -------- | ------------ |
| 必須       | false        |
| 既定値      | 30           |
| 型        | Int32        |
| ポータルの表示名 | アクティビティがない日数 |

#### Windows

Windows デバイスを含みます。

| プロパティ    | 値                   |
| -------- | ------------------- |
| 必須       | false               |
| 既定値      | True                |
| 型        | ブール値                |
| ポータルの表示名 | Windows デバイスを含めますか？ |

#### macOS

macOS デバイスを含みます。

| プロパティ    | 値                 |
| -------- | ----------------- |
| 必須       | false             |
| 既定値      | True              |
| 型        | ブール値              |
| ポータルの表示名 | macOS デバイスを含めますか？ |

#### iOS

iOS および iPadOS デバイスが含まれます。

| プロパティ    | 値               |
| -------- | --------------- |
| 必須       | false           |
| 既定値      | True            |
| 型        | ブール値            |
| ポータルの表示名 | iOS デバイスを含めますか? |

#### Android

Android デバイスが含まれます。

| プロパティ    | 値                   |
| -------- | ------------------- |
| 必須       | false               |
| 既定値      | True                |
| 型        | ブール値                |
| ポータルの表示名 | Android デバイスを含めますか? |

#### DeleteDevices

Delete は古いデバイスを Intune から削除します。Report only はそれらを一覧表示するだけで、何も変更しません。

| プロパティ    | 値     |
| -------- | ----- |
| 必須       | false |
| 既定値      | False |
| 型        | ブール値  |
| ポータルの表示名 | 削除モード |

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

| ポータル オプション                    | 値     |
| ----------------------------- | ----- |
| レポートのみ - 削除される内容を表示（シミュレーション） | false |
| 古いデバイスを Intune から削除           | true  |

#### 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                    |
| 既定値      | delete-stale-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 のカスタマイズで事前設定） |

#### UseUserScope

「プライマリ ユーザー グループでフィルターしますか?」の選択によって設定されます。「はい」の場合、少なくとも 1 つのグループが必要です。「グループからユーザーを含める」または「グループからユーザーを除外する」のグループは、設定されている場合は常に適用され、この選択がなくても適用されます。

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

#### IncludeUserGroup

このグループのメンバーであるプライマリ ユーザーを持つデバイスのみ。ネストされたグループを通じて直接対象になります。プライマリ ユーザーのいないデバイスは除外されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルの表示名 | グループからユーザーを含める           |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ExcludeUserGroup

このグループのメンバーであるプライマリ ユーザーを持つデバイスと、そのグループ自体に属するデバイスを、直接またはネストされたグループを通じてスキップします。スキップされたデバイスは削除されることはありません。

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

#### EmailTo

レポートをこれらのアドレスに送信します。複数ある場合はカンマで区切ってください。各受信者には個別のメールが送信されます。

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

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