> 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-report-settings.md). # Runbook レポート設定 ## 概要 複数の RealmJoin Runbooks では、自動レポート機能により、レポート、通知、アラートを管理者に直接配信できます。構成によって、レポートは次の方法で配信できます: * **メールで送信** — 構成済みの送信者アドレスを代表して Microsoft Graph API を使用して * **Azure Storage Account にアップロードされる** — そして、時間制限付きの SAS ダウンロード リンクとして利用可能になります 両方の配信チャネルをサポートすることが、今後すべてのレポート用 runbook の想定標準です。まだすべてのレポート用 runbook が両方のチャネルをサポートしているわけではありませんが、対応済み runbook のセットは継続的に拡大しています。両方のチャネルは、個別にも組み合わせても有効化できます。 共有設定はすべて、次の [RealmJoin Runbook Customization](https://portal.realmjoin.com/settings/runbooks-customizations) で一度だけ構成され、各機能を使用するすべての runbook に自動的に適用されます。runbook ごとに異なる設定（ターゲット コンテナー名など）は、この中央構成の一部ではなく、それぞれの runbook で直接設定します。 これらの設定を使用する関数 — [`Send-RjRbReportEmail`](/ja/dev-reference/report-functions/send-rjrbreportemail.md) および [`Publish-RjRbFilesToStorageContainer`](/ja/dev-reference/report-functions/publish-rjrbfilestostoragecontainer.md) — は、次の **RealmJoin.RunbookHelper** PowerShell モジュールです。 [レポート関数](/ja/dev-reference/report-functions.md) の詳細な使用ドキュメントを参照してください。 ## メール配信 ### 前提条件 専用の共有メールボックスの使用を推奨します。たとえば、 `realmjoin-report@contoso.com`。このメールボックスは、すべてのレポートの送信者アドレスとして使用されます。受信者が自動レポートに返信することは想定されないため、no-reply アドレスを使用できます。 ### 構成 で詳しく説明されているとおり、 [JSON ベースのカスタマイズ](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) ドキュメントを参照し、 [RealmJoin Runbook Customization](https://portal.realmjoin.com/settings/runbooks-customizations) RealmJoin Portal（Settings > Runbook Customizations）へ移動してください。 次の `Settings` ブロックで、次の `RJReport` セクションに `EmailSender` プロパティを追加し、希望する送信者メールアドレスを指定します: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com" } } } ``` 置き換えてください `realmjoin-report@contoso.com` 実際の共有メールボックス アドレスに ### サービスデスクの連絡先情報（任意） 通知メールにサービスデスクの連絡先情報を含めるには、次のプロパティを `RJReport` セクションに追加します: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "IT Service Desk", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789" } } } ``` **パラメーター:** * `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 Customization](https://portal.realmjoin.com/settings/runbooks-customizations) 次の `StorageAccount` サブセクションを `RJReport` ブロックに追加します: ```json { "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` | いいえ | `はい` | タイムスタンプ（`yyyyMMdd-HHmmss`）を blob 名の先頭に付加して、上書きを防ぎます | | `UseRandomPrefix` | いいえ | `いいえ` | タイムスタンプの代わりに 6 文字の英数字ランダム文字列をプレフィックスとして使用します。適用されるのは `AddBlobNamePrefix` です `はい` | > **注:** 個々の runbook に固有の設定—たとえばターゲット コンテナー名やカスタム Blob 名など—は、その runbook で直接構成され、この中央構成には意図的に含まれていません。 ## 組み合わせの例 次のスニペットは、完全な `RJReport` すべての機能を有効にした構成を示します: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "IT Service Desk", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789", "StorageAccount": { "ResourceGroup": "rg-reports", "StorageAccountName": "stcontosoreports", "LinkExpiryDays": 6, "AddBlobNamePrefix": true, "UseRandomPrefix": false } } } } ``` --- # 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: ``` GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-report-settings.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.