> 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 です。単一のオブジェクトによってトリガーされるのではなく、繰り返しスケジュールで実行されるように設計されています。詳細は [スケジューリング](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/scheduling.md) runbook のスケジュールを構成する方法の詳細は。
{% endhint %}

### 説明

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

### 一般的な使用例

* しきい値が超えられた場合にのみ警告する、SharePoint Online テナント ストレージの毎日予定されたヘルス チェック。
* ユーザーがファイルを保存できなくなる前に、ストレージ クォータに近づいているテナントを見つけます。
* 大量の未使用で、回収可能な可能性のあるライセンス済みストレージを見つけます。

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

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

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

* `AlertLowStorageLimitInGB` 空きテナント ストレージが構成された値を下回るとアラートします。
* `AlertUnusedStorageLimitInGB` 空きテナント ストレージが構成された値を上回るとアラートします。これは回収可能なライセンス済みストレージの指標です。これを `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 Tenant Storage (スケジュール済み)

**完全な 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 は、SharePoint 管理センターの URL に対して Connect-PnPOnline -ManagedIdentity で接続し、テナント全体のフル コントロールを必要とするテナント管理用 cmdlet の Get-PnPGeoStorageQuota と Get-PnPTenantSite を呼び出します。読み取り専用の Sites.Read.All では、テナント管理エンドポイントには不十分です*

#### 権限に関する注意事項

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

### パラメーター

#### 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 リファレンスの概要に戻る](https://docs.realmjoin.com/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.
