Microsoft Entra IDコネクタThinklet

Microsoft Entra IDコネクタのThinkletを設定して、ワークフローで特定のアクションを実行させます。

Microsoft Graph API を Nexthink プラットフォームに接続するために API 資格情報を設定してください。 詳しい手順については、ワークフローのための Entra ID 統合 ドキュメントをご参照ください。

必要な認可を確認するには Microsoft ドキュメントの 権限 セクションを参照してください。

アクション: ユーザーUUIDを取得

ユーザーUUIDを取得 はユーザーの一意の識別子（UUID）を取得します。

Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する Get a User API エンドポイントを使用します。

• パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。

  • ユーザー名: Active Directory のユーザー名

• 出力: コネクタ Thinklet の出力を表示します。

  • UUID (uuid): ユーザーID

下表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/users/{{adUsername}}
メソッド	GET
ペイロード
出力	UUID $.id

アクション: ユーザーがグループにいるか確認

ユーザーがグループにいるか確認 はユーザーが Entra ID グループに所属しているかを確認します。 システムがユーザーをグループ内で見つけた場合、出力 フィールドは空のままです。 ユーザーがグループに存在しない、またはサポートされていないクエリを送信した場合、出力 フィールドには Request_ResourceNotFound または Request_UnsupportedQuery エラーが表示されます。

Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する List a user's direct memberships API エンドポイントを使用します。

• パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。

  • グループUUID: Active Directory グループID

  • ユーザーUUID: Entra ID ユーザーUUID

• 出力: コネクタ Thinklet の出力を表示します。

  • エラーコード (groupPresenceErrorCode): エラーコード

下表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/users/{{userUuid}}//memberOf?$filter=id+eq+'{{groupUuid}}'&$select=id
メソッド	GET
ペイロード
出力	groupPresenceErrorCode $.error.code

アクション: デバイスがグループのメンバーかを確認

デバイスがグループのメンバーかを確認 はデバイスが Entra ID グループに所属しているかを検証します。 システムがユーザーをグループ内で見つけた場合、出力 フィールドは空のままです。 ユーザーがグループに存在しない、またはサポートされていないクエリを送信した場合、出力 フィールドには Request_ResourceNotFound または Request_UnsupportedQuery エラーが表示されます。

Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する List device memberships API エンドポイントを使用します。

• パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。

  • デバイスオブジェクトID: デバイスAzure ID

  • グループUUID: Active Directory グループID

• 出力: コネクタ Thinklet の出力を表示します。

  • エラーコード (groupPresenceErrorCode): エラーコード

下表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/devices/{{DeviceObjectID}}//memberOf?$filter=id+eq+'{{groupUuid}}'&$select=id
メソッド	GET
ペイロード
出力	groupPresenceErrorCode $.error.code

アクション: ユーザーをグループに追加

ユーザーをグループに追加 はユーザーを Entra ID グループに追加します。&#x20

Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する Add members API エンドポイントを使用します。

• パラメーター: このアクションのパラメーターとして使用するデータを設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコンにカーソルを合わせて表示します。

  • ユーザーUUID: ユーザーAzure ID

  • グループUUID: ユーザーを追加したい Entra ID グループのUUID

• 出力: コネクタThinkletの出力を表示します。

下表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/groups/{{groupUuid}}/members/$ref
メソッド	POST
ペイロード
出力	{ "@odata.id": "https://graph.microsoft.com/v1.0/directoryObjects/{{userUuid}}"}

アクション: グループからユーザーを削除

グループからユーザーを削除 はユーザーを Entra ID グループから削除します。&#x20

Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する Remove member API エンドポイントを使用します。

• パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。

  • ユーザーUUID: ユーザーAzure ID

  • グループUUID: ユーザーを削除したい Entra ID グループのUUID

• 出力: コネクタ Thinklet の出力を表示します。

下表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/groups/{{groupUuid}}/members/{{userUuid}}/$ref
メソッド	DELETE
ペイロード
出力

アクション: ユーザーのマネージャーを取得

ユーザーのマネージャーを取得 はユーザーのマネージャー情報を取得します。 &#x20

Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する List manager API エンドポイントを使用します。

• パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。

  • AD ユーザー名: Active Directory ユーザー名

