Runbook レポート設定

レポート用 Runbook の中央集約メールおよびストレージ配信設定を構成します。

概要

いくつかの RealmJoin runbook には、自動レポート機能が含まれており、レポート、通知、アラートを管理者に直接配信できます。構成に応じて、レポートは次の方法で配信できます:

• メールで送信 — 構成済みの送信元アドレスの代理として Microsoft Graph API を使用して

• Azure Storage Account にアップロード — および期限付きの SAS ダウンロード リンクとして利用可能にする

今後、両方の配信チャネルをサポートすることが、すべてのレポート用 runbook における標準となる予定です。まだすべてのレポート用 runbook が両方のチャネルをサポートしているわけではありませんが、サポート対象の runbook は継続的に増えています。両方のチャネルは個別にも、組み合わせても有効にできます。

共有設定はすべて次で一度だけ構成されます RealmJoin Runbook のカスタマイズ それぞれの機能を使用するすべての runbook に自動的に適用されます。runbook ごとに異なる設定（対象コンテナー名など）はこの中央構成には含まれず、それぞれの runbook に直接設定します。

これらの設定を使用する関数 — Send-RjReportEmail および Publish-RjRbFilesToStorageContainer — は、 RealmJoin.RunbookHelper PowerShell モジュールによって提供されます。詳細な使用方法のドキュメントについては、 レポート関数 を参照してください。

メール配信

前提条件

たとえば次のような専用の共有メールボックスの使用を推奨します [email protected]。このメールボックスは、すべてのレポートの送信元アドレスとして使用されます。受信者が自動レポートに返信することは想定されていないため、no-reply アドレスを使用できます。

構成

詳細は JSON ベースのカスタマイズ ドキュメントで説明されているように、移動先は RealmJoin Runbook のカスタマイズ RealmJoin Portal（Settings > Runbook Customizations）です。

次の 設定 ブロックで、 RJReport セクションを追加または変更し、 EmailSender プロパティに希望する送信元メールアドレスを含めます:

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[email protected]"
        }
    }
}

置き換えてください [email protected] 実際の共有メールボックス アドレスに。

Service Desk の連絡先情報（任意）

通知メールにサービスデスクの連絡先情報を含めるには、次のプロパティを RJReport セクションに追加します:

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[email protected]",
            "ServiceDesk_DisplayName": "IT Service Desk",
            "ServiceDesk_EMail": "[email protected]",
            "ServiceDesk_Phone": "[phone]"
        }
    }
}

パラメーター:

• ServiceDesk_DisplayName — サービスデスクの表示名（例: "IT Support", "Help Desk"）

• ServiceDesk_EMail — サービスデスクのメールアドレス（クリック可能な mailto: リンクとして表示）

• ServiceDesk_Phone — サービスデスクの電話番号（国際形式、クリック可能な tel: リンクとして表示）

3 つのパラメーターはすべて任意です。構成すると、メールのフッターにクリック可能なリンクとして表示されます。

Storage Account への配信

この配信チャネルをサポートするレポート用 runbook は、その出力を Azure Blob Storage コンテナーにアップロードできます。アップロードが成功すると、runbook はファイルを直接ダウンロードするために使用できる期限付きの SAS リンクを返します。このチャネルは、メール配信とは独立して、または追加で使用できます。

前提条件

既存の Azure Storage Account が必要です。Automation Account のマネージド ID（または runbook で使用される Service Principal）には、少なくとも Storage Blob Data Contributor Storage Account またはそのリソース グループに対する権限が必要です。

構成

次へ移動し、 RealmJoin Runbook のカスタマイズ 次を追加します StorageAccount サブセクションを RJReport ブロックに:

{
    "Settings": {
        "RJReport": {
            "StorageAccount": {
                "ResourceGroup": "rg-reports",
                "StorageAccountName": "stcontosoreports",
                "LinkExpiryDays": 6,
                "AddBlobNamePrefix": true,
                "UseRandomPrefix": false
            }
        }
    }
}

パラメーター:

設定	必須	既定値	説明
ResourceGroup	はい	—	Storage Account を含むリソース グループ
StorageAccountName	はい	—	Azure Storage Account の名前
LinkExpiryDays	いいえ	6	生成された SAS ダウンロード リンクの有効期限が切れるまでの日数
AddBlobNamePrefix	いいえ	true	タイムスタンプ（yyyyMMdd-HHmmss）を blob 名の先頭に付加して上書きを防ぎます
UseRandomPrefix	いいえ	false	タイムスタンプの代わりに 6 文字の英数字ランダム文字列をプレフィックスとして使用します。適用されるのは AddBlobNamePrefix が true

注: 個々の runbook に固有の設定 — たとえば対象コンテナー名やカスタム blob 名など — は、その runbook に直接構成され、この中央構成には意図的に含まれていません。

組み合わせ例

次のスニペットは、完全な RJReport すべての機能を有効にした構成を示しています:

{
    "Settings": {
        "RJReport": {
            "EmailSender": "[email protected]",
            "ServiceDesk_DisplayName": "IT Service Desk",
            "ServiceDesk_EMail": "[email protected]",
            "ServiceDesk_Phone": "[phone]",
            "StorageAccount": {
                "ResourceGroup": "rg-reports",
                "StorageAccountName": "stcontosoreports",
                "LinkExpiryDays": 6,
                "AddBlobNamePrefix": true,
                "UseRandomPrefix": false
            }
        }
    }
}