> 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).

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

最終アクティビティ日とプラットフォームに基づく古いデバイスのスケジュール削除

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

### 説明

指定した日数の間アクティブでない Intune 管理デバイスを特定します。既定では、この runbook はレポートのみモード（シミュレーション）で実行され、削除対象となるデバイスを一覧表示します。削除が有効な場合は、条件に一致したデバイスが Intune から削除され、結果はレポートに含まれます。CSV および/または Excel (xlsx) の添付ファイル付きのメール レポートをオプションで送信でき、レポート ファイルを Azure Storage Account にアップロードして、期限付きのダウンロード リンクを返すこともできます。

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

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

### 場所

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

**完全な runbook 名**

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

### 詳細

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

### 注記

この runbook は、非アクティブ状態に基づいて Intune から管理デバイスを削除します。慎重に使用してください！

前提条件:

* メール レポートを使用する場合、EmailFrom パラメーターは runbook のカスタマイズ（RJReport.EmailSender 設定）で構成する必要があります

一般的な使用例:

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

この runbook は、プライマリ ユーザーのグループ所属に基づいてデバイスを含める／除外するための、オプションのユーザー スコープ フィルターをサポートします。これは、削除が有効な場合の追加の安全策として機能します。

### アクセス許可

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

* **種類**: Microsoft Graph
  * DeviceManagementManagedDevices.ReadWrite.All
    * *古い Intune デバイスを一覧表示し、DELETE /deviceManagement/managedDevices/{id} を介して削除します*
  * Directory.Read.All
    * *含める/除外するグループのメンバー、主ユーザーの詳細、および Tenant 名を読み取ります*
  * Mail.Send *(オプション — 機能: メール レポート)*
    * *EmailTo が構成されている場合、Send-RjReportEmail を使用してレポート メールを送信します*

### パラメーター

#### 日数

古いと見なすまでの非アクティブ日数。

| プロパティ   | 値              |
| ------- | -------------- |
| 必須      | いいえ            |
| 既定値     | 30             |
| 種類      | Int32          |
| ポータル表示名 | 非アクティブと見なす最小日数 |

#### Windows

結果に Windows デバイスを含めます。

| プロパティ   | 値                |
| ------- | ---------------- |
| 必須      | いいえ              |
| 既定値     | True             |
| 種類      | ブール値             |
| ポータル表示名 | Windows デバイスを含める |

#### macOS

結果に macOS デバイスを含めます。

| プロパティ   | 値              |
| ------- | -------------- |
| 必須      | いいえ            |
| 既定値     | True           |
| 種類      | ブール値           |
| ポータル表示名 | macOS デバイスを含める |

#### iOS

結果に iOS デバイスを含めます。

| プロパティ   | 値            |
| ------- | ------------ |
| 必須      | いいえ          |
| 既定値     | True         |
| 種類      | ブール値         |
| ポータル表示名 | iOS デバイスを含める |

#### Android

結果に Android デバイスを含めます。

| プロパティ   | 値                |
| ------- | ---------------- |
| 必須      | いいえ              |
| 既定値     | True             |
| 種類      | ブール値             |
| ポータル表示名 | Android デバイスを含める |

#### DeleteDevices

true に設定すると、一致する古いデバイスは Intune から削除されます。false（既定）の場合、runbook は削除対象となるデバイスのみを報告します（シミュレーション）。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | いいえ   |
| 既定値     | False |
| 種類      | ブール値  |
| ポータル表示名 | 削除モード |

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

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

#### EmailFrom

送信者のメールアドレス。これは runbook のカスタマイズで構成する必要があります

| プロパティ     | 値                        |
| --------- | ------------------------ |
| 必須        | いいえ                      |
| 既定値       |                          |
| 種類        | 文字列                      |
| ポータルでは非表示 | はい（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

レポートメール テンプレート用の任意のアクセント色の上書き（6 桁の 16 進数、例: '#0052cc'）。RJReport.Branding.AccentColor テナント設定から取得されます。空または無効な場合は、既定の RealmJoin アクセント色が使用されます。

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

#### BrandingTextColor

レポートメール テンプレート用の任意のテキスト色の上書き（6 桁の 16 進数）。RJReport.Branding.TextColor テナント設定から取得されます。空または無効な場合は、既定の RealmJoin テキスト色が使用されます。

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

#### ReportFileFormat

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

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

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

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

#### CreateDownloadLink

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

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

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

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

#### ContainerName

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

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

#### ResourceGroupName

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

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

#### StorageAccountName

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

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

#### LinkExpiryDays

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

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

#### UseUserScope

主ユーザー グループのメンバーシップに基づいてデバイスを含める/除外するために、ユーザー スコープ フィルターを有効にします。

| プロパティ     | 値                        |
| --------- | ------------------------ |
| 必須        | いいえ                      |
| 既定値       | False                    |
| 種類        | ブール値                     |
| ポータル表示名   | ユーザー スコープ フィルタリングを使用     |
| ポータルでは非表示 | はい（runbook のカスタマイズで事前設定） |

#### IncludeUserGroup

主ユーザーがこのグループのメンバーであるデバイスのみを含めます。UseUserScope を有効にする必要があります。

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

#### ExcludeUserGroup

主ユーザーがこのグループのメンバーであるデバイスを除外します。UseUserScope を有効にする必要があります。

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

#### EmailTo

指定した場合、レポートを含むメールが指定された宛先アドレスに送信されます。1 つのアドレスでも、カンマ区切りの複数アドレスでも指定できます（文字列）。関数はプライバシー保護のため、受信者ごとに個別のメールを送信します。

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

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