Jamf Pro コネクタ Thinklet

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

Jamf Pro コネクタは Jamf Pro とのシームレスな統合を可能にし、管理者がワークフロー内でデバイス管理操作を実行できるようにします。 このコネクタは Jamf ProのAPI と連携し、在庫データの取得、プロファイルの更新、コマンドの送信などのさまざまなアクションを提供します。

アクション: MDM SETTINGS コマンドを投稿

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

SETTINGSコマンドは、デバイスの構成設定を更新またはリフレッシュするために使用され、組織のポリシーに準拠していることを確認します。 詳細については、MDM エンドポイントのドキュメントを参照してください。

パラメータ:

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

出力:

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

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

フィールド	Valeur
リソースパス	api/v2/mdm/commands
方法	POST
ペイロード	{ "clientData": [ { "managementId": "{{ComputerManagementId}}" } ], "commandData": { "commandType": "SETTINGS" } }
出力	CommandId: $[0].id

アクション: コンピュータの在庫一般データを取得

MDM ステータス、監督状態、および MDM プロファイルの有効期限を含む、コンピュータの一般的な在庫詳細を取得します。 詳細についてはコンピュータの一般セクションを返すを参照してください。

パラメータ:

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

出力:

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

• UDID (UDID) - Apple デバイスの UDID（ユニークデバイス識別子）

• 名前 (Name) – コンピュータ名。

• MDM 可能? (MDMCapable) – デバイスが MDM をサポートしているかどうかを示します。

• 監視中? (Supervised) – デバイスが監視下にあるかどうかを示します。

• レポートの日付 (ReportDate) – 最後のインベントリレポートの日付。

• MDM プロファイルの有効期限 (mdmProfileExpiration) – MDM プロファイルの有効期限。

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

フィールド	Valeur
リソースパス	api/v1/computers-inventory/{{ComputerId}}?section=GENERAL
方法	GET
出力	ComputerManagementId: $.general.managementId UDID:$.udid Name: $.general.name MDMCapable: $.general.mdmCapable.capable Supervised: $.general.supervised ReportDate: $.general.reportDate mdmProfileExpiration:$.general.mdmProfileExpiration

アクション: コンピュータのインベントリ購入データを取得する

購入注文日、保証の有効期限、予想寿命を含むコンピュータの購入関連のインベントリデータを取得します。 コンピュータの一般的なセクションのリターンを参照して、詳細をご覧ください。

パラメータ:

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

出力:

• 購入注文日 (PODate) – 購入日。

• 保証有効期限 (WarrantyDate) – 保証の有効期限。

• 寿命期待 (LifeExpectancy) – 予想運用寿命。

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

フィールド	Valeur
リソースパス	api/v1/computers-inventory/{{ComputerId}}?section=PURCHASING
方法	GET
出力	PODate: $.purchasing.poDate WarrantyDate:$.purchasing.warrantyDate LifeExpectancy:$.purchasing.lifeExpectancy

アクション: MDM プロファイルを更新する

Jamf Pro 管理ポリシーに準拠していることを確認するために、コンピュータの MDM プロファイルの更新を要求します。 MDM プロファイルの更新を参照して、詳細をご覧ください。

パラメータ:

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

出力:

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

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

フィールド	Valeur
リソースパス	api/v1/mdm/renew-profile
方法	POST
ペイロード	{ "udids": ["{{UDID}}"] }
出力	NotProcessedId: $.udidsNotProcessed.udids[0]

アクション: コンピュータ名でコンピュータのインベントリ一般データを取得する

コンピュータ ID の代わりにコンピュータ名を使用して一般的なインベントリデータを取得します。 コンピュータの一般的なセクションのリターンを参照して、詳細をご覧ください。

パラメータ:

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

出力:

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

• コンピュータID (ComputerId)

• UDID (UDID) - Apple デバイスの UDID（ユニークデバイス識別子）

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

フィールド	Valeur
リソースパス	api/v1/computers-inventory?section=GENERAL&page=0&page-size=100&sort=general.name%3Aasc&filter=general.name=={{ComputerName}}
方法	GET
出力	ComputerManagementId: $.results[0].general.managementId ComputerId: $.results[0].id UDID: $.results[0].udid

アクション: MDM コマンド情報を取得する

以前に実行された MDM コマンドのステータスと種類を取得します。 Jamf Pro による MDM コマンドに関する情報を取得するを参照して、詳細をご覧ください。

パラメータ:

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

出力:

• コマンドの種類 (CommandType)

• コマンドの状態 (CommandState)

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

フィールド	値
リソースパス	api/v2/mdm/commands?page=0&page-size=100&sort=dateSent%3Aasc&filter=uuid=={{CommandId}}
方法	GET
出力	CommandType: $.results[0].commandType CommandState: $.results[0].commandState

アクション: MDM DEVICE_LOCK コマンドを送信する

MDMを通じてデバイスをロックし、カスタムメッセージと連絡先情報を表示します。 作成とキューイングのためのコマンドを送信するを参照して、詳細をご覧ください。

パラメータ:

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

• PIN (PIN) – ロック画面のPIN。

• メッセージ (Message) – ロックされた画面に表示されるカスタムメッセージ。

• 電話番号 (PhoneNumber) – ロック解除のための連絡先を表示します。

出力:

• コマンド ID (CommandId)

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

フィールド	Valeur
リソースパス	api/v2/mdm/commands
方法	POST
ペイロード	{ "clientData": [{"managementId": "{{ComputerManagementId}}"}], "commandData": {"commandType": "DEVICE_LOCK","pin": "{{PIN}}","message": "{{Message}}", "phoneNumber": "{{PhoneNumber}}"} }
出力	CommandId: $[0].id

アクション: MDM DECLARATIVE_MANAGEMENT コマンドを送信する

管理デバイスへ宣言的管理コマンドを送信します。 作成とキューイングのためのコマンドを送信するを参照して、詳細をご覧ください。

パラメータ:

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

出力:

• コマンド ID (CommandId)

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

フィールド	Valeur
リソースパス	api/v2/mdm/commands
方法	POST
ペイロード	{ "clientData": [{"managementId": "{{ComputerManagementId}}"}], "commandData": {"commandType": "DECLARATIVE_MANAGEMENT"} }
出力	CommandId: $[0].id

コネクタ thinklets の詳細については、コネクタ thinklets の設定 ドキュメントを参照してください。