Microsoft Entra IDコネクタThinklet
Last updated
Last updated
Microsoft Entra ID コネクタ Thinklet を設定し、ワークフローで特定の操作を実行します。 
Microsoft Graph API を Nexthink プラットフォームに接続するために API 資格情報を設定してください。 詳しい手順については、ワークフローのための Entra ID 統合 ドキュメントをご参照ください。
必要な認可を確認するには Microsoft ドキュメントの 権限 セクションを参照してください。
ユーザーUUIDを取得 はユーザーの汎用一意識別子(UUID)を取得します。 
Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する Get a User API エンドポイントを使用します。
パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。
ユーザー名: Active Directory のユーザー名
出力: コネクタ Thinklet の出力を表示します。
UUID (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): エラーコード
デバイスがグループのメンバーかを確認 はデバイスが 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): エラーコード
ユーザーをグループに追加 はユーザーを Entra ID グループに追加します。 
Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する Add members API エンドポイントを使用します。
パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。
ユーザーUUID: ユーザーAzure ID
グループUUID: ユーザーを追加したい Entra ID グループのUUID
出力: コネクタ Thinklet の出力を表示します。
グループからユーザーを削除 はユーザーを Entra ID グループから削除します。 
Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する Remove member API エンドポイントを使用します。
パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。
ユーザーUUID: ユーザーAzure ID
グループUUID: ユーザーを削除したい Entra ID グループのUUID
出力: コネクタ Thinklet の出力を表示します。
ユーザーのマネージャーを取得 はユーザーのマネージャー情報を取得します。  
Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する List manager API エンドポイントを使用します。
パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。
AD ユーザー名: Active Directory ユーザー名
出力: コネクタ Thinklet の出力を表示します。
マネージャーユーザーUUID (ManagerUserUUID): マネージャーユーザーUUID
マネージャーUPN (ユーザープリンシパル名) (ManagerUPN): マネージャーユーザープリンシパル名 (UPN) 
マネージャーのメールアドレス (ManagerEmailAddress): マネージャーのメールアドレス
ユーザーライセンスを確認 は特定のユーザーが Azure に特定のライセンスを持っているかを検証します。 
Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する List licenseDetails API エンドポイントを使用します。
パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。
AD ユーザー名: Active Directory ユーザー名
ソフトウェアライセンスSKU部品番号: グローバルワークフローパラメータのskuPartNumberプロパティ SKU部品番号
出力: コネクタ Thinklet の出力を表示します。
ソフトウェアライセンスSKU部品番号 (outputSkuPartNumber): ソフトウェアライセンスSKU部品番号
SKU ID (skuId): SKU 内部ID
ユーザー詳細を取得 は職名、携帯電話番号、オフィスの所在地などのユーザー詳細を取得します。
Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する Get user API エンドポイントを使用します。
パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。
AD ユーザー名: Active Directory ユーザー名
出力: コネクタ Thinklet の出力を表示します。
ユーザー職名 (UserJobTitle): ユーザー職名
ユーザー携帯電話 (UserMobilePhone): ユーザー携帯電話
ユーザーオフィスの所在地 (UserOfficeLocation): ユーザーオフィスの所在地
デバイスオブジェクトIDを取得 はデバイスUUIDを取得します。 
Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する List devices API エンドポイントを使用します。
パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。
デバイス名: Active Directory デバイス名
出力: コネクタ Thinklet の出力を表示します。
デバイスオブジェクトID (DeviceObjectID): デバイスオブジェクトID
デバイスをグループに追加 はデバイスをグループに追加します。 
Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する Add members API エンドポイントを使用します。
パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。
デバイスオブジェクトID: Entra ID デバイスID
グループUUID: デバイスを追加したい Entra ID グループのUUID
出力: コネクタ Thinklet の出力を表示します。
グループからデバイスを削除 はデバイスをグループから削除します。
Microsoft Entra ID コネクタ Thinklet は Microsoft Graph が提供する Remove member API エンドポイントを使用します。
パラメーター: この操作のために使用するデータをパラメーターとして設定します。 パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細は、ツールチップアイコン上にカーソルを移動してください。
デバイスオブジェクトID: Entra ID デバイスID
グループUUID: デバイスを削除したい Entra ID グループのUUID
コネクタ Thinklet の設定 ドキュメントを参照すると、コネクタ Thinklet についての詳しい情報を得ることができます。
