> 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 Based Customizing](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) のドキュメントを参照し、次へ移動します: [RealmJoin Runbook Customization](https://portal.realmjoin.com/settings/runbooks-customizations) RealmJoin ポータルの（Settings > Runbook Customizations）内。 次の `Settings` ブロックで、次を追加または変更します: `RJReport` セクションに次の項目を含めます: `EmailSender` プロパティに、希望する送信者のメールアドレスを指定します: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com" } } } ``` を置き換えてください `realmjoin-report@contoso.com` 実際の共有メールボックスのアドレスに。 ### Service Desk 連絡先情報（任意） この中央設定は、すべての Runbook に共通の Service Desk 値を提供するだけです。連絡先情報が実際に通知メールに含まれるかどうかは、各 Runbook 自身によって決まります。対応する Service Desk パラメーター（例: `ServiceDeskDisplayName`, `ServiceDeskPortalUrl`）がこれらの値を読み取り、各メールに表示します。 これらの Runbook に Service Desk の連絡先情報を提供するには、次のプロパティを `RJReport` セクションに追加します: ```json { "Settings": { "RJReport": { "EmailSender": "realmjoin-report@contoso.com", "ServiceDesk_DisplayName": "IT Service Desk", "ServiceDesk_EMail": "servicedesk@domain.com", "ServiceDesk_Phone": "+49123456789", "ServiceDesk_PortalUrl": "https://servicedesk.domain.com" } } } ``` **パラメーター:** * `ServiceDesk_DisplayName` — Service Desk の表示名（例: "IT Support", "Help Desk"） * `ServiceDesk_EMail` — Service Desk のメールアドレス（クリック可能な `mailto:` リンクとして表示されます） * `ServiceDesk_Phone` — Service Desk の電話番号（国際形式。クリック可能な `tel:` リンクとして表示されます） * `ServiceDesk_PortalUrl` — Service Desk ポータルまたは Web サイトの URL（クリック可能なリンクとして表示されます） すべてのパラメーターは任意です。構成されている場合、メールのフッターにクリック可能なリンクとして表示されます。 > **注:** 一部の Runbook では、実行ごとのチケット リンク（例: `ServiceDeskTicketUrl`）を追加で受け取り、要求のきっかけとなった特定のチケットを参照します。これは Runbook パラメーターであり、この中央設定の一部ではありません。 ## 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` | いいえ | `true` | タイムスタンプ（`yyyyMMdd-HHmmss`）を blob 名の先頭に付け、上書きを防止します | | `UseRandomPrefix` | いいえ | `false` | タイムスタンプの代わりに、6文字の英数字ランダム文字列をプレフィックスとして使用します。これは、次の場合にのみ適用されます: `AddBlobNamePrefix` です `true` | > **注:** 個々の 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", "ServiceDesk_PortalUrl": "https://servicedesk.domain.com", "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, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-report-settings.md?ask=&goal= ``` `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.