グループメンバーの検索

Azure Active Directoryのグループのメンバーを一覧表示します。

オプション

フィールド 定義 タイプ 必須

Result Set(結果セット)

検索結果を表示するために次のオプションのいずれかを選択します。

  • First Matching Record(最初に一致したレコード):単一のレコードを返します。

  • First 900 Matching Records(最初に一致する900レコード):検索条件に最初に一致する900レコードを返します。

  • Stream Matching Records(一致レコードのストリーミング):一致するすべてのユーザーレコードが親フローからヘルパーフローに渡されます。カードに[Streaming(ストリーミング)]入力セクションが追加され、カスタム拡張可能フィールドのストリーミングと追加のためのヘルパーフローを選択できるようになりました。

ドロップダウン

TRUE

Search By(検索条件)

グループを検索する際の検索演算子を選択します。

  • [Exact Match (完全一致)]は、プロパティが入力値と完全に一致するユーザーを返します。

  • [Starts With(先頭一致)]は、先頭が入力値と一致するグループを返します。

  • [Query(クエリ)]は、Microsoft Graphクエリパラメータを使用してグループメンバーを返します。「クエリパラメータを使用してレスポンスをカスタマイズする」を参照してください。オプションは、[Result Set(結果セット)]ドロップダウンで[Stream Matching Users(一致ユーザーのストリーミング)]が選択されている場合にのみ使用できます。

たとえば、市町村がフィラデルフィアで名が「John」であるユーザーをクエリするには、$filter = city eq 'Philadelphia' and displayName eq 'John'クエリを使用します。

ドロップダウン

TRUE

[Stream Matching Records(一致レコードのストリーミング)]オプションの使用方法と、多数のレコードを返すためのヘルパーフローのセットアップ方法については、「ヘルパーフローを使ったレコードのストリーミング一致」を参照してください。

[Exact Match(完全一致)] に表示される入力フィールドプロパティは、[Starts With(先頭一致)] の入力フィールドプロパティとは異なります。

入力値に#ハッシュ文字を含めることはできません。

入力

フィールド 定義 タイプ 必須

ユーザー

Id or Username (IDまたはユーザー名)

Office 365ユーザーのユーザーIDまたはユーザー名。これはユーザーのユーザープリンシパル名(UPN)です。UPNは、ユーザー名とドメインを@区切り文字で組み合わせたものです。

たとえば、john.doe@somedomain.comとなります。ユーザーのメールアドレスが考えられますが、常にそうであるとは限りません。

テキスト

TRUE

入力

フィールド 定義 タイプ 必須

グループ

ID

グループの一意識別子。

テキスト

TRUE

検索

Account Enabled(有効なアカウント)

アカウントが有効な場合はTrue。それ以外の場合はFalse

ドロップダウン

FALSE

Age Group (年齢グループ)

ユーザーの年齢グループ。許容値:nullminorNot Adultadult

ドロップダウン

FALSE

City(市町村)

ユーザーの所在地の市。

テキスト

FALSE

Consent Provided For Minor (未成年者への同意の提供)

未成年者に対する同意が得られているかどうかを示します。許容値:nullgranted(付与)、denied(拒否)、notRequired(同意不要)。

テキスト

FALSE

Country(国)

ユーザーの所在地の国または地域。

たとえば、USまたはUKなど。

テキスト

FALSE

Department(部門)

ユーザーが勤務する部門の名前。

テキスト

FALSE

Display Name(表示名)

ユーザーの住所録に表示される名前。これは通常、ユーザーの名、ミドルネームのイニシャル、姓を組み合わせたものです。

最大文字数は256文字です。

テキスト

FALSE

Employee Id (従業員ID)

Organizationによってユーザーに割り当てられている従業員識別子。

テキスト

FALSE

Given Name(名)

ユーザーの名 (ファーストネーム)。

テキスト

FALSE

Job Title (役職名)

ユーザーの役職名。

テキスト

FALSE

Mail(メール)

ユーザーのSMTPアドレス。

たとえば、jeff@contoso.onmicrosoft.comなど。

テキスト

FALSE

Mail Nickname (メールニックネーム)

ユーザーのメールエイリアス。

テキスト

FALSE

On Premises Immutable Id(オンプレミス不変ID)

プロパティは、オンプレミスActive DirectoryユーザーアカウントをAzure Active Directoryユーザーオブジェクトに関連付けるために使用されます。

ユーザーのユーザープリンシパル名(UPN)プロパティに対してフェデレーションドメインを使用する場合、Graphのユーザーアカウントを作成する際にこのプロパティを指定する必要があります。

テキスト

FALSE

On Premises User Principal Name(オンプレミスユーザープリンシパル名)

オンプレミスのディレクトリから同期されるオンプレミスユーザープリンシパル名が含まれます。

このプロパティの値は、Azure Active Directory Connectを使ってオンプレミスのディレクトリをAzure Active Directoryに同期している顧客に対してのみ入力されます。

テキスト

FALSE

State(州、都道府県)

ユーザーの住所の州または都道府県。

テキスト

FALSE

Surname(姓)

ユーザーの姓 (ファミリーネーム、つまり名字)。

テキスト

FALSE

Usage Location(使用場所)

ISO 3166によって定義される2文字の国コード。国におけるサービスの可用性を検査する法的な要件により、ユーザーへのライセンスの割り当てに必要です。

たとえば、USJPGBなど。

テキスト

FALSE

User Principal Name (ユーザープリンシパル名)

ユーザーのユーザープリンシパル名 (UPN)。これは、RFC 822に基づく、ユーザーのインターネット様式のログイン名です。形式はalias@domainで、ドメインはテナントの検証済みドメインの集合に存在する必要があります。これはユーザーのメールアドレスと同じである場合があります。

テキスト

FALSE

User Type (ユーザータイプ)

MemberおよびGuestなど、ディレクトリ内でユーザータイプを分類するために使用できる文字列値。

ドロップダウン

FALSE

出力

フィールド 定義 タイプ

ID

ユーザーの一意識別子。

テキスト

Display Name(表示名)

ユーザーの住所録に表示される名前。これは通常、ユーザーの名、ミドルネームのイニシャル、姓を組み合わせたものです。

テキスト

Mail(メール)

ユーザーのSMTPアドレス。

たとえば、jeff@contoso.onmicrosoft.comなど。

テキスト

Account Enabled(有効なアカウント)

アカウントが有効な場合はtrue。それ以外の場合はfalse

True/False

Age Group (年齢グループ)

ユーザーの年齢グループ。許容値:nullminorNot Adultadult

テキスト

関連項目

Azure Active Directoryコネクター

Workflows要素

Azure Active Directoryコネクターのガイダンス

Azure Active Directory管理APIの概要