Microsoft Entra ID コネクタ Thinklet
Last updated
Last updated
Microsoft Entra ID コネクタ Thinklet を設定して、ワークフロー内で特定のアクションを実行します。
API クレデンシャルを設定し、Microsoft Graph API と Nexthink Platform を接続します。 詳細な手順については、ワークフロー用 Entra ID Integration ドキュメントを参照してください。
必要な許可を表示するには、Microsoft のドキュメントの Permissions セクションを参照してください。
ユーザー UUID を取得は、ユーザーの Universally Unique Identifier (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 番号: SKU番号の SKU Part Number グローバルワークフロー パラメーターの skuPartNumber プロパティ
出力: コネクタ 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
コネクタ Thinklets についての詳細は、Configuring connector thinklets ドキュメントを参照してください。
