# Jamf Proコネクターシンクレット

このページでは、Jamf Pro を使用してThinkletを構成する際のさまざまなアクションを説明しています。

Jamf Pro コネクタは Jamf Pro とのシームレスな統合を可能にし、管理者がワークフロー内でデバイス管理操作を実行できるようにします。 コネクタは[Jamf ProのAPI](https://developer.jamf.com/jamf-pro/reference/jamf-pro-api)と連携し、インベントリデータの取得やプロファイルの更新、コマンドの送信など様々なアクションを提供します。

## アクション: **MDM SETTINGS コマンドを投稿** <a href="#chatgptconnectorthinklet-connector-chatgpt" id="chatgptconnectorthinklet-connector-chatgpt"></a>

このアクションは、管理デバイスに MDM (モバイルデバイス管理) SETTINGS コマンドを送信します。

SETTINGSコマンドは、デバイスの構成設定を更新またはリフレッシュするために使用され、組織のポリシーに準拠していることを確認します。 詳細については、[MDM エンドポイントのドキュメント](https://developer.jamf.com/jamf-pro/reference/post_v2-mdm-commands)を参照してください。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-035f866a0417550032a0637c30d3670720161886%2Fimage%20(325).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**パラメータ:**

* **コンピュータ管理ID** (`​ComputerManagementId`) – Jamf Proによって割り当てられたターゲットコンピュータを管理するための一意の識別子。

**出力:**

* **コマンドID** (`CommandId`) – コマンドの内部識別子で、コマンドの実行結果を追跡および検証するのに役立ちます。

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

<table><thead><tr><th width="272">フィールド</th><th>Valeur</th><th data-hidden></th></tr></thead><tbody><tr><td>リソースパス</td><td><code>api/v2/mdm/commands</code></td><td></td></tr><tr><td>方法</td><td>POST</td><td></td></tr><tr><td>ペイロード</td><td><code>{</code><br><code>"clientData": [</code><br><code>{</code><br><code>"managementId": "{{ComputerManagementId}}"</code><br><code>}</code><br><code>],</code><br><code>"commandData": {</code><br><code>"commandType": "SETTINGS"</code><br><code>}</code><br><code>}</code></td><td></td></tr><tr><td>出力</td><td><code>CommandId</code>: <code>$[0].id</code></td><td></td></tr></tbody></table>

## アクション: コンピュータの在庫一般データを取得 <a href="#chatgptconnectorthinklet-connector-chatgpt" id="chatgptconnectorthinklet-connector-chatgpt"></a>

MDM ステータス、監督状態、および MDM プロファイルの有効期限を含む、コンピュータの一般的な在庫詳細を取得します。 詳細については[コンピュータの一般セクションを返す](https://developer.jamf.com/jamf-pro/reference/get_v1-computers-inventory-id)を参照してください。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-47691e1ebc30040fbf35a6e7baa1657b56cc245b%2Fimage%20(416).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**パラメータ:**

* **コンピュータ ID** (`ComputerId`) – Jamf Pro コンピュータ ID。

**出力:**

* **コンピュータ管理ID** (`ComputerManagementId`)
* **UDID** (`UDID`) - Apple デバイスの UDID（ユニークデバイス識別子）
* **名前** (`Name`) – コンピュータ名。
* **MDM 可能?** (`MDMCapable`) – デバイスが MDM をサポートしているかどうかを示します。
* **監視中?** (`Supervised`) – デバイスが監視下にあるかどうかを示します。
* **レポートの日付** (`ReportDate`) – 最後のインベントリレポートの日付。
* **MDM プロファイルの有効期限** (`mdmProfileExpiration`) – MDM プロファイルの有効期限。

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

<table><thead><tr><th width="221.33331298828125">フィールド</th><th>Valeur</th><th data-hidden></th></tr></thead><tbody><tr><td>リソースパス</td><td><code>api/v1/computers-inventory/{{ComputerId}}?section=GENERAL</code></td><td></td></tr><tr><td>方法</td><td>GET</td><td></td></tr><tr><td>出力</td><td><p><code>ComputerManagementId</code>: <code>$.general.managementId</code></p><p><code>UDID</code>:<code>$.udid</code></p><p><code>Name</code>: <code>$.general.name</code></p><p><code>MDMCapable</code>: <code>$.general.mdmCapable.capable</code></p><p><code>Supervised</code>: <code>$.general.supervised</code></p><p><code>ReportDate</code>: <code>$.general.reportDate</code></p><p><code>mdmProfileExpiration</code>:<code>$.general.mdmProfileExpiration</code></p></td><td></td></tr></tbody></table>

## アクション: コンピュータのインベントリ購入データを取得する <a href="#chatgptconnectorthinklet-connector-chatgpt" id="chatgptconnectorthinklet-connector-chatgpt"></a>

購入注文日、保証の有効期限、予想寿命を含むコンピュータの購入関連のインベントリデータを取得します。 [コンピュータの一般的なセクションのリターン](https://developer.jamf.com/jamf-pro/reference/get_v1-computers-inventory-id)を参照して、詳細をご覧ください。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-7ff985ddd611a0cbbf6a20cdccde93ab96d1fdf7%2Fimage%20(329).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**パラメータ:**

* **コンピュータ ID** (`ComputerId`) – Jamf Pro コンピュータ ID。

**出力:**

* **購入注文日** (`PODate`) – 購入日。
* **保証有効期限** (`WarrantyDate`) – 保証の有効期限。
* **寿命期待** (`LifeExpectancy`) – 予想運用寿命。

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

<table><thead><tr><th width="226">フィールド</th><th>Valeur</th><th data-hidden></th></tr></thead><tbody><tr><td>リソースパス</td><td><code>api/v1/computers-inventory/{{ComputerId}}?section=PURCHASING</code></td><td></td></tr><tr><td>方法</td><td>GET</td><td></td></tr><tr><td>出力</td><td><p><code>PODate</code>: <code>$.purchasing.poDate</code></p><p><code>WarrantyDate</code>:<code>$.purchasing.warrantyDate</code></p><p><code>LifeExpectancy</code>:<code>$.purchasing.lifeExpectancy</code></p></td><td></td></tr></tbody></table>

## アクション: MDM プロファイルを更新する <a href="#chatgptconnectorthinklet-connector-chatgpt" id="chatgptconnectorthinklet-connector-chatgpt"></a>

Jamf Pro 管理ポリシーに準拠していることを確認するために、コンピュータの MDM プロファイルの更新を要求します。 [MDM プロファイルの更新](https://developer.jamf.com/jamf-pro/reference/post_v1-mdm-renew-profile)を参照して、詳細をご覧ください。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-7f8d5b2c5f41cd5baf3352bbfff1141e68881c70%2Fimage%20(417).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**パラメータ:**

* **UDID** (`UDID`) – Apple デバイスの UDID（ユニークデバイス識別子）。

**出力:**

* **処理されていない ID** (`NotProcessedId`) – 更新要求が処理されなかったことを示します。

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

<table><thead><tr><th width="226">フィールド</th><th>Valeur</th><th data-hidden></th></tr></thead><tbody><tr><td>リソースパス</td><td><code>api/v1/mdm/renew-profile</code></td><td></td></tr><tr><td>方法</td><td>POST</td><td></td></tr><tr><td>ペイロード</td><td><code>{</code><br><code>"udids": ["{{UDID}}"]</code><br><code>}</code></td><td></td></tr><tr><td>出力</td><td><code>NotProcessedId</code>: <code>$.udidsNotProcessed.udids[0]</code></td><td></td></tr></tbody></table>

## アクション: コンピュータ名でコンピュータのインベントリ一般データを取得する <a href="#chatgptconnectorthinklet-connector-chatgpt" id="chatgptconnectorthinklet-connector-chatgpt"></a>

コンピュータ ID の代わりにコンピュータ名を使用して一般的なインベントリデータを取得します。 [コンピュータの一般的なセクションのリターン](https://developer.jamf.com/jamf-pro/reference/get_v1-computers-inventory-id)を参照して、詳細をご覧ください。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-7808f0ea112e1492feffde7d258ca9a96ee00c77%2Fimage%20(418).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**パラメータ:**

* **コンピュータ名** (`ComputerName`) – Jamf Pro コンピュータ名。

**出力:**

* **コンピュータ管理ID** (`ComputerManagementId`)
* **コンピュータID** (`ComputerId`)
* **UDID** (`UDID`) - Apple デバイスの UDID（ユニークデバイス識別子）

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

<table><thead><tr><th width="226">フィールド</th><th>Valeur</th><th data-hidden></th></tr></thead><tbody><tr><td>リソースパス</td><td><code>api/v1/computers-inventory?section=GENERAL&#x26;page=0&#x26;page-size=100&#x26;sort=general.name%3Aasc&#x26;filter=general.name=={{ComputerName}}</code></td><td></td></tr><tr><td>方法</td><td>GET</td><td></td></tr><tr><td>出力</td><td><p><code>ComputerManagementId</code>: <code>$.results[0].general.managementId</code></p><p><code>ComputerId</code>: <code>$.results[0].id</code></p><p><code>UDID</code>: <code>$.results[0].udid</code></p></td><td></td></tr></tbody></table>

## アクション: MDM コマンド情報を取得する <a href="#chatgptconnectorthinklet-connector-chatgpt" id="chatgptconnectorthinklet-connector-chatgpt"></a>

以前に実行された MDM コマンドのステータスと種類を取得します。 [Jamf Pro による MDM コマンドに関する情報を取得する](https://developer.jamf.com/jamf-pro/reference/get_v2-mdm-commands)を参照して、詳細をご覧ください。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-e5c6f1113479ff39c8b441a2c9c145b172d14ba2%2Fimage%20(324).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**パラメータ:**

* **コマンド ID** (`CommandId`) – 実行されたコマンドの ID。

**出力:**

* **コマンドの種類** (`CommandType`)
* **コマンドの状態** (`CommandState`)

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

<table><thead><tr><th width="226">フィールド</th><th>値</th><th data-hidden></th></tr></thead><tbody><tr><td>リソースパス</td><td><code>api/v2/mdm/commands?page=0&#x26;page-size=100&#x26;sort=dateSent%3Aasc&#x26;filter=uuid=={{CommandId}}</code></td><td></td></tr><tr><td>方法</td><td>GET</td><td></td></tr><tr><td>出力</td><td><p><code>CommandType</code>: <code>$.results[0].commandType</code></p><p><code>CommandState</code>: <code>$.results[0].commandState</code></p></td><td></td></tr></tbody></table>

## アクション: MDM `DEVICE_LOCK` コマンドを送信する <a href="#chatgptconnectorthinklet-connector-chatgpt" id="chatgptconnectorthinklet-connector-chatgpt"></a>

MDMを通じてデバイスをロックし、カスタムメッセージと連絡先情報を表示します。 [作成とキューイングのためのコマンドを送信する](https://developer.jamf.com/jamf-pro/reference/post_v2-mdm-commands)を参照して、詳細をご覧ください。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-bf9f7314405f926568e748ad1cea07c0bbb8d102%2Fimage%20(332).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**パラメータ:**

* **コンピュータ管理ID** (`ComputerManagementId`)
* **PIN** (`PIN`) – ロック画面のPIN。
* **メッセージ** (`Message`) – ロックされた画面に表示されるカスタムメッセージ。
* **電話番号** (`PhoneNumber`) – ロック解除のための連絡先を表示します。

**出力:**

* **コマンド ID** (`CommandId`)

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

<table><thead><tr><th width="226">フィールド</th><th>Valeur</th><th data-hidden></th></tr></thead><tbody><tr><td>リソースパス</td><td><code>api/v2/mdm/commands</code></td><td></td></tr><tr><td>方法</td><td>POST</td><td></td></tr><tr><td>ペイロード</td><td><code>{</code><br><code>"clientData": [{"managementId": "{{ComputerManagementId}}"}],</code><br><code>"commandData": {"commandType": "DEVICE_LOCK", "pin": "{{PIN}}", "message": "{{Message}}", "phoneNumber": "{{PhoneNumber}}"}</code><br><code>}</code></td><td></td></tr><tr><td>出力</td><td><code>CommandId</code>: <code>$[0].id</code></td><td></td></tr></tbody></table>

## アクション: MDM `DECLARATIVE_MANAGEMENT` コマンドを送信する <a href="#chatgptconnectorthinklet-connector-chatgpt" id="chatgptconnectorthinklet-connector-chatgpt"></a>

管理デバイスへ宣言的管理コマンドを送信します。 [作成とキューイングのためのコマンドを送信する](https://developer.jamf.com/jamf-pro/reference/post_v2-mdm-commands)を参照して、詳細をご覧ください。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-a110e3373adede5fcc9d93918f0c3ca9947d8883%2Fimage%20(323).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**パラメータ:**

* **コンピュータ管理ID** (`ComputerManagementId`)

**出力:**

* **コマンド ID** (`CommandId`)

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

<table><thead><tr><th width="226">フィールド</th><th>Valeur</th><th data-hidden></th></tr></thead><tbody><tr><td>リソースパス</td><td><code>api/v2/mdm/commands</code></td><td></td></tr><tr><td>方法</td><td>POST</td><td></td></tr><tr><td>ペイロード</td><td><code>{</code><br><code>"clientData": [{"managementId": "{{ComputerManagementId}}"}],</code><br><code>"commandData": {"commandType": "DECLARATIVE_MANAGEMENT"}</code><br><code>}</code></td><td></td></tr><tr><td>出力</td><td><code>CommandId</code>: <code>$[0].id</code></td><td></td></tr></tbody></table>

コネクタ thinklets の詳細については、[コネクタ thinklets の設定](https://docs.nexthink.com/platform/ja/user-guide/workflows/creating-workflows/configuring-connector-thinklet) ドキュメントを参照してください。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexthink.com/platform/ja/user-guide/workflows/creating-workflows/configuring-connector-thinklet/jamf-pro-connector-thinklet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
