> 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-references/org/collab/report-sharepoint-tenant-storage_scheduled.md).

# SharePoint Tenant ストレージをレポート（スケジュール済み）

SharePoint ストレージを監視し、制限を超えたら警告

{% hint style="info" %}
これはスケジュールされた runbook です。単一のオブジェクトに対してトリガーされるのではなく、繰り返しのスケジュールで実行されるように設計されています。詳細は [スケジューリング](/ja/zi-dong-hua/runbooks/scheduling.md) runbook のスケジュールの設定方法の詳細については
{% endhint %}

### 説明

毎回の実行で SharePoint Online テナントのストレージを確認します。クォータ、使用量、最も多く使用しているサイト コレクションを確認します。完全な一覧は実行出力に書き込まれます。アラート メールは、空きストレージが低ストレージのしきい値を下回るか、ライセンス済みだが未使用のストレージが回収可能な上限を超えた場合にのみ送信されます。

### 一般的な使用例

* しきい値が超過した場合にのみ通知する、SharePoint Online テナントのストレージの毎日のスケジュール済みヘルス チェック。
* ユーザーがファイルを保存できなくなる前に、ストレージ クォータに近づいているテナントを把握します。
* 大量の未使用で、潜在的に回収可能なライセンス済みストレージを把握します。

### スケジュール設定と出力

毎日スケジュールすることを推奨します。ストレージの概要、両方のしきい値チェックの結果、および上位のサイト コレクションは、 **出力データ** しきい値が超過したかどうかにかかわらず、毎回、ジョブの出力データ タブに書き込まれるため、アラートがない日でもジョブ履歴を有用に保てます。レポート ファイルは作成されません。

### パラメーターの相互作用

* `AlertLowStorageLimitInGB` 空きテナント ストレージが構成された値を下回るとアラートを送信します。
* `AlertUnusedStorageLimitInGB` 空きテナント ストレージが構成された値を上回るとアラートを送信します。これは、回収可能なライセンス済みストレージの指標です。0 に設定すると `0` このチェックを無効にできます。
* 両方のチェックが同じ実行で発動するのは、 `AlertLowStorageLimitInGB` がより高く構成されている場合のみです `AlertUnusedStorageLimitInGB`。しきい値を調整するときは、両方の値をまとめて確認してください。
* アラート メールは、少なくとも 1 つのしきい値が超過された場合にのみ送信されます。超過のない実行は通常どおり完了し、何も送信されません。
* 上位のサイト コレクション一覧は SharePoint サイト コレクションのみを対象とします。OneDrive for Business サイトは、これらのストレージがこの runbook が監視するテナントのストレージ クォータに含まれないため、除外されます。

### メール送信に関する設定

アラート メールの送信は、ストレージのしきい値が超過した場合にのみ行われます。送信先は受信者（`AlertEmailTo`）。送信者アドレスは次の設定から取得されます。 `RJReport.EmailSender` テナント設定から取得されます。

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

詳細については [RealmJoin Report Settings のドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) を参照してください。

#### メールのブランディング

レポートメールでは、任意の `RJReport.Branding.*` テナント設定が反映されます:

* **ヘッダーおよびフッター画像** – 公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB
* **フッターリンク** – フッター画像のリンク先
* **アクセントカラーとテキストカラー** – 6 桁の 16 進数値、例: `#0052cc`

これらの設定が構成されていない場合は、既定の RealmJoin のグラフィックと色が使用されます。ダウンロードまたは検証できない画像、または無効な色の値があっても、レポートメールが失敗することはありません。代わりに、該当する既定値が使用されます。

