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

このユーザーのグループ メンバーシップを一覧表示

説明

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

メール送信に関するセットアップ

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

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

以下を参照してください RealmJoin レポート設定ドキュメント 利用可能なすべての設定の詳細について。

メールのブランド設定

レポートメールは、任意の RJReport.Branding.* テナント設定に従います:

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

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

セットアップ手順と画像要件: メールのブランド設定.

場所

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

完全な runbook 名

rjgit-user_general_list-group-memberships

詳細

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

アクセス許可

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

• 種類: Microsoft Graph

  • User.Read.All

    • 対象ユーザーを解決して、レポート用の ID と UPN を取得します
  • Group.Read.All

    • フィルター用のメンバーシップ ルールも含めて、/users/{id}/memberOf 経由でユーザーのグループを読み取ります
  • Mail.Send (オプション — 機能: メール レポート)

    • SendMail が有効で EmailTo が構成されている場合に、Send-RjReportEmail を使用してレポート メールを送信します
  • Organization.Read.All

    • メール レポート内の Tenant 表示名を取得するために /organization を読み取ります

パラメーター

UserName

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

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

GroupType

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

プロパティ	値
必須	いいえ
既定値	All
種類	文字列

MembershipType

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

プロパティ	値
必須	いいえ
既定値	All
種類	文字列

RoleAssignable

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

プロパティ	値
必須	いいえ
既定値	NotSet
種類	文字列

TeamsEnabled

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

プロパティ	値
必須	いいえ
既定値	NotSet
種類	文字列

Source

グループの起源でフィルターします: Cloud（Azure AD のみ）、OnPrem（オンプレミス AD から同期されたもの）、または All（既定）。

プロパティ	値
必須	いいえ
既定値	All
種類	文字列

WritebackEnabled

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

プロパティ	値
必須	いいえ
既定値	All
種類	文字列

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 桁の 16 進数、例: '#0052cc'）。RJReport.Branding.AccentColor テナント設定から取得されます。空または無効な場合は、既定の RealmJoin アクセント色が使用されます。

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

BrandingTextColor

レポートメール テンプレート用の任意のテキスト色の上書き（6 桁の 16 進数）。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 Account 内のコンテナー名。

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

ResourceGroupName

アップロード先の Storage Account を含むリソース グループ。

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

StorageAccountName

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

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

LinkExpiryDays

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

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

Runbook Reference の概要に戻る