> 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/dev-reference/report-functions/send-rjrbreportemail.md).

# Send-RjRbReportEmail

Markdown コンテンツを使用して Microsoft Graph 経由で、ブランド付き HTML レポート メールを Azure Automation runbook から送信します。

## 概要

`Send-RjRbReportEmail` RealmJoin のレポート runbook からレポートメールを配信するための標準ヘルパーです。Markdown コンテンツを受け取り、RealmJoin ブランドのレスポンシブ HTML メールに変換し、任意のファイルとインラインのブランディング画像（ヘッダー/フッター）を添付し、結果を Microsoft Graph 経由で送信します `sendMail` エンドポイント。

> **このリリースで名前が変更されました。** この関数は次の名前から変更されました: `Send-RjReportEmail` を `Send-RjRbReportEmail` モジュールの他の部分との命名の一貫性を保つために（`*-RjRb*`）。旧名 `Send-RjReportEmail` は後方互換のエイリアスとしてエクスポートされるため、既存の runbook は変更なしで引き続き動作します — ただし、新しい runbook では次を呼び出してください `Send-RjRbReportEmail`.

主な特徴:

* **Markdown 入力、HTML 出力** — runbook はレポート本文を Markdown で作成します。この関数はそれをテーマ付き HTML にレンダリングし、Outlook Classic、New Outlook、Outlook Web、モバイル クライアント、およびダークモードで動作します。
* **受信者ごとに1通のメール** — 複数の受信者が指定された場合、1通の複数受信者宛てメールではなく、各アドレスに個別のメッセージを送信します。これはプライバシー/BCC 既定の設計です。
* **インラインのブランド付きヘッダーとフッター** — 同梱の PNG アセットは CID 添付として送信され、埋め込み HTML から参照されます。どちらも上書きまたは完全に無効化できます。
* **テンプレート色をカスタマイズ可能** — テンプレートのアクセント色とテキスト色は呼び出しごとに上書きできるため、レポートメールを顧客のコーポレートデザインに合わせられます。
* **組み込みの添付サイズガード** — 通常のセットがサイズ上限を超えるか、その送信試行が失敗した場合、任意の小さいフォールバック添付セットが自動的に送信されます。
* **自動接続** — Graph セッションがアクティブでない場合、この関数は透過的に次を呼び出します `Connect-RjRbGraph` （または `Connect-MgGraph -Identity` の場合 `-UseNativeGraphRequest` が設定されているとき）。
* **堅牢** — 失敗した添付の読み取り、無効な画像の上書き、無効な色、または受信者ごとの sendMail 失敗は報告されますが、すべての受信者が失敗しない限りバッチ全体は中止されません *すべての* 受信者が失敗した場合。

集中管理されたメール設定（送信者アドレス、サービスデスク情報）は次で文書化されています [Runbook レポート設定](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-report-settings.md) — このドキュメントは、runbook からこの関数を呼び出す方法に焦点を当てています。

## 前提条件

### 送信者メールボックス

ライセンス付与済みの Microsoft 365 メールボックス（通常は次のような専用の共有メールボックス） `realmjoin-report@contoso.com`）が `From` アドレスとして必要です。Automation Account のマネージド ID には、そのメールボックスの代理として Graph 経由で送信することを許可する必要があります `Mail.Send` application permission（ID を単一のメールボックスに制限したい場合は RBAC for Applications でスコープ指定）

> **送信者は Microsoft 365 グループであってはなりません。** この関数は Graph エンドポイント経由で送信します `/users/{EmailFrom}/sendMail` — Microsoft 365 グループは user オブジェクトではないため、呼び出しは失敗します。user か共有メールボックスを使用してください。
>
> Microsoft 365 グループのアドレスは **受信者として** 技術的には受け入れられますが、 **推奨されません**: メッセージがグループ メールボックスにしか届かない可能性があり（メンバーはグループをフォローしている場合のみ個別コピーを受け取ります）、グループの配信管理が送信者を拒否する場合があり、配信失敗は送信者メールボックス内の NDR としてのみ表面化します — runbook 自体は成功を報告したままです。個々のメールボックス アドレスを推奨します。

