MS Graph Groups and Users

  • リファレンス

MS Graph Groups and Users コネクタでは、Microsoft Entra ID グループ、メンバー (ユーザー)、およびライセンスの詳細を取得することができます

このコネクタは、次の製品および地域で利用可能です:

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 Jay Jani、マイクロソフト
メール jayjani@microsoft.com
Connector Metadata
発行者 Jay Jani
Web サイト https://graph.microsoft.com
プライバシー ポリシー https://privacy.microsoft.com/en-us/privacystatement
カテゴリ IT オペレーション、データ

接続を作成する

このコネクタは、次の認証タイプをサポートしています:
既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

グループのプロパティの取得

Microsoft Entra ID グループのプロパティとリレーションシップを取得する
グループを表示名検索で一覧表示

グループの表示名を検索してグループを取得します
ディレクト グループ メンバーを一覧表示する

カウントのあるグループのディレクト メンバーを取得する
メンバー グループの取得

ユーザー (メンバー) のグループ メンバーシップ
メンバー ライセンスの詳細の取得

グループ メンバー (ユーザー) のライセンスの詳細を取得する
ユーザーを一覧表示

組織のユーザーをすべて取得する (Microsoft Entra ID テナント)
登録している SKU のリスト

組織が登録したライセンス プラン SKU の詳細

グループのプロパティの取得

操作 ID:
GetGroupProperties

Microsoft Entra ID グループのプロパティとリレーションシップを取得する

パラメーター

名前 キー 必須 型 説明
Microsoft Entra ID グループのオブジェクト ID
 group-id True string

Microsoft Entra ID グループのオブジェクト ID

戻り値

名前 パス 型 説明
Odata コンテキスト
 @odata.context string

Odata.context リンク。
ID
 id string

グループのオブジェクト ID
削除済み日時
 deletedDateTime string

グループの削除日時
分類
 classification string

分類
作成日時
 createdDateTime string

グループの作成日時
creationOptions
 creationOptions array of string

グループのオプションを作成しました。
説明
 description string

説明
表示名
 displayName string

グループの表示名
有効期限の日時
 expirationDateTime string

グループの有効期限の日時
groupTypes
 groupTypes array of string

グループのグループ タイプ。
ロールに割り当てが可能
 isAssignableToRole string

このグループにロールを割り当てることはできますか。
メール
 mail string

グループのメール
メールの有効化
 mailEnabled boolean

グループ メールは有効ですか。
メール ニックネーム
 mailNickname string

グループのメール ニックネーム
メンバーシップ ルール
 membershipRule string

メンバーシップ評価に使用されるルール。
メンバーシップ ルールの処理状態
 membershipRuleProcessingState string

メンバーシップ評価に使用されるルールの処理状態。
OnPremises のドメイン名
 onPremisesDomainName string

オンプレミスのディレクトリから同期された dnsDomainName とも呼ばれるオンプレミスの domainFQDN が含まれます。
OnPremises の前回の同期日時
 onPremisesLastSyncDateTime string

テナントがオンプレミス ディレクトリと最後に同期された日時。
OnPremises NetBios 名
 onPremisesNetBiosName string

オンプレミス サーバーのネットワーク サービスの名前。
OnPremises Sam アカウント名
 onPremisesSamAccountName string

オンプレミス ディレクトリの Sam アカウント名。
OnPremises のセキュリティ識別子
 onPremisesSecurityIdentifier string

オンプレミスのセキュリティ識別子。
OnPremises の同期が有効
 onPremisesSyncEnabled boolean

オンプレミスの同期がグループに対して有効の場合は True。
優先データの場所
 preferredDataLocation string

グループの優先データの場所。
優先する言語
 preferredLanguage string

Microsoft Entra ID で構成された優先する言語。
proxyAddresses
 proxyAddresses array of string

グループのプロキシ アドレスです。
更新された日時
 renewedDateTime string

グループの更新日時。
resourceBehaviorOptions
 resourceBehaviorOptions array of string

グループのリソース動作オプションです。
resourceProvisioningOptions
 resourceProvisioningOptions array of string

グループのリソース プロビジョニング オプションです。
セキュリティの有効化
 securityEnabled boolean

グループのセキュリティが有効化されているかどうかを示します。
セキュリティ ID
 securityIdentifier string

グループのセキュリティ ID。
Theme
 theme string

Microsoft Entra ID グループのテーマ。
Visibility
 visibility string

グループの可視性。
onPremisesProvisioningErrors
 onPremisesProvisioningErrors array of string

