サポート (英語のみ)

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 エンドポイントを使用します。

image-20240531-134603.png

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

    • ユーザー名: 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 エンドポイントを使用します。

image-20240531-140301.png

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

    • グループ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 エンドポイントを使用します。

image-20240531-142406.png

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

    • デバイスオブジェクト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 エンドポイントを使用します。

image-20240531-144444.png

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

    • ユーザー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 エンドポイントを使用します。

image-20240531-145251.png

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

    • ユーザー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 エンドポイントを使用します。

image-20240531-145852.png

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

    • 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 エンドポイントを使用します。

image-20240320-082519.png

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

    • 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 エンドポイントを使用します。

image-20240531-151328.png

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

    • 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 エンドポイントを使用します。

image-20240531-152149.png

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

    • デバイス名: 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 エンドポイントを使用します。

image-20240604-105948.png

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

    • デバイスオブジェクト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 エンドポイントを使用します。

image-20240604-110920.png

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

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

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

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

フィールド
値

リソースパス

/groups/{{GroupUUID}}/members/{{DeviceObjectID}}/$ref

メソッド

DELETE

ペイロード

出力

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

Last updated

Was this helpful?