> 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/user/general/list-group-memberships.md).

# グループ メンバーシップを一覧表示

### 説明

このユーザーのグループ メンバーシップを一覧表示し、グループの種類、メンバーシップの種類、ロール割り当て可能状態、Teams の有効化、ソース、書き戻し状態でのフィルターをサポートします。結果は CSV 形式のテキストとして出力します。

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

メール レポートの送信は任意であり、次の場合にのみ行われます: `SendMail` オプションが有効な場合です。受信者 (`EmailTo`) が必要になります。送信者アドレスは次の項目から取得されます: `RJReport.EmailSender` テナント設定から取得されます。

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

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

#### メールのブランド設定

レポートメールでは、任意の `RJReport.Branding.*` テナント設定が考慮されます。対象は、カスタムのヘッダー画像、カスタムのフッター画像（公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB）、カスタムのフッターリンク、およびカスタムのアクセントカラーとテキストカラー（6 桁の hex 値、例: `#0052cc`）です。これらの設定が構成されていない場合は、既定の RealmJoin のグラフィックと色が使用されます。ダウンロードまたは検証できないブランド画像、または有効な hex カラーではない色の値があっても、レポートメールが送信されなくなることはありません。代わりに、該当する既定値が使用されます。

詳細については、 [RealmJoin レポート設定のドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) 設定の詳細については、

### 場所

ユーザー → 全般 → グループ メンバーシップの一覧

**Runbook の完全名**

rjgit-user\_general\_list-group-memberships

### 詳細

| プロパティ    | 値                                                                   |
| -------- | ------------------------------------------------------------------- |
| バージョン    | 1.7.0                                                               |
| 必要なモジュール | <p>RealmJoin.RunbookHelper (>= 0.8.9)<br>Az.Accounts (>= 5.5.2)</p> |
| スケジュール可能 | いいえ                                                                 |

### アクセス許可

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

* **種類**：Microsoft Graph
  * User.Read.All
    * *対象ユーザーを解決し、レポート用の id と UPN を取得します*
  * Group.Read.All
    * */users/{id}/memberOf を使用してユーザーのグループを読み取り、フィルター用のメンバーシップ ルールも含めます*
  * Mail.Send *（任意 — 機能: メールレポート）*
    * *SendMail が有効で EmailTo が構成されている場合、Send-RjReportEmail を使用してレポートのメールを送信します*
  * Organization.Read.All
    * *メール レポートで Tenant の表示名を取得するために /organization を読み取ります*

### パラメーター

#### ユーザー名

対象ユーザーのユーザー プリンシパル名。

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

#### グループの種類

グループの種類でフィルターします: Security（セキュリティ権限のみ）、M365（Microsoft 365 のメールボックス付きグループ）、または すべて（既定）。

| プロパティ | 値   |
| ----- | --- |
| 必須    | いいえ |
| 既定値   | すべて |
| 種類    | 文字列 |

#### メンバーシップの種類

メンバーシップの種類でフィルターします: Assigned（手動で追加されたメンバー）、Dynamic（ルールベースのメンバーシップ）、または すべて（既定）。

| プロパティ | 値   |
| ----- | --- |
| 必須    | いいえ |
| 既定値   | すべて |
| 種類    | 文字列 |

#### ロール割り当て可能

Azure AD ロールに割り当て可能なグループでフィルターします: はい（ロール割り当て可能なもののみ）または 未設定（すべてのグループ、既定）。

| プロパティ | 値   |
| ----- | --- |
| 必須    | いいえ |
| 既定値   | 未設定 |
| 種類    | 文字列 |

#### Teams 有効

Microsoft Teams 機能を持つグループでフィルターします: はい（Teams 有効のもののみ）または 未設定（すべてのグループ、既定）。

| プロパティ | 値   |
| ----- | --- |
| 必須    | いいえ |
| 既定値   | 未設定 |
| 種類    | 文字列 |

#### ソース

グループの由来でフィルターします: クラウド（Azure AD のみ）、オンプレミス（オンプレミス AD から同期されたもの）、または すべて（既定）。