グループのオンプレミス プロビジョニング エラー。

グループを表示名検索で一覧表示

操作 ID:
ListGroupsByDisplayNameSearch

グループの表示名を検索してグループを取得します

パラメーター

名前 キー 必須 型 説明
表示名で検索する
 $search string

Microsoft Entra ID グループの表示名に含まれるキーワードで検索する

戻り値

名前 パス 型 説明
Odata コンテキスト
 @odata.context string

Odata.context リンク。
グループの数
 @odata.count integer

@odata.count
価値
 value array of object

価値
ID
 value.id string

グループのオブジェクト ID
削除済み日時
 value.deletedDateTime string

グループ削除の日時
分類
 value.classification string

グループの分類
作成日時
 value.createdDateTime string

グループ作成の日時
creationOptions
 value.creationOptions array of

グループのオプションを作成しました。
説明
 value.description string

グループの説明
表示名
 value.displayName string

グループの表示名
有効期限の日時
 value.expirationDateTime string

グループの有効期限の日時
groupTypes
 value.groupTypes array of string

グループのグループ タイプ。
ロールに割り当てが可能
 value.isAssignableToRole string

このグループにロールを割り当てることはできますか。
メール
 value.mail string

グループのメール
メールの有効化
 value.mailEnabled boolean

グループ メールは有効ですか。
メール ニックネーム
 value.mailNickname string

グループのメール ニックネーム
メンバーシップ ルール
 value.membershipRule string

メンバーシップ評価に使用されるルール。
メンバーシップ ルールの処理状態
 value.membershipRuleProcessingState string

メンバーシップ評価に使用されるルールの処理状態。
OnPremises のドメイン名
 value.onPremisesDomainName string

オンプレミスのディレクトリから同期された dnsDomainName とも呼ばれるオンプレミスの domainFQDN が含まれます。
OnPremises の前回の同期日時
 value.onPremisesLastSyncDateTime string

テナントがオンプレミス ディレクトリと最後に同期された日時。
OnPremises NetBios 名
 value.onPremisesNetBiosName string

オンプレミス サーバーのネットワーク サービスの名前。
OnPremises Sam アカウント名
 value.onPremisesSamAccountName string

オンプレミス ディレクトリの Sam アカウント名。
OnPremises のセキュリティ識別子
 value.onPremisesSecurityIdentifier string

オンプレミスのセキュリティ識別子。
OnPremises の同期が有効
 value.onPremisesSyncEnabled boolean

オンプレミスの同期がグループに対して有効の場合は True。
優先データの場所
 value.preferredDataLocation string

グループの優先データの場所。
優先する言語
 value.preferredLanguage string

Microsoft Entra ID で構成された優先する言語。
proxyAddresses
 value.proxyAddresses array of string

グループのプロキシ アドレスです。
更新された日時
 value.renewedDateTime string

グループの更新日時。
resourceBehaviorOptions
 value.resourceBehaviorOptions array of

グループのリソース動作オプションです。
resourceProvisioningOptions
 value.resourceProvisioningOptions array of string

グループのリソース プロビジョニング オプションです。
セキュリティの有効化
 value.securityEnabled boolean

グループのセキュリティが有効化されているかどうかを示します。
セキュリティ ID
 value.securityIdentifier string

グループのセキュリティ ID。
Theme
 value.theme string

Microsoft Entra ID グループのテーマ。
Visibility
 value.visibility string

グループの可視性。
onPremisesProvisioningErrors
 value.onPremisesProvisioningErrors array of

グループのオンプレミス プロビジョニング エラー。

ディレクト グループ メンバーを一覧表示する

操作 ID:
ListDirectGroupMembers

カウントのあるグループのディレクト メンバーを取得する

パラメーター

名前 キー 必須 型 説明
Microsoft Entra ID グループのオブジェクト ID
 group-id True string

Microsoft Entra ID グループのオブジェクト ID
フィルター
 $filter string

フィルター
データ ポイント (列) の選択
 $select string

取得する列を選択します

戻り値

名前 パス 型 説明
Odata コンテキスト
 @odata.context string

Odata.context リンク。
Odata カウント
 @odata.count integer

@odata.count
価値
 value array of object

価値
Odata タイプ
 value.@odata.type string

@odata.type
Display Name
 value.displayName string

メンバーの姓名
User Principal Name
 value.userPrincipalName string

メンバーのユーザー プリンシパル名
ID
 value.id string

メンバーのオブジェクト ID
役職
 value.jobTitle string

