次の方法で共有

MS Graph グループとユーザー

MS Graph グループとユーザー コネクタは、Microsoft Entra ID グループ、メンバー (ユーザー)、ライセンスの詳細を取得するのに役立ちます

このコネクタは、次の製品とリージョンで使用できます。

サービス クラス リージョン
コピロット スタジオ Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
ロジック アプリ Standard 次を除くすべての Logic Apps リージョン :
     - Azure Government リージョン
     - Azure China リージョン
     - 米国国防総省 (DoD)
Power Apps Premium 次を除くすべての Power Apps リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Automate Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
お問い合わせ
名前 Jay Jani、Microsoft
Email jayjani@microsoft.com
コネクタ メタデータ
Publisher Jay Jani
Website https://graph.microsoft.com
プライバシー ポリシー https://privacy.microsoft.com/en-us/privacystatement
カテゴリ IT 運用;データ

接続を作成する

コネクタでは、次の認証の種類がサポートされています。
デフォルト 接続を作成するためのパラメーター。 すべてのリージョン 共有不可

デフォルト

適用対象: すべてのリージョン

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

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

調整制限

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

アクション

グループのプロパティを取得する

Microsoft Entra ID グループのプロパティとリレーションシップを取得する
サブスクライブされている SKU の一覧表示

組織のサブスクライブ済みライセンス プラン SKU の詳細
メンバー グループを取得する

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

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

組織内のすべてのユーザーを取得する (Microsoft Entra ID テナント)
直接グループ メンバーを一覧表示する

count を使用してグループの直接メンバーを取得する
表示名検索でグループを一覧表示する

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

グループのプロパティを取得する

操作 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
 classification string

classification
作成日時
 createdDateTime string

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

グループの作成されたオプション。
Description
 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

オンプレミス のドメインFQDN (オンプレミス ディレクトリから同期される dnsDomainName とも呼ばれます) が含まれます。
OnPremises の最終同期日時
 onPremisesLastSyncDateTime string

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

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

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

オンプレミスのセキュリティ識別子。
OnPremises Sync Enabled
 onPremisesSyncEnabled boolean

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

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

Microsoft Entra ID で構成されている優先言語。
プロキシアドレス
 proxyAddresses array of string

グループのプロキシ アドレス。
更新日時
 renewedDateTime string

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

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

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

グループがセキュリティが有効かどうかを示します。
セキュリティ ID
 securityIdentifier string

グループのセキュリティ識別子。
テーマ
 theme string

Microsoft Entra ID グループのテーマ。
可視性
 visibility string

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

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

サブスクライブされている SKU の一覧表示

操作 ID:
ListSubscribedSkus

組織のサブスクライブ済みライセンス プラン SKU の詳細

戻り値

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

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

value
機能の状態
 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 は誰に適用されますか?
Enabled
 value.prepaidUnits.enabled integer

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

吊り下げユニット
Warnung
 value.prepaidUnits.warning integer

警告の単位数
servicePlans
 value.servicePlans array of object

servicePlans
servicePlanId
 value.servicePlans.servicePlanId string

servicePlanId
servicePlanName
 value.servicePlans.servicePlanName string

servicePlanName
プロビジョニングステータス
 value.servicePlans.provisioningStatus string

プロビジョニングステータス
適用する
 value.servicePlans.appliesTo string

適用する

メンバー グループを取得する

操作 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
 value array of string

value

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

操作 ID:
GetMemberLicenseDetails

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

パラメーター

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

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

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

戻り値

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

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

value
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
プロビジョニングステータス
 value.servicePlans.provisioningStatus string

プロビジョニングステータス
適用する
 value.servicePlans.appliesTo string

適用する

ユーザー一覧表示

操作 ID:
ListUsers

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

戻り値

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

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

value
businessPhones
 value.businessPhones array of string

businessPhones
表示される名前
 value.displayName string

ユーザーのフル ネーム
名前
 value.givenName string

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

ユーザーの役職
郵便
 value.mail string

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

ユーザーの携帯電話
Office の場所
 value.officeLocation string

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

ユーザーの優先言語
Surname
 value.surname string

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

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

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

直接グループ メンバーを一覧表示する

操作 ID:
ListDirectGroupMembers

count を使用してグループの直接メンバーを取得する

パラメーター

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

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

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

取得する列を選択する

戻り値

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

Odata.context リンク。
Odata Count
 @odata.count integer

@odata.count
value
 value array of object

value
Odata 型
 value.@odata.type string

@odata.type
表示される名前
 value.displayName string

メンバーのフル ネーム
ユーザー プリンシパル名
 value.userPrincipalName string

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

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

職務タイトル
メール ニック名
 value.mailNickname string

メンバーの電子メールのニック名
郵便
 value.mail string

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

メンバーの名
Surname
 value.surname string

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

businessPhones
携帯電話番号
 value.mobilePhone string

mobilePhone
Office の場所
 value.officeLocation string

officeLocation
優先言語
 value.preferredLanguage string

Microsoft Entra ID で構成されている優先言語。

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

操作 ID:
ListGroupsByDisplayNameSearch

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

パラメーター

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

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

戻り値

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

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

@odata.count
value
 value array of object

value
ID
 value.id string

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

グループ削除の日付と時刻
Classification
 value.classification string

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

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

グループの作成されたオプション。
Description
 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

オンプレミス のドメインFQDN (オンプレミス ディレクトリから同期される dnsDomainName とも呼ばれます) が含まれます。
OnPremises の最終同期日時
 value.onPremisesLastSyncDateTime string

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

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

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

オンプレミスのセキュリティ識別子。
OnPremises Sync Enabled
 value.onPremisesSyncEnabled boolean

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

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

Microsoft Entra ID で構成されている優先言語。
プロキシアドレス
 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

グループのセキュリティ識別子。
テーマ
 value.theme string

Microsoft Entra ID グループのテーマ。
可視性
 value.visibility string

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

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