| プロパティ | 値   |
| ----- | --- |
| 必須    | いいえ |
| 既定値   | すべて |
| 種類    | 文字列 |

#### 書き戻し有効

書き戻しの有効化でグループをフィルターします。

| プロパティ | 値   |
| ----- | --- |
| 必須    | いいえ |
| 既定値   | すべて |
| 種類    | 文字列 |

#### SendMail

有効にすると、選択したレポート ファイル形式を添付したメールでレポートが送信されます。これをオンにすると、受信者アドレスとレポート ファイル形式のフィールドが表示されます。

| プロパティ   | 値                |
| ------- | ---------------- |
| 必須      | いいえ              |
| 既定値     | False            |
| 種類      | ブール値             |
| ポータル表示名 | レポートをメールで送信しますか? |

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

| ポータルオプション           | 値 |
| ------------------- | - |
| はい - レポートをメールで送信します |   |
| いいえ - メールを送信しません    |   |

#### EmailTo

メール レポート用の受信者アドレス、またはカンマ区切りの複数のアドレス。SendMail が有効な場合にのみ使用されます。

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

#### EmailFrom

送信者のメールアドレスです。これは Runbook のカスタマイズで設定する必要があります。

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

#### BrandingHeaderImageUrl

レポートメール用のカスタム ヘッダー画像（PNG/JPEG/GIF、最大 200 KB）の任意の公開 HTTPS URL です。RJReport.Branding.HeaderImageUrl テナント設定から取得されます。空の場合は、既定の RealmJoin ヘッダー グラフィックが使用されます。

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

#### BrandingFooterImageUrl

レポートメール用のカスタム フッター画像（PNG/JPEG/GIF、最大 200 KB）の任意の公開 HTTPS URL です。RJReport.Branding.FooterImageUrl テナント設定から取得されます。空の場合は、既定の RealmJoin フッター グラフィックが使用されます。

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

#### BrandingFooterLink

フッター画像のリンク先となる任意の URL です。RJReport.Branding.FooterLink テナント設定から取得されます。空の場合は、既定のリンク（<https://www.realmjoin.com）が使用されます。>

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

#### BrandingAccentColor

レポートメール テンプレート用のアクセントカラーの任意の上書き（6 桁の hex、例: '#0052cc'）です。RJReport.Branding.AccentColor テナント設定から取得されます。空または無効な場合は、既定の RealmJoin アクセントカラーが使用されます。

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

#### BrandingTextColor

レポートメール テンプレート用のテキストカラーの任意の上書き（6 桁の hex）です。RJReport.Branding.TextColor テナント設定から取得されます。空または無効な場合は、既定の RealmJoin テキストカラーが使用されます。

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

#### ReportFileFormat

生成および配信されるレポート ファイル形式を制御します: CSV のみ、CSV と XLSX（既定）または XLSX のみ。

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

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

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

#### CreateDownloadLink

有効にすると、レポート ファイル（CSV と Excel）が Azure Storage Account にアップロードされ、期限付きのダウンロード リンクが出力に返されます。

| プロパティ   | 値                                          |
| ------- | ------------------------------------------ |
| 必須      | いいえ                                        |
| 既定値     | False                                      |
| 種類      | ブール値                                       |
| ポータル表示名 | ファイルのダウンロード リンクを作成しますか（レポートをストレージにアップロード）? |

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

| ポータルオプション                       | 値 |
| ------------------------------- | - |
| はい - レポートをアップロードしてダウンロード リンクを返す |   |
| いいえ - ダウンロード リンクを作成しない          |   |

#### ContainerName

アップロードに使用する Storage container 名。

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

#### ResourceGroupName

ストレージ アカウントを含むリソース グループ。

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

#### StorageAccountName

アップロードに使用する Storage Account 名。

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

#### LinkExpiryDays

生成されたダウンロード リンクの有効期限が切れるまでの日数。

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

[Runbook Reference の概要に戻る](/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/user/general/list-group-memberships.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.