> 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-teams-channels_scheduled.md).

# Teams チャネルのレポート（スケジュール）

すべての Teams のプライベート チャネルと共有チャネルを所有者とともに一覧表示します

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

### 説明

テナント内のすべてのチームを巡回し、それぞれのチームに属するプライベート チャネルと共有チャネル、その所有者、必要に応じてメンバーを一覧表示します。プライベート チャネルは RealmJoin Portal のグループ表示には表示されないため、このレポートでは誰が所有し、誰がアクセスできるかを示します。所有者がいないチャネルは別途一覧表示されます。レポートはメールで送信することも、ダウンロードリンクとして提供することもできます。

### 仕組み

この runbook は、チームとしてプロビジョニングされたすべての Microsoft 365 グループを一覧表示します。必要に応じて、次で絞り込めます *チーム名のプレフィックス*。各チームについて選択された種類のチャネルを読み取り、各チャネルについてメンバー一覧を取得します。

* **プライベート チャネル** は 1 つのチームに属し、メンバーだけが表示できます。また、RealmJoin Portal のグループ表示や、そのチームのグループ メンバーシップには表示されません。このレポートを使うと、ひと目で確認できます。
* **共有チャネル** は 1 つのチームでホストされ、他のチームや他のテナントのユーザーと共有できます。このレポートでは、各チームがホストしている共有チャネルを一覧表示します。別の場所からチームに共有されたチャネルは、そのチームの下では重複して表示されません。

各行には、チームとその公開範囲、チャネル、その種類、アーカイブ済みかどうか、作成日、所有者数、メンバー数、外部メンバー数、そして所有者の名前とメールアドレスが表示されます。なお、 *メンバーも一覧表示しますか？* を yes に設定すると、メンバーも名前付きで一覧表示されます。大規模なテナントでは、レポートを短く保つためにオフにしてください。

所有者がいないチャネルは、それぞれ専用のテーブルとワークシートに一覧表示されます。プライベート チャネルまたは共有チャネルは所有者がいなくても動作を続けられますが、Teams 内からメンバーシップを管理することはできないため、そのようなチャネルは最初の整理対象候補になります。

#### 外部メンバー

ホーム テナントと異なるテナントのメンバーはマークされます *（外部）* としてカウントされ、 *ExternalCount* 列に含まれます。ホーム テナントのゲスト アカウントは、テナント ディレクトリのメンバーであるためマークされません。

#### 読み取れない Teams とチャネル

チャネルを読み取れないチームは、たとえばレポートの実行中に削除された場合や、チームがアーカイブされていてアクセスできない場合など、 *読み取り不可の Teams* テーブルに理由とともに一覧表示され、実行は停止しません。メンバー一覧を読み取れないチャネルは、その行を保持したまま、理由が *注* 列に表示され、所有者なしのチャネルとしてはカウントされません。

#### 実行時間

チャネルとメンバーは Graph のバッチ要求で、20 件ずつ読み取られます。数千のチームがあるテナントでも、処理にはしばらく時間がかかります。ジョブ ログに進行状況が表示されます。使用してください *チーム名のプレフィックス* サブセットに対してレポートするには

### レポートの配信

結果は常に、RealmJoin portal の Output Data タブに名前付きテーブルとして表示されます。レポート ファイルが生成されるのは、 **レポートの配信** オプションにメールおよび/またはダウンロードリンクが含まれている場合にのみ *出力データのみ* レポート ファイルは作成されません。メール配信とダウンロードリンクの生成は独立しており、組み合わせることができます。

ダウンロードリンクの場合、レポート ファイルは、Azure Storage Account に構成された `RJReport.StorageAccount.*` テナント設定にアップロードされ、期限付きの SAS ダウンロードリンクが返されます。ストレージへのアップロードは、Automation アカウントのマネージド ID で認証されます。その ID には **Reader and Data Access** 対象の Storage Account に対する RBAC ロールが必要です（これは Azure RBAC の割り当てであり、Graph のアプリケーション権限ではありません）。

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

メール レポートの送信は任意であり、 *レポートもメール送信* または *レポートもメール送信とダウンロードリンク* がレポート配信として選択されます。その場合、受信者が必要です。送信者アドレスは次から取得されます。 `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).

### 注意事項と制限

* このレポートは読み取り専用です。プライベート チャネルと共有チャネルの所有者とメンバーは、Teams 管理センターまたは Teams 自体で変更します。runbook は **チャネルまたはグループ メンバーを同期（スケジュール済み）** と **Shared Channel の所有者を同期（スケジュール済み）** 共有チャネルの自動化されたケースをカバーします。
* 標準チャネルは一覧表示されません。そのメンバーシップはチームのメンバーシップと同じであり、RealmJoin Portal に表示されます。
* 共有チャネルのメンバー一覧には、その直接メンバーが含まれます。チャネルが共有されている別のチームを経由して共有チャネルにアクセスする人は一覧表示されません。

### 場所

組織 → コラボ → Report Teams Channels (Scheduled)

**完全な Runbook 名**

rjgit-org\_collab\_report-teams-channels\_scheduled

### 詳細

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

### アクセス許可

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

* **型**: Microsoft Graph
  * Channel.ReadBasic.All
    * */teams/{id}/channels を介して、すべてのチームのプライベート チャネルと共有チャネルを一覧表示します*
  * ChannelMember.Read.All
    * *一覧表示された各チャネルのメンバーを読み取り、所有者、メンバー、外部メンバーを区別します*
  * Group.Read.All
    * *Teams としてプロビジョニングされた Microsoft 365 グループを、名前と公開範囲とともに一覧表示します*
  * Mail.Send *（任意 — 機能: メール レポート）*
    * *メール配信が選択されている場合、Send-RjRbReportEmail を介してレポートメールを送信します*
  * Organization.Read.All *（任意 — 機能: メール レポート）*
    * *メールの件名、メール本文、レポート ファイル名のために Tenant の表示名を読み取ります*

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

Azure Storage Account: 対象 Storage Account 上の Automation アカウントのマネージド ID に対する 'Reader and Data Access' ロール - アップロードでは listKeys 経由でアカウント キーを取得します（ダウンロードリンク オプションでのみ必要です）

### パラメーター

#### IncludePrivateChannels

各チームがホストするプライベート チャネルを一覧表示します。

| プロパティ    | 値                  |
| -------- | ------------------ |
| 必須       | false              |
| 既定値      | True               |
| 型        | ブール値               |
| ポータルの表示名 | プライベート チャネルを含めますか？ |

**ポータル オプション**

| ポータル オプション | 値     |
| ---------- | ----- |
| はい         | true  |
| なし         | false |

#### IncludeSharedChannels

各チームがホストする共有チャネルを一覧表示します。他のテナントのメンバーは外部としてマークされます。

| プロパティ    | 値             |
| -------- | ------------- |
| 必須       | false         |
| 既定値      | True          |
| 型        | ブール値          |
| ポータルの表示名 | 共有チャネルを含めますか？ |

**ポータル オプション**

| ポータル オプション | 値     |
| ---------- | ----- |
| はい         | true  |
| なし         | false |

#### IncludeMembers

各チャネルのメンバーも名前付きで一覧表示します。Off にすると所有者のみが一覧表示され、大規模なテナントではレポートを短く保てます。

| プロパティ    | 値              |
| -------- | -------------- |
| 必須       | false          |
| 既定値      | False          |
| 型        | ブール値           |
| ポータルの表示名 | メンバーも一覧表示しますか？ |

**ポータル オプション**

| ポータル オプション  | 値     |
| ----------- | ----- |
| はい、所有者とメンバー | true  |
| いいえ、所有者のみ   | false |

#### TeamNamePrefix

名前がこのテキストで始まるチームのみを対象にします。すべてのチームを対象にする場合は空欄のままにしてください。

| プロパティ    | 値            |
| -------- | ------------ |
| 必須       | false        |
| 既定値      |              |
| 型        | 文字列          |
| ポータルの表示名 | チーム名のプレフィックス |

#### 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 のカスタマイズで事前設定） |

#### SendEmailReport

レポートを受信者のメールアドレスに送信します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | False                    |
| 型        | ブール値                     |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### EmailTo

レポートをこれらのアドレスに送信します。複数ある場合はカンマで区切ってください。各受信者には個別のメールが送信されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルの表示名 | 受信者のメール アドレス             |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ReportFileFormat

レポートを CSV、Excel ブック、またはその両方で配信します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | CSV と XLSX               |
| 型        | 文字列                      |
| ポータルの表示名 | レポート ファイル形式              |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

**ポータル オプション**

| ポータル オプション | 値          |
| ---------- | ---------- |
| CSV と XLSX | CSV と XLSX |
| CSV のみ     | CSV のみ     |
| XLSX のみ    | XLSX のみ    |

#### CreateDownloadLink

レポートもアップロードし、数日後に期限切れになるダウンロード リンクを返します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | False                    |
| 型        | ブール値                     |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ContainerName

レポート ファイルをアップロードする Storage container。runbook ごとに設定します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | report-teams-channels    |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ResourceGroupName

レポート アップロード用の Storage Account のリソース グループ。テナント設定 RJReport.StorageAccount.ResourceGroup から取得します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### StorageAccountName

レポート アップロード用の Storage Account。テナント設定 RJReport.StorageAccount.StorageAccountName から取得します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### SubscriptionId

レポート アップロード用の Storage Account のサブスクリプション ID。テナント設定 RJReport.StorageAccount.SubscriptionId から取得します。空の場合は、管理対象 ID がサインインするサブスクリプションが使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### LinkExpiryDays

ダウンロード リンクの有効期間（日数）。テナント設定 RJReport.StorageAccount.LinkExpiryDays から取得します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | 6                        |
| 型        | Int32                    |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

[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-teams-channels_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.