役職
メール ニックネーム
 value.mailNickname string

メンバーのメール ニックネーム
メール
 value.mail string

メンバーのメール
名前
 value.givenName string

メンバーの名
姓
 value.surname string

メンバーの姓
businessPhones
 value.businessPhones array of string

businessPhones
携帯電話
 value.mobilePhone string

mobilePhone
オフィスの場所
 value.officeLocation string

officeLocation
優先する言語
 value.preferredLanguage string

Microsoft Entra ID で構成された優先する言語。

メンバー グループの取得

操作 ID:
GetMemberGroups

ユーザー (メンバー) のグループ メンバーシップ

パラメーター

名前 キー 必須 型 説明
Microsoft Entra ID メンバー (ユーザー) のオブジェクト ID
 member-id True string

Microsoft Entra ID メンバー (ユーザー) のオブジェクト ID
有効なセキュリティのみ (true/false)
 securityEnabledOnly True boolean

セキュリティが有効なグループのみを取得しますか。

戻り値

名前 パス 型 説明
Odata コンテキスト
 @odata.context string

Odata.context リンク。
価値
 value array of string

価値

メンバー ライセンスの詳細の取得

操作 ID:
GetMemberLicenseDetails

グループ メンバー (ユーザー) のライセンスの詳細を取得する

パラメーター

名前 キー 必須 型 説明
Microsoft Entra ID メンバー (ユーザー) のオブジェクト ID
 id True string

Microsoft Entra ID メンバー (ユーザー) のオブジェクト ID
データ ポイント (列) の選択
 $select string

データ ポイント (列) の選択

戻り値

名前 パス 型 説明
Odata コンテキスト
 @odata.context string

Odata.context リンク。
価値
 value array of object

価値
ID
 value.id string

ID
SKU ID
 value.skuId string

SKU の ID。
SKU 部品番号
 value.skuPartNumber string

SKU の名前
servicePlans
 value.servicePlans array of object

servicePlans
servicePlanId
 value.servicePlans.servicePlanId string

servicePlanId
servicePlanName
 value.servicePlans.servicePlanName string

servicePlanName
provisioningStatus
 value.servicePlans.provisioningStatus string

provisioningStatus
appliesTo
 value.servicePlans.appliesTo string

appliesTo

ユーザーを一覧表示

操作 ID:
ListUsers

組織のユーザーをすべて取得する (Microsoft Entra ID テナント)

戻り値

名前 パス 型 説明
@odata.context
 @odata.context string

Odata.context リンク。
価値
 value array of object

価値
businessPhones
 value.businessPhones array of string

businessPhones
表示名
 value.displayName string

ユーザーの氏名
姓
 value.givenName string

ユーザーの名
役職
 value.jobTitle string

ユーザーの役職
メール
 value.mail string

ユーザーのメール
携帯電話
 value.mobilePhone string

ユーザーの携帯電話番号
オフィスの場所
 value.officeLocation string

ユーザーのオフィスの場所
優先する言語
 value.preferredLanguage string

ユーザーが優先する言語
姓
 value.surname string

ユーザーの姓
ユーザー プリンシパル名
 value.userPrincipalName string

ユーザーのプリンシパル名
ID
 value.id string

ユーザーのオブジェクト ID

登録している SKU のリスト

操作 ID:
ListSubscribedSkus

組織が登録したライセンス プラン SKU の詳細

戻り値

名前 パス 型 説明
Odata コンテキスト
 @odata.context string

Odata.context リンク。
価値
 value array of object

価値
機能ステータス
 value.capabilityStatus string

SKU の機能ステータス
消費ユニット
 value.consumedUnits integer

すでにいくつの SKU ユニットが消費されていますか。
ID
 value.id string

ID
SKU ID
 value.skuId string

SKU のグローバル一意識別子
SKU 部品番号
 value.skuPartNumber string

SKU の名前
適用対象
 value.appliesTo string

SKU の対象者
有効化
 value.prepaidUnits.enabled integer

有効なユニット
中断
 value.prepaidUnits.suspended integer

中断されたユニット
警告
 value.prepaidUnits.warning integer

警告されているユニット
servicePlans
 value.servicePlans array of object

servicePlans
servicePlanId
 value.servicePlans.servicePlanId string

servicePlanId
servicePlanName
 value.servicePlans.servicePlanName string

servicePlanName
provisioningStatus
 value.servicePlans.provisioningStatus string

provisioningStatus
appliesTo
 value.servicePlans.appliesTo string

appliesTo