### Graph の権限

| シナリオ                             | 必要な権限                                    |
| -------------------------------- | ---------------------------------------- |
| 既定（`Invoke-RjRbRestMethodGraph`) | `Mail.Send` （Application）を送信者メールボックスに対して |
| 次の場合は `-UseNativeGraphRequest`   | 同じです — 呼び出しは引き続き `/users/{id}/sendMail`  |

### モジュール接続

既定では、この関数は `Invoke-RjRbRestMethodGraph` をこのモジュールから使用します。接続がアクティブでない場合は、次を介して自動接続します `Connect-RjRbGraph`。 `-UseNativeGraphRequest` が設定されている場合、関数は代わりに次を確認します `Get-MgContext` そして次を呼び出します `Connect-MgGraph -Identity -NoWelcome` 必要に応じて。

## クイック スタート

最小構成の呼び出しに必要なのは、送信者、受信者、件名、そして Markdown 本文だけです:

```powershell
Send-RjRbReportEmail `
    -EmailFrom "realmjoin-report@contoso.com" `
    -EmailTo   "alice@contoso.com" `
    -Subject   "Weekly Report" `
    -MarkdownContent @"
# 週次レポート

こんにちは、Alice,

今週の数値は次のとおりです:

- 新しく登録されたデバイス: **42**
- ライセンス準拠率: **98%**
"@
```

これにより、既定のヘッダーとフッター、ライト/ダークモード対応、そしてフッター内のテナント/バージョン ブロックを備えた、完全にブランド化された RealmJoin メールが生成されます。

## パラメーター

### 必須

