# 古いデバイスについてユーザーに通知をスケジュール

### 説明

指定した日数の間アクティブでなかったデバイスを識別し、それらのデバイスの主要ユーザーに個別のメール通知を送信します。メールにはデバイス情報とユーザー向けの対応手順が含まれます。必要に応じて、特定のグループを含めるか除外することでユーザーをフィルタリングできます。

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

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

この手順については、 [メールレポートのセットアップ](https://github.com/realmjoin/realmjoin-runbooks/tree/master/docs/general/setup-email-reporting.md) ドキュメントに詳しく記載されています。

### メールテンプレート言語の選択

この Runbook は 3 つのメールテンプレートオプションをサポートしています:

1. **EN (英語 - デフォルト)**: 組み込みの英語テンプレートを使用します
2. **DE (ドイツ語)**: 組み込みのドイツ語テンプレートを使用します
3. **カスタム**: Runbook Customizations のカスタムテンプレートを使用します

#### カスタムメールテンプレートの使用

カスタムメールテンプレート（たとえば、オランダ語、スペイン語、またはその他の言語）を使用するには、Runbook Customizations でテンプレートテキストを設定する必要があります。カスタムテンプレートのパラメーターが 1 つでも不足している場合、Runbook は自動的に英語テンプレートにフォールバックします。

**例: カスタムテンプレート**

```json
{
    "Runbooks": {
        "rjgit-org_devices_notify-users-about-stale-devices_scheduled": {
            "Parameters": {
                "CustomMailTemplateSubject": {
                    "Default": "これはカスタム件名です - 要対応: 非アクティブなデバイス"
                },
                "CustomMailTemplateBeforeDeviceDetails": {
                    "Default": "**これはデバイス詳細の上に表示されます。** \n\nDear user ..."
                },
                "CustomMailTemplateAfterDeviceDetails": {
                    "Default": "**これはデバイス詳細の下に表示されます。** \n\n## あなたが行うべきこと..."
                }
            }
        }
    }
}
```

**重要事項:**

* 使用してください `\n` JSON 設定での改行に使用します
* テンプレートテキストでは Markdown 書式（##, ###, \*\*, -）がサポートされています
* カスタムテンプレートの 3 つのパラメーター（Subject、BeforeDeviceDetails、AfterDeviceDetails）をすべて設定してください
* いずれかのパラメーターが不足している場合、Runbook は自動的に英語（EN）テンプレートにフォールバックします
* カスタムテンプレートを使用する場合は、Mail Template のドロップダウンで「Custom - Use Template from Runbook Customizations」を選択してください

### 場所

組織 → デバイス → 非アクティブなデバイスにユーザーへ通知（スケジュール済み）

**フル Runbook 名**

rjgit-org\_devices\_notify-users-about-stale-devices\_scheduled

### 権限

#### アプリケーションの権限

* **種類**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
  * Directory.Read.All
  * Device.Read.All
  * Group.Read.All
  * Mail.Send

### パラメーター

#### Days

非アクティブと見なすための、活動なしの日数（最小しきい値）。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   | 30    |
| 種類    | Int32 |

#### MaxDays

任意の、アクティビティがない最大日数。設定すると、Days と MaxDays の間で非アクティブなデバイスのみが含まれます。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | Int32 |

#### Windows

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

| プロパティ | 値       |
| ----- | ------- |
| 必須    | false   |
| 既定値   | True    |
| 種類    | Boolean |

#### MacOS

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

| プロパティ | 値       |
| ----- | ------- |
| 必須    | false   |
| 既定値   | True    |
| 種類    | Boolean |

#### iOS

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

| プロパティ | 値       |
| ----- | ------- |
| 必須    | false   |
| 既定値   | True    |
| 種類    | Boolean |

#### Android

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

| プロパティ | 値       |
| ----- | ------- |
| 必須    | false   |
| 既定値   | True    |
| 種類    | Boolean |

#### EmailFrom

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

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### ServiceDeskDisplayName

ユーザーの連絡先情報として表示する Service Desk の表示名（任意）。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### ServiceDeskEmail

ユーザーの連絡先情報として表示する Service Desk のメールアドレス（任意）。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### ServiceDeskPhone

ユーザーの連絡先情報として表示する Service Desk の電話番号（任意）。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### UseUserScope

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

| プロパティ | 値       |
| ----- | ------- |
| 必須    | false   |
| 既定値   | False   |
| 種類    | Boolean |

#### IncludeUserGroup

このグループのメンバーであるユーザーにのみメールを送信します。UseUserScope を有効にする必要があります。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### ExcludeUserGroup

このグループのメンバーであるユーザーにはメールを送信しません。UseUserScope を有効にする必要があります。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### OverrideEmailRecipient

任意: エンドユーザーの代わりにすべての通知を送信するメールアドレス。複数の受信者をカンマ区切りで指定できます。テスト、パイロット、チケットシステムへの送信に最適です。空欄のままにすると、メールは実際のエンドユーザーに送信されます。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### MailTemplateLanguage

使用するメールテンプレートを選択します: EN（英語、デフォルト）、DE（ドイツ語）、または Custom（Runbook Customizations から）。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   | EN    |
| 種類    | 文字列   |

#### CustomMailTemplateSubject

カスタムの件名（MailTemplateLanguage が 'Custom' に設定されている場合のみ使用）。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### CustomMailTemplateBeforeDeviceDetails

デバイス一覧の前に表示するカスタムテキスト（MailTemplateLanguage が 'Custom' に設定されている場合のみ使用）。Markdown 書式をサポートします。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

#### CustomMailTemplateAfterDeviceDetails

デバイス一覧の後に表示するカスタムテキスト（MailTemplateLanguage が 'Custom' に設定されている場合のみ使用）。Markdown 書式をサポートします。

| プロパティ | 値     |
| ----- | ----- |
| 必須    | false |
| 既定値   |       |
| 種類    | 文字列   |

[Runbook Reference の概要に戻る](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references)