設定手順と画像要件: [メールのブランディング](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### 制限事項

* サイト数の多いテナントでは、すべてのサイト コレクションを列挙するのに数分かかる場合があります。

### 場所

Organization → Collab → SharePoint テナント ストレージ レポート (スケジュール済み)

**完全な Runbook 名**

rjgit-org\_collab\_report-sharepoint-tenant-storage\_scheduled

### 詳細

| プロパティ    | 値                                                                                                                     |
| -------- | --------------------------------------------------------------------------------------------------------------------- |
| バージョン    | 1.5.0                                                                                                                 |
| 必須モジュール  | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>PnP.PowerShell (>= 3.4.1)</p> |
| スケジュール可能 | はい                                                                                                                    |

### 権限

#### アプリケーションのアクセス許可

* **種類**: Microsoft Graph
  * Mail.Send
    * *Send-RjRbReportEmail を介してストレージしきい値のアラート メールを送信します。この runbook の目的はアラートそのものなので、送信はしきい値超過時に必ず行われ、トグルではありません。*
  * Organization.Read.All
    * */organization を読み取り、アラート メールの件名とブランド表示で使用するテナントの表示名を取得します。*
  * Sites.Read.All
    * *Connect-PnPOnline で使用する SharePoint 管理センターの URL を導出するために、テナントのルート サイト (/sites/root) を読み取ります。*
* **種類**: Office 365 SharePoint Online
  * Sites.FullControl.All
    * *この runbook は、Connect-PnPOnline -ManagedIdentity を使用して SharePoint 管理センターの URL に接続し、テナント管理 cmdlet の Get-PnPGeoStorageQuota と Get-PnPTenantSite を呼び出します。これらにはテナント全体に対するフル コントロールが必要であり、読み取り専用の Sites.Read.All ではテナント管理エンドポイントには不十分です。*

#### アクセス許可に関する注意

SharePoint Online: Automation Account のマネージド ID に対して、'Office 365 SharePoint Online' リソース (appId 00000003-0000-0ff1-ce00-000000000000) に Sites.FullControl.All を付与します — このアプリのみの付与は Microsoft Graph で使用される標準の Entra アプリ ロール割り当てフローでは行えないため、テナントごとに手動で割り当てる必要があります。

### パラメーター

#### AlertLowStorageLimitInGB

空きテナント ストレージがこのギガバイト数を下回ったらアラートを送信します。

| プロパティ   | 値                      |
| ------- | ---------------------- |
| 必須      | true                   |
| 既定値     | 200                    |
| 種類      | Int32                  |
| ポータル表示名 | 空きストレージが（GB）を下回ったらアラート |

#### AlertUnusedStorageLimitInGB

どのサイトでも使用していないライセンス済みストレージがこのギガバイト数を超えたらアラートを送信します。そのストレージは回収できる可能性があります。

| プロパティ   | 値                      |
| ------- | ---------------------- |
| 必須      | false                  |
| 既定値     | 1024                   |
| 種類      | Int32                  |
| ポータル表示名 | 未使用ストレージが（GB）を超えたらアラート |

#### TopSiteCount

一覧に表示する最大規模のサイト コレクションの数。

| プロパティ   | 値                    |
| ------- | -------------------- |
| 必須      | false                |
| 既定値     | 10                   |
| 種類      | Int32                |
| ポータル表示名 | レポートする上位サイト コレクションの数 |

#### EmailFrom

アラート メールの送信者アドレス。テナント設定 RJReport.EmailSender から取得されます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### BrandingHeaderImageUrl

レポートメールのヘッダー画像 (HTTPS URL、PNG/JPEG/GIF、最大 200 KB)。テナント設定 RJReport.Branding.HeaderImageUrl から取得されます。空の場合は既定の RealmJoin ヘッダーが使用されます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### BrandingFooterImageUrl

レポートメールのフッター画像 (HTTPS URL、PNG/JPEG/GIF、最大 200 KB)。テナント設定 RJReport.Branding.FooterImageUrl から取得されます。空の場合は既定の RealmJoin フッターが使用されます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### BrandingFooterLink

レポートメールのフッター画像のリンク先。テナント設定 RJReport.Branding.FooterLink から取得されます。空の場合は realmjoin.com が使用されます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### BrandingAccentColor

レポートメールのアクセントカラーを 6 桁の 16 進数値で指定します。テナント設定 RJReport.Branding.AccentColor から取得されます。空または無効な場合は RealmJoin の既定値が使用されます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### BrandingTextColor

レポートメールのテキストカラーを 6 桁の 16 進数値で指定します。テナント設定 RJReport.Branding.TextColor から取得されます。空または無効な場合は RealmJoin の既定値が使用されます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### AlertEmailTo

しきい値を超えたときにアラートの送信先となるアドレス。

| プロパティ   | 値                |
| ------- | ---------------- |
| 必須      | true             |
| 既定値     |                  |
| 種類      | 文字列              |
| ポータル表示名 | アラート受信者のメール アドレス |

#### AlertEmailSubject

アラート メールの件名。

| プロパティ   | 値                                        |
| ------- | ---------------------------------------- |
| 必須      | true                                     |
| 既定値     | RealmJoin - SharePoint Online ストレージ アラート |
| 種類      | 文字列                                      |
| ポータル表示名 | アラート メールの件名                              |

[Runbook リファレンスの概要に戻る](/ja/zi-dong-hua/runbooks/runbook-references.md)


---

# 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/zi-dong-hua/runbooks/runbook-references/org/collab/report-sharepoint-tenant-storage_scheduled.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.