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

### 説明

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

### 仕組み

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

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

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

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

#### 外部メンバー

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

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

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

#### 実行時間

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

### レポート配信

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

ダウンロードリンクの場合、レポートファイルは、 `RJReport.StorageAccount.*` テナント設定で構成された Azure Storage Account にアップロードされ、時間制限付きの SAS ダウンロードリンクが返されます。ストレージへのアップロードは Automation アカウントのマネージド ID で認証します。その ID には、 **Reader and Data Access** RBAC ロールがターゲットの Storage Account に必要です（これは 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).

### 注記と制限

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

### 場所

組織 → コラボ → Teams チャンネル レポート (スケジュール済み)

**完全な Runbook 名**

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

### 詳細

| プロパティ    | 値                                                                                                                  |
| -------- | ------------------------------------------------------------------------------------------------------------------ |
| バージョン    | 1.0.1                                                                                                              |
| 必須モジュール  | <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 経由で、各チームのプライベート チャンネルと Shared Channel を一覧表示します*
  * ChannelMember.Read.All
    * *一覧表示された各チャンネルのメンバーを読み取り、所有者、メンバー、外部メンバーを区別します*
  * Group.Read.All
    * *チームとしてプロビジョニングされた Microsoft 365 グループを、名前と可視性付きで一覧表示します*
  * Mail.Send *(オプション — 機能: メール レポート)*
    * *メール配信が選択されている場合、Send-RjRbReportEmail を使用してレポートメールを送信します*
  * Organization.Read.All *(オプション — 機能: メール レポート)*
    * *メール件名、メール本文、およびレポート ファイル名のためにテナントの表示名を読み取ります*

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

Azure Storage Account: Automation Account のマネージド ID に対してターゲットの Storage Account 上で 'Reader and Data Access' ロールを付与します。アップロードでは listKeys を使用してアカウント キーを取得します（ダウンロードリンクのオプションでのみ必要です）

### パラメーター

#### IncludePrivateChannels

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

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

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

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

#### IncludeSharedChannels

各チームがホストする Shared Channel を一覧表示します。ほかのテナントのメンバーは外部としてマークされます。

| プロパティ   | 値                      |
| ------- | ---------------------- |
| 必須      | false                  |
| 既定値     | True                   |
| 種類      | ブール値                   |
| ポータル表示名 | Shared Channel を含めますか？ |

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

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

#### IncludeMembers

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

| プロパティ   | 値              |
| ------- | -------------- |
| 必須      | 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 のカスタマイズで事前設定) |

#### コンテナー名

レポート ファイルがアップロードされるストレージ コンテナーです。runbook ごとに設定します。

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

#### リソース グループ名

レポート アップロード用のストレージ アカウントのリソース グループです。Tenant 設定 RJReport.StorageAccount.ResourceGroup から取得されます。

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

#### Storage Account 名

レポート アップロード用の Storage Account です。Tenant 設定 RJReport.StorageAccount.StorageAccountName から取得されます。

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

#### LinkExpiryDays

ダウンロード リンクが有効なままの期間（日数）です。Tenant 設定 RJReport.StorageAccount.LinkExpiryDays から取得されます。

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

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