• 出力: コネクタ Thinklet の出力を表示します。

  • マネージャーユーザーUUID (ManagerUserUUID): マネージャーユーザーUUID

  • マネージャーUPN (ユーザープリンシパル名) (ManagerUPN): マネージャーユーザープリンシパル名 (UPN)&#x20

  • マネージャーのメールアドレス (ManagerEmailAddress): マネージャーのメールアドレス

下表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/users/{{adUsername}}/manager
メソッド	GET
ペイロード
出力	ManagerUserUUID $.id ManagerEmailAddress $.mail ManagerUPN $.userPrincipalName

アクション: ユーザーライセンスを確認

ユーザーライセンスを確認 は特定のユーザーが Azure に特定のライセンスを持っているかを検証します。&#x20

Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する List licenseDetails API エンドポイントを使用します。

• パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。

  • AD ユーザー名: Active Directory ユーザー名

  • ソフトウェアライセンスSKU部品番号: グローバルワークフローパラメータのskuPartNumberプロパティ SKU部品番号

• 出力: コネクタ Thinklet の出力を表示します。

  • ソフトウェアライセンスSKU部品番号 (outputSkuPartNumber): ソフトウェアライセンスSKU部品番号

  • SKU ID (skuId): SKU 内部ID

下表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/users/{{adUsername}}/licenseDetails
メソッド	GET
ペイロード
出力	skuId $.value[?(@.skuPartNumber=="{{skuPartNumber}}")].skuId outputSkuPartNumber $.value[?(@.skuPartNumber=="{{skuPartNumber}}")].skuPartNumber

アクション: ユーザー詳細を取得

ユーザー詳細を取得 は職名、携帯電話番号、オフィスの所在地などのユーザー詳細を取得します。

Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する Get user API エンドポイントを使用します。

• パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。

  • AD ユーザー名: Active Directory ユーザー名

• 出力: コネクタ Thinklet の出力を表示します。

  • ユーザー職名 (UserJobTitle): ユーザー職名

  • ユーザー携帯電話 (UserMobilePhone): ユーザー携帯電話

  • ユーザーオフィスの所在地 (UserOfficeLocation): ユーザーオフィスの所在地

下表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/users/{{adUsername}}
メソッド	GET
ペイロード
出力	UserJobTitle $.jobTitle UserMobilePhone $.mobilePhone UserOfficeLocation $.officeLocation

アクション: デバイスオブジェクトIDを取得

デバイスオブジェクトIDを取得 はデバイスUUIDを取得します。&#x20

Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する List devices API エンドポイントを使用します。

• パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。

  • デバイス名: Active Directory デバイス名

• 出力: コネクタ Thinklet の出力を表示します。

  • デバイスオブジェクトID (DeviceObjectID): デバイスオブジェクトID

下表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/devices?$filter=displayName+eq+'{{DeviceName}}'
メソッド	GET
ペイロード
出力	DeviceObjectID $.value[0].id

アクション: デバイスをグループに追加

デバイスをグループに追加 はデバイスをグループに追加します。&#x20

Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する Add members API エンドポイントを使用します。

• パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。

  • デバイスオブジェクトID: Entra ID デバイスID

  • グループUUID: デバイスを追加したい Entra ID グループのUUID

• 出力: コネクタ Thinklet の出力を表示します。

下表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/groups/{{groupUuid}}/members/$ref
メソッド	POST
ペイロード	{"@odata.id": "https://graph.microsoft.com/v1.0/directoryObjects/{{DeviceObjectID}}"}
出力

アクション: グループからデバイスを削除

グループからデバイスを削除 はデバイスをグループから削除します。

Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する Remove member API エンドポイントを使用します。

• パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。

  • デバイスオブジェクトID: Entra ID デバイスID

  • グループUUID: デバイスを削除したい Entra ID グループのUUID

下表は、コネクタを再作成する際に必要なAPIサービスコネクタの詳細を示しています。

フィールド	値
リソースパス	/groups/{{GroupUUID}}/members/{{DeviceObjectID}}/$ref
メソッド	DELETE
ペイロード
出力

コネクタ Thinklet の設定 ドキュメントを参照すると、コネクタ Thinklet についての詳しい情報を得ることができます。