| パラメーター            | 型        | 説明                                                                                                                                                  |
| ----------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `EmailFrom`       | `string` | 送信者メールボックスのユーザー プリンシパル名またはオブジェクト ID。次として使用されます `/users/{id}/sendMail`。user または共有メールボックスである必要があります — Microsoft 365 グループは user オブジェクトではないため、送信は失敗します。 |
| `EmailTo`         | `string` | 受信者アドレス。 **単一の文字列** — 複数のアドレスはカンマ区切りのリストとして渡されます。以下を参照してください。Microsoft 365 グループのアドレスは受け入れられますが、推奨されません — メンバーへの配信は保証されず、失敗は runbook からは見えません。       |
| `件名`              | `string` | 件名行。HTML にも挿入されます `<title>` 要素。                                                                                                                     |
| `MarkdownContent` | `string` | Markdown 形式のレポート本文。 [Markdown サポート](#markdown-support) 対応構文についてはこちら。                                                                                |

### オプション — 内容

| パラメーター              | 型          | 既定値     | 説明                                                                                                |
| ------------------- | ---------- | ------- | ------------------------------------------------------------------------------------------------- |
| `添付`                | `string[]` | `@()`   | 添付するローカル ファイル パス。存在しないファイルはログに記録されてスキップされ、読み取れないファイルは警告を出しますが送信は中断されません。MIME タイプはファイル拡張子から推定されます。 |
| `saveToSentItems`   | `bool`     | `$true` | もし `$true` 送信されたメッセージが送信者メールボックスの *送信済みアイテム*。次に設定すると `$false` 大量レポートでメールボックスがいっぱいになるのを避けるために      |
| `TenantDisplayName` | `string`   | —       | コンテンツ領域の末尾に埋め込まれたテナント情報ボックスに表示されます。                                                               |
| `ReportVersion`     | `string`   | —       | テナント情報ボックスに表示されます（セマンティック バージョン文字列、ビルド番号、または runbook 名 + 日付を使用してください）。                            |

### オプション — ブランディング

| パラメーター        | 型        | 既定値                         | 説明                                                                                                                                                                        |
| ------------- | -------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `HeaderImage` | `string` | 同梱の `Assets/Header.png`     | 既定のヘッダー画像を上書きする PNG/JPG/GIF へのローカル ファイル パス。 **runbook は URL/blob をあらかじめローカル ファイルに解決しておく必要があります** （例: `Get-AzStorageBlobContent`）。存在しない/読み取れない上書きは同梱の既定値にフォールバックし、警告を出します。 |
| `FooterImage` | `string` | 同梱の `Assets/Footer.png`     | 同じ扱いです `HeaderImage`。フッターは1つのクリック可能な画像としてレンダリングされます — ブランディング テキスト、ロゴ、URL はすべて PNG に埋め込む必要があります。                                                                          |
| `FooterLink`  | `string` | `https://www.realmjoin.com` | URL は次として使用されます `href` と `title` フッター画像を囲むアンカーの                                                                                                                           |
| `NoHeader`    | `スイッチ`   | オフ                          | ヘッダー画像を完全に抑制します。これと組み合わせた場合 `HeaderImage`、警告が出され、上書きは無視されます。                                                                                                              |
| `NoFooter`    | `スイッチ`   | オフ                          | フッター画像とそのリンクを完全に抑制します。これと組み合わせた場合 `FooterImage` またはカスタムの `FooterLink`、警告が出され、それらの値は無視されます。                                                                                |
| `AccentColor` | `string` | `#f8842c`                   | *0.8.9 で追加。* テーブルのヘッダー行、アクション ボタン、情報ボックスのアクセント枠線用の 6 桁の hex カラー。空または不正な値の場合は警告を出し、既定値にフォールバックします。                                                                         |
| `TextColor`   | `string` | `#011e33`                   | *0.8.9 で追加。* 本文テキスト、見出し、リスト項目、コード用の 6 桁の hex カラー。フォールバック動作は `AccentColor`.                                                                                                |

**推奨画像サイズ:** 750 × 200 px の PNG です。これはメール コンテナーの幅と同梱の既定値に一致します。大きく異なるアスペクト比は狭いビューポートで歪んで見える場合があります。各画像は 3 MB を大きく下回るようにしてください — Graph は合計 `sendMail` 要求を 4 MB に制限し、どちらかの画像が 3 MB を超えると警告を出します。

**色:** なしでは `AccentColor`/`TextColor` 生成される HTML は、以前のモジュール バージョンとバイト単位で同一です — 既定値は RealmJoin のオレンジとネイビーです。状態色（緑/赤/琥珀）とニュートラル グレーは意味を伝えるため、意図的にパラメーター化していません。カスタム色はライトモードとダークモードの両方で確認してください: コンテンツ カードはダークモードでも白のままなので、非常に明るいテキスト色は読めなくなります。

### オプション — 添付サイズガード

*0.8.9 で追加。* Graph は全体の `sendMail` 要求を、メッセージが約 4 MB を超えると拒否します。レポートを失敗させる代わりに、この関数はより小さい添付セットにフォールバックできます。このロジックは以前、インライン runbook ヘルパー `Send-RjRbGuardedReportEmail` として重複していましたが、現在は関数自体の一部になっています。

| パラメーター                    | 型          | 既定値                  | 説明                                                                                                                                       |
| ------------------------- | ---------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `FallbackAttachments`     | `string[]` | —                    | 通常のセットが次を超えた場合に使用される小さい添付セット `MaxAttachmentBytes`、または通常のセットでの送信がすべての受信者で失敗した場合に使用されます。このパラメーターがない場合、フォールバックはなく、失敗した送信は即座に例外を投げます。        |
| `FallbackMarkdownContent` | `string`   | の値 `MarkdownContent` | フォールバック セットが送信されるときに使用する本文 — どのファイルが除外されたか、どう入手するかを説明するために使ってください。                                                                       |
| `MaxAttachmentBytes`      | `long`     | `2.5MB`              | 通常の添付セットの生サイズ上限。base64 エンコード（+33%）、HTML 本文、インライン ブランディング画像を含めても、約 4 MB の Graph 制限を安全に下回ります。次の場合にのみ評価されます `FallbackAttachments` が指定されたとき。 |

ガードは 2 段階で動作します:

1. **送信前** — 通常のセットが上限を超える場合、フォールバック セットが直接送信され、メッセージで両方のサイズが示されます。
2. **送信失敗後** — 通常のセットでの送信が *すべての* 受信者で失敗した場合、関数が例外を投げる前にフォールバック セットで 1 回再試行されます。

### オプション — 送信手段

| パラメーター                  | 型      | 既定値 | 説明                                                                                                                                                                                                |
| ----------------------- | ------ | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `UseNativeGraphRequest` | `スイッチ` | オフ  | 次を介して送信します `Invoke-MgGraphRequest` （必要 `Microsoft.Graph` モジュールと `Connect-MgGraph` のセッションが必要）として送信します。代わりに `Invoke-RjRbRestMethodGraph`。runbook が RealmJoin ラッパーではなくネイティブ SDK を中心に構築されている場合に使用します。 |

## 使用例

### 複数の受信者

`EmailTo` カンマ区切りのアドレスを 1 つ以上含む単一文字列を受け入れます。各アドレスは前後の空白が削除され、空のエントリは除去され、 **受信者ごとに1通の個別メールが送信されます** — 受信者同士は互いに見えません。

```powershell
Send-RjRbReportEmail `
    -EmailFrom "realmjoin-report@contoso.com" `
    -EmailTo   "alice@contoso.com, bob@contoso.com, team-lead@contoso.com" `
    -Subject   "Monthly Inventory" `
    -MarkdownContent $reportMd
```

### 添付とテナント メタデータ付き

```powershell
$csvPath = Join-Path $env:TEMP 'devices.csv'
$exportData | Export-Csv -Path $csvPath -NoTypeInformation -Encoding UTF8

Send-RjRbReportEmail `
    -EmailFrom         "realmjoin-report@contoso.com" `
    -EmailTo           "it-reports@contoso.com" `
    -Subject           "Device Inventory — $(Get-Date -Format 'yyyy-MM-dd')" `
    -MarkdownContent   $reportMd `
    -Attachments       @($csvPath, "$env:TEMP\\summary.xlsx") `
    -TenantDisplayName "Contoso Ltd" `
    -ReportVersion     "DeviceInventory v1.4.2"
```

添付ファイルは、メッセージへの実際の添付として追加されるだけでなく、メール本文下部の「添付ファイル」ボックスにも一覧表示されます。

### カスタムのヘッダー/フッター ブランディング

まずアセットをローカル パスにダウンロードして独自のブランディングを用意し、その後でそのパスを渡してください。この関数自体は URL を取得しません。

```powershell
# Azure Blob Storage から runbook の一時フォルダーへブランディング アセットを解決
$headerPath = Join-Path $env:TEMP 'contoso-header.png'
$footerPath = Join-Path $env:TEMP 'contoso-footer.png'

Get-AzStorageBlobContent -Container 'branding' -Blob 'header.png' -Destination $headerPath -Force | Out-Null
Get-AzStorageBlobContent -Container 'branding' -Blob 'footer.png' -Destination $footerPath -Force | Out-Null

Send-RjRbReportEmail `
    -EmailFrom        "realmjoin-report@contoso.com" `
    -EmailTo          "alice@contoso.com" `
    -Subject          "Branded Report" `
    -MarkdownContent  $reportMd `
    -HeaderImage      $headerPath `
    -FooterImage      $footerPath `
    -FooterLink       "https://intranet.contoso.com/it-reports"
```

もし `$headerPath` が見つからないか読み取れない場合でも、呼び出しは成功します — 同梱の RealmJoin 既定値が使用され、警告が記録されます。

### カスタムのテンプレート色

メールを顧客のコーポレートデザインに合わせます。両方のパラメーターは独立しているため、アクセント色だけを上書きしても既定のテキスト色は維持されます:

```powershell
Send-RjRbReportEmail `
    -EmailFrom       "realmjoin-report@contoso.com" `
    -EmailTo         "alice@contoso.com" `
    -Subject         "Branded Report" `
    -MarkdownContent $reportMd `
    -AccentColor     "#0052cc" `
    -TextColor       "#1a1a2e"
```

無効な値（たとえば `blue` または `#05c`）でも送信は失敗しません: 警告で該当パラメーター名が示され、既定色が使用されます。

### フォールバック添付セットを使う大きなレポート

CSV と Excel ワークブックを生成しますが、2つを合わせるとサイズ上限を超える場合はワークブックのみへフォールバックします:

```powershell
$sizeHint = "CSV エクスポートは添付ファイルがメール サイズ制限を超えたため省略されました。Excel ワークブックには完全なデータが含まれています。"

Send-RjRbReportEmail `
    -EmailFrom                "realmjoin-report@contoso.com" `
    -EmailTo                  "it-reports@contoso.com" `
    -Subject                  "Device Inventory" `
    -MarkdownContent          $reportMd `
    -Attachments              @($csvPath, $xlsxPath) `
    -FallbackAttachments      @($xlsxPath) `
    -FallbackMarkdownContent  ($reportMd + "`n`n> **Note:** $sizeHint")
```

インライン ヘルパーから移行する runbook `Send-RjRbGuardedReportEmail` はその関数を削除し、呼び出しを次に変更できます `Send-RjRbReportEmail` — パラメーター名（`添付`, `FallbackAttachments`, `FallbackMarkdownContent`, `MaxAttachmentBytes`）は変更されていません。

### プレーン コンテンツ（ヘッダー/フッターなし）

マーケティング メールのように見せたくないアラート形式の通知には:

```powershell
Send-RjRbReportEmail `
    -EmailFrom       "realmjoin-report@contoso.com" `
    -EmailTo         "oncall@contoso.com" `
    -Subject         "[ALERT] License threshold exceeded" `
    -MarkdownContent "## License threshold exceeded`n`nSee dashboard for details." `
    -NoHeader `
    -NoFooter
```

### ネイティブ Microsoft.Graph SDK の使用

runbook がすでに `Connect-MgGraph` （マネージド ID）で認証済みで、RealmJoin ラッパーを混ぜたくない場合:

```powershell
Connect-MgGraph -Identity -NoWelcome

Send-RjRbReportEmail `
    -EmailFrom             "realmjoin-report@contoso.com" `
    -EmailTo               "alice@contoso.com" `
    -Subject               "Native Graph send" `
    -MarkdownContent       $reportMd `
    -UseNativeGraphRequest
```

### ファイルからレポート本文を読み込む

大きなレポートでは、Markdown を `.md` ファイルに出力してから読み込んでください:

```powershell
$reportMd = Get-Content -Path .\generated-report.md -Raw

Send-RjRbReportEmail `
    -EmailFrom       "realmjoin-report@contoso.com" `
    -EmailTo         "alice@contoso.com" `
    -Subject         "Weekly Report" `
    -MarkdownContent $reportMd
```

### アクション ボタン（CTA）

Markdown リンクに `{button}` を追加することで、1つ以上のブランド付きボタンをレンダリングします。同じ行に配置されたボタンは 1 行にグループ化されます:

```powershell
$reportMd = @"
# アクセス要求

新しいデバイス アクセス要求があなたの判断を待っています。

[承認](https://portal.contoso.com/approve/123){button} [却下](https://portal.contoso.com/reject/123){button}
"@

Send-RjRbReportEmail `
    -EmailFrom       "realmjoin-report@contoso.com" `
    -EmailTo         "approver@contoso.com" `
    -Subject         "Action required: device access request" `
    -MarkdownContent $reportMd
```

各ボタンは CTA としてスタイル設定された通常のハイパーリンクです — すべてのクライアントで安全で、現代的なクライアントでは角が丸く、Outlook Classic では四角になります。

## Markdown サポート

この関数には軽量な Markdown → HTML 変換器が組み込まれています。 **外部の Markdown モジュールは不要です。** サポートされている構文:

| Markdown                                      | 注記                                                                                                                                                                                      |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `# … ######` 見出し                              | 6 レベルすべてに対応。後ろのスペースは `#` 任意です。 `h1` には下線が付きます。間隔は Outlook 向けに調整されています。                                                                                                                  |
| `**bold**`, `*italic*`, `~~strike~~`          | インラインのみ（複数行にまたがってはいけません）。                                                                                                                                                               |
| `` `inline code` ``                           | 次のようにレンダリングされます `<code>` 薄いグレーの背景で。                                                                                                                                                     |
| lang ... のフェンス付きコード ブロック                      | 言語タグは次のように保持されます `class="language-…"`。不正な単一バッククォートのフェンスも許容します。                                                                                                                          |
| `[text](url)` リンク                             | 次を使って新しいタブで開きます `noopener noreferrer`.                                                                                                                                                  |
| `[label](url){button}` リンク ボタン                | プレーンなリンクではなく、ブランド付きのオレンジ色の CTA ボタンとしてレンダリングされます。複数の `{button}` 同じ行上の **同じ行** は1行に横並びでレンダリングされます（幅は均等分割）。角の丸みは現代的なクライアント（New Outlook、OWA、モバイル）で表示され、Outlook Classic（Word エンジン）では四角になります。 |
| `![alt](url)` 画像                              | 次のように挿入されます `<img>` （インライン添付の魔法はありません — URL はメール クライアントから到達可能でなければなりません）。                                                                                                               |
| `- 項目` / `1. 項目` リスト                          | 各レベルごとに2スペースのインデントでネストされたリストをサポートします。順序付きと順序なしを混在させると、前のリストが終了します。                                                                                                                      |
| 複数行のリスト項目                                     | インデントされた空でない行が、直下の `<li>` は、次の `<br>` のソフトブレークとして同じ項目に折りたたまれます。各項目を1行に収める必要はありません。                                                                                                      |
| `- [ ]` / `- [x]` タスクリスト                      | 次のようにレンダリングされます `☐` / `☑` Unicodeのグリフ（チェック時は緑色）。 `<input type="checkbox">` は、Outlook Classic がフォームコントロールを除去するため、意図的に避けています。大文字の `[X]` もチェック済みとして扱われます。                                  |
| `> 引用ブロック`                                    | 色付きの左罫線と陰影付きの背景でレンダリングされます。                                                                                                                                                             |
| `> [!NOTE\|TIP\|IMPORTANT\|WARNING\|CAUTION]` | GitHubスタイルの注意書き。blockquote の1行目がマーカー（単独）で、残りの `>`-で始まる行が本文です。各タイプには独自のアクセントカラー、グリフ、タイトルバーが付きます。                                                                                         |
| `---`, `***`, `___`                           | 水平線。                                                                                                                                                                                    |
| `\|col\|col\|` テーブル                           | 標準的なパイプテーブルで、 `:---`, `:---:`, `---:` 配置指定子を使用します。ヘッダー行と区切り行が必要です。                                                                                                                      |
| `\\` エスケープ                                    | `\*`, `\|` などが尊重されるため、Markdown の文字をリテラルとして出力できます。                                                                                                                                       |

未対応の項目には脚注、定義リスト、HTML のそのまま通過が含まれます。Markdown は上の表に留めてください。

## 動作とエラー処理

### 受信者の解析

`EmailTo` はカンマで分割され、各項目はトリムされ、空の項目は除外されます。結果のリストが空の場合、関数は `EmailTo パラメーターに有効なメール受信者が見つかりませんでした。` Graph 呼び出しを行う前に例外を発生させます。

### 受信者ごとの失敗

各受信者には個別に送信されます。関数は成功と失敗を追跡します。

* もし **少なくとも1件の** 送信が成功し、他が失敗した場合は、失敗したアドレスの一覧を含む警告が出力され、関数は正常に戻ります。
* もし **すべての** 送信がすべて失敗した場合、関数は `すべての受信者へのメール送信に失敗しました: …` そのため、runbook は明確に失敗します。

### 添付ファイルの失敗

* 存在しないファイル（パスが存在しない）— 詳細にログに記録され、静かにスキップされます。
* 存在するが読み取れないファイル（ロック中、権限なし）— 警告が出力され、スキップされ、呼び出しの残りは継続されます。
* メール下部の「添付ファイル」ボックスには、正常に読み取れた添付のみが一覧表示されます。

### 画像の上書き失敗

両方とも `HeaderImage` と `FooterImage` どちらも、いずれかのエラー（ファイルがない、I/O エラー、または有効な画像でないファイル）が発生すると、同梱の既定値にフォールバックします。警告には失敗内容と、どの既定値が使用されたかが記載されます。

0.8.9 以降、画像形式は **ファイルシグネチャ** （マジックバイト）から判定され、ファイル拡張子は使われません。次の名前のファイルは `.png` ですが、実際には HTML のエラーページを含んでいる場合 — ダウンロードが静かにエラードキュメントを返すとよく起こる結果です — は、壊れたインライン添付を作成する代わりに警告付きで拒否されます。逆に、誤解を招く拡張子で保存された有効な PNG は受け入れられ、正しく型判定されます。

### 無効な色

`AccentColor` と `TextColor` は次に対して検証されます `^#[0-9A-Fa-f]{6}$`。一致しない値では、パラメーター名を示す警告が出力され、送信は既定色で続行されます。色が理由でレポートが失敗することはありません。

### 合計サイズ上限

Graph は上限を設けており `sendMail` 、合計約 4 MB（HTML 本文 + すべての添付ファイル、Base64 エンコード後）に制限されています。どちらかのブランド画像が 3 MB を超えると、関数は警告を出力します。

次の場合、 `FallbackAttachments` が指定されていると、上のパラメーター節で説明した添付サイズガードが大きすぎるペイロードを自動的に処理します。フォールバックセットがない場合、大きすぎる要求は Graph 呼び出しで失敗します。次を検討してください:

* 次のものを指定する: `FallbackAttachments` セット（たとえば、生の CSV ファイルを含まない Excel ブック）。
* 代わりに大きなデータを Storage Account チャネルへアップロードする — 参照: [Runbook レポート設定](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-report-settings.md#storage-account-delivery).
* 埋め込むのではなく、外部ホストされた添付ファイルにリンクする。
* 表形式データを圧縮する（`Compress-Archive`）を添付前に実行する。

## Runbook Report Settings との統合

レポート用 runbook は送信元アドレスやブランド情報をハードコードしません。RealmJoin ポータルが中央のカスタマイズ JSON から事前入力する、非表示パラメーターを宣言します。利用可能な設定は次に文書化されています。 [Runbook レポート設定](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-report-settings.md).

バインディングは runbook の `param()` ブロック内で、次を介して行われます: `Use-RJInterface -Type Setting`、そしてパラメーターには `"Hide": true` 次の `.INPUTS RunbookCustomization` ブロックで印が付けられ、ポータルフォームを煩雑にしません。

```powershell
param(
    [ValidateScript( { Use-RJInterface -Type Setting -Attribute "RJReport.EmailSender" } )]
    [string]$EmailFrom,

    [ValidateScript( { Use-RJInterface -Type Setting -Attribute "RJReport.Branding.HeaderImageUrl" } )]
    [string]$BrandingHeaderImageUrl,

    [ValidateScript( { Use-RJInterface -Type Setting -Attribute "RJReport.Branding.FooterImageUrl" } )]
    [string]$BrandingFooterImageUrl,

    [ValidateScript( { Use-RJInterface -Type Setting -Attribute "RJReport.Branding.FooterLink" } )]
    [string]$BrandingFooterLink,

    [ValidateScript( { Use-RJInterface -Type Setting -Attribute "RJReport.Branding.AccentColor" } )]
    [string]$BrandingAccentColor,

    [ValidateScript( { Use-RJInterface -Type Setting -Attribute "RJReport.Branding.TextColor" } )]
    [string]$BrandingTextColor
)

if (-not $EmailFrom) {
    throw "EmailSender が構成されていません。セットアップ手順は https://docs.realmjoin.com/automation/runbooks/runbook-report-settings を参照してください。"
}

# ブランド画像は各実行で1回だけダウンロードして検証する。成功したキーのみを返す
# 解決に成功したものだけを返すため、未設定の項目は既定値にフォールスルーします。
$brandingMailParams = Get-RjRbBrandingMailParams `
    -HeaderImageUrl $BrandingHeaderImageUrl `
    -FooterImageUrl $BrandingFooterImageUrl `
    -FooterLink     $BrandingFooterLink `
    -AccentColor    $BrandingAccentColor `
    -TextColor      $BrandingTextColor

Send-RjRbReportEmail `
    -EmailFrom         $EmailFrom `
    -EmailTo           $RecipientParameter `
    -Subject           $Subject `
    -MarkdownContent   $reportMd `
    -TenantDisplayName $TenantDisplayName `
    -ReportVersion     "MyReport v1.0" `
    @brandingMailParams
```

参照 [Get-RjRbBrandingMailParams](https://docs.realmjoin.com/ja/dev-reference/report-functions/get-rjrbbrandingmailparams.md) は、ダウンロード、検証、クリーンアップのルールを指します。

## 出力

成功しても関数は何も返しません。すべての進捗は次を通じて書き込まれます。 `Write-RjRbLog -Verbose` （runbook を次で実行したときに表示されます `-Verbose` または `$VerbosePreference = 'Continue'`）。警告は次を通じて強制的に出力されます `$WarningPreference = 'Continue'` 呼び出し側の上書きに関係なく、そのため Azure Automation のジョブ ストリームに確実に表示されます。

## 関連するエクスポート済みヘルパー

の背後にある構成要素は `Send-RjRbReportEmail` モジュールからもエクスポートされるようになったため、runbook は送信せずに HTML を組み立てたりプレビューしたりできます。

| 関数                                                                                                                         | 目的                                                                                                                                           |
| -------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| [`Get-RjRbBrandingMailParams`](https://docs.realmjoin.com/ja/dev-reference/report-functions/get-rjrbbrandingmailparams.md) | を変換して `RJReport.Branding.*` Tenant 設定を、そのまま展開できるパラメーターに変換します。画像をダウンロードして検証し、色とフッターリンクをそのまま渡します。                                              |
| `ConvertFrom-RjRbMarkdownToHtml`                                                                                           | スタンドアロンの Markdown → HTML 変換器（内部で使われているのと同じ軽量エンジンで、次のものを含みます `{button}` 構文）。次を受け取ります `-AccentColor`/`-TextColor`.                             |
| `Get-RjRbReportEmailBody`                                                                                                  | HTML または Markdown から、完全なブランド付き HTML 本文（ヘッダー/フッター、Tenant 情報ボックス、添付一覧）を組み立てます。送信前にメールをレンダリングして確認するのに便利です。次を受け取ります `-AccentColor`/`-TextColor`. |
| `Resolve-RjRbImageSource`                                                                                                  | ヘッダー/フッター画像のパスを、そのインライン CID ソースに解決します。ファイルシグネチャで検証し、PNG、JPEG、GIF 以外なら例外を投げます。                                                                |

次を除き、 `Get-RjRbBrandingMailParams`これらは主に高度な/テスト用途を想定しています。通常の経路では次を直接呼び出します。 `Send-RjRbReportEmail` を直接。

## 関連項目

* [Get-RjRbBrandingMailParams](https://docs.realmjoin.com/ja/dev-reference/report-functions/get-rjrbbrandingmailparams.md) — runbook 内で Tenant のブランド設定を解決します。
* [Runbook レポート設定](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-report-settings.md) — 送信元メールボックス、サービスデスク情報、ブランド、Storage Account 配信チャネルの中央設定。
* Microsoft Graph: [メールを送信](https://learn.microsoft.com/en-us/graph/api/user-sendmail) — 基盤となる API。


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/ja/dev-reference/report-functions/send-rjrbreportemail.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
