jamf v2
Enterprise Mobility Management (EMM) for Apple devices (Mac, iPhone, Apple TV, iPad). Can be used to control various configurations via different policies, install and uninstall applications, lock devices, smart groups searches, and more.
Endpoint · Jamf
Details
| ID | jamf v2 |
|---|---|
| Provider | Jamf |
| Category | Endpoint |
| From Version | 5.5.0 |
| Docker Image | demisto/btfl-soup:1.0.1.10120494 |
| Supported Modules | Agentix XSIAM EDR Cortex Cloud Cloud Runtime Security |
README
Enterprise Mobility Management (EMM) for Apple devices (Mac, iPhone, Apple TV, iPad). Can be used to control various configurations via different policies, install and uninstall applications, lock devices, smart groups searches, and more.
This integration was integrated and tested with version 10.28.0 of jamf v2
JAMF classic API: https://www.jamf.com/developers/apis/classic/reference/#/
JAMF Pro API: https://developer.jamf.com/jamf-pro/reference/jamf-pro-api/
Some changes have been made that might affect your existing content.
If you are upgrading from a previous version of this integration, see Breaking Changes.
Configure jamf v2 on Cortex XSOAR
- Navigate to Settings > Integrations > Servers & Services.
- Search for JAMF v2.
-
Click Add instance to create and configure a new integration instance.
Parameter Required Server URL True Username False Password False Client ID False Client Secret False Trust any certificate (not secure) False Use system proxy settings False - Click Test to validate the URLs, token, and connection.
Required Permissions
In order to run JAMF V2 commands, the user should have a set of minimum permissions on the Jamf Pro server. Changing permissions on Jamf Pro server can be done using the following steps inside the Jamf Pro management GUI:
1.Go to “Management Settings → All Settings → Jamf Pro User Accounts & Group”
2.Click on the relevant user which is going to be used inside the integration.
3.Click the “Edit” button.
4.Under the “Account” tab, set the “Privilege Set” to “Custom” (or create a new user with “Privilege Set” as “Custom” if you don’t want to change the existing user’s permissions)
5.Under the “Privileges” tab, tick the relevant checkboxes based on the detailed permissions list below.
6.Click the “Save” button.
| Combined permissions for all of the commands: |
|---|
| Jamf Pro Server Objects → Computers → Read |
| Jamf Pro Server Objects → Computers → Create |
| Jamf Pro Server Objects → Users → Read |
| Jamf Pro Server Objects → Mobile Devices → Read |
| Jamf Pro Server Objects → Mobile Devices → Create |
| Jamf Pro Server Objects → Advanced Computer Searches → Read |
| Jamf Pro Server Settings → Apple Education Support → Read |
| Jamf Pro Server Actions → Send Computer Remote Lock Command |
| Jamf Pro Server Actions → Send Computer Remote Wipe Command |
| Jamf Pro Server Actions → Send Mobile Device Lost Mode Command |
| Jamf Pro Server Actions → Send Mobile Device Remote Wipe Command |
| Jamf Pro Server Actions → View Mobile Device Lost Mode Location |
Commands
You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.
jamf-get-computers
Returns a list of all computers with their associated IDs. By default, returns the first 50 computers to the context (ID + name).
This command is a replacement for jamf-get-computers in jamf v1 integration.
Base Command
jamf-get-computers
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| limit | The maximum number of results to be returned on each page. The maximum size is 200. Default is 50. | Optional |
| page | The number of the requested page. Default is 0. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.Computer.id | Number | The computer ID. |
| JAMF.Computer.name | String | The computer name. |
| JAMF.Computer.Paging.total_results | Number | The number of computers returned in this specific search. |
| JAMF.Computer.Paging.page_size | Number | The number of computers returned on each page. |
| JAMF.Computer.Paging.current_page | Number | The number of the requested page. |
Command Example
!jamf-get-computers limit=3
Context Example
{
"JAMF": {
"Computer": [
{
"applications": null,
"attachments": null,
"certificates": null,
"configurationProfiles": null,
"contentCaching": null,
"diskEncryption": null,
"extensionAttributes": null,
"general": {
"assetTag": null,
"barcode1": null,
"barcode2": null,
"declarativeDeviceManagementEnabled": false,
"distributionPoint": null,
"enrolledViaAutomatedDeviceEnrollment": false,
"enrollmentMethod": null,
"extensionAttributes": [
{
"dataType": "STRING",
"definitionId": "1",
"description": "Number of charge cycles logged on the current battery",
"enabled": true,
"inputType": "TEXT",
"multiValue": false,
"name": "Local Password",
"options": [],
"values": []
}
],
"initialEntryDate": "2021-03-29",
"itunesStoreAccountActive": false,
"jamfBinaryVersion": null,
"lastCloudBackupDate": null,
"lastContactTime": null,
"lastEnrolledDate": null,
"lastIpAddress": null,
"lastLoggedInUsernameBinary": null,
"lastLoggedInUsernameBinaryTimestamp": null,
"lastLoggedInUsernameSelfService": null,
"lastLoggedInUsernameSelfServiceTimestamp": null,
"lastReportedIp": null,
"lastReportedIpV4": null,
"lastReportedIpV6": null,
"managementId": "38b8002d-5033-4cf9-8645-060bfbebf61c",
"mdmCapable": {
"capable": false,
"capableUsers": [],
"userManagementInfo": []
},
"mdmProfileExpiration": null,
"name": null,
"platform": "Mac",
"remoteManagement": {
"managed": false,
"managementUsername": null
},
"reportDate": "2021-03-29T12:44:46.84Z",
"site": {
"id": "-1",
"name": "None"
},
"supervised": false,
"userApprovedMdm": false
},
"groupMemberships": null,
"hardware": null,
"ibeacons": null,
"id": "54",
"licensedSoftware": null,
"localUserAccounts": null,
"name": null,
"operatingSystem": null,
"packageReceipts": null,
"printers": null,
"purchasing": null,
"security": null,
"services": null,
"softwareUpdates": null,
"storage": null,
"udid": null,
"userAndLocation": null
},
{
...
},
{
...
},
{
"Paging": {
"current_page": 0,
"page_size": 3,
"total_results": 138
}
}
]
}
}
Human Readable Output
Paging for get computers
Current Page Page Size Total Results 0 3 138
Jamf get computers results
Computer ID Computer Name 54 70 Computer 10 64 Computer 100
jamf-get-computers-basic-subset
Returns the “basic” subset for all of the computers. The “basic” subset includes: MAC address, model, UDID, name, department, building, serial number, username, ID.
Base Command
jamf-get-computers-basic-subset
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| limit | The maximum number of results to be returned on each page. The maximum size is 200. Default is 50. | Optional |
| page | The number of the requested page. Default is 0. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.Computer.id | Number | The computer ID. |
| JAMF.Computer.name | String | The computer name. |
| JAMF.Computer.managed | Boolean | Whether the computer is managed. |
| JAMF.Computer.username | String | The computer username. |
| JAMF.Computer.model | String | The computer model. |
| JAMF.Computer.mac_address | String | The computer MAC address. |
| JAMF.Computer.udid | String | The computer UDID. |
| JAMF.Computer.serial_number | String | The computer serial number. |
Command Example
!jamf-get-computers-basic-subset limit=3
Context Example
{
"JAMF": {
"Computer": [
{
"applications": null,
"attachments": null,
"building": null,
"certificates": null,
"configurationProfiles": null,
"contentCaching": null,
"department": null,
"diskEncryption": null,
"extensionAttributes": null,
"general": {
"assetTag": null,
"barcode1": null,
"barcode2": null,
"declarativeDeviceManagementEnabled": false,
"distributionPoint": null,
"enrolledViaAutomatedDeviceEnrollment": false,
"enrollmentMethod": null,
"extensionAttributes": [
{
"dataType": "STRING",
"definitionId": "1",
"description": "Number of charge cycles logged on the current battery",
"enabled": true,
"inputType": "TEXT",
"multiValue": false,
"name": "Local Password",
"options": [],
"values": []
}
],
"initialEntryDate": "2021-03-29",
"itunesStoreAccountActive": false,
"jamfBinaryVersion": null,
"lastCloudBackupDate": null,
"lastContactTime": null,
"lastEnrolledDate": null,
"lastIpAddress": null,
"lastLoggedInUsernameBinary": null,
"lastLoggedInUsernameBinaryTimestamp": null,
"lastLoggedInUsernameSelfService": null,
"lastLoggedInUsernameSelfServiceTimestamp": null,
"lastReportedIp": null,
"lastReportedIpV4": null,
"lastReportedIpV6": null,
"managementId": "38b8002d-5033-4cf9-8645-060bfbebf61c",
"mdmCapable": {
"capable": false,
"capableUsers": [],
"userManagementInfo": []
},
"mdmProfileExpiration": null,
"name": null,
"platform": "Mac",
"remoteManagement": {
"managed": false,
"managementUsername": null
},
"reportDate": "2021-03-29T12:44:46.84Z",
"site": {
"id": "-1",
"name": "None"
},
"supervised": false,
"userApprovedMdm": false
},
"groupMemberships": null,
"hardware": {
"altMacAddress": null,
"altNetworkAdapterType": null,
"appleSilicon": false,
"batteryCapacityPercent": 0,
"batteryHealth": "UNKNOWN",
"bleCapable": false,
"bootRom": null,
"busSpeedMhz": -1,
"cacheSizeKilobytes": 0,
"coreCount": -1,
"extensionAttributes": [],
"macAddress": null,
"make": null,
"model": null,
"modelIdentifier": null,
"networkAdapterType": null,
"nicSpeed": null,
"openRamSlots": 0,
"opticalDrive": null,
"processorArchitecture": null,
"processorCount": -1,
"processorSpeedMhz": -1,
"processorType": null,
"provisioningUdid": null,
"serialNumber": null,
"smcVersion": null,
"supportsIosAppInstalls": false,
"totalRamMegabytes": -1
},
"ibeacons": null,
"id": "54",
"licensedSoftware": null,
"localUserAccounts": null,
"mac_address": null,
"managed": false,
"model": null,
"name": null,
"operatingSystem": null,
"packageReceipts": null,
"printers": null,
"purchasing": null,
"security": null,
"serial_number": null,
"services": null,
"softwareUpdates": null,
"storage": null,
"udid": null,
"userAndLocation": {
"buildingId": null,
"departmentId": null,
"email": null,
"extensionAttributes": [],
"phone": null,
"position": null,
"realname": null,
"room": null,
"username": null
},
"username": null
},
{
...
},
{
...
},
{
"Paging": {
"current_page": 0,
"page_size": 3,
"total_results": 138
}
}
]
}
}
Human Readable Output
Paging for get computers basic subset
Current Page Page Size Total Results 0 3 138
Jamf get computers basic subset results
ID Mac Address Name Serial Number UDID Username 54 70 3C:15:C2:DC:7D:1C Computer 10 CA40FA3860A3 CA40FA2E-60A3-11E4-90B8-12DF261F2C7E user50 64 Computer 100 C02Q8KHTGFWF
jamf-get-computer-by-id
Returns the “general” subset of a specific computer, e.g.: name, MAC address, IP, serial number, UDID, etc.
Base Command
jamf-get-computer-by-id
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| id | The computer ID. To get the computer ID, run the jamf-get-computers command to get all computers names and IDs. |
Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.Computer.id | Number | The computer ID. |
| JAMF.Computer.name | String | The computer name. |
| JAMF.Computer.network_adapter_type | String | The computer network adapter type. |
| JAMF.Computer.mac_address | Date | The computer MAC address. |
| JAMF.Computer.alt_network_adapter_type | String | The computer alt network adapter type. |
| JAMF.Computer.alt_mac_address | String | The computer alt MAC address. |
| JAMF.Computer.ip_address | String | The computer IP address. |
| JAMF.Computer.last_reported_ip | String | The computer last reported IP address. |
| JAMF.Computer.serial_number | String | The computer serial number. |
| JAMF.Computer.udid | String | The computer UDID. |
| JAMF.Computer.jamf_version | String | The computer Jamf version. |
| JAMF.Computer.platform | String | The computer platform. |
| JAMF.Computer.barcode_1 | String | The computer barcode_1. |
| JAMF.Computer.barcode_2 | String | The computer barcode_2. |
| JAMF.Computer.asset_tag | String | The computer asset tag. |
| JAMF.Computer.remote_management.managed | Boolean | Whether the computer is remotely managed. |
| JAMF.Computer.remote_management.management_username | String | The computer remote management username. |
| JAMF.Computer.supervised | Boolean | Whether the computer is supervised. |
| JAMF.Computer.mdm_capable | Boolean | Whether the computer is enabled for mobile device management (MDM). |
| JAMF.Computer.mdm_capable_users | Boolean | The computer has MDM capable users. |
| JAMF.Computer.distribution_point | String | The computer distribution point. |
| JAMF.Computer.site.id | Number | The computer site ID. |
| JAMF.Computer.site.name | String | The computer site name. |
| JAMF.Computer.itunes_store_account_is_active | Boolean | The computer iTunes store account. |
Command Example
!jamf-get-computer-by-id id=1
Context Example
{
"JAMF": {
"Computer": {
"alt_mac_address": "B0:34:95:EC:97:C4",
"alt_network_adapter_type": null,
"applications": [
{
"bundleId": null,
"cfBundleShortVersionString": null,
"cfBundleVersion": null,
"externalVersionId": "0",
"macAppStore": false,
"name": "Stickies.app",
"path": "/Applications/Stickies.app",
"sizeMegabytes": 0,
"updateAvailable": false,
"version": "10.0"
}
],
"asset_tag": null,
"attachments": [],
"barcode_1": null,
"barcode_2": null,
"certificates": [],
"configurationProfiles": [],
"contentCaching": null,
"diskEncryption": {
"bootPartitionEncryptionDetails": {
"partitionFileVault2Percent": 100,
"partitionFileVault2State": "ENCRYPTED",
"partitionName": "Macintosh HD (Boot Partition)"
},
"diskEncryptionConfigurationName": null,
"fileVault2EligibilityMessage": null,
"fileVault2Enabled": false,
"fileVault2EnabledUserNames": [],
"individualRecoveryKeyValidityStatus": "UNKNOWN",
"institutionalRecoveryKeyPresent": false
},
"distribution_point": null,
"extensionAttributes": [
{
"dataType": "STRING",
"definitionId": "6",
"description": "This is a test by tomer",
"enabled": true,
"inputType": "TEXT",
"multiValue": false,
"name": "Tomer test",
"options": [],
"values": []
}
],
"general": {
"assetTag": null,
"barcode1": null,
"barcode2": null,
"declarativeDeviceManagementEnabled": false,
"distributionPoint": null,
"enrolledViaAutomatedDeviceEnrollment": false,
"enrollmentMethod": null,
"extensionAttributes": [
{
"dataType": "STRING",
"definitionId": "1",
"description": "Number of charge cycles logged on the current battery",
"enabled": true,
"inputType": "TEXT",
"multiValue": false,
"name": "Local Password",
"options": [],
"values": []
}
],
"initialEntryDate": "2021-03-29",
"itunesStoreAccountActive": false,
"jamfBinaryVersion": "9.6.29507.c",
"lastCloudBackupDate": null,
"lastContactTime": "2014-10-24T10:26:55.335Z",
"lastEnrolledDate": "2014-10-24T10:25:39.607Z",
"lastIpAddress": "123.123.123.123",
"lastLoggedInUsernameBinary": null,
"lastLoggedInUsernameBinaryTimestamp": null,
"lastLoggedInUsernameSelfService": null,
"lastLoggedInUsernameSelfServiceTimestamp": null,
"lastReportedIp": "123.123.123.123",
"lastReportedIpV4": "123.123.123.123",
"lastReportedIpV6": null,
"managementId": "45145f18-0762-4994-b7d8-467f02f5ee5a",
"mdmCapable": {
"capable": false,
"capableUsers": [],
"userManagementInfo": []
},
"mdmProfileExpiration": null,
"name": "Computer 95",
"platform": "Mac",
"remoteManagement": {
"managed": false,
"managementUsername": null
},
"reportDate": "2021-03-29T12:44:12.595Z",
"site": {
"id": "-1",
"name": "None"
},
"supervised": false,
"userApprovedMdm": false
},
"groupMemberships": [],
"hardware": {
"altMacAddress": "B0:34:95:EC:97:C4",
"altNetworkAdapterType": null,
"appleSilicon": false,
"batteryCapacityPercent": 90,
"batteryHealth": "UNKNOWN",
"bleCapable": true,
"bootRom": "MBP91.00D3.B09",
"busSpeedMhz": 0,
"cacheSizeKilobytes": 3072,
"coreCount": -1,
"extensionAttributes": [],
"macAddress": "68:5B:35:CA:12:56",
"make": "Apple",
"model": "13-inch MacBook Pro (Mid 2012)",
"modelIdentifier": "MacBookPro9,2",
"networkAdapterType": null,
"nicSpeed": "n/a",
"openRamSlots": 0,
"opticalDrive": "MATSHITA DVD-R UJ-8A8",
"processorArchitecture": "i386",
"processorCount": 2,
"processorSpeedMhz": 2500,
"processorType": "Intel Core i5",
"provisioningUdid": null,
"serialNumber": "CA40F81C60A3",
"smcVersion": "2.2f44",
"supportsIosAppInstalls": false,
"totalRamMegabytes": 4096
},
"ibeacons": [],
"id": "1",
"ip_address": "123.123.123.123",
"itunes_store_account_is_active": false,
"jamf_version": "9.6.29507.c",
"last_reported_ip": "123.123.123.123",
"licensedSoftware": [],
"localUserAccounts": [],
"mac_address": "68:5B:35:CA:12:56",
"mdm_capable": false,
"mdm_capable_users": [],
"name": "Computer 95",
"network_adapter_type": null,
"operatingSystem": {
"activeDirectoryStatus": "Not Bound",
"build": "14A389",
"extensionAttributes": [],
"fileVault2Status": "ALL_ENCRYPTED",
"name": "Mac OS X",
"rapidSecurityResponse": null,
"softwareUpdateDeviceId": null,
"supplementalBuildVersion": null,
"version": "10.10.0"
},
"packageReceipts": {
"cached": [],
"installedByInstallerSwu": [],
"installedByJamfPro": []
},
"platform": "Mac",
"printers": [],
"purchasing": {
"appleCareId": null,
"extensionAttributes": [],
"leaseDate": null,
"leased": false,
"lifeExpectancy": 0,
"poDate": null,
"poNumber": null,
"purchasePrice": null,
"purchased": true,
"purchasingAccount": null,
"purchasingContact": null,
"vendor": null,
"warrantyDate": null
},
"remote_management": {
"managed": false,
"management_username": null
},
"security": {
"activationLockEnabled": null,
"attestationStatus": "PENDING",
"autoLoginDisabled": true,
"bootstrapTokenAllowed": null,
"bootstrapTokenEscrowedStatus": "NOT_SUPPORTED",
"externalBootLevel": null,
"firewallEnabled": false,
"gatekeeperStatus": "NOT_COLLECTED",
"lastAttestationAttempt": null,
"lastSuccessfulAttestation": null,
"recoveryLockEnabled": false,
"remoteDesktopEnabled": null,
"secureBootLevel": null,
"sipStatus": "NOT_COLLECTED",
"xprotectVersion": null
},
"serial_number": "CA40F81C60A3",
"services": [],
"site": {
"id": "-1",
"name": "None"
},
"softwareUpdates": [],
"storage": {
"bootDriveAvailableSpaceMegabytes": 1,
"disks": [
{
"device": "disk0",
"id": "2",
"model": "APPLE HDD HTS545050A7E362",
"partitions": [
{
"availableMegabytes": 1,
"fileVault2ProgressPercent": 100,
"fileVault2State": "ENCRYPTED",
"lvmManaged": false,
"name": "Macintosh HD (Boot Partition)",
"partitionType": "BOOT",
"percentUsed": 5,
"sizeMegabytes": 237851
}
],
"revision": "GG2AB990",
"serialNumber": "TNS5193T0BTYVH",
"sizeMegabytes": 512113,
"smartStatus": "Verified",
"type": "NO"
}
]
},
"supervised": false,
"udid": "CA40F812-60A3-11E4-90B8-12DF261F2C7E",
"userAndLocation": {
"buildingId": null,
"departmentId": null,
"email": "User91@email.com",
"extensionAttributes": [],
"phone": "612-605-6625",
"position": null,
"realname": "User 91",
"room": "100 Walker Street\t \r\nLevel 14, Suite 3",
"username": "user91"
}
}
}
}
Human Readable Output
Jamf get computers result for computer ID: 1
Jamf Version Last IP Address MAC Address Name Platform Serial Number 9.6.29507.c 123.123.123.123 68:5B:35:CA:12:56 Computer 95 Mac CA40F81C60A3
jamf-get-computer-by-match
Matches computers by specific characteristics using a filter query and returns general data on each of the computers.
Base Command
jamf-get-computer-by-match
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| limit | The maximum number of results to be returned on each page. The maximum size is 200. Default is 50. | Optional |
| page | The number of the requested page. Default is 0. | Optional |
| filter | Filter query for the Pro API (supports RSQL). e.g.: general.name==”Computer 1*”, userAndLocation.email==”user@email.com”. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.Computer.id | Number | The computer ID. |
| JAMF.Computer.name | String | The computer name. |
| JAMF.Computer.udid | String | The computer UDID. |
| JAMF.Computer.serial_number | String | The computer serial number. |
| JAMF.Computer.mac_address | String | The computer MAC address. |
| JAMF.Computer.alt_mac_address | String | The computer alt MAC address. |
| JAMF.Computer.asset_tag | String | The computer asset tag. |
| JAMF.Computer.barcode_1 | String | The computer barcode 1. |
| JAMF.Computer.barcode_2 | String | The computer barcode 2. |
| JAMF.Computer.username | String | The computer username. |
| JAMF.Computer.realname | String | The computer real name. |
| JAMF.Computer.email | String | The computer email address. |
| JAMF.Computer.email_address | String | The computer email address. |
| JAMF.Computer.room | String | The computer room. |
| JAMF.Computer.position | String | The computer position. |
| JAMF.Computer.Paging.total_results | Number | The number of computers returned in this specific search. |
| JAMF.Computer.Paging.page_size | Number | The number of computers to be returned on each page. |
| JAMF.Computer.Paging.current_page | Number | The number of the requested page. |
Command Example
!jamf-get-computer-by-match filter="general.name==\"Computer 9*\"" limit=3
Context Example
{
"JAMF": {
"Computer": [
{
"alt_mac_address": null,
"applications": null,
"asset_tag": "JS002221",
"attachments": null,
"barcode_1": null,
"barcode_2": null,
"certificates": null,
"configurationProfiles": null,
"contentCaching": null,
"diskEncryption": null,
"email": "User81@email.com",
"email_address": "User81@email.com",
"extensionAttributes": null,
"general": {
"assetTag": "JS002221",
"barcode1": null,
"barcode2": null,
"declarativeDeviceManagementEnabled": false,
"distributionPoint": null,
"enrolledViaAutomatedDeviceEnrollment": false,
"enrollmentMethod": null,
"extensionAttributes": [
{
"dataType": "STRING",
"definitionId": "1",
"description": "Number of charge cycles logged on the current battery",
"enabled": true,
"inputType": "TEXT",
"multiValue": false,
"name": "Local Password",
"options": [],
"values": []
}
],
"initialEntryDate": "2021-03-29",
"itunesStoreAccountActive": true,
"jamfBinaryVersion": "9.6.29507.c",
"lastCloudBackupDate": null,
"lastContactTime": "2014-10-30T03:54:44.22Z",
"lastEnrolledDate": "2014-08-19T20:20:45.206Z",
"lastIpAddress": "123.123.123.123",
"lastLoggedInUsernameBinary": null,
"lastLoggedInUsernameBinaryTimestamp": null,
"lastLoggedInUsernameSelfService": null,
"lastLoggedInUsernameSelfServiceTimestamp": null,
"lastReportedIp": "123.123.123.123",
"lastReportedIpV4": "123.123.123.123",
"lastReportedIpV6": null,
"managementId": "5c9435d2-6774-4bca-9d0f-2d6c3b58fbc6",
"mdmCapable": {
"capable": false,
"capableUsers": [],
"userManagementInfo": []
},
"mdmProfileExpiration": null,
"name": "Computer 9",
"platform": "Mac",
"remoteManagement": {
"managed": false,
"managementUsername": null
},
"reportDate": "2021-03-29T12:44:45.288Z",
"site": {
"id": "-1",
"name": "None"
},
"supervised": false,
"userApprovedMdm": false
},
"groupMemberships": null,
"hardware": {
"altMacAddress": "72:00:04:22:5F:10",
"altNetworkAdapterType": null,
"appleSilicon": false,
"batteryCapacityPercent": 97,
"batteryHealth": "UNKNOWN",
"bleCapable": true,
"bootRom": "MBP111.0138.B07",
"busSpeedMhz": 0,
"cacheSizeKilobytes": 3072,
"coreCount": -1,
"extensionAttributes": [],
"macAddress": "3C:15:C2:DC:7D:22",
"make": "Apple",
"model": "13-inch Retina MacBook Pro (Late 2013)",
"modelIdentifier": "MacBookPro11,1",
"networkAdapterType": null,
"nicSpeed": "n/a",
"openRamSlots": 0,
"opticalDrive": null,
"processorArchitecture": "i386",
"processorCount": 2,
"processorSpeedMhz": 2600,
"processorType": "Intel Core i5",
"provisioningUdid": null,
"serialNumber": "CA41077660A3",
"smcVersion": "2.16f63",
"supportsIosAppInstalls": false,
"totalRamMegabytes": 16384
},
"ibeacons": null,
"id": "49",
"licensedSoftware": null,
"localUserAccounts": null,
"mac_address": null,
"name": "Computer 9",
"operatingSystem": null,
"packageReceipts": null,
"position": null,
"printers": null,
"purchasing": null,
"realname": "User 81",
"room": "1011 Washington Avenue S\r\nSuite 350",
"security": null,
"serial_number": null,
"services": null,
"softwareUpdates": null,
"storage": null,
"udid": "CA41076C-60A3-11E4-90B8-12DF261F2C7E",
"userAndLocation": {
"buildingId": null,
"departmentId": null,
"email": "User81@email.com",
"extensionAttributes": [],
"phone": "612-605-6625",
"position": null,
"realname": "User 81",
"room": "1011 Washington Avenue S\r\nSuite 350",
"username": "user81"
},
"username": "user81"
},
{
...
},
{
...
},
{
"Paging": {
"current_page": 0,
"page_size": 3,
"total_results": 10
}
}
]
}
}
Human Readable Output
Paging for get computer by match
Current Page Page Size Total Results 0 3 10
Jamf get computer by match results
ID MAC Address Name Serial Number UDID Username 49 3C:15:C2:DC:7D:22 Computer 9 CA41077660A3 CA41076C-60A3-11E4-90B8-12DF261F2C7E user81 99 48:D7:05:B3:B9:7B Computer 90 CA41043860A3 CA41042E-60A3-11E4-90B8-12DF261F2C7E user30 127 80:E6:50:09:B8:B6 Computer 91 CA40F6C860A3 CA40F6B4-60A3-11E4-90B8-12DF261F2C7E user56
jamf-get-computer-general-subset
Returns the general subset for a specific computer according to the given arguments.
Base Command
jamf-get-computer-general-subset
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerSubset.Computer.general.id | Number | The computer ID. |
| JAMF.ComputerSubset.Computer.general.name | String | The computer name. |
| JAMF.ComputerSubset.Computer.general.network_adapter_type | String | The computer network adapter type. |
| JAMF.ComputerSubset.Computer.general.mac_address | Date | The computer MAC address. |
| JAMF.ComputerSubset.Computer.general.alt_network_adapter_type | String | The computer alt network adapter type. |
| JAMF.ComputerSubset.Computer.general.alt_mac_address | String | The computer alt MAC address. |
| JAMF.ComputerSubset.Computer.general.ip_address | String | The computer IP address. |
| JAMF.ComputerSubset.Computer.general.last_reported_ip | String | The computer last reported IP address. |
| JAMF.ComputerSubset.Computer.general.serial_number | String | The computer serial number. |
| JAMF.ComputerSubset.Computer.general.udid | String | The computer UDID. |
| JAMF.ComputerSubset.Computer.general.jamf_version | String | The computer Jamf version. |
| JAMF.ComputerSubset.Computer.general.platform | String | The computer platform. |
| JAMF.ComputerSubset.Computer.general.barcode_1 | String | The computer barcode 1. |
| JAMF.ComputerSubset.Computer.general.barcode_2 | String | The computer barcode 2. |
| JAMF.ComputerSubset.Computer.general.asset_tag | String | The computer asset tag. |
| JAMF.ComputerSubset.Computer.general.remote_management.managed | Boolean | Whether the computer is remotely managed. |
| JAMF.ComputerSubset.Computer.general.remote_management.management_username | String | The computer managment username. |
| JAMF.ComputerSubset.Computer.general.supervised | Boolean | Whether the computer is supervised. |
| JAMF.ComputerSubset.Computer.general.mdm_capable | Boolean | Whether the computer is MDM capable. |
| JAMF.ComputerSubset.Computer.general.mdm_capable_users | Boolean | Whether the computer has MDM capable users. |
| JAMF.ComputerSubset.Computer.general.management_status.user_approved_mdm | Boolean | Whether the MDM is user-approved. |
| JAMF.ComputerSubset.Computer.general.distribution_point | String | The computer distribution point format. |
| JAMF.ComputerSubset.Computer.general.site.id | Number | The computer site ID. |
| JAMF.ComputerSubset.Computer.general.site.name | String | The computer site name. |
| JAMF.ComputerSubset.Computer.general.itunes_store_account_is_active | Boolean | The computer iTunes store account. |
Command Example
!jamf-get-computer-general-subset identifier=name identifier_value="Computer 95"
Context Example
{
"JAMF": {
"ComputerSubset": {
"computer": {
"applications": null,
"attachments": null,
"certificates": null,
"configurationProfiles": null,
"contentCaching": null,
"diskEncryption": null,
"extensionAttributes": null,
"general": {
"alt_mac_address": "B0:34:95:EC:97:C4",
"alt_network_adapter_type": null,
"assetTag": null,
"asset_tag": null,
"barcode1": null,
"barcode2": null,
"barcode_1": null,
"barcode_2": null,
"declarativeDeviceManagementEnabled": false,
"distributionPoint": null,
"distribution_point": null,
"enrolledViaAutomatedDeviceEnrollment": false,
"enrollmentMethod": null,
"extensionAttributes": [
{
"dataType": "STRING",
"definitionId": "1",
"description": "Number of charge cycles logged on the current battery",
"enabled": true,
"inputType": "TEXT",
"multiValue": false,
"name": "Local Password",
"options": [],
"values": []
}
],
"id": "1",
"initialEntryDate": "2021-03-29",
"ip_address": "123.123.123.123",
"itunesStoreAccountActive": false,
"itunes_store_account_is_active": false,
"jamfBinaryVersion": "9.6.29507.c",
"jamf_version": "9.6.29507.c",
"lastCloudBackupDate": null,
"lastContactTime": "2014-10-24T10:26:55.335Z",
"lastEnrolledDate": "2014-10-24T10:25:39.607Z",
"lastIpAddress": "123.123.123.123",
"lastLoggedInUsernameBinary": null,
"lastLoggedInUsernameBinaryTimestamp": null,
"lastLoggedInUsernameSelfService": null,
"lastLoggedInUsernameSelfServiceTimestamp": null,
"lastReportedIp": "123.123.123.123",
"lastReportedIpV4": "123.123.123.123",
"lastReportedIpV6": null,
"last_reported_ip": "123.123.123.123",
"mac_address": "68:5B:35:CA:12:56",
"managementId": "45145f18-0762-4994-b7d8-467f02f5ee5a",
"management_status": {
"user_approved_mdm": false
},
"mdmCapable": {
"capable": false,
"capableUsers": [],
"userManagementInfo": []
},
"mdmProfileExpiration": null,
"mdm_capable": false,
"mdm_capable_users": [],
"name": "Computer 95",
"network_adapter_type": null,
"platform": "Mac",
"remoteManagement": {
"managed": false,
"managementUsername": null
},
"remote_management": {
"managed": false,
"management_username": null
},
"reportDate": "2021-03-29T12:44:12.595Z",
"serial_number": "CA40F81C60A3",
"site": {
"id": "-1",
"name": "None"
},
"supervised": false,
"udid": "CA40F812-60A3-11E4-90B8-12DF261F2C7E",
"userApprovedMdm": false
},
"groupMemberships": null,
"hardware": {
"altMacAddress": "B0:34:95:EC:97:C4",
"altNetworkAdapterType": null,
"appleSilicon": false,
"batteryCapacityPercent": 90,
"batteryHealth": "UNKNOWN",
"bleCapable": true,
"bootRom": "MBP91.00D3.B09",
"busSpeedMhz": 0,
"cacheSizeKilobytes": 3072,
"coreCount": -1,
"extensionAttributes": [],
"macAddress": "68:5B:35:CA:12:56",
"make": "Apple",
"model": "13-inch MacBook Pro (Mid 2012)",
"modelIdentifier": "MacBookPro9,2",
"networkAdapterType": null,
"nicSpeed": "n/a",
"openRamSlots": 0,
"opticalDrive": "MATSHITA DVD-R UJ-8A8",
"processorArchitecture": "i386",
"processorCount": 2,
"processorSpeedMhz": 2500,
"processorType": "Intel Core i5",
"provisioningUdid": null,
"serialNumber": "CA40F81C60A3",
"smcVersion": "2.2f44",
"supportsIosAppInstalls": false,
"totalRamMegabytes": 4096
},
"ibeacons": null,
"id": "1",
"licensedSoftware": null,
"localUserAccounts": null,
"operatingSystem": null,
"packageReceipts": null,
"printers": null,
"purchasing": null,
"security": null,
"services": null,
"softwareUpdates": null,
"storage": null,
"udid": "CA40F812-60A3-11E4-90B8-12DF261F2C7E",
"userAndLocation": null
}
}
}
}
Human Readable Output
Jamf computer General subset result
ID Last IP Address Managed Name Platform UDID 1 123.123.123.123 false Computer 95 Mac CA40F812-60A3-11E4-90B8-12DF261F2C7E
jamf-get-computer-location-subset
Returns the location subset for a specific computer according to the given arguments.
Base Command
jamf-get-computer-location-subset
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerSubset.Computer.location.username | String | The computer username. |
| JAMF.ComputerSubset.Computer.location.realname | String | The computer real name. |
| JAMF.ComputerSubset.Computer.location.real_name | String | The computer real name. |
| JAMF.ComputerSubset.Computer.location.email_address | String | The computer email address. |
| JAMF.ComputerSubset.Computer.location.position | String | The computer position. |
| JAMF.ComputerSubset.Computer.location.phone | String | The computer phone number. |
| JAMF.ComputerSubset.Computer.location.phone_number | String | The computer phone number. |
| JAMF.ComputerSubset.Computer.location.room | String | The computer room. |
| JAMF.ComputerSubset.Computer.id | Number | The computer ID. |
Command Example
!jamf-get-computer-location-subset identifier=name identifier_value="Computer 95"
Context Example
{
"JAMF": {
"ComputerSubset": {
"computer": {
"applications": null,
"attachments": null,
"certificates": null,
"configurationProfiles": null,
"contentCaching": null,
"diskEncryption": null,
"extensionAttributes": null,
"general": null,
"groupMemberships": null,
"hardware": null,
"ibeacons": null,
"id": "1",
"licensedSoftware": null,
"localUserAccounts": null,
"location": {
"email_address": "User91@email.com",
"phone": "612-605-6625",
"phone_number": "612-605-6625",
"position": null,
"real_name": "User 91",
"realname": "User 91",
"room": "100 Walker Street\t \r\nLevel 14, Suite 3",
"username": "user91"
},
"operatingSystem": null,
"packageReceipts": null,
"printers": null,
"purchasing": null,
"security": null,
"services": null,
"softwareUpdates": null,
"storage": null,
"udid": "CA40F812-60A3-11E4-90B8-12DF261F2C7E",
"userAndLocation": {
"buildingId": null,
"departmentId": null,
"email": "User91@email.com",
"extensionAttributes": [],
"phone": "612-605-6625",
"position": null,
"realname": "User 91",
"room": "100 Walker Street\t \r\nLevel 14, Suite 3",
"username": "user91"
}
}
}
}
}
Human Readable Output
Jamf computer Location subset result
Email Address Phone Real Name Room Username User91@email.com 612-605-6625 User 91 100 Walker Street
Level 14, Suite 3user91
jamf-get-computer-purchasing-subset
Returns the purchasing subset for a specific computer according to the given arguments.
Base Command
jamf-get-computer-purchasing-subset
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerSubset.Computer.purchasing.is_purchased | Boolean | If the computer is purchased. |
| JAMF.ComputerSubset.Computer.purchasing.is_leased | Boolean | If the computer is leased. |
| JAMF.ComputerSubset.Computer.purchasing.po_number | String | The computer PO number. |
| JAMF.ComputerSubset.Computer.purchasing.vendor | String | The computer vendor. |
| JAMF.ComputerSubset.Computer.purchasing.applecare_id | String | The computer AppleCare ID. |
| JAMF.ComputerSubset.Computer.purchasing.purchase_price | String | The computer purchase price. |
| JAMF.ComputerSubset.Computer.purchasing.purchasing_account | String | The computer purchase account. |
| JAMF.ComputerSubset.Computer.purchasing.life_expectancy | Number | The computer life expectancy. |
| JAMF.ComputerSubset.Computer.purchasing.purchasing_contact | String | The computer purchasing contact. |
| JAMF.ComputerSubset.Computer.id | Number | The computer ID. |
Command Example
Context Example
{
"JAMF": {
"ComputerSubset": {
"computer": {
"applications": null,
"attachments": null,
"certificates": null,
"configurationProfiles": null,
"contentCaching": null,
"diskEncryption": null,
"extensionAttributes": null,
"general": null,
"groupMemberships": null,
"hardware": null,
"ibeacons": null,
"id": "1",
"licensedSoftware": null,
"localUserAccounts": null,
"operatingSystem": null,
"packageReceipts": null,
"printers": null,
"purchasing": {
"appleCareId": null,
"applecare_id": null,
"extensionAttributes": [],
"is_leased": false,
"is_purchased": true,
"leaseDate": null,
"leased": false,
"lifeExpectancy": 0,
"life_expectancy": 0,
"poDate": null,
"poNumber": null,
"po_number": null,
"purchasePrice": null,
"purchase_price": null,
"purchased": true,
"purchasingAccount": null,
"purchasingContact": null,
"purchasing_account": null,
"purchasing_contact": null,
"vendor": null,
"warrantyDate": null
},
"security": null,
"services": null,
"softwareUpdates": null,
"storage": null,
"udid": "CA40F812-60A3-11E4-90B8-12DF261F2C7E",
"userAndLocation": null
}
}
}
}
Human Readable Output
Jamf computer Purchasing subset result
Is Leased Is Purchased false true
jamf-get-computer-peripherals-subset
This command is deprecated and has no replacement.
Returns the peripherals subset for a specific computer according to the given arguments.
Base Command
jamf-get-computer-peripherals-subset
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerSubset.Computer.peripherals | Number | The computer peripherals. |
| JAMF.ComputerSubset.Computer.id | Number | The computer ID. |
Command Example
!jamf-get-computer-peripherals-subset identifier=name identifier_value="Computer 95"
Context Example
{
"JAMF": {
"ComputerSubset": {
"computer": {
"id": 1,
"peripherals": []
}
}
}
}
Human Readable Output
Jamf computer Peripherals subset result
No entries.
jamf-get-computer-hardware-subset
Returns the hardware subset for a specific computer according to the given arguments.
Base Command
jamf-get-computer-hardware-subset
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerSubset.Computer.hardware.make | String | The computer maker. |
| JAMF.ComputerSubset.Computer.hardware.model | String | The computer model. |
| JAMF.ComputerSubset.Computer.hardware.model_identifier | String | The computer model ID. |
| JAMF.ComputerSubset.Computer.hardware.os_name | String | The computer operating system name. |
| JAMF.ComputerSubset.Computer.hardware.os_version | String | The computer operating system version. |
| JAMF.ComputerSubset.Computer.hardware.os_build | String | The computer operating system build. |
| JAMF.ComputerSubset.Computer.hardware.active_directory_status | String | The computer active directory status. |
| JAMF.ComputerSubset.Computer.hardware.processor_type | String | The computer processor type. |
| JAMF.ComputerSubset.Computer.hardware.processor_architecture | String | The computer processor architecture. |
| JAMF.ComputerSubset.Computer.hardware.processor_speed | Number | The computer processor speed. |
| JAMF.ComputerSubset.Computer.hardware.processor_speed_mhz | Number | The computer processor speed in MHz. |
| JAMF.ComputerSubset.Computer.hardware.number_processors | Number | The number of processors in the computer. |
| JAMF.ComputerSubset.Computer.hardware.number_cores | Number | The number of cores in the computer. |
| JAMF.ComputerSubset.Computer.hardware.total_ram | Number | The amount of RAM in the computer. |
| JAMF.ComputerSubset.Computer.hardware.total_ram_mb | Number | The amount of RAM in the computer in MB. |
| JAMF.ComputerSubset.Computer.hardware.boot_rom | String | The computer boot ROM. |
| JAMF.ComputerSubset.Computer.hardware.bus_speed | Number | The computer bus speed. |
| JAMF.ComputerSubset.Computer.hardware.bus_speed_mhz | Number | The computer bus speed in MHz. |
| JAMF.ComputerSubset.Computer.hardware.battery_capacity | Number | The computer battery capacity. |
| JAMF.ComputerSubset.Computer.hardware.cache_size | Number | The computer cache size. |
| JAMF.ComputerSubset.Computer.hardware.cache_size_kb | Number | The computer cache size in KB. |
| JAMF.ComputerSubset.Computer.hardware.available_ram_slots | Number | The number of available RAM slots. |
| JAMF.ComputerSubset.Computer.hardware.optical_drive | String | The computer optical drive. |
| JAMF.ComputerSubset.Computer.hardware.nic_speed | String | The computer NIC speed. |
| JAMF.ComputerSubset.Computer.hardware.smc_version | String | The compute SMC version. |
| JAMF.ComputerSubset.Computer.hardware.ble_capable | Boolean | Whether the computer is BLE capable. |
| JAMF.ComputerSubset.Computer.hardware.supports_ios_app_installs | Boolean | If the computer supports iOS app installations. |
| JAMF.ComputerSubset.Computer.hardware.sip_status | String | The computer SIP status. |
| JAMF.ComputerSubset.Computer.hardware.gatekeeper_status | String | The computer gatekeeper status. |
| JAMF.ComputerSubset.Computer.hardware.xprotect_version | String | The computer xprotect version. |
| JAMF.ComputerSubset.Computer.hardware.disk_encryption_configuration | String | The computer disk encryption configuration. |
| JAMF.ComputerSubset.Computer.id | Number | The computer ID. |
Command Example
!jamf-get-computer-hardware-subset identifier=id identifier_value="138"
Context Example
{
"JAMF": {
"ComputerSubset": {
"computer": {
"applications": null,
"attachments": null,
"certificates": null,
"configurationProfiles": null,
"contentCaching": null,
"diskEncryption": {
"bootPartitionEncryptionDetails": {
"partitionFileVault2Percent": 0,
"partitionFileVault2State": "UNENCRYPTED",
"partitionName": "HD (Boot Partition)"
},
"diskEncryptionConfigurationName": null,
"fileVault2EligibilityMessage": "Eligible",
"fileVault2Enabled": false,
"fileVault2EnabledUserNames": [
"itadmin",
"test",
"user"
],
"individualRecoveryKeyValidityStatus": "UNKNOWN",
"institutionalRecoveryKeyPresent": false
},
"extensionAttributes": null,
"general": null,
"groupMemberships": null,
"hardware": {
"active_directory_status": "Not Bound",
"altMacAddress": "82:9C:53:E4:20:01",
"altNetworkAdapterType": "Ethernet",
"appleSilicon": false,
"available_ram_slots": 0,
"batteryCapacityPercent": 83,
"batteryHealth": "UNKNOWN",
"battery_capacity": 83,
"bleCapable": true,
"ble_capable": true,
"bootRom": "1554.80.3.0.0 (iBridge: 18.16.14347.0.0,0)",
"boot_rom": "1554.80.3.0.0 (iBridge: 18.16.14347.0.0,0)",
"busSpeedMhz": 0,
"bus_speed": 0,
"bus_speed_mhz": 0,
"cacheSizeKilobytes": 8192,
"cache_size": 8192,
"cache_size_kb": 8192,
"coreCount": 4,
"disk_encryption_configuration": null,
"extensionAttributes": [],
"gatekeeper_status": "APP_STORE_AND_IDENTIFIED_DEVELOPERS",
"macAddress": "F0:18:98:3F:DB:8E",
"make": "Apple",
"model": "MacBook Pro (13-inch, 2018)",
"modelIdentifier": "MacBookPro15,2",
"model_identifier": "MacBookPro15,2",
"networkAdapterType": "IEEE80211",
"nicSpeed": "10/100",
"nic_speed": "10/100",
"number_cores": 4,
"number_processors": 1,
"openRamSlots": 0,
"opticalDrive": null,
"optical_drive": null,
"os_build": "20D91",
"os_name": "macOS",
"os_version": "11.2.3",
"processorArchitecture": "x86_64",
"processorCount": 1,
"processorSpeedMhz": 2700,
"processorType": "Quad-Core Intel Core i7",
"processor_architecture": "x86_64",
"processor_speed": 2700,
"processor_speed_mhz": 2700,
"processor_type": "Quad-Core Intel Core i7",
"provisioningUdid": null,
"serialNumber": "C02X94LZJHD3",
"sip_status": "ENABLED",
"smcVersion": null,
"smc_version": null,
"storage": {
"bootDriveAvailableSpaceMegabytes": 480067,
"disks": [
{
"device": "disk0",
"id": "395",
"model": "APPLE SSD AP0512M",
"partitions": [
{
"availableMegabytes": 480067,
"fileVault2ProgressPercent": 0,
"fileVault2State": "UNENCRYPTED",
"lvmManaged": false,
"name": "VM",
"partitionType": "OTHER",
"percentUsed": 1,
"sizeMegabytes": 499963
}
],
"revision": "1161.80.",
"serialNumber": "C02834600HKJN1N15",
"sizeMegabytes": 500277,
"smartStatus": "Verified",
"type": "NO"
}
]
},
"supportsIosAppInstalls": false,
"supports_ios_app_installs": false,
"totalRamMegabytes": 16384,
"total_ram": 16384,
"total_ram_mb": 16384,
"xprotect_version": "2144"
},
"ibeacons": null,
"id": "138",
"licensedSoftware": null,
"localUserAccounts": null,
"operatingSystem": {
"activeDirectoryStatus": "Not Bound",
"build": "20D91",
"extensionAttributes": [],
"fileVault2Status": "NOT_ENCRYPTED",
"name": "macOS",
"rapidSecurityResponse": null,
"softwareUpdateDeviceId": null,
"supplementalBuildVersion": null,
"version": "11.2.3"
},
"packageReceipts": null,
"printers": null,
"purchasing": null,
"security": {
"activationLockEnabled": false,
"attestationStatus": "PENDING",
"autoLoginDisabled": true,
"bootstrapTokenAllowed": true,
"bootstrapTokenEscrowedStatus": "ESCROWED",
"externalBootLevel": "DISALLOW_BOOTING_FROM_EXTERNAL_MEDIA",
"firewallEnabled": false,
"gatekeeperStatus": "APP_STORE_AND_IDENTIFIED_DEVELOPERS",
"lastAttestationAttempt": null,
"lastSuccessfulAttestation": null,
"recoveryLockEnabled": false,
"remoteDesktopEnabled": false,
"secureBootLevel": "FULL_SECURITY",
"sipStatus": "ENABLED",
"xprotectVersion": "2144"
},
"services": null,
"softwareUpdates": null,
"storage": {
"bootDriveAvailableSpaceMegabytes": 480067,
"disks": [
{
"device": "disk0",
"id": "395",
"model": "APPLE SSD AP0512M",
"partitions": [
{
"availableMegabytes": 480067,
"fileVault2ProgressPercent": 0,
"fileVault2State": "UNENCRYPTED",
"lvmManaged": false,
"name": "VM",
"partitionType": "OTHER",
"percentUsed": 1,
"sizeMegabytes": 499963
}
],
"revision": "1161.80.",
"serialNumber": "C02834600HKJN1N15",
"sizeMegabytes": 500277,
"smartStatus": "Verified",
"type": "NO"
}
]
},
"udid": "67EAC1E5-43E7-57BE-BAD7-06922C177BDC",
"userAndLocation": null
}
}
}
}
Human Readable Output
Jamf computer Hardware subset result
Core Count Hardware Make Hardware Model Model Identifier Processor Architecture Processor Count Processor Speed Mhz Processor Type Serial Number Storage 4 Apple MacBook Pro (13-inch, 2018) MacBookPro15,2 x86_64 1 2700 Quad-Core Intel Core i7 C02X94LZJHD3 bootDriveAvailableSpaceMegabytes: 480067
disks: {‘id’: ‘395’, ‘device’: ‘disk0’, ‘model’: ‘APPLE SSD AP0512M’, ‘revision’: ‘1161.80.’, ‘serialNumber’: ‘C02834600HKJN1N15’, ‘sizeMegabytes’: 500277, ‘smartStatus’: ‘Verified’, ‘type’: ‘NO’, ‘partitions’: [{‘name’: ‘VM’, ‘sizeMegabytes’: 499963, ‘availableMegabytes’: 480067, ‘partitionType’: ‘OTHER’, ‘percentUsed’: 1, ‘fileVault2State’: ‘UNENCRYPTED’, ‘fileVault2ProgressPercent’: 0, ‘lvmManaged’: False}, {‘name’: ‘Data’, ‘sizeMegabytes’: 499963, ‘availableMegabytes’: 480067, ‘partitionType’: ‘OTHER’, ‘percentUsed’: 1, ‘fileVault2State’: ‘UNENCRYPTED’, ‘fileVault2ProgressPercent’: 0, ‘lvmManaged’: False}, {‘name’: ‘Preboot’, ‘sizeMegabytes’: 499963, ‘availableMegabytes’: 480067, ‘partitionType’: ‘OTHER’, ‘percentUsed’: 1, ‘fileVault2State’: ‘UNENCRYPTED’, ‘fileVault2ProgressPercent’: 0, ‘lvmManaged’: False}, {‘name’: ‘HD - Data’, ‘sizeMegabytes’: 499963, ‘availableMegabytes’: 480067, ‘partitionType’: ‘OTHER’, ‘percentUsed’: 1, ‘fileVault2State’: ‘UNENCRYPTED’, ‘fileVault2ProgressPercent’: 0, ‘lvmManaged’: False}, {‘name’: ‘HD (Boot Partition)’, ‘sizeMegabytes’: 499963, ‘availableMegabytes’: 480067, ‘partitionType’: ‘BOOT’, ‘percentUsed’: 4, ‘fileVault2State’: ‘UNENCRYPTED’, ‘fileVault2ProgressPercent’: 0, ‘lvmManaged’: False}, {‘name’: ‘Update’, ‘sizeMegabytes’: 499963, ‘availableMegabytes’: 480067, ‘partitionType’: ‘OTHER’, ‘percentUsed’: 1, ‘fileVault2State’: ‘UNENCRYPTED’, ‘fileVault2ProgressPercent’: 0, ‘lvmManaged’: False}]}
jamf-get-computer-certificates-subset
Returns the certificates subset for a specific computer according to the given arguments.
Base Command
jamf-get-computer-certificates-subset
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerSubset.Computer.certificates.common_name | String | The certificat common name. |
| JAMF.ComputerSubset.Computer.certificates.identity | Boolean | The certificat identity. |
| JAMF.ComputerSubset.Computer.certificates.expires_utc | Date | The certificat expiration date in UTC format. |
| JAMF.ComputerSubset.Computer.certificates.expires_epoch | Number | The certificat expiration date in epoch format. |
| JAMF.ComputerSubset.Computer.id | Number | The computer ID. |
Command Example
!jamf-get-computer-certificates-subset identifier=id identifier_value="138"
Context Example
{
"JAMF": {
"ComputerSubset": {
"computer": {
"applications": null,
"attachments": null,
"certificates": [
{
"certificateStatus": "ISSUED",
"commonName": "com.apple.systemdefault",
"common_name": "com.apple.systemdefault",
"expirationDate": "2041-04-16T12:33:10Z",
"expires_epoch": 2249728390000,
"expires_utc": "2041-04-16T12:33:10Z",
"identity": true,
"issuedDate": "2021-04-21T12:33:10Z",
"lifecycleStatus": "ACTIVE",
"serialNumber": "1501331370",
"sha1Fingerprint": "c1683116fb9606928c3da1ad12efc925896bac07",
"subjectName": "CN=com.apple.systemdefault,O=System Identity",
"username": null
}
],
"configurationProfiles": null,
"contentCaching": null,
"diskEncryption": null,
"extensionAttributes": null,
"general": null,
"groupMemberships": null,
"hardware": null,
"ibeacons": null,
"id": "138",
"licensedSoftware": null,
"localUserAccounts": null,
"operatingSystem": null,
"packageReceipts": null,
"printers": null,
"purchasing": null,
"security": null,
"services": null,
"softwareUpdates": null,
"storage": null,
"udid": "67EAC1E5-43E7-57BE-BAD7-06922C177BDC",
"userAndLocation": null
}
}
}
}
Human Readable Output
Jamf computer Certificates subset result
Certificates ID UDID {‘commonName’: ‘com.apple.systemdefault’, ‘identity’: True, ‘expirationDate’: ‘2041-04-16T12:33:10Z’, ‘username’: None, ‘lifecycleStatus’: ‘ACTIVE’, ‘certificateStatus’: ‘ISSUED’, ‘subjectName’: ‘CN=com.apple.systemdefault,O=System Identity’, ‘serialNumber’: ‘1501331370’, ‘sha1Fingerprint’: ‘c1683116fb9606928c3da1ad12efc925896bac07’, ‘issuedDate’: ‘2021-04-21T12:33:10Z’} 138 67EAC1E5-43E7-57BE-BAD7-06922C177BDC
jamf-get-computer-security-subset
Returns the security subset for a specific computer according to the given arguments.
Base Command
jamf-get-computer-security-subset
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerSubset.Computer.security.activation_lock | Boolean | The computer activation lock. |
| JAMF.ComputerSubset.Computer.security.secure_boot_level | String | The computer secure boot level. |
| JAMF.ComputerSubset.Computer.security.external_boot_level | String | The computer external boot level. |
| JAMF.ComputerSubset.Computer.id | Number | The computer ID. |
Command Example
!jamf-get-computer-security-subset identifier=name identifier_value="Computer 95"
Context Example
{
"JAMF": {
"ComputerSubset": {
"computer": {
"applications": null,
"attachments": null,
"certificates": null,
"configurationProfiles": null,
"contentCaching": null,
"diskEncryption": null,
"extensionAttributes": null,
"general": null,
"groupMemberships": null,
"hardware": null,
"ibeacons": null,
"id": "1",
"licensedSoftware": null,
"localUserAccounts": null,
"operatingSystem": null,
"packageReceipts": null,
"printers": null,
"purchasing": null,
"security": {
"activationLockEnabled": null,
"activation_lock": null,
"attestationStatus": "PENDING",
"autoLoginDisabled": true,
"bootstrapTokenAllowed": null,
"bootstrapTokenEscrowedStatus": "NOT_SUPPORTED",
"externalBootLevel": null,
"external_boot_level": null,
"firewallEnabled": false,
"gatekeeperStatus": "NOT_COLLECTED",
"lastAttestationAttempt": null,
"lastSuccessfulAttestation": null,
"recoveryLockEnabled": false,
"remoteDesktopEnabled": null,
"secureBootLevel": null,
"secure_boot_level": null,
"sipStatus": "NOT_COLLECTED",
"xprotectVersion": null
},
"services": null,
"softwareUpdates": null,
"storage": null,
"udid": "CA40F812-60A3-11E4-90B8-12DF261F2C7E",
"userAndLocation": null
}
}
}
}
Human Readable Output
Jamf computer Security subset result
Auto Login Disabled Bootstrap Token Escrowed Status Firewall Enabled ID Recovery Lock Enabled UDID true NOT_SUPPORTED false 1 false CA40F812-60A3-11E4-90B8-12DF261F2C7E
jamf-get-computer-software-subset
Returns the software subset for a specific computer according to the given arguments.
Base Command
jamf-get-computer-software-subset
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerSubset.Computer.software.licensed_software.name | String | The computer software’s licensed software name. |
| JAMF.ComputerSubset.Computer.software.installed_by_installer_swu | String | The computer software that was installed either by an installer, an app or a software update. |
| JAMF.ComputerSubset.Computer.software.available_updates.name | String | The name of the available updates. |
| JAMF.ComputerSubset.Computer.software.available_updates.version | String | The version of the available update. |
| JAMF.ComputerSubset.Computer.software.running_services.name | String | The computer running service name. |
| JAMF.ComputerSubset.Computer.software.applications.name | String | The computer application name. |
| JAMF.ComputerSubset.Computer.software.applications.path | String | The computer application path. |
| JAMF.ComputerSubset.Computer.software.applications.version | String | The computer application version. |
| JAMF.ComputerSubset.Computer.software.applications.bundleId | String | The computer application bundle ID. |
| JAMF.ComputerSubset.Computer.id | Number | The computer ID. |
Command Example
!jamf-get-computer-software-subset identifier=name identifier_value="Computer 95"
Context Example
{
"JAMF": {
"ComputerSubset": {
"computer": {
"applications": [
{
"bundleId": null,
"cfBundleShortVersionString": null,
"cfBundleVersion": null,
"externalVersionId": "0",
"macAppStore": false,
"name": "Script Editor.app",
"path": "/Applications/Utilities/Script Editor.app",
"sizeMegabytes": 0,
"updateAvailable": false,
"version": "2.7"
}
],
"attachments": null,
"certificates": null,
"configurationProfiles": null,
"contentCaching": null,
"diskEncryption": null,
"extensionAttributes": null,
"general": null,
"groupMemberships": null,
"hardware": null,
"ibeacons": null,
"id": "1",
"licensedSoftware": [],
"localUserAccounts": null,
"operatingSystem": null,
"packageReceipts": {
"cached": [],
"installedByInstallerSwu": [],
"installedByJamfPro": []
},
"printers": null,
"purchasing": null,
"security": null,
"services": [],
"software": {
"applications": [
{
"bundleId": null,
"cfBundleShortVersionString": null,
"cfBundleVersion": null,
"externalVersionId": "0",
"macAppStore": false,
"name": "Script Editor.app",
"path": "/Applications/Utilities/Script Editor.app",
"sizeMegabytes": 0,
"updateAvailable": false,
"version": "2.7"
}
],
"available_updates": [],
"installed_by_installer_swu": [],
"licensed_software": [],
"running_services": []
},
"softwareUpdates": [],
"storage": null,
"udid": "CA40F812-60A3-11E4-90B8-12DF261F2C7E",
"userAndLocation": null
}
}
}
}
Human Readable Output
Jamf computer Software subset result
Applications Services 48 0
jamf-get-computer-extension-attributes-subset
Returns the extension attributes subset for a specific computer according to the given arguments.
Base Command
jamf-get-computer-extension-attributes-subset
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerSubset.Computer.extension_attributes.id | Number | The computer extension attributes ID. |
| JAMF.ComputerSubset.Computer.extension_attributes.name | String | The computer extension attributes name. |
| JAMF.ComputerSubset.Computer.extension_attributes.multi_value | Boolean | The computer extension attributes multi value. |
| JAMF.ComputerSubset.Computer.extension_attributes.value | String | The computer extension attributes value. |
| JAMF.ComputerSubset.Computer.id | Number | The computer ID. |
Command Example
!jamf-get-computer-extension-attributes-subset identifier=name identifier_value="Computer 95"
Context Example
{
"JAMF": {
"ComputerSubset": {
"computer": {
"applications": null,
"attachments": null,
"certificates": null,
"configurationProfiles": null,
"contentCaching": null,
"diskEncryption": null,
"extensionAttributes": [
{
"dataType": "STRING",
"definitionId": "6",
"description": "This is a test by tomer",
"enabled": true,
"inputType": "TEXT",
"multiValue": false,
"name": "Tomer test",
"options": [],
"values": []
}
],
"extension_attributes": [
{
"dataType": "STRING",
"definitionId": "6",
"description": "This is a test by tomer",
"enabled": true,
"id": "6",
"inputType": "TEXT",
"multiValue": false,
"multi_value": false,
"name": "Tomer test",
"options": [],
"value": [],
"values": []
}
],
"general": null,
"groupMemberships": null,
"hardware": null,
"ibeacons": null,
"id": "1",
"licensedSoftware": null,
"localUserAccounts": null,
"operatingSystem": null,
"packageReceipts": null,
"printers": null,
"purchasing": null,
"security": null,
"services": null,
"softwareUpdates": null,
"storage": null,
"udid": "CA40F812-60A3-11E4-90B8-12DF261F2C7E",
"userAndLocation": null
}
}
}
}
Human Readable Output
Jamf computer ExtensionAttributes subset result
Extension Attributes ID UDID {‘definitionId’: ‘6’, ‘name’: ‘Tomer test’, ‘description’: ‘This is a test by tomer’, ‘values’: [], ‘dataType’: ‘STRING’, ‘options’: [], ‘inputType’: ‘TEXT’, ‘enabled’: True, ‘multiValue’: False} 1 CA40F812-60A3-11E4-90B8-12DF261F2C7E
jamf-get-computer-groups-accounts-subset
Returns the groups accounts subset for a specific computer according to the given arguments.
Base Command
jamf-get-computer-groups-accounts-subset
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerSubset.Computer.groups_accounts.computer_group_memberships | String | The computer group memberships. |
| JAMF.ComputerSubset.Computer.groups_accounts.local_accounts.uid | String | The computer local account UID. |
| JAMF.ComputerSubset.Computer.groups_accounts.local_accounts.homeDirectory | String | The computer local account home. |
| JAMF.ComputerSubset.Computer.groups_accounts.local_accounts.admin | Boolean | Whether the computer is the local account administrator. |
| JAMF.ComputerSubset.Computer.id | Number | The computer ID. |
Command Example
!jamf-get-computer-groups-accounts-subset identifier=id identifier_value="138"
Context Example
{
"JAMF": {
"ComputerSubset": {
"computer": {
"applications": null,
"attachments": null,
"certificates": null,
"configurationProfiles": null,
"contentCaching": null,
"diskEncryption": null,
"extensionAttributes": null,
"general": null,
"groupMemberships": [
{
"groupDescription": "",
"groupId": "1",
"groupName": "All Managed Clients",
"smartGroup": true
}
],
"groups_accounts": {
"computer_group_memberships": [
{
"groupDescription": "",
"groupId": "1",
"groupName": "All Managed Clients",
"smartGroup": true
}
],
"local_accounts": [
{
"admin": true,
"azureActiveDirectoryId": null,
"computerAzureActiveDirectoryId": null,
"fileVault2Enabled": true,
"fullName": "test",
"homeDirectory": "/Users/test",
"homeDirectorySizeMb": -1,
"passwordHistoryDepth": null,
"passwordMaxAge": null,
"passwordMinComplexCharacters": null,
"passwordMinLength": 4,
"passwordRequireAlphanumeric": false,
"uid": "504",
"userAccountType": "UNKNOWN",
"userAzureActiveDirectoryId": null,
"userGuid": null,
"username": "test"
}
],
"user_inventories": [
{
"admin": true,
"azureActiveDirectoryId": null,
"computerAzureActiveDirectoryId": null,
"fileVault2Enabled": true,
"fullName": "test",
"homeDirectory": "/Users/test",
"homeDirectorySizeMb": -1,
"passwordHistoryDepth": null,
"passwordMaxAge": null,
"passwordMinComplexCharacters": null,
"passwordMinLength": 4,
"passwordRequireAlphanumeric": false,
"uid": "504",
"userAccountType": "UNKNOWN",
"userAzureActiveDirectoryId": null,
"userGuid": null,
"username": "test"
}
]
},
"hardware": null,
"ibeacons": null,
"id": "138",
"licensedSoftware": null,
"localUserAccounts": [
{
"admin": true,
"azureActiveDirectoryId": null,
"computerAzureActiveDirectoryId": null,
"fileVault2Enabled": true,
"fullName": "test",
"homeDirectory": "/Users/test",
"homeDirectorySizeMb": -1,
"passwordHistoryDepth": null,
"passwordMaxAge": null,
"passwordMinComplexCharacters": null,
"passwordMinLength": 4,
"passwordRequireAlphanumeric": false,
"uid": "504",
"userAccountType": "UNKNOWN",
"userAzureActiveDirectoryId": null,
"userGuid": null,
"username": "test"
}
],
"operatingSystem": null,
"packageReceipts": null,
"printers": null,
"purchasing": null,
"security": null,
"services": null,
"softwareUpdates": null,
"storage": null,
"udid": "67EAC1E5-43E7-57BE-BAD7-06922C177BDC",
"userAndLocation": null
}
}
}
}
Human Readable Output
Jamf computer GroupsAccounts subset result
Group Memberships ID UDID {‘groupId’: ‘1’, ‘groupName’: ‘All Managed Clients’, ‘groupDescription’: ‘’, ‘smartGroup’: True} 138 67EAC1E5-43E7-57BE-BAD7-06922C177BDC
jamf-get-computer-iphones-subset
This command is deprecated and has no replacement.
Returns the iPhones subset for a specific computer according to the given arguments.
Base Command
jamf-get-computer-iphones-subset
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerSubset.Computer.iphones | String | The commputer related iPhones. |
| JAMF.ComputerSubset.Computer.id | Number | The computer ID. |
Command Example
!jamf-get-computer-iphones-subset identifier=id identifier_value="138"
Context Example
{
"JAMF": {
"ComputerSubset": {
"computer": {
"id": 138,
"iphones": []
}
}
}
}
Human Readable Output
Jamf computer iphones subset result
No entries.
jamf-get-computer-configuration-profiles-subset
Returns the configuration profiles subset for a specific computer according to the given arguments.
Base Command
jamf-get-computer-configuration-profiles-subset
Required Permissions
Jamf Pro Server Objects → Computers → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerSubset.Computer.configuration_profiles.id | Number | The configuration profile ID. |
| JAMF.ComputerSubset.Computer.configuration_profiles.removable | Boolean | If the configuration profile is removable. |
| JAMF.ComputerSubset.Computer.id | Number | The computer ID. |
Command Example
!jamf-get-computer-configuration-profiles-subset identifier=id identifier_value="138"
Context Example
{
"JAMF": {
"ComputerSubset": {
"computer": {
"applications": null,
"attachments": null,
"certificates": null,
"configurationProfiles": [
{
"displayName": "Jamf Notifications",
"id": null,
"lastInstalled": "2021-04-21T14:19:43.735Z",
"profileIdentifier": "com.jamf.notifications.settings",
"removable": false,
"username": null
}
],
"configuration_profiles": [
{
"displayName": "Jamf Notifications",
"id": null,
"lastInstalled": "2021-04-21T14:19:43.735Z",
"profileIdentifier": "com.jamf.notifications.settings",
"removable": false,
"username": null
}
],
"contentCaching": null,
"diskEncryption": null,
"extensionAttributes": null,
"general": null,
"groupMemberships": null,
"hardware": null,
"ibeacons": null,
"id": "138",
"licensedSoftware": null,
"localUserAccounts": null,
"operatingSystem": null,
"packageReceipts": null,
"printers": null,
"purchasing": null,
"security": null,
"services": null,
"softwareUpdates": null,
"storage": null,
"udid": "67EAC1E5-43E7-57BE-BAD7-06922C177BDC",
"userAndLocation": null
}
}
}
}
Human Readable Output
Jamf computer ConfigurationProfiles subset result
Configuration Profiles ID UDID {‘id’: None, ‘username’: None, ‘lastInstalled’: ‘2021-04-21T14:19:43.735Z’, ‘removable’: False, ‘displayName’: ‘Jamf Notifications’, ‘profileIdentifier’: ‘com.jamf.notifications.settings’} 138 67EAC1E5-43E7-57BE-BAD7-06922C177BDC
jamf-get-computer-subset
Returns the requested section for a specific computer according to the given arguments.
Base Command
jamf-get-computer-subset
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
| section | The section of the computer to retrieve. Possible values are: GENERAL, HARDWARE, OPERATING_SYSTEM, USER_AND_LOCATION, PURCHASING, DISK_ENCRYPTION, SECURITY, SOFTWARE_UPDATES, APPLICATIONS, STORAGE, CONFIGURATION_PROFILES, PRINTERS, SERVICES, LOCAL_USER_ACCOUNTS, CERTIFICATES, ATTACHMENTS, PACKAGE_RECEIPTS, LICENSED_SOFTWARE, IBEACONS, EXTENSION_ATTRIBUTES, CONTENT_CACHING, GROUP_MEMBERSHIPS. Default is GENERAL. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.Computer.id | Number | The computer’s ID. |
| JAMF.Computer.udid | String | The computer’s UDID. |
Command Example
!jamf-get-computer-subset identifier=id identifier_value="138" section=GENERAL
Context Example
{
"JAMF": {
"Computer": {
"GENERAL": {
"applications": null,
"attachments": null,
"certificates": null,
"configurationProfiles": null,
"contentCaching": null,
"diskEncryption": null,
"extensionAttributes": null,
"general": {
"assetTag": null,
"barcode1": null,
"barcode2": null,
"declarativeDeviceManagementEnabled": false,
"distributionPoint": null,
"enrolledViaAutomatedDeviceEnrollment": false,
"enrollmentMethod": {
"id": "4",
"objectName": null,
"objectType": "User-initiated - no invitation"
},
"extensionAttributes": [
{
"dataType": "STRING",
"definitionId": "1",
"description": "Number of charge cycles logged on the current battery",
"enabled": true,
"inputType": "TEXT",
"multiValue": false,
"name": "Local Password",
"options": [],
"values": []
}
],
"initialEntryDate": "2021-04-21",
"itunesStoreAccountActive": false,
"jamfBinaryVersion": "10.28.0-t1615386406",
"lastCloudBackupDate": null,
"lastContactTime": "2021-04-21T14:19:13.137Z",
"lastEnrolledDate": "2021-04-21T13:08:15.88Z",
"lastIpAddress": "123.123.123.123",
"lastLoggedInUsernameBinary": null,
"lastLoggedInUsernameBinaryTimestamp": null,
"lastLoggedInUsernameSelfService": null,
"lastLoggedInUsernameSelfServiceTimestamp": null,
"lastReportedIp": "123.123.123.123",
"lastReportedIpV4": "123.123.123.123",
"lastReportedIpV6": null,
"managementId": "6bc9fc18-d06b-4b2a-8d34-bc3351aefa52",
"mdmCapable": {
"capable": true,
"capableUsers": [
"user"
],
"userManagementInfo": [
{
"capableUser": "user",
"managementId": "d4c74272-b0ce-4b6d-af8d-14aba63f5f5b"
}
]
},
"mdmProfileExpiration": "2023-04-21T13:07:35Z",
"name": "itadmin’s MacBook Pro",
"platform": "Mac",
"remoteManagement": {
"managed": true,
"managementUsername": null
},
"reportDate": "2021-04-21T14:19:41.431Z",
"site": {
"id": "-1",
"name": "None"
},
"supervised": true,
"userApprovedMdm": true
},
"groupMemberships": null,
"hardware": null,
"ibeacons": null,
"id": "138",
"licensedSoftware": null,
"localUserAccounts": null,
"operatingSystem": null,
"packageReceipts": null,
"printers": null,
"purchasing": null,
"security": null,
"services": null,
"softwareUpdates": null,
"storage": null,
"udid": "67EAC1E5-43E7-57BE-BAD7-06922C177BDC",
"userAndLocation": null
}
}
}
}
Human Readable Output
Jamf computer GENERAL section result
ID UDID 138 67EAC1E5-43E7-57BE-BAD7-06922C177BDC
jamf-computer-lock
Sends the “DeviceLock” command to a computer. This command logs the user out of the computer, restarts the computer, and then locks the computer. Optional: Displays a message on the computer when it locks.
Base Command
jamf-computer-lock
Required Permissions
Jamf Pro Server Actions → Send Computer Remote Lock Command
Jamf Pro Server Objects → Computers → Create
Input
| Argument Name | Description | Required |
|---|---|---|
| passcode | A 6-digit passcode to be used to unlock the computer after it was locked. | Required |
| id | The ID of the computer that you want to lock. | Required |
| lock_message | A message to display on the locked screen. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerCommand.name | String | The command name. |
| JAMF.ComputerCommand.command_uuid | String | The command UDID. |
| JAMF.ComputerCommand.computer_id | String | The computer ID. |
Command Example
!jamf-computer-lock id=138 passcode=123456
Context Example
{
"JAMF": {
"ComputerCommand": {
"command_uuid": "2f410832-c87e-4b4c-aab7-8edaa22b2e08",
"computer_id": "138",
"name": "DeviceLock"
}
}
}
Human Readable Output
Computer 138 locked successfully
Command UUID Computer ID Name 2f410832-c87e-4b4c-aab7-8edaa22b2e08 138 DeviceLock
jamf-computer-erase
Sends the “EraseDevice’’ command to a computer. Permanently erases all the data on the computer and sets a passcode when required by the computer hardware type.
Base Command
jamf-computer-erase
Required Permissions
Jamf Pro Server Actions → Send Computer Remote Wipe Command
Jamf Pro Server Objects → Computers → Create
Input
| Argument Name | Description | Required |
|---|---|---|
| passcode | A 6-digit passcode that locks the computer after being erased. | Required |
| id | The ID of the computer that you want to erase. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputerCommand.name | String | The command name. |
| JAMF.ComputerCommand.command_uuid | String | The command UDID. |
| JAMF.ComputerCommand.computer_id | String | The computer ID. |
Command Example
!jamf-computer-erase id=138 passcode=123456
Context Example
{
"JAMF": {
"ComputerCommand": {
"command_uuid": "91cfac41-7826-4d73-b8b7-9ab34848f2f2",
"computer_id": "138",
"name": "EraseDevice"
}
}
}
Human Readable Output
Computer 138 erased successfully
Command UUID Computer ID Name 91cfac41-7826-4d73-b8b7-9ab34848f2f2 138 EraseDevice
jamf-get-users
Returns a list of users with their IDs and names. By default, returns the first 50 users to the context (ID + name).
Base Command
jamf-get-users
Required Permissions
Jamf Pro Server Objects → Users → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| limit | Maximum number of users to retrieve. The maximal value is 200. Default is 50. | Optional |
| page | The number of the requested page. Default is 0. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.User.id | Number | The user ID. |
| JAMF.User.name | String | The user name. |
| JAMF.User.Paging.total_results | Number | The number of users returned in this specific search. |
| JAMF.User.Paging.page_size | Number | The number of users to be returned on each page. |
| JAMF.User.Paging.current_page | Number | The number of requested page. |
Command Example
!jamf-get-users limit=3
Context Example
{
"JAMF": {
"User": [
{
"id": 81,
"name": "AHarrison"
},
{
"id": 80,
"name": "David.Aspir"
},
{
"id": 76,
"name": "dummy00001"
},
{
"Paging": {
"current_page": 0,
"page_size": 3,
"total_results": 98
}
}
]
}
}
Human Readable Output
Paging for get users
Current Page Page Size Total Results 0 3 98
Jamf get users result
Total results:98
Results per page: 3
Page: 0
ID Name 81 AHarrison 80 David.Aspir 76 dummy00001
jamf-get-user-by-id
Returns a specific user with general data about the user according to the given ID.
Base Command
jamf-get-user-by-id
Required Permissions
Jamf Pro Server Objects → Users → Read
Jamf Pro Server Settings → Apple Education Support → Read (in order to view these fields: “enable_custom_photo_url” and “custom_photo_url”)
Input
| Argument Name | Description | Required |
|---|---|---|
| id | The user ID. To get the user ID, run the jamf-get-users command to get all user names and IDs. |
Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.User.id | Number | The user ID. |
| JAMF.User.name | String | The user name. |
| JAMF.User.full_name | String | The user full name. |
| JAMF.User.email | String | The user email. |
| JAMF.User.email_address | String | The user email address. |
| JAMF.User.phone_number | String | The user phone number. |
| JAMF.User.position | String | The user position. |
| JAMF.User.managed_apple_id | String | The user managed Apple ID. |
| JAMF.User.enable_custom_photo_url | Boolean | Whether the user custom photo URL is enabled. |
| JAMF.User.custom_photo_url | String | The user custom photo URL. |
| JAMF.User.ldap_server.id | Number | The user LDAP server ID. |
| JAMF.User.ldap_server.name | String | The user LDAP server name. |
| JAMF.User.extension_attributes.id | Number | The user extension attributes ID. |
| JAMF.User.extension_attributes.name | String | The user extension attributes name. |
| JAMF.User.extension_attributes.type | String | The user extension attributes type. |
| JAMF.User.extension_attributes.value | String | The user extension attributes value. |
| JAMF.User.sites.id | Number | The user’s site ID. |
| JAMF.User.sites.name | String | The user’s site name. |
| JAMF.User.links.total_vpp_code_count | Number | The user total VPP code acount. |
| JAMF.User.links.vpp_assignments.id | Number | The VPP assignment ID that is linked to the user. |
| JAMF.User.links.vpp_assignments.name | String | The VPP assignment name that is linked to the user. |
| JAMF.User.links.computers.id | Number | The computer ID that is linked to the user. |
| JAMF.User.links.computers.name | String | The computer name that is linked to the user. |
| JAMF.User.links.peripherals.id | Number | The peripherals ID that is linked to the user. |
| JAMF.User.links.peripherals.name | String | The peripherals name that is linked to the user. |
| JAMF.User.links.mobile_devices.id | String | The mobile device ID that is linked to the user. |
| JAMF.User.links.mobile_devices.name | String | The mobile device name that is linked to the user. |
| JAMF.User.user_groups.size | Number | The user group size. |
| JAMF.User.user_groups.user_group.id | Number | The user group ID. |
| JAMF.User.user_groups.user_group.name | String | The user group name. |
| JAMF.User.user_groups.user_group.is_smart | Boolean | Whether the user group is smart. |
Command Example
!jamf-get-user-by-id id=1
Context Example
{
"JAMF": {
"User": {
"custom_photo_url": "",
"email": "User28@email.com",
"email_address": "User28@email.com",
"enable_custom_photo_url": false,
"extension_attributes": [
{
"id": 1,
"name": "vip",
"type": "String",
"value": ""
},
{
"id": 2,
"name": "test user attribute",
"type": "String",
"value": ""
}
],
"full_name": "User 28",
"id": 1,
"ldap_server": {
"id": -1,
"name": "None"
},
"links": {
"computers": [
{
"id": 16,
"name": "Computer 3"
},
{
"id": 42,
"name": "Computer 36"
},
{
"id": 85,
"name": "Computer 96"
}
],
"mobile_devices": [
{
"id": 1,
"name": "Device 71"
},
{
"id": 28,
"name": "Device 70"
},
{
"id": 31,
"name": "Device 114"
}
],
"peripherals": [],
"total_vpp_code_count": 0,
"vpp_assignments": []
},
"managed_apple_id": "",
"name": "user28",
"phone_number": "612-605-6625",
"position": "",
"sites": [],
"user_groups": {
"size": 0
}
}
}
}
Human Readable Output
Jamf get user result
ID Name Phone User28@email.com 1 user28 612-605-6625
jamf-get-user-by-name
Returns a specific user with general data about the user according to the given name.
Base Command
jamf-get-user-by-name
Required Permissions
Jamf Pro Server Objects → Users → Read
Jamf Pro Server Settings → Apple Education Support → Read (in order to view these fields: “enable_custom_photo_url” and “custom_photo_url”)
Input
| Argument Name | Description | Required |
|---|---|---|
| name | The user name. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.User.id | Number | The user ID. |
| JAMF.User.name | String | The user name. |
| JAMF.User.full_name | String | The user full name. |
| JAMF.User.email | String | The user email. |
| JAMF.User.email_address | String | The user email address. |
| JAMF.User.phone_number | String | The user phone number. |
| JAMF.User.position | String | The user position. |
| JAMF.User.managed_apple_id | String | The user managed Apple ID. |
| JAMF.User.enable_custom_photo_url | Boolean | Whether the user custom photo URL is enabled. |
| JAMF.User.custom_photo_url | String | The user custom photo URL. |
| JAMF.User.ldap_server.id | Number | The user LDAP server ID. |
| JAMF.User.ldap_server.name | String | The user LDAP server name. |
| JAMF.User.extension_attributes.id | Number | The user extension attributes ID. |
| JAMF.User.extension_attributes.name | String | The user extension attributes name. |
| JAMF.User.extension_attributes.type | String | The user extension attributes type. |
| JAMF.User.extension_attributes.value | String | The user extension attributes value. |
| JAMF.User.sites.site.id | Number | The user’s site ID. |
| JAMF.User.sites.site.name | String | The user’s site name. |
| JAMF.User.links.total_vpp_code_count | Number | The user total VPP code acount. |
| JAMF.User.links.vpp_assignments.id | Number | The VPP assignment ID that is linked to the user. |
| JAMF.User.links.vpp_assignments.name | String | The VPP assignment name that is linked to the user. |
| JAMF.User.links.computers.id | Number | The computer ID that is linked to the user. |
| JAMF.User.links.computers.name | String | The computer name that is linked to the user. |
| JAMF.User.links.peripherals.id | Number | The peripherals ID that is linked to the user. |
| JAMF.User.links.peripherals.name | String | The peripherals name that is linked to the user. |
| JAMF.User.links.mobile_devices.id | String | The mobile device ID that is linked to the user. |
| JAMF.User.links.mobile_devices.name | String | The mobile device name that is linked to the user. |
| JAMF.User.user_groups.size | Number | The user groups size. |
| JAMF.User.user_groups.user_group.id | Number | The user group ID. |
| JAMF.User.user_groups.user_group.name | String | The user group name. |
| JAMF.User.user_groups.user_group.is_smart | Boolean | Whether the user group is smart. |
Command Example
!jamf-get-user-by-name name=tomertest
Context Example
{
"JAMF": {
"User": {
"custom_photo_url": "",
"email": "tomertest@test.com",
"email_address": "tomertest@test.com",
"enable_custom_photo_url": false,
"extension_attributes": [
{
"id": 1,
"name": "vip",
"type": "String",
"value": ""
},
{
"id": 2,
"name": "test user attribute",
"type": "String",
"value": ""
}
],
"full_name": "tomer test",
"id": 97,
"ldap_server": {
"id": 2,
"name": "AD XSOAR Ninja"
},
"links": {
"computers": [
{
"id": 138,
"name": "itadmin MacBook Pro"
},
{
"id": 139,
"name": "Tomer Mac"
}
],
"mobile_devices": [
{
"id": 114,
"name": "test iPhone"
}
],
"peripherals": [],
"total_vpp_code_count": 0,
"vpp_assignments": []
},
"managed_apple_id": "",
"name": "tomertest",
"phone_number": "",
"position": "",
"sites": [
{
"id": 1,
"name": "Mainz"
},
{
"id": 2,
"name": "Test4"
},
{
"id": 7,
"name": "Alpha"
}
],
"user_groups": {
"size": 0
}
}
}
}
Human Readable Output
Jamf get user result
ID Name tomertest@test.com 97 tomertest
jamf-get-user-by-email
Returns a specific user with general data about the user according to the given email.
Base Command
jamf-get-user-by-email
Required Permissions
Jamf Pro Server Objects → Users → Read
Jamf Pro Server Settings → Apple Education Support → Read (in order to view these fields: “enable_custom_photo_url” and “custom_photo_url”)
Input
| Argument Name | Description | Required |
|---|---|---|
| The user email. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.User.id | Number | The user ID. |
| JAMF.User.name | String | The user name. |
| JAMF.User.full_name | String | The user full name. |
| JAMF.User.email | String | The user email. |
| JAMF.User.email_address | String | The user email address. |
| JAMF.User.phone_number | String | The user phone number. |
| JAMF.User.position | String | The user position. |
| JAMF.User.managed_apple_id | String | The user managed Apple ID. |
| JAMF.User.enable_custom_photo_url | Boolean | Whether the user custom photo URL is enabled. |
| JAMF.User.custom_photo_url | String | The user custom photo URL. |
| JAMF.User.ldap_server.id | Number | The user LDAP server ID. |
| JAMF.User.ldap_server.name | String | The user LDAP server name. |
| JAMF.User.extension_attributes.id | Number | The user extension attributes ID. |
| JAMF.User.extension_attributes.name | String | The user extension attributes name. |
| JAMF.User.extension_attributes.type | String | The user extension attributes type. |
| JAMF.User.extension_attributes.value | String | The user extension attributes value. |
| JAMF.User.sites.site.id | Number | The user’s site ID. |
| JAMF.User.sites.site.name | String | The user’s site name. |
| JAMF.User.links.total_vpp_code_count | Number | The user total VPP code acount. |
| JAMF.User.links.vpp_assignments.id | Number | The VPP assignment ID that is linked to the user. |
| JAMF.User.links.vpp_assignments.name | String | The VPP assignment name that is linked to the user. |
| JAMF.User.links.computers.id | Number | The computer ID that is linked to the user. |
| JAMF.User.links.computers.name | String | The computer name that is linked to the user. |
| JAMF.User.links.peripherals.id | Number | The peripherals ID that is linked to the user. |
| JAMF.User.links.peripherals.name | String | The peripherals name that is linked to the user. |
| JAMF.User.links.mobile_devices.id | String | The mobile device ID that is linked to the user. |
| JAMF.User.links.mobile_devices.name | String | The mobile device name that is linked to the user. |
| JAMF.User.user_groups.size | Number | The user groups size. |
| JAMF.User.user_groups.user_group.id | Number | The user group ID. |
| JAMF.User.user_groups.user_group.name | String | The user group name. |
| JAMF.User.user_groups.user_group.is_smart | Boolean | If the user group is smart. |
Command Example
!jamf-get-user-by-email email=user28@email.com
Context Example
{
"JAMF": {
"User": {
"custom_photo_url": "",
"email": "User28@email.com",
"email_address": "User28@email.com",
"enable_custom_photo_url": false,
"extension_attributes": [
{
"id": 1,
"name": "vip",
"type": "String",
"value": ""
},
{
"id": 2,
"name": "test user attribute",
"type": "String",
"value": ""
}
],
"full_name": "User 28",
"id": 1,
"ldap_server": [
{
"id": -1
},
{
"name": "None"
}
],
"links": [
{
"computer": [
{
"id": 85
},
{
"name": "Computer 96"
}
]
},
{},
{
"mobile_device": [
{
"id": 31
},
{
"name": "Device 114"
}
]
},
{},
{
"total_vpp_code_count": 0
}
],
"managed_apple_id": "",
"name": "user28",
"phone_number": "612-605-6625",
"position": "",
"sites": [],
"user_groups": []
}
}
}
Human Readable Output
Jamf get user result
ID Name Phone User28@email.com 1 user28 612-605-6625
jamf-get-mobile-devices
Returns a list of devices with basic data on each. By default, returns the first 50 devices to the context (ID + name).
Base Command
jamf-get-mobile-devices
Required Permissions
Jamf Pro Server Objects → Mobile Devices → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| limit | Maximum number of devices to retrieve. Maximal value is 200. Default is 50. | Optional |
| page | Number of requested page. Default is 0. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDevice.id | Number | The mobile device ID. |
| JAMF.MobileDevice.name | String | The mobile device name. |
| JAMF.MobileDevice.device_name | String | The mobile device name. |
| JAMF.MobileDevice.udid | String | The mobile device UDID. |
| JAMF.MobileDevice.serial_number | String | The mobile device serial number. |
| JAMF.MobileDevice.phone_number | String | The mobile device phone number. |
| JAMF.MobileDevice.wifi_mac_address | String | The mobile device WIFI MAC address. |
| JAMF.MobileDevice.managed | Boolean | Whether the mobile device is managed. |
| JAMF.MobileDevice.supervised | Boolean | Whether the mobile device is supervised. |
| JAMF.MobileDevice.model | String | The mobile device model. |
| JAMF.MobileDevice.model_identifier | String | The mobile device model ID. |
| JAMF.MobileDevice.modelDisplay | String | The mobile device model display. |
| JAMF.MobileDevice.model_display | String | The mobile device model display. |
| JAMF.MobileDevice.username | String | The mobile device username. |
| JAMF.MobileDevice.Paging.total_results | Number | The number of mobile devices returned in this specific search. |
| JAMF.MobileDevice.Paging.page_size | Number | The number of mobile devices to be returned on each page. |
| JAMF.MobileDevice.Paging.current_page | Number | The number of the requested page. |
Command Example
!jamf-get-mobile-devices limit=3
Context Example
{
"JAMF": {
"MobileDevice": [
{
"device_name": "Device 71",
"id": 1,
"managed": true,
"model": "iPad 3rd Generation (Wi-Fi)",
"modelDisplay": "iPad 3rd Generation (Wi-Fi)",
"model_display": "iPad 3rd Generation (Wi-Fi)",
"model_identifier": "iPad3,1",
"name": "Device 71",
"phone_number": "612-605-6625",
"serial_number": "CA44F4D060A3",
"supervised": false,
"udid": "ca44f4c660a311e490b812df261f2c7e",
"username": "user28",
"wifi_mac_address": "B0:65:BD:4E:50:5D"
},
{
"device_name": "Device 4",
"id": 2,
"managed": true,
"model": "iPad mini (CDMA)",
"modelDisplay": "iPad mini (CDMA)",
"model_display": "iPad mini (CDMA)",
"model_identifier": "iPad2,7",
"name": "Device 4",
"phone_number": "612-605-6625",
"serial_number": "CA44CA9660A3",
"supervised": false,
"udid": "ca44ca8c60a311e490b812df261f2c7e",
"username": "user82",
"wifi_mac_address": "5C:96:9D:15:B7:CF"
},
{
"device_name": "Device 68",
"id": 3,
"managed": true,
"model": "iPad mini (Wi-Fi Only)",
"modelDisplay": "iPad mini (Wi-Fi Only)",
"model_display": "iPad mini (Wi-Fi Only)",
"model_identifier": "iPad2,5",
"name": "Device 68",
"phone_number": "612-605-6625",
"serial_number": "CA44F34060A3",
"supervised": true,
"udid": "ca44f33660a311e490b812df261f2c7e",
"username": "user60",
"wifi_mac_address": "1C:E6:2B:A5:62:51"
},
{
"Paging": {
"current_page": 0,
"page_size": 3,
"total_results": 114
}
}
]
}
}
Human Readable Output
Paging for get mobile devices
Current Page Page Size Total Results 0 3 114
Jamf get mobile devices result
ID Name Serial Number UDID 1 Device 71 CA44F4D060A3 ca44f4c660a311e490b812df261f2c7e 2 Device 4 CA44CA9660A3 ca44ca8c60a311e490b812df261f2c7e 3 Device 68 CA44F34060A3 ca44f33660a311e490b812df261f2c7e
jamf-get-mobile-device-by-id
Returns the “general” subset of a specific mobile device, e.g.: name, MAC address, IP, serial number, UDID. etc.
Base Command
jamf-get-mobile-device-by-id
Required Permissions
Jamf-get-mobile-device-by-id
Jamf Pro Server Objects → Mobile Devices → Read
*Jamf Pro Server Actions → Send Mobile Device Lost Mode Command
**Jamf Pro Server Actions → View Mobile Device Lost Mode Location
| *In order to view these fields: | |
|---|---|
| lost_mode_enabled | |
| lost_mode_enforced | |
| lost_mode_enable_issued_epoch | |
| lost_mode_enable_issued_utc | |
| lost_mode_message | |
| lost_mode_phone | |
| lost_mode_footnote |
| ** In order to view these fields (has to be combined with “Send Mobile Device Lost Mode Command” permission) | |
|---|---|
| lost_location_epoch | |
| lost_location_utc | |
| lost_location_latitude | |
| lost_location_longitude | |
| lost_location_altitude | |
| lost_location_speed | |
| lost_location_course | |
| lost_location_horizontal_accuracy | |
| lost_location_vertical_accuracy |
Input
| Argument Name | Description | Required |
|---|---|---|
| id | Gets the “general” subset of a specific device. To get the mobile device ID, run the jamf-get-mobile-devices command to get all mobile devices names and IDs. |
Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDevice.id | Number | The mobile device ID. |
| JAMF.MobileDevice.display_name | String | The mobile device display name. |
| JAMF.MobileDevice.device_name | String | The mobile device name. |
| JAMF.MobileDevice.name | String | The mobile device name. |
| JAMF.MobileDevice.asset_tag | String | The mobile device asset ID. |
| JAMF.MobileDevice.last_inventory_update | String | The date of the mobile device last inventory update. |
| JAMF.MobileDevice.last_inventory_update_epoch | Date | The date of the mobile device last inventory update in epoch format. |
| JAMF.MobileDevice.last_inventory_update_utc | Date | The date of the mobile device last inventory update in UTC format. |
| JAMF.MobileDevice.capacity | Number | The mobile device capacity. |
| JAMF.MobileDevice.capacity_mb | Number | The mobile device capacity in MB. |
| JAMF.MobileDevice.available | Number | The mobile device available storage. |
| JAMF.MobileDevice.available_mb | Number | The mobile device available storage in MB. |
| JAMF.MobileDevice.percentage_used | Number | The percentage of memory used. |
| JAMF.MobileDevice.os_type | String | The mobile device operating system type. |
| JAMF.MobileDevice.os_version | String | The mobile device operating system version. |
| JAMF.MobileDevice.os_build | String | The mobile device operating system build. |
| JAMF.MobileDevice.serial_number | String | The mobile device serial number. |
| JAMF.MobileDevice.udid | String | The mobile device UDID. |
| JAMF.MobileDevice.initial_entry_date_epoch | Date | The mobile device initial entry date in epoch format. |
| JAMF.MobileDevice.initial_entry_date_utc | Date | The mobile device initial entry date in UTC format. |
| JAMF.MobileDevice.phone_number | String | The mobile device phone number. |
| JAMF.MobileDevice.ip_address | String | The mobile device IP address. |
| JAMF.MobileDevice.wifi_mac_address | String | The mobile device WIFI MAC address. |
| JAMF.MobileDevice.bluetooth_mac_address | String | The mobile device bluetooth MAC address. |
| JAMF.MobileDevice.modem_firmware | String | The mobile device modem fireware. |
| JAMF.MobileDevice.model | String | The mobile device model. |
| JAMF.MobileDevice.model_identifier | String | The mobile device model ID. |
| JAMF.MobileDevice.model_number | String | The mobile device model number. |
| JAMF.MobileDevice.modelDisplay | String | The mobile device model display. |
| JAMF.MobileDevice.model_display | String | The mobile device model display. |
| JAMF.MobileDevice.device_ownership_level | String | The mobile device ownership level. |
| JAMF.MobileDevice.enrollment_method | String | The mobile device enrollment method. |
| JAMF.MobileDevice.last_enrollment_epoch | Number | The mobile device last enrollment in epoch. |
| JAMF.MobileDevice.last_enrollment_utc | String | The mobile device last enrollment in UTC format. |
| JAMF.MobileDevice.mdm_profile_expiration_epoch | Number | The mobile device MDM profile expiration in epoch format. |
| JAMF.MobileDevice.mdm_profile_expiration_utc | String | The mobile device MDM profile expiration in UTC format. |
| JAMF.MobileDevice.managed | Boolean | Whether the mobile device is managed. |
| JAMF.MobileDevice.supervised | Boolean | Whether the mobile device is supervised. |
| JAMF.MobileDevice.exchange_activesync_device_identifier | String | The mobile device exchange active sync device ID. |
| JAMF.MobileDevice.shared | String | Whether the device is shared. |
| JAMF.MobileDevice.diagnostic_submission | String | The mobile device diagnostic submission. |
| JAMF.MobileDevice.app_analytics | String | The mobile device app analytics. |
| JAMF.MobileDevice.tethered | String | The mobile device tethered status. |
| JAMF.MobileDevice.battery_level | Number | The mobile device battery level. |
| JAMF.MobileDevice.ble_capable | Boolean | Whether the mobile device is BLE capable. |
| JAMF.MobileDevice.device_locator_service_enabled | Boolean | Whether the mobile device locator service is enabled. |
| JAMF.MobileDevice.do_not_disturb_enabled | Boolean | Whether the mobile device do not disturb is enabled. |
| JAMF.MobileDevice.cloud_backup_enabled | Boolean | Whether the mobile device cloud backup is enabled. |
| JAMF.MobileDevice.last_cloud_backup_date_epoch | Date | The mobile device last cloud update backup date in epoch format. |
| JAMF.MobileDevice.last_cloud_backup_date_utc | Date | The mobile device last cloud update backup date in UTC format. |
| JAMF.MobileDevice.location_services_enabled | Boolean | Whether the mobile device location services is enabled. |
| JAMF.MobileDevice.itunes_store_account_is_active | Boolean | Whether the mobile device iTunes store account is enabled. |
| JAMF.MobileDevice.last_backup_time_epoch | Number | The mobile device last backup time in epoch format. |
| JAMF.MobileDevice.last_backup_time_utc | String | The mobile device last backup time in UTC format. |
| JAMF.MobileDevice.site.id | Number | The mobile device site ID. |
| JAMF.MobileDevice.site.name | String | The mobile device site name. |
Command Example
!jamf-get-mobile-device-by-id id=114
Context Example
{
"JAMF": {
"MobileDevice": {
"app_analytics": "Not Enabled",
"asset_tag": "",
"available": 250989,
"available_mb": 250989,
"battery_level": 65,
"ble_capable": false,
"bluetooth_mac_address": "F8:E9:4E:8C:34:F5",
"capacity": 262144,
"capacity_mb": 262144,
"cloud_backup_enabled": true,
"device_locator_service_enabled": true,
"device_name": "\u05d6\u05d4\u05d1\u05d9\u05ea\u2019s iPhone",
"device_ownership_level": "Institutional",
"diagnostic_submission": "Not Enabled",
"display_name": "\u05d6\u05d4\u05d1\u05d9\u05ea\u2019s iPhone",
"do_not_disturb_enabled": false,
"enrollment_method": "User-initiated - no invitation",
"exchange_activesync_device_identifier": "U9J58M08ST4KHBH3FH15VD6KG1",
"id": 114,
"initial_entry_date_epoch": 1620740433498,
"initial_entry_date_utc": "2021-05-11T13:40:33.498+0000",
"ip_address": "123.243.192.22",
"itunes_store_account_is_active": true,
"last_backup_time_epoch": 0,
"last_backup_time_utc": "",
"last_cloud_backup_date_epoch": 0,
"last_cloud_backup_date_utc": "",
"last_enrollment_epoch": 1620741624868,
"last_enrollment_utc": "2021-05-11T14:00:24.868+0000",
"last_inventory_update": "Tuesday, May 11 2021 at 2:00 PM",
"last_inventory_update_epoch": 1620741638658,
"last_inventory_update_utc": "2021-05-11T14:00:38.658+0000",
"location_services_enabled": false,
"managed": false,
"mdm_profile_expiration_epoch": 1683813623000,
"mdm_profile_expiration_utc": "2023-05-11T14:00:23.000+0000",
"model": "iPhone XS Max",
"modelDisplay": "iPhone XS Max",
"model_display": "iPhone XS Max",
"model_identifier": "iPhone11,6",
"model_number": "NT6J2LL",
"modem_firmware": "3.03.05",
"name": "test iPhone",
"os_build": "18E212",
"os_type": "iOS",
"os_version": "14.5.1",
"percentage_used": 4,
"phone_number": "",
"serial_number": "F2LXX5ZKKPHG",
"shared": "No",
"site": {
"id": -1,
"name": "None"
},
"supervised": false,
"tethered": "",
"udid": "00008020-001C285E3EE1002E",
"wifi_mac_address": "F8:E9:4E:96:21:FB"
}
}
}
Human Readable Output
Jamf get mobile devices result on mobile ID:114
Bluetooth MAC address ID IP address Managed Model Model Number Name Serial Number Supervised UDID WIFI MAC address F8:E9:4E:8C:34:F5 114 123.243.192.22 false iPhone XS Max NT6J2LL test iPhone F2LXX5ZKKPHG false 00008020-001C285E3EE1002E F8:E9:4E:96:21:FB
jamf-get-mobile-device-by-match
Matches mobile devices by specific characteristics and returns general data on each one of the mobile devices.
Base Command
jamf-get-mobile-device-by-match
Required Permissions
Jamf Pro Server Objects → Mobile Devices → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| match | The specific characteristics by which to match devices such as: name, udid, serial_number, mac_address, username, email. e.g: “match=john*”, “match=C52F72FACB9T”. (Supports wildcards). Possible values are: . | Required |
| limit | Maximum number of devices to retrieve. (Maximal value is 200). Default is 50. | Optional |
| page | The number of the requested page. Default is 0. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDevice.id | Number | The mobile device ID. |
| JAMF.MobileDevice.name | String | The mobile device name. |
| JAMF.MobileDevice.udid | String | The mobile device UDID. |
| JAMF.MobileDevice.serial_number | String | The mobile device serial number. |
| JAMF.MobileDevice.mac_address | String | The mobile device MAC address. |
| JAMF.MobileDevice.wifi_mac_address | String | The mobile device WIFI MAC address. |
| JAMF.MobileDevice.username | String | The mobile device username. |
| JAMF.MobileDevice.realname | String | The mobile device real name. |
| JAMF.MobileDevice.email | String | The mobile device user email address. |
| JAMF.MobileDevice.email_address | String | The mobile device user email address. |
| JAMF.MobileDevice.room | String | The mobile device room. |
| JAMF.MobileDevice.position | String | The mobile device position. |
| JAMF.MobileDevice.building | String | The mobile device building. |
| JAMF.MobileDevice.building_name | String | The mobile device building name. |
| JAMF.MobileDevice.department | String | The mobile device department. |
| JAMF.MobileDevice.department_name | String | The mobile device department name. |
| JAMF.MobileDevice.Paging.total_results | Number | The number of mobile devices returned in this specific search. |
| JAMF.MobileDevice.Paging.page_size | Number | The number of mobile devices to be returned on each page. |
| JAMF.MobileDevice.Paging.current_page | Number | The number of the requested page. |
Command Example
!jamf-get-mobile-device-by-match match="B0:65:BD:4E:50:5D"
Context Example
{
"JAMF": {
"MobileDevice": {
"Paging": {
"current_page": 0,
"page_size": 50,
"total_results": 1
},
"building": "",
"building_name": "",
"department": "",
"department_name": "",
"email": "User28@email.com",
"email_address": "User28@email.com",
"id": 1,
"mac_address": "B0:65:BD:4E:50:5D",
"name": "Device 71",
"position": "",
"realname": "User 28",
"room": "315 Graham Ave",
"serial_number": "CA44F4D060A3",
"udid": "ca44f4c660a311e490b812df261f2c7e",
"username": "user28",
"wifi_mac_address": "B0:65:BD:4E:50:5D"
}
}
}
Human Readable Output
Paging for get mobile devices
Current Page Page Size Total Results 0 50 1
Jamf get mobile devices result
ID Name Serial Number UDID 1 Device 71 CA44F4D060A3 ca44f4c660a311e490b812df261f2c7e
jamf-get-mobile-device-general-subset
Returns the general subset for a specific mobile device according to the given arguments.
Base Command
jamf-get-mobile-device-general-subset
Required Permissions
Jamf Pro Server Objects → Mobile Devices → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDeviceSubset.id | String | The mobile device ID. |
| JAMF.MobileDeviceSubset.general.id | Number | The mobile device ID. |
| JAMF.MobileDeviceSubset.general.display_name | String | The mobile device display name. |
| JAMF.MobileDeviceSubset.general.device_name | String | The mobile device name. |
| JAMF.MobileDeviceSubset.general.name | String | The mobile device name. |
| JAMF.MobileDeviceSubset.general.asset_tag | String | The mobile device asset ID. |
| JAMF.MobileDeviceSubset.general.last_inventory_update | String | The date of the mobile device last inventory update. |
| JAMF.MobileDeviceSubset.general.last_inventory_update_epoch | Date | The date of the mobile device last inventory update in epoch format. |
| JAMF.MobileDeviceSubset.general.last_inventory_update_utc | Date | The date of the mobile device last inventory update in UTC format. |
| JAMF.MobileDeviceSubset.general.capacity | Number | The mobile device capacity. |
| JAMF.MobileDeviceSubset.general.capacity_mb | Number | The mobile device capacity in MB. |
| JAMF.MobileDeviceSubset.general.available | Number | The available memory in the mobile device. |
| JAMF.MobileDeviceSubset.general.available_mb | Number | The available memory in the mobile device in MB. |
| JAMF.MobileDeviceSubset.general.percentage_used | Number | The percentage of memory used in the mobile device. |
| JAMF.MobileDeviceSubset.general.os_type | String | The mobile device operating system type. |
| JAMF.MobileDeviceSubset.general.os_version | String | The mobile device operating system version. |
| JAMF.MobileDeviceSubset.general.os_build | String | The mobile device operating system build. |
| JAMF.MobileDeviceSubset.general.serial_number | String | The mobile device serial number. |
| JAMF.MobileDeviceSubset.general.udid | String | The mobile device UDID. |
| JAMF.MobileDeviceSubset.general.initial_entry_date_epoch | Date | The mobile device initial entry date in epoch format. |
| JAMF.MobileDeviceSubset.general.initial_entry_date_utc | Date | The mobile device initial entry date in UTC format. |
| JAMF.MobileDeviceSubset.general.phone_number | String | The mobile device phone number. |
| JAMF.MobileDeviceSubset.general.ip_address | String | The mobile device IP address. |
| JAMF.MobileDeviceSubset.general.wifi_mac_address | String | The mobile device WIFI MAC address. |
| JAMF.MobileDeviceSubset.general.bluetooth_mac_address | String | The mobile device bluetooth MAC address. |
| JAMF.MobileDeviceSubset.general.modem_firmware | String | The mobile device modem fireware. |
| JAMF.MobileDeviceSubset.general.model | String | The mobile device model. |
| JAMF.MobileDeviceSubset.general.model_identifier | String | The mobile device model ID. |
| JAMF.MobileDeviceSubset.general.model_number | String | The mobile device model number. |
| JAMF.MobileDeviceSubset.general.modelDisplay | String | The mobile device model display. |
| JAMF.MobileDeviceSubset.general.model_display | String | The mobile device model display. |
| JAMF.MobileDeviceSubset.general.device_ownership_level | String | The mobile device ownership level. |
| JAMF.MobileDeviceSubset.general.enrollment_method | String | The mobile device enrollment method. |
| JAMF.MobileDeviceSubset.general.last_enrollment_epoch | Number | The mobile device last enrollment in epoch format. |
| JAMF.MobileDeviceSubset.general.last_enrollment_utc | String | The mobile device last enrollment in UTC format. |
| JAMF.MobileDeviceSubset.general.mdm_profile_expiration_epoch | Number | The mobile device MDM profile expiration in epoch format. |
| JAMF.MobileDeviceSubset.general.mdm_profile_expiration_utc | String | The mobile device MDM profile expiration in UTC format. |
| JAMF.MobileDeviceSubset.general.managed | Boolean | Whether the mobile device is managed. |
| JAMF.MobileDeviceSubset.general.supervised | Boolean | Whether the mobile device is supervised. |
| JAMF.MobileDeviceSubset.general.exchange_activesync_device_identifier | String | The mobile device exchange active sync device ID. |
| JAMF.MobileDeviceSubset.general.shared | String | Whether the device is shared. |
| JAMF.MobileDeviceSubset.general.diagnostic_submission | String | The mobile device diagnostic submission. |
| JAMF.MobileDeviceSubset.general.app_analytics | String | The mobile device app analytics. |
| JAMF.MobileDeviceSubset.general.tethered | String | The mobile device tethered status. |
| JAMF.MobileDeviceSubset.general.battery_level | Number | The mobile device battery level. |
| JAMF.MobileDeviceSubset.general.ble_capable | Boolean | Whether the mobile device is BLE capable. |
| JAMF.MobileDeviceSubset.general.device_locator_service_enabled | Boolean | Whether the mobile device locator service is enabled. |
| JAMF.MobileDeviceSubset.general.do_not_disturb_enabled | Boolean | Whether the mobile device do not disturb is enabled. |
| JAMF.MobileDeviceSubset.general.cloud_backup_enabled | Boolean | Whether the mobile device cloud backup is enabled. |
| JAMF.MobileDeviceSubset.general.last_cloud_backup_date_epoch | Date | The mobie device last cloud update backup date in epoch format. |
| JAMF.MobileDeviceSubset.general.last_cloud_backup_date_utc | Date | The mobie device last cloud update backup date in UTC format. |
| JAMF.MobileDeviceSubset.general.location_services_enabled | Boolean | Whether the mobile device location services is enabled. |
| JAMF.MobileDeviceSubset.general.itunes_store_account_is_active | Boolean | Whether the mobile device iTunes store account is enabled. |
| JAMF.MobileDeviceSubset.general.last_backup_time_epoch | Number | The mobile device last backup time in epoch format. |
| JAMF.MobileDeviceSubset.general.last_backup_time_utc | String | The mobile device last backup time in UTC format. |
| JAMF.MobileDeviceSubset.general.site.id | Number | The mobile device site ID. |
| JAMF.MobileDeviceSubset.general.site.name | String | The mobile device site name. |
Command Example
!jamf-get-mobile-device-general-subset identifier=id identifier_value=1
Context Example
{
"JAMF": {
"MobileDeviceSubset": {
"mobiledevice": {
"general": {
"app_analytics": "Not Enabled",
"asset_tag": "",
"available": 9341,
"available_mb": 9341,
"battery_level": 72,
"ble_capable": true,
"bluetooth_mac_address": "B0:65:BD:4E:50:2A",
"capacity": 12495,
"capacity_mb": 12495,
"cloud_backup_enabled": true,
"device_locator_service_enabled": false,
"device_name": "Device 71",
"device_ownership_level": "Institutional",
"diagnostic_submission": "Not Enabled",
"display_name": "Device 71",
"do_not_disturb_enabled": false,
"enrollment_method": "",
"exchange_activesync_device_identifier": "",
"id": 1,
"initial_entry_date_epoch": 1617021510106,
"initial_entry_date_utc": "2021-03-29T12:38:30.106+0000",
"ip_address": "71.13.172.131",
"itunes_store_account_is_active": true,
"last_backup_time_epoch": 0,
"last_backup_time_utc": "",
"last_cloud_backup_date_epoch": 1412270303000,
"last_cloud_backup_date_utc": "2014-10-02T17:18:23.000+0000",
"last_enrollment_epoch": 0,
"last_enrollment_utc": "",
"last_inventory_update": "Monday, March 29 2021 at 12:38 PM",
"last_inventory_update_epoch": 1617021510710,
"last_inventory_update_utc": "2021-03-29T12:38:30.710+0000",
"location_services_enabled": false,
"managed": true,
"mdm_profile_expiration_epoch": 0,
"mdm_profile_expiration_utc": "",
"model": "iPad 3rd Generation (Wi-Fi)",
"modelDisplay": "iPad 3rd Generation (Wi-Fi)",
"model_display": "iPad 3rd Generation (Wi-Fi)",
"model_identifier": "iPad3,1",
"model_number": "MD333LL",
"modem_firmware": "",
"name": "Device 71",
"os_build": "12A405",
"os_type": "iOS",
"os_version": "8.0.2",
"percentage_used": 25,
"phone_number": "",
"serial_number": "CA44F4D060A3",
"shared": "No",
"site": {
"id": -1,
"name": "None"
},
"supervised": false,
"tethered": "",
"udid": "ca44f4c660a311e490b812df261f2c7e",
"wifi_mac_address": "B0:65:BD:4E:50:5D"
},
"id": 1
}
}
}
}
Human Readable Output
Jamf mobile device General subset result
Bluetooth MAC address ID IP address Managed Model Model Number Name Serial Number Supervised UDID WIFI MAC address B0:65:BD:4E:50:2A 1 71.13.172.131 true iPad 3rd Generation (Wi-Fi) MD333LL Device 71 CA44F4D060A3 false ca44f4c660a311e490b812df261f2c7e B0:65:BD:4E:50:5D
jamf-get-mobile-device-location-subset
Returns the location subset for a specific mobile device according to the given arguments.
Base Command
jamf-get-mobile-device-location-subset
Required Permissions
Jamf Pro Server Objects → Mobile Devices → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDeviceSubset.id | String | The mobile device ID. |
| JAMF.MobileDeviceSubset.location.username | String | The mobile device username. |
| JAMF.MobileDeviceSubset.location.realname | String | The mobile device real name. |
| JAMF.MobileDeviceSubset.location.real_name | String | The mobile device real name. |
| JAMF.MobileDeviceSubset.location.email_address | String | The mobile device email address. |
| JAMF.MobileDeviceSubset.location.position | String | The mobile device position. |
| JAMF.MobileDeviceSubset.location.phone | String | The mobile device phone number. |
| JAMF.MobileDeviceSubset.location.phone_number | String | The mobile device phone number. |
| JAMF.MobileDeviceSubset.location.department | String | The mobile device department. |
| JAMF.MobileDeviceSubset.location.building | String | The mobile device building. |
| JAMF.MobileDeviceSubset.location.room | String | The mobile device room. |
Command Example
!jamf-get-mobile-device-location-subset identifier=id identifier_value=1
Context Example
{
"JAMF": {
"MobileDeviceSubset": {
"mobiledevice": {
"id": 1,
"location": {
"building": "",
"department": "",
"email_address": "User28@email.com",
"phone": "612-605-6625",
"phone_number": "612-605-6625",
"position": "",
"real_name": "User 28",
"realname": "User 28",
"room": "315 Graham Ave",
"username": "user28"
}
}
}
}
}
Human Readable Output
Jamf mobile device Location subset result
Email Address Phone Real Name Room Username User28@email.com 612-605-6625 User 28 315 Graham Ave user28
jamf-get-mobile-device-purchasing-subset
Returns the purchasing subset for a specific mobile device according to the given arguments.
Base Command
jamf-get-mobile-device-purchasing-subset
Required Permissions
Jamf Pro Server Objects → Mobile Devices → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDeviceSubset.id | String | The mobile device ID. |
| JAMF.MobileDeviceSubset.purchasing.is_purchased | Boolean | Whether the mobile device is purchased. |
| JAMF.MobileDeviceSubset.purchasing.is_leased | Boolean | Whether the mobile device is leased. |
| JAMF.MobileDeviceSubset.purchasing.po_number | String | The mobile device PO number. |
| JAMF.MobileDeviceSubset.purchasing.vendor | String | The mobile device vendor. |
| JAMF.MobileDeviceSubset.purchasing.applecare_id | String | The mobile device AppleCare ID. |
| JAMF.MobileDeviceSubset.purchasing.purchase_price | String | The mobile device purchase price. |
| JAMF.MobileDeviceSubset.purchasing.purchasing_account | String | The mobile device purchase account. |
| JAMF.MobileDeviceSubset.purchasing.po_date | String | The mobile device purchase PO date. |
| JAMF.MobileDeviceSubset.purchasing.po_date_epoch | Number | The mobile device purchase PO date in epoch format. |
| JAMF.MobileDeviceSubset.purchasing.po_date_utc | String | The mobile device purchase PO date in UTC format. |
| JAMF.MobileDeviceSubset.purchasing.warranty_expires | String | The mobile device warranty expiration date. |
| JAMF.MobileDeviceSubset.purchasing.warranty_expires_epoch | Number | The mobile device warranty expiration date in epoch format. |
| JAMF.MobileDeviceSubset.purchasing.warranty_expires_utc | String | The mobile device warranty expiration date in UTC format. |
| JAMF.MobileDeviceSubset.purchasing.lease_expires | String | The mobile device lease expiration date. |
| JAMF.MobileDeviceSubset.purchasing.lease_expires_epoch | Number | The mobile device lease expiration date in epoch format. |
| JAMF.MobileDeviceSubset.purchasing.lease_expires_utc | String | The mobile device lease expiration date in UTC format. |
| JAMF.MobileDeviceSubset.purchasing.life_expectancy | Number | The mobile device life expectancy. |
| JAMF.MobileDeviceSubset.purchasing.purchasing_contact | String | The mobile device purchasing contact. |
Command Example
!jamf-get-mobile-device-purchasing-subset identifier=id identifier_value=114
Context Example
{
"JAMF": {
"MobileDeviceSubset": {
"mobiledevice": {
"id": 114,
"purchasing": {
"applecare_id": "",
"attachments": [],
"is_leased": false,
"is_purchased": true,
"lease_expires": "",
"lease_expires_epoch": 0,
"lease_expires_utc": "",
"life_expectancy": 0,
"po_date": "",
"po_date_epoch": 0,
"po_date_utc": "",
"po_number": "",
"purchase_price": "",
"purchasing_account": "",
"purchasing_contact": "",
"vendor": "",
"warranty_expires": "",
"warranty_expires_epoch": 0,
"warranty_expires_utc": ""
}
}
}
}
}
Human Readable Output
Jamf mobile device Purchasing subset result
Is Leased Is Purchased false true
jamf-get-mobile-device-applications-subset
Returns the applications subset for a specific mobile device according to the given arguments.
Base Command
jamf-get-mobile-device-applications-subset
Required Permissions
Jamf Pro Server Objects → Mobile Devices → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDeviceSubset.id | String | The mobile device ID. |
| JAMF.MobileDeviceSubset.applications.application_name | String | The mobile device application name. |
| JAMF.MobileDeviceSubset.applications.application_version | String | The mobile device application version. |
| JAMF.MobileDeviceSubset.applications.application_short_version | String | The mobile device application short version. |
| JAMF.MobileDeviceSubset.applications.identifier | String | The mobile device application ID. |
Command Example
!jamf-get-mobile-device-applications-subset identifier=id identifier_value=114
Context Example
{
"JAMF": {
"MobileDeviceSubset": {
"mobiledevice": {
"applications": [],
"id": 114
}
}
}
}
Human Readable Output
Jamf mobile device Applications subset result
Number of applications 0
jamf-get-mobile-device-security-subset
Returns the security subset for a specific mobile device according to the given arguments.
Base Command
jamf-get-mobile-device-security-subset
Required Permissions
Jamf Pro Server Objects → Mobile Devices → Read
*Jamf Pro Server Actions → Send Mobile Device Lost Mode Command
**Jamf Pro Server Actions → View Mobile Device Lost Mode Location
| *In order to view these fields: | |
|---|---|
| lost_mode_enabled | |
| lost_mode_enforced | |
| lost_mode_enable_issued_epoch | |
| lost_mode_enable_issued_utc | |
| lost_mode_message | |
| lost_mode_phone | |
| lost_mode_footnote |
| ** In order to view these fields (has to be combined with “Send Mobile Device Lost Mode Command” permission) | |
|---|---|
| lost_location_epoch | |
| lost_location_utc | |
| lost_location_latitude | |
| lost_location_longitude | |
| lost_location_altitude | |
| lost_location_speed | |
| lost_location_course | |
| lost_location_horizontal_accuracy | |
| lost_location_vertical_accuracy |
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDeviceSubset.id | String | The mobile device ID. |
| JAMF.MobileDeviceSubset.security.data_protection | Boolean | If the mobile device has data protection. |
| JAMF.MobileDeviceSubset.security.block_level_encryption_capable | Boolean | If the mobile device is block level encryption capable. |
| JAMF.MobileDeviceSubset.security.file_level_encryption_capable | Boolean | If the mobile device is file level encryption capable. |
| JAMF.MobileDeviceSubset.security.passcode_present | Boolean | Whether the mobile device has a passcode present. |
| JAMF.MobileDeviceSubset.security.passcode_compliant | Boolean | Whether the mobile device is passcode compliant. |
| JAMF.MobileDeviceSubset.security.passcode_compliant_with_profile | Boolean | Whether the mobile device is passcode compliant with profile. |
| JAMF.MobileDeviceSubset.security.passcode_lock_grace_period_enforced | String | The mobile device passcode lock grace period enforced. |
| JAMF.MobileDeviceSubset.security.hardware_encryption | Number | The mobile device hardware encryption. |
| JAMF.MobileDeviceSubset.security.activation_lock_enabled | Boolean | Whether the mobile device has activation lock enabled. |
| JAMF.MobileDeviceSubset.security.jailbreak_detected | String | The mobile device security jailbreak detected. |
| JAMF.MobileDeviceSubset.security.lost_mode_enabled | String | The mobile device lost mode. |
| JAMF.MobileDeviceSubset.security.lost_mode_enforced | Boolean | Whether the mobile device has lost mode enforced. |
| JAMF.MobileDeviceSubset.security.lost_mode_enable_issued_epoch | Date | The mobile device lost mode enable issued date in epoch. |
| JAMF.MobileDeviceSubset.security.lost_mode_enable_issued_utc | Date | The mobile device lost mode enable issued date in UTC format. |
| JAMF.MobileDeviceSubset.security.lost_mode_message | String | The mobile device lost mode message. |
| JAMF.MobileDeviceSubset.security.lost_mode_phone | String | The mobile device lost mode phone. |
| JAMF.MobileDeviceSubset.security.lost_mode_footnote | String | The mobile device lost mode footnote. |
| JAMF.MobileDeviceSubset.security.lost_location_epoch | Date | The mobile device lost location date in epoch format. |
| JAMF.MobileDeviceSubset.security.lost_location_utc | Date | The mobile device lost location date in UTC format. |
| JAMF.MobileDeviceSubset.security.lost_location_latitude | Number | The mobile device security lost location latitude. |
| JAMF.MobileDeviceSubset.security.lost_location_longitude | Number | The mobile device security lost location longitude. |
| JAMF.MobileDeviceSubset.security.lost_location_altitude | Number | The mobile device security lost location altitude. |
| JAMF.MobileDeviceSubset.security.lost_location_speed | Number | The mobile device security lost location speed. |
| JAMF.MobileDeviceSubset.security.lost_location_course | Number | The mobile device security lost location course. |
| JAMF.MobileDeviceSubset.security.lost_location_horizontal_accuracy | Number | The mobile device security lost location horizontal accuracy. |
| JAMF.MobileDeviceSubset.security.lost_location_vertical_accuracy | Number | The mobile device security lost location vertical accuracy. |
Command Example
!jamf-get-mobile-device-security-subset identifier=id identifier_value=114
Context Example
{
"JAMF": {
"MobileDeviceSubset": {
"mobiledevice": {
"id": 114,
"security": {
"activation_lock_enabled": true,
"block_level_encryption_capable": true,
"data_protection": true,
"file_level_encryption_capable": true,
"hardware_encryption": 3,
"jailbreak_detected": "Unknown",
"lost_location_altitude": -1,
"lost_location_course": -1,
"lost_location_epoch": 1624265477602,
"lost_location_horizontal_accuracy": -1,
"lost_location_latitude": 0,
"lost_location_longitude": 0,
"lost_location_speed": -1,
"lost_location_utc": "2021-06-21T08:51:17.602+0000",
"lost_location_vertical_accuracy": -1,
"lost_mode_enable_issued_epoch": 1620740433498,
"lost_mode_enable_issued_utc": "2021-05-11T13:40:33.498+0000",
"lost_mode_enabled": "Unsupervised Device",
"lost_mode_enforced": false,
"lost_mode_footnote": "",
"lost_mode_message": "",
"lost_mode_phone": "",
"passcode_compliant": true,
"passcode_compliant_with_profile": true,
"passcode_lock_grace_period_enforced": "Immediate",
"passcode_present": true
}
}
}
}
}
Human Readable Output
Jamf mobile device Security subset result
Activation Lock Enabled Block Level Encryption Capable Data Protection File Level Encryption Capable Hardware Encryption Jailbreak Detected Lost Mode Enable Issued UTC Lost Mode Enabled Lost Mode Enforced Passcode Compliant Passcode Lock Grace Period Enforced Passcode Present Phone true true true true 3 Unknown 2021-05-11T13:40:33.498+0000 Unsupervised Device false true Immediate true true
jamf-get-mobile-device-network-subset
Returns the network subset for a specific mobile device according to the given arguments.
Base Command
jamf-get-mobile-device-network-subset
Required Permissions
Jamf Pro Server Objects → Mobile Devices → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDeviceSubset.id | String | The mobile device ID. |
| JAMF.MobileDeviceSubset.network.home_carrier_network | String | The mobile device home carrier network. |
| JAMF.MobileDeviceSubset.network.cellular_technology | String | The mobile device cellular technology. |
| JAMF.MobileDeviceSubset.network.voice_roaming_enabled | String | The mobile device voice roaming enabled. |
| JAMF.MobileDeviceSubset.network.imei | String | The mobile device network IMEI. |
| JAMF.MobileDeviceSubset.network.iccid | String | The mobile device network ICCID. |
| JAMF.MobileDeviceSubset.network.meid | String | The mobile device network MEID. |
| JAMF.MobileDeviceSubset.network.current_carrier_network | String | The mobile device current carrier network. |
| JAMF.MobileDeviceSubset.network.carrier_settings_version | String | The mobile device network carrier settings version. |
| JAMF.MobileDeviceSubset.network.current_mobile_country_code | String | The mobile device current mobile country code. |
| JAMF.MobileDeviceSubset.network.current_mobile_network_code | String | The mobile device current mobile network code. |
| JAMF.MobileDeviceSubset.network.home_mobile_country_code | String | The mobile device home mobile country code. |
| JAMF.MobileDeviceSubset.network.home_mobile_network_code | String | The mobile device home mobile network code. |
| JAMF.MobileDeviceSubset.network.data_roaming_enabled | Boolean | Whether the mobile device has data roaming enabled. |
| JAMF.MobileDeviceSubset.network.roaming | Boolean | Whether the mobile device has network roaming. |
| JAMF.MobileDeviceSubset.network.phone_number | String | The mobile device network phone number. |
Command Example
!jamf-get-mobile-device-network-subset identifier=id identifier_value=114
Context Example
{
"JAMF": {
"MobileDeviceSubset": {
"mobiledevice": {
"id": 114,
"network": {
"carrier_settings_version": "",
"cellular_technology": "Both",
"current_carrier_network": "",
"current_mobile_country_code": "",
"current_mobile_network_code": "",
"data_roaming_enabled": false,
"home_carrier_network": "",
"home_mobile_country_code": "",
"home_mobile_network_code": "",
"iccid": "",
"imei": "35 727309 398808 9",
"meid": "35727309398808",
"phone_number": "",
"roaming": false,
"voice_roaming_enabled": "No"
}
}
}
}
}
Human Readable Output
Jamf mobile device Network subset result
Cellular Technology Data Roaming Enabled Imei Meid Voice_roaming_enabled Both false 35 727309 398808 9 35727309398808 No
jamf-get-mobile-device-certificates-subset
Returns the certificates subset for a specific mobile device according to the given arguments.
Base Command
jamf-get-mobile-device-certificates-subset
Required Permissions
Jamf Pro Server Objects → Mobile Devices → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDeviceSubset.id | String | The mobile device ID. |
| JAMF.MobileDeviceSubset.certificates.size | String | The mobile device certificates size. |
| JAMF.MobileDeviceSubset.certificates.certificate.common_name | String | The mobile device certificate common name. |
| JAMF.MobileDeviceSubset.certificates.certificate.identity | Boolean | Whether this is an identity certificate. |
Command Example
!jamf-get-mobile-device-certificates-subset identifier=id identifier_value=114
Context Example
{
"JAMF": {
"MobileDeviceSubset": {
"mobiledevice": {
"certificates": [
{
"common_name": "F53DA0E7-9CEC-436E-90A4-0128769F5A2A",
"expires_epoch": "1683813623000",
"expires_utc": "2023-05-11T14:00:23.000+0000",
"identity": true
},
{
"common_name": "Palo Alto Networks JSS Built-in Certificate Authority",
"expires_epoch": "1930290855000",
"expires_utc": "2031-03-03T07:54:15.000+0000",
"identity": false
}
],
"id": 114
}
}
}
}
Human Readable Output
Jamf mobile device Certificates subset result
Common Name Expires Epoch Expires UTC Identity F53DA0E7-9CEC-436E-90A4-0128769F5A2A 1683813623000 2023-05-11T14:00:23.000+0000 true Palo Alto Networks JSS Built-in Certificate Authority 1930290855000 2031-03-03T07:54:15.000+0000 false
jamf-get-mobile-device-provisioning-profiles-subset
Returns the provisioning profiles subset for a specific mobile device according to the given arguments.
Base Command
jamf-get-mobile-device-provisioning-profiles-subset
Required Permissions
Jamf Pro Server Objects → Mobile Devices → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDeviceSubset.id | String | The mobile device ID. |
| JAMF.MobileDeviceSubset.provisioning_profiles.size | Number | The mobile device provisioning profiles size. |
| JAMF.MobileDeviceSubset.provisioning_profiles.mobile_device_provisioning_profile.display_name | String | The mobile device provisioning profiles display name. |
| JAMF.MobileDeviceSubset.provisioning_profiles.mobile_device_provisioning_profile.expiration_date | String | The mobile device provisioning profiles expiration date. |
| JAMF.MobileDeviceSubset.provisioning_profiles.mobile_device_provisioning_profile.expiration_date_epoch | Number | The mobile device provisioning profiles expiration date in epoch format. |
| JAMF.MobileDeviceSubset.provisioning_profiles.mobile_device_provisioning_profile.expiration_date_utc | String | The mobile device provisioning profiles expiration date in UTC format. |
| JAMF.MobileDeviceSubset.provisioning_profiles.mobile_device_provisioning_profile.uuid | String | The mobile device provisioning profiles UUID. |
Command Example
!jamf-get-mobile-device-provisioning-profiles-subset identifier=id identifier_value=114
Context Example
{
"JAMF": {
"MobileDeviceSubset": {
"mobiledevice": {
"id": 114,
"provisioning_profiles": []
}
}
}
}
Human Readable Output
Jamf mobile device ProvisioningProfiles subset result
No entries.
jamf-get-mobile-device-configuration-profiles-subset
Returns the configuration profiles subset for a specific mobile device according to the given arguments.
Base Command
jamf-get-mobile-device-configuration-profiles-subset
Required Permissions
Jamf Pro Server Objects → Mobile Devices → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDeviceSubset.id | String | The mobile device ID. |
| JAMF.MobileDeviceSubset.configuration_profiles.size | Number | The mobile device configuration profiles size. |
| JAMF.MobileDeviceSubset.configuration_profiles.configuration_profile.display_name | String | The mobile device configuration profiles display name. |
| JAMF.MobileDeviceSubset.configuration_profiles.configuration_profile.version | String | The mobile device configuration profiles version. |
| JAMF.MobileDeviceSubset.configuration_profiles.configuration_profile.identifier | Number | The mobile device configuration profiles identifier. |
| JAMF.MobileDeviceSubset.configuration_profiles.configuration_profile.uuid | String | The mobile device configuration profiles UUID. |
Command Example
!jamf-get-mobile-device-configuration-profiles-subset identifier=id identifier_value=114
Context Example
{
"JAMF": {
"MobileDeviceSubset": {
"mobiledevice": {
"configuration_profiles": [
{
"display_name": "MDM Profile",
"identifier": "00000000-0000-0000-A000-4A414D460003",
"uuid": "00000000-0000-0000-A000-4A414D460003",
"version": "1"
}
],
"id": 114
}
}
}
}
Human Readable Output
Jamf mobile device ConfigurationProfiles subset result
Display Name identifier uuid version MDM Profile 00000000-0000-0000-A000-4A414D460003 00000000-0000-0000-A000-4A414D460003 1
jamf-get-mobile-device-groups-subset
Returns the mobile device groups subset for a specific mobile device according to the given arguments.
Base Command
jamf-get-mobile-device-groups-subset
Required Permissions
Jamf Pro Server Objects → Mobile Devices → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDeviceSubset.id | String | The mobile device ID. |
| JAMF.MobileDeviceSubset.mobile_device_groups.id | Number | The mobile device group ID. |
| JAMF.MobileDeviceSubset.mobile_device_groups.name | String | The mobile device group name. |
Command Example
!jamf-get-mobile-device-groups-subset identifier=id identifier_value=114
Context Example
{
"JAMF": {
"MobileDeviceSubset": {
"mobiledevice": {
"id": 114,
"mobile_device_groups": []
}
}
}
}
Human Readable Output
Jamf mobile device MobileDeviceGroups subset result
Number of groups 0
jamf-get-mobile-device-extension-attributes-subset
Returns the extension attributes subset for a specific mobile device according to the given arguments.
Base Command
jamf-get-mobile-device-extension-attributes-subset
Required Permissions
Jamf Pro Server Objects → Mobile Devices → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| identifier | The identifier used to determine which computer is requested. Possible values: “id”, “name”, “udid”, “serialnumber”, and “macaddress”. Possible values are: id, name, udid, serialnumber, macaddress. | Required |
| identifier_value | The value of the “identifier”. For example, if you choose the “id” identifier, a computer ID should be passed. If you choose “macaddress” as the identifier, a computer’s MAC address should be passed, etc. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDeviceSubset.id | String | The mobile device ID. |
| JAMF.MobileDeviceSubset.extension_attributes.id | Number | The mobile device extension attribute ID. |
| JAMF.MobileDeviceSubset.extension_attributes.name | String | The mobile device extension attribute name. |
| JAMF.MobileDeviceSubset.extension_attributes.type | String | The mobile device extension attribute type. |
| JAMF.MobileDeviceSubset.extension_attributes.multi_value | Boolean | The mobile device extension attribute multi value. |
| JAMF.MobileDeviceSubset.extension_attributes.value | String | The mobile device extension attribute value. |
Command Example
!jamf-get-mobile-device-extension-attributes-subset identifier=id identifier_value=114
Context Example
{
"JAMF": {
"MobileDeviceSubset": {
"mobiledevice": {
"extension_attributes": [
{
"id": 9,
"multi_value": false,
"name": "Asset Selector",
"type": "String",
"value": ""
},
{
"id": 4,
"multi_value": false,
"name": "rang",
"type": "String",
"value": ""
},
{
"id": 6,
"multi_value": false,
"name": "rangal",
"type": "String",
"value": ""
},
{
"id": 1,
"multi_value": false,
"name": "risk_test",
"type": "String",
"value": ""
},
{
"id": 2,
"multi_value": false,
"name": "Sample",
"type": "String",
"value": ""
},
{
"id": 5,
"multi_value": false,
"name": "Sample2",
"type": "String",
"value": ""
},
{
"id": 3,
"multi_value": false,
"name": "Sample4",
"type": "String",
"value": ""
},
{
"id": 7,
"multi_value": false,
"name": "Yuval Shapria",
"type": "String",
"value": ""
},
{
"id": 8,
"multi_value": false,
"name": "Yuval Shapria",
"type": "String",
"value": ""
}
],
"id": 114
}
}
}
}
Human Readable Output
Jamf mobile device ExtensionAttributes subset result
ID Name Type Value 9 Asset Selector String false 4 rang String false 6 rangal String false 1 risk_test String false 2 Sample String false 5 Sample2 String false 3 Sample4 String false 7 Yuval Shapria String false 8 Yuval Shapria String false
jamf-get-computers-by-application
Returns a list of computers with basic information on each.
Base Command
jamf-get-computers-by-application
Required Permissions
Jamf Pro Server Objects → Advanced Computer Searches → Read
Input
| Argument Name | Description | Required |
|---|---|---|
| application | The application’s name (supports wildcards). | Required |
| version | The application’s version (supports wildcards). Applicable only when “application” parameter value is set. | Optional |
| limit | Maximum number of devices to retrieve. (Maximal value is 200). Default is 50. | Optional |
| page | The number of the requested page. Default is 0. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.ComputersByApp.Computer.id | Number | The computer ID. |
| JAMF.ComputersByApp.Computer.name | String | The computer name. |
| JAMF.ComputersByApp.Computer.udid | String | The computer UDID. |
| JAMF.ComputersByApp.Computer.serial_number | String | The computer serial number. |
| JAMF.ComputersByApp.Computer.mac_address | String | The computer MAC address. |
| JAMF.ComputersByApp.Application | String | The application the user serched for. |
| JAMF.ComputersByApp.Paging.total_results | Number | The number of computers returned in this specific search. |
| JAMF.ComputersByApp.Paging.page_size | Number | The number of computers to be returned on each page. |
| JAMF.ComputersByApp.Paging.current_page | Number | The number of the requested page. |
Command Example
!jamf-get-computers-by-application application=safar* limit=3
Context Example
{
"JAMF": {
"ComputersByApp": {
"Paging": {
"current_page": 0,
"page_size": 3,
"total_results": 96
},
"application": "safar*",
"computers": [
{
"id": 69,
"mac_address": "B8:E8:56:22:12:3E",
"name": "Computer 54",
"serial_number": "CA41014A60A3",
"udid": "CA410140-60A3-11E4-90B8-12DF261F2C7E"
},
{
"id": 25,
"mac_address": "40:6C:8F:1A:4B:10",
"name": "Computer 67",
"serial_number": "CA40EE4460A3",
"udid": "CA40EE3A-60A3-11E4-90B8-12DF261F2C7E"
},
{
"id": 24,
"mac_address": "00:88:65:41:14:B0",
"name": "Computer 31",
"serial_number": "CA40E50C60A3",
"udid": "CA40E502-60A3-11E4-90B8-12DF261F2C7E"
}
]
}
}
}
Human Readable Output
Paging for get mobile devices
Current Page Page Size Total Results 0 3 96
Jamf computers by application result
Sum of computers version 2 14.0.3 1 7.0 1 7.0.1
jamf-mobile-device-lost-mode
This is a beta command
This is a beta command - couldn’t be tested due to technical limitations. Enables “lost mode” on a specific device. Lost Mode is a feature that allows you to lock a mobile device and track the device’s location. The device reports the GPS coordinates of the point where the device received the command. This feature adds additional protection to mobile devices and their data in the event that a device is lost or stolen.
Base Command
jamf-mobile-device-lost-mode
Required Permissions
Jamf Pro Server Actions → Send Mobile Device Lost Mode Command
Jamf Pro Server Objects → Mobile Devices → Create
Input
| Argument Name | Description | Required |
|---|---|---|
| id | The mobile device’s ID. | Required |
| lost_mode_message | A message that is displayed on the device’s lock screen. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDeviceCommands.name | String | The mobile device command name. |
| JAMF.MobileDeviceCommands.status | String | The mobile device command status. |
| JAMF.MobileDeviceCommands.management_id | String | The mobile device command management ID. |
| JAMF.MobileDeviceCommands.id | String | The mobile device command ID. |
Command Example
jamf-mobile-device-lost-mode id=114
Human Readable Output
Computer 114 locked successfully
jamf-mobile-device-erase
This is a beta command
This is a beta command - couldn’t be tested due to technical limitations. Permanently erases all data on the device and deactivates the device.
Base Command
jamf-mobile-device-erase
Required Permissions
Jamf Pro Server Actions → Send Mobile Device Remote Wipe Command
Jamf Pro Server Objects → Mobile Devices → Create
Input
| Argument Name | Description | Required |
|---|---|---|
| id | The device’s ID. | Required |
| preserve_data_plan | Whether to retain cellular data plans (iOS 11 or later). Possible values are: True, False. Default is False. | Optional |
| clear_activation_code | Whether to clear activation lock on the device. Possible values are: True, False. Default is False. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.MobileDeviceCommands.name | String | The mobile device command name. |
| JAMF.MobileDeviceCommands.status | String | The mobile device command status. |
| JAMF.MobileDeviceCommands.management_id | String | The mobile device command managment ID. |
| JAMF.MobileDeviceCommands.id | String | The mobile device command ID. |
Command Example
jamf-mobile-device-erase id=114
Human Readable Output
Computer 114 erased successfully
endpoint
Returns information about an endpoint.
Base Command
endpoint
Input
| Argument Name | Description | Required |
|---|---|---|
| id | The endpoint ID. | Optional |
| ip | The endpoint IP address. | Optional |
| hostname | The endpoint hostname. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| Endpoint.Hostname | String | The endpoint’s hostname. |
| Endpoint.OS | String | The endpoint’s operating system. |
| Endpoint.IPAddress | String | The endpoint’s IP address. |
| Endpoint.ID | String | The endpoint’s ID. |
| Endpoint.Status | String | The endpoint’s status. |
| Endpoint.IsIsolated | String | The endpoint’s isolation status. |
| Endpoint.MACAddress | String | The endpoint’s MAC address. |
| Endpoint.Vendor | String | The integration name of the endpoint vendor. |
Command Example
!endpoint id=138
Context Example
{
"Endpoint": {
"Hostname": "test MacBook Pro",
"ID": 138,
"MACAddress": "F0:18:98:3F:DB:8E",
"OS": "Mac",
"Vendor": "JAMF v2"
}
}
Human Readable Output
Cortex XDR Endpoint
Hostname ID MACAddress OS Vendor test MacBook Pro 138 F0:18:98:3F:DB:8E Mac JAMF v2
jamf-get-mobile-configuration-profiles-by-id
Returns the configuration profiles subset for a specific mobile device according to the given arguments.
Base Command
jamf-get-mobile-configuration-profiles-by-id
Input
| Argument Name | Description | Required |
|---|---|---|
| id | The ID of the mobile device. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.Mobile.ProfileConfiguration.general.id | Number | The ID of the configuration profile. |
| JAMF.Mobile.ProfileConfiguration.general.name | String | The name of the configuration profile. |
| JAMF.Mobile.ProfileConfiguration.general.description | String | The mobile device configuration description. |
| JAMF.Mobile.ProfileConfiguration.general.level | String | Level of the configuration profile (System or User). |
| JAMF.Mobile.ProfileConfiguration.general.site | String | Site of the configuration profile. |
| JAMF.Mobile.ProfileConfiguration.general.category | String | Category of the configuration profile. |
| JAMF.Mobile.ProfileConfiguration.general.uuid | String | Unique identifier of the mobile profile configuration. |
| JAMF.Mobile.ProfileConfiguration.general.deployment_method | String | Install Automatically or Make Available in Self Service. |
| JAMF.Mobile.ProfileConfiguration.general.payloads | String | Payloads of the configuration profile for Mobile device. |
| JAMF.Mobile.ProfileConfiguration.scope | String | Scope object of the configuration profile. |
| JAMF.Mobile.ProfileConfiguration.self_service | String | Self-service object of the configuration profile. |
jamf-get-computer-configuration-profiles-by-id
Returns the configuration profiles subset for a specific mobile device according to the given arguments.
Base Command
jamf-get-computer-configuration-profiles-by-id
Input
| Argument Name | Description | Required |
|---|---|---|
| id | The ID of the mobile device. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| JAMF.OSX.ProfileConfiguration.general.id | Number | The ID of the configuration profile. |
| JAMF.OSX.ProfileConfiguration.general.name | String | The name of the configuration profile. |
| JAMF.OSX.ProfileConfiguration.general.description | unknown | The mobile device configuration description. |
| JAMF.OSX.ProfileConfiguration.general.level | String | Level of the configuration profile (System or User). |
| JAMF.OSX.ProfileConfiguration.general.site | String | Site of the configuration profile. |
| JAMF.OSX.ProfileConfiguration.general.category | String | Category of the configuration profile. |
| JAMF.OSX.ProfileConfiguration.general.uuid | String | Unique identifier of the mobile profile configuration. |
| JAMF.OSX.ProfileConfiguration.general.distribution_method | String | Install Automatically or Make Available in Self Service. |
| JAMF.OSX.ProfileConfiguration.general.payloads | String | Payloads of the configuration profile for OSX device. |
| JAMF.OSX.ProfileConfiguration.scope | String | Scope object of the configuration profile. |
| JAMF.OSX.ProfileConfiguration.self_service | String | Self-service object of the configuration profile. |
Configuration parameters
url— Server URL (required)credentials— Usernameclient_credentials— Client IDinsecure— Trust any certificate (not secure)proxy— Use system proxy settings
Commands (43)
-
endpointReturns information about an endpoint.
-
jamf-computer-eraseDeprecatedDeprecated. Sends the “EraseDevice'' command to a computer. Permanently erases all the data on the computer and sets a passcode when required by the computer hardware type.
-
jamf-computer-lockSends the "DeviceLock" command to a computer. This command logs the user out of the computer, restarts the computer, and then locks the computer. Optional: Displays a message on the computer when it locks.
-
jamf-get-computer-by-idReturns the "general" subset of a specific computer, e.g.: name, MAC address, IP, serial number, UDID, etc.
-
jamf-get-computer-by-matchReturns general data for computers that match specific characteristics defined by a filter query.
-
jamf-get-computer-certificates-subsetReturns the certificates subset for a specific computer according to the given arguments.
-
jamf-get-computer-configuration-profiles-by-idReturns the configuration profiles subset for a specific mobile device according to the given arguments.
-
jamf-get-computer-configuration-profiles-subsetReturns the configuration profiles subset for a specific computer according to the given arguments.
-
jamf-get-computer-extension-attributes-subsetReturns the extension attributes subset for a specific computer according to the given arguments.
-
jamf-get-computer-general-subsetReturns the general subset for a specific computer according to the given arguments.
-
jamf-get-computer-groups-accounts-subsetReturns the groups accounts subset for a specific computer according to the given arguments.
-
jamf-get-computer-hardware-subsetReturns the hardware subset for a specific computer according to the given arguments.
-
jamf-get-computer-iphones-subsetDeprecatedReturns the iPhones subset for a specific computer according to the given arguments.
-
jamf-get-computer-location-subsetReturns the location subset for a specific computer according to the given arguments.
-
jamf-get-computer-peripherals-subsetDeprecatedReturns the peripherals subset for a specific computer according to the given arguments.
-
jamf-get-computer-purchasing-subsetReturns the purchasing subset for a specific computer according to the given arguments.
-
jamf-get-computer-security-subsetReturns the security subset for a specific computer according to the given arguments.
-
jamf-get-computer-software-subsetReturns the software subset for a specific computer according to the given arguments.
-
jamf-get-computer-subsetReturns the requested section for a specific computer according to the given arguments.
-
jamf-get-computersReturns a list of all computers with their associated IDs. By default, returns the first 50 computers to the context (ID + name).
-
jamf-get-computers-basic-subsetReturns the “basic” subset for all of the computers. The “basic” subset includes: MAC address, model, UDID, name, department, building, serial number, username, ID.
-
jamf-get-computers-by-applicationReturns a list of computers with basic information on each.
-
jamf-get-mobile-configuration-profiles-by-idReturns the configuration profiles subset for a specific mobile device according to the given arguments.
-
jamf-get-mobile-device-applications-subsetReturns the applications subset for a specific mobile device according to the given arguments.
-
jamf-get-mobile-device-by-idReturns the "general" subset of a specific mobile device, e.g.: name, MAC address, IP, serial number, UDID. etc.
-
jamf-get-mobile-device-by-matchMatches mobile devices by specific characteristics and returns general data on each one of the mobile devices.
-
jamf-get-mobile-device-certificates-subsetReturns the certificates subset for a specific mobile device according to the given arguments.
-
jamf-get-mobile-device-configuration-profiles-subsetReturns the configuration profiles subset for a specific mobile device according to the given arguments.
-
jamf-get-mobile-device-extension-attributes-subsetReturns the extension attributes subset for a specific mobile device according to the given arguments.
-
jamf-get-mobile-device-general-subsetReturns the general subset for a specific mobile device according to the given arguments.
-
jamf-get-mobile-device-groups-subsetReturns the mobile device groups subset for a specific mobile device according to the given arguments.
-
jamf-get-mobile-device-location-subsetReturns the location subset for a specific mobile device according to the given arguments.
-
jamf-get-mobile-device-network-subsetReturns the network subset for a specific mobile device according to the given arguments.
-
jamf-get-mobile-device-provisioning-profiles-subsetReturns the provisioning profiles subset for a specific mobile device according to the given arguments.
-
jamf-get-mobile-device-purchasing-subsetReturns the purchasing subset for a specific mobile device according to the given arguments.
-
jamf-get-mobile-device-security-subsetReturns the security subset for a specific mobile device according to the given arguments.
-
jamf-get-mobile-devicesReturns a list of devices with basic data on each. By default, returns the first 50 devices to the context (ID + name).
-
jamf-get-user-by-emailReturns a specific user with general data about the user according to the given email.
-
jamf-get-user-by-idReturns a specific user with general data about the user according to the given ID.
-
jamf-get-user-by-nameReturns a specific user with general data about the user according to the given name.
-
jamf-get-usersReturns a list of users with their IDs and names. By default, returns the first 50 users to the context (ID + name).
-
jamf-mobile-device-eraseThis is a beta command - couldn't be tested due to technical limitations. Permanently erases all data on the device and deactivates the device.
-
jamf-mobile-device-lost-modeThis is a beta command - couldn't be tested due to technical limitations. Enables “lost mode” on a specific device. Lost Mode is a feature that allows you to lock a mobile device and track the device's location. The device reports the GPS coordinates of the point where the device received the command. This feature adds additional protection to mobile devices and their data in the event that a device is lost or stolen.
category: Endpoint provider: Jamf commonfields: id: jamf v2 version: -1 sectionorder: - Connect configuration: - display: Server URL name: url required: true type: 0 additionalinfo: 'Your server URL (e.g., https://yourdomain.jamfcloud.com)' section: Connect - display: Username name: credentials required: false type: 9 section: Connect - display: Client ID name: client_credentials type: 9 required: false displaypassword: Client Secret section: Connect - display: Trust any certificate (not secure) name: insecure type: 8 required: false section: Connect - display: Use system proxy settings name: proxy type: 8 required: false section: Connect description: Enterprise Mobility Management (EMM) for Apple devices (Mac, iPhone, Apple TV, iPad). Can be used to control various configurations via different policies, install and uninstall applications, lock devices, smart groups searches, and more. display: JAMF v2 name: jamf v2 script: commands: - arguments: - defaultValue: '50' description: The maximum number of results to be returned on each page. The maximum size is 200. name: limit - defaultValue: '0' description: The number of the requested page. name: page description: Returns a list of all computers with their associated IDs. By default, returns the first 50 computers to the context (ID + name). name: jamf-get-computers outputs: - contextPath: JAMF.Computer.id description: The computer ID. type: Number - contextPath: JAMF.Computer.name description: The computer name. type: String - contextPath: JAMF.Computer.Paging.total_results description: The number of computers returned in this specific search. type: Number - contextPath: JAMF.Computer.Paging.page_size description: The number of computers returned on each page. type: Number - contextPath: JAMF.Computer.Paging.current_page description: The number of the requested page. type: Number - arguments: - defaultValue: '50' description: The maximum number of results to be returned on each page. The maximum size is 200. name: limit - defaultValue: '0' description: The number of the requested page. name: page description: 'Returns the “basic” subset for all of the computers. The “basic” subset includes: MAC address, model, UDID, name, department, building, serial number, username, ID.' name: jamf-get-computers-basic-subset outputs: - contextPath: JAMF.Computer.id description: The computer ID. type: Number - contextPath: JAMF.Computer.name description: The computer name. type: String - contextPath: JAMF.Computer.managed description: Whether the computer is managed. type: Boolean - contextPath: JAMF.Computer.username description: The computer username. type: String - contextPath: JAMF.Computer.model description: The computer model. type: String - contextPath: JAMF.Computer.mac_address description: The computer MAC address. type: String - contextPath: JAMF.Computer.udid description: The computer UDID. type: String - contextPath: JAMF.Computer.serial_number description: The computer serial number. type: String - arguments: - description: |- The computer ID. To get the computer ID, run the `jamf-get-computers` command to get all computers names and IDs. name: id required: true description: 'Returns the "general" subset of a specific computer, e.g.: name, MAC address, IP, serial number, UDID, etc.' name: jamf-get-computer-by-id outputs: - contextPath: JAMF.Computer.id description: The computer ID. type: Number - contextPath: JAMF.Computer.name description: The computer name. type: String - contextPath: JAMF.Computer.network_adapter_type description: The computer network adapter type. type: String - contextPath: JAMF.Computer.mac_address description: The computer MAC address. type: Date - contextPath: JAMF.Computer.alt_network_adapter_type description: The computer alt network adapter type. type: String - contextPath: JAMF.Computer.alt_mac_address description: The computer alt MAC address. type: String - contextPath: JAMF.Computer.ip_address description: The computer IP address. type: String - contextPath: JAMF.Computer.last_reported_ip description: The computer last reported IP address. type: String - contextPath: JAMF.Computer.serial_number description: The computer serial number. type: String - contextPath: JAMF.Computer.udid description: The computer UDID. type: String - contextPath: JAMF.Computer.jamf_version description: The computer Jamf version. type: String - contextPath: JAMF.Computer.platform description: The computer platform. type: String - contextPath: JAMF.Computer.barcode_1 description: The computer barcode_1. type: String - contextPath: JAMF.Computer.barcode_2 description: The computer barcode_2. type: String - contextPath: JAMF.Computer.asset_tag description: The computer asset tag. type: String - contextPath: JAMF.Computer.remote_management.managed description: Whether the computer is remotely managed. type: Boolean - contextPath: JAMF.Computer.remote_management.management_username description: The computer remote management username. type: String - contextPath: JAMF.Computer.supervised description: Whether the computer is supervised. type: Boolean - contextPath: JAMF.Computer.mdm_capable description: Whether the computer is enabled for mobile device management (MDM). type: Boolean - contextPath: JAMF.Computer.mdm_capable_users description: The computer has MDM capable users. type: Boolean - contextPath: JAMF.Computer.distribution_point description: The computer distribution point. type: String - contextPath: JAMF.Computer.site.id description: The computer site ID. type: Number - contextPath: JAMF.Computer.site.name description: The computer site name. type: String - contextPath: JAMF.Computer.itunes_store_account_is_active description: The computer iTunes store account. type: Boolean - arguments: - defaultValue: '50' description: The maximum number of results to be returned on each page. The maximum size is 200. name: limit - defaultValue: '0' description: The number of the requested page. name: page - description: 'The filter query for the Pro API (supports RSQL). For example, general.name=="Computer 1*", userAndLocation.email=="user@email.com".' name: filter required: true description: Returns general data for computers that match specific characteristics defined by a filter query. name: jamf-get-computer-by-match outputs: - contextPath: JAMF.Computer.id description: The computer ID. type: Number - contextPath: JAMF.Computer.name description: The computer name. type: String - contextPath: JAMF.Computer.udid description: The computer UDID. type: String - contextPath: JAMF.Computer.serial_number description: The computer serial number. type: String - contextPath: JAMF.Computer.mac_address description: The computer MAC address. type: String - contextPath: JAMF.Computer.alt_mac_address description: The computer alt MAC address. type: String - contextPath: JAMF.Computer.asset_tag description: The computer asset tag. type: String - contextPath: JAMF.Computer.barcode_1 description: The computer barcode 1. type: String - contextPath: JAMF.Computer.barcode_2 description: The computer barcode 2. type: String - contextPath: JAMF.Computer.username description: The computer username. type: String - contextPath: JAMF.Computer.realname description: The computer real name. type: String - contextPath: JAMF.Computer.email description: The computer email address. type: String - contextPath: JAMF.Computer.email_address description: The computer email address. type: String - contextPath: JAMF.Computer.room description: The computer room. type: String - contextPath: JAMF.Computer.position description: The computer position. type: String - contextPath: JAMF.Computer.Paging.total_results description: The number of computers returned in this specific search. type: Number - contextPath: JAMF.Computer.Paging.page_size description: The number of computers to be returned on each page. type: Number - contextPath: JAMF.Computer.Paging.current_page description: The number of the requested page. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the general subset for a specific computer according to the given arguments. name: jamf-get-computer-general-subset outputs: - contextPath: JAMF.ComputerSubset.Computer.general.id description: The computer ID. type: Number - contextPath: JAMF.ComputerSubset.Computer.general.name description: The computer name. type: String - contextPath: JAMF.ComputerSubset.Computer.general.network_adapter_type description: The computer network adapter type. type: String - contextPath: JAMF.ComputerSubset.Computer.general.mac_address description: The computer MAC address. type: Date - contextPath: JAMF.ComputerSubset.Computer.general.alt_network_adapter_type description: The computer alt network adapter type. type: String - contextPath: JAMF.ComputerSubset.Computer.general.alt_mac_address description: The computer alt MAC address. type: String - contextPath: JAMF.ComputerSubset.Computer.general.ip_address description: The computer IP address. type: String - contextPath: JAMF.ComputerSubset.Computer.general.last_reported_ip description: The computer last reported IP address. type: String - contextPath: JAMF.ComputerSubset.Computer.general.serial_number description: The computer serial number. type: String - contextPath: JAMF.ComputerSubset.Computer.general.udid description: The computer UDID. type: String - contextPath: JAMF.ComputerSubset.Computer.general.jamf_version description: The computer Jamf version. type: String - contextPath: JAMF.ComputerSubset.Computer.general.platform description: The computer platform. type: String - contextPath: JAMF.ComputerSubset.Computer.general.barcode_1 description: The computer barcode 1. type: String - contextPath: JAMF.ComputerSubset.Computer.general.barcode_2 description: The computer barcode 2. type: String - contextPath: JAMF.ComputerSubset.Computer.general.asset_tag description: The computer asset tag. type: String - contextPath: JAMF.ComputerSubset.Computer.general.remote_management.managed description: Whether the computer is remotely managed. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.general.remote_management.management_username description: The computer managment username. type: String - contextPath: JAMF.ComputerSubset.Computer.general.supervised description: Whether the computer is supervised. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.general.mdm_capable description: Whether the computer is MDM capable. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.general.mdm_capable_users description: Whether the computer has MDM capable users. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.general.management_status.user_approved_mdm description: Whether the MDM is user-approved. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.general.distribution_point description: The computer distribution point format. type: String - contextPath: JAMF.ComputerSubset.Computer.general.site.id description: The computer site ID. type: Number - contextPath: JAMF.ComputerSubset.Computer.general.site.name description: The computer site name. type: String - contextPath: JAMF.ComputerSubset.Computer.general.itunes_store_account_is_active description: The computer iTunes store account. type: Boolean - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the location subset for a specific computer according to the given arguments. name: jamf-get-computer-location-subset outputs: - contextPath: JAMF.ComputerSubset.Computer.location.username description: The computer username. type: String - contextPath: JAMF.ComputerSubset.Computer.location.realname description: The computer real name. type: String - contextPath: JAMF.ComputerSubset.Computer.location.real_name description: The computer real name. type: String - contextPath: JAMF.ComputerSubset.Computer.location.email_address description: The computer email address. type: String - contextPath: JAMF.ComputerSubset.Computer.location.position description: The computer position. type: String - contextPath: JAMF.ComputerSubset.Computer.location.phone description: The computer phone number. type: String - contextPath: JAMF.ComputerSubset.Computer.location.phone_number description: The computer phone number. type: String - contextPath: JAMF.ComputerSubset.Computer.location.room description: The computer room. type: String - contextPath: JAMF.ComputerSubset.Computer.id description: The computer ID. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the purchasing subset for a specific computer according to the given arguments. name: jamf-get-computer-purchasing-subset outputs: - contextPath: JAMF.ComputerSubset.Computer.purchasing.is_purchased description: If the computer is purchased. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.purchasing.is_leased description: If the computer is leased. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.purchasing.po_number description: The computer PO number. type: String - contextPath: JAMF.ComputerSubset.Computer.purchasing.vendor description: The computer vendor. type: String - contextPath: JAMF.ComputerSubset.Computer.purchasing.applecare_id description: The computer AppleCare ID. type: String - contextPath: JAMF.ComputerSubset.Computer.purchasing.purchase_price description: The computer purchase price. type: String - contextPath: JAMF.ComputerSubset.Computer.purchasing.purchasing_account description: The computer purchase account. type: String - contextPath: JAMF.ComputerSubset.Computer.purchasing.life_expectancy description: The computer life expectancy. type: Number - contextPath: JAMF.ComputerSubset.Computer.purchasing.purchasing_contact description: The computer purchasing contact. type: String - contextPath: JAMF.ComputerSubset.Computer.id description: The computer ID. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the peripherals subset for a specific computer according to the given arguments. name: jamf-get-computer-peripherals-subset deprecated: true outputs: - contextPath: JAMF.ComputerSubset.Computer.peripherals description: The computer peripherals. type: Number - contextPath: JAMF.ComputerSubset.Computer.id description: The computer ID. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the hardware subset for a specific computer according to the given arguments. name: jamf-get-computer-hardware-subset outputs: - contextPath: JAMF.ComputerSubset.Computer.hardware.make description: The computer maker. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.model description: The computer model. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.model_identifier description: The computer model ID. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.os_name description: The computer operating system name. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.os_version description: The computer operating system version. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.os_build description: The computer operating system build. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.active_directory_status description: The computer active directory status. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.processor_type description: The computer processor type. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.processor_architecture description: The computer processor architecture. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.processor_speed description: The computer processor speed. type: Number - contextPath: JAMF.ComputerSubset.Computer.hardware.processor_speed_mhz description: The computer processor speed in MHz. type: Number - contextPath: JAMF.ComputerSubset.Computer.hardware.number_processors description: The number of processors in the computer. type: Number - contextPath: JAMF.ComputerSubset.Computer.hardware.number_cores description: The number of cores in the computer. type: Number - contextPath: JAMF.ComputerSubset.Computer.hardware.total_ram description: The amount of RAM in the computer. type: Number - contextPath: JAMF.ComputerSubset.Computer.hardware.total_ram_mb description: The amount of RAM in the computer in MB. type: Number - contextPath: JAMF.ComputerSubset.Computer.hardware.boot_rom description: The computer boot ROM. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.bus_speed description: The computer bus speed. type: Number - contextPath: JAMF.ComputerSubset.Computer.hardware.bus_speed_mhz description: The computer bus speed in MHz. type: Number - contextPath: JAMF.ComputerSubset.Computer.hardware.battery_capacity description: The computer battery capacity. type: Number - contextPath: JAMF.ComputerSubset.Computer.hardware.cache_size description: The computer cache size. type: Number - contextPath: JAMF.ComputerSubset.Computer.hardware.cache_size_kb description: The computer cache size in KB. type: Number - contextPath: JAMF.ComputerSubset.Computer.hardware.available_ram_slots description: The number of available RAM slots. type: Number - contextPath: JAMF.ComputerSubset.Computer.hardware.optical_drive description: The computer optical drive. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.nic_speed description: The computer NIC speed. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.smc_version description: The compute SMC version. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.ble_capable description: Whether the computer is BLE capable. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.hardware.supports_ios_app_installs description: If the computer supports iOS app installations. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.hardware.sip_status description: The computer SIP status. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.gatekeeper_status description: The computer gatekeeper status. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.xprotect_version description: The computer xprotect version. type: String - contextPath: JAMF.ComputerSubset.Computer.hardware.disk_encryption_configuration description: The computer disk encryption configuration. type: String - contextPath: JAMF.ComputerSubset.Computer.id description: The computer ID. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the certificates subset for a specific computer according to the given arguments. name: jamf-get-computer-certificates-subset outputs: - contextPath: JAMF.ComputerSubset.Computer.certificates.common_name description: The certificat common name. type: String - contextPath: JAMF.ComputerSubset.Computer.certificates.identity description: The certificat identity. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.certificates.expires_utc description: The certificat expiration date in UTC format. type: Date - contextPath: JAMF.ComputerSubset.Computer.certificates.expires_epoch description: The certificat expiration date in epoch format. type: Number - contextPath: JAMF.ComputerSubset.Computer.id description: The computer ID. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the security subset for a specific computer according to the given arguments. name: jamf-get-computer-security-subset outputs: - contextPath: JAMF.ComputerSubset.Computer.security.activation_lock description: The computer activation lock. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.security.secure_boot_level description: The computer secure boot level. type: String - contextPath: JAMF.ComputerSubset.Computer.security.external_boot_level description: The computer external boot level. type: String - contextPath: JAMF.ComputerSubset.Computer.id description: The computer ID. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the software subset for a specific computer according to the given arguments. name: jamf-get-computer-software-subset outputs: - contextPath: JAMF.ComputerSubset.Computer.software.licensed_software.name description: The computer software's licensed software name. type: String - contextPath: JAMF.ComputerSubset.Computer.software.installed_by_installer_swu description: The computer software that was installed either by an installer, an app or a software update. type: String - contextPath: JAMF.ComputerSubset.Computer.software.available_updates.name description: The name of the available updates. type: String - contextPath: JAMF.ComputerSubset.Computer.software.available_updates.version description: The version of the available update. type: String - contextPath: JAMF.ComputerSubset.Computer.software.running_services.name description: The computer running service name. type: String - contextPath: JAMF.ComputerSubset.Computer.software.applications.name description: The computer application name. type: String - contextPath: JAMF.ComputerSubset.Computer.software.applications.path description: The computer application path. type: String - contextPath: JAMF.ComputerSubset.Computer.software.applications.version description: The computer application version. type: String - contextPath: JAMF.ComputerSubset.Computer.software.applications.bundleId description: The computer application bundle ID. type: String - contextPath: JAMF.ComputerSubset.Computer.id description: The computer ID. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the extension attributes subset for a specific computer according to the given arguments. name: jamf-get-computer-extension-attributes-subset outputs: - contextPath: JAMF.ComputerSubset.Computer.extension_attributes.id description: The computer extension attributes ID. type: Number - contextPath: JAMF.ComputerSubset.Computer.extension_attributes.name description: The computer extension attributes name. type: String - contextPath: JAMF.ComputerSubset.Computer.extension_attributes.multi_value description: The computer extension attributes multi value. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.extension_attributes.value description: The computer extension attributes value. type: String - contextPath: JAMF.ComputerSubset.Computer.id description: The computer ID. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the groups accounts subset for a specific computer according to the given arguments. name: jamf-get-computer-groups-accounts-subset outputs: - contextPath: JAMF.ComputerSubset.Computer.groups_accounts.computer_group_memberships description: The computer group memberships. type: String - contextPath: JAMF.ComputerSubset.Computer.groups_accounts.local_accounts.uid description: The computer local account UID. type: String - contextPath: JAMF.ComputerSubset.Computer.groups_accounts.local_accounts.homeDirectory description: The computer local account home. type: String - contextPath: JAMF.ComputerSubset.Computer.groups_accounts.local_accounts.admin description: Whether the computer is the local account administrator. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.id description: The computer ID. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the iPhones subset for a specific computer according to the given arguments. name: jamf-get-computer-iphones-subset deprecated: true outputs: - contextPath: JAMF.ComputerSubset.Computer.iphones description: The commputer related iPhones. type: String - contextPath: JAMF.ComputerSubset.Computer.id description: The computer ID. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the configuration profiles subset for a specific computer according to the given arguments. name: jamf-get-computer-configuration-profiles-subset outputs: - contextPath: JAMF.ComputerSubset.Computer.configuration_profiles.id description: The configuration profile ID. type: Number - contextPath: JAMF.ComputerSubset.Computer.configuration_profiles.removable description: If the configuration profile is removable. type: Boolean - contextPath: JAMF.ComputerSubset.Computer.id description: The computer ID. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the specified identifier. For example, if "id" is selected as the identifier, provide the computer ID. If "macaddress" is selected, provide the computer's MAC address. name: identifier_value required: true - auto: PREDEFINED description: The section of the computer to retrieve. name: section predefined: - GENERAL - HARDWARE - OPERATING_SYSTEM - USER_AND_LOCATION - PURCHASING - DISK_ENCRYPTION - SECURITY - SOFTWARE_UPDATES - APPLICATIONS - STORAGE - CONFIGURATION_PROFILES - PRINTERS - SERVICES - LOCAL_USER_ACCOUNTS - CERTIFICATES - ATTACHMENTS - PACKAGE_RECEIPTS - LICENSED_SOFTWARE - IBEACONS - EXTENSION_ATTRIBUTES - CONTENT_CACHING - GROUP_MEMBERSHIPS required: false defaultValue: GENERAL description: Returns the requested section for a specific computer according to the given arguments. name: jamf-get-computer-subset outputs: - contextPath: JAMF.Computer.id description: The computer's ID. type: Number - contextPath: JAMF.Computer.udid description: The computer's UDID. type: String - arguments: - description: A 6-digit passcode to be used to unlock the computer after it was locked. name: passcode required: true secret: true - description: The ID of the computer that you want to lock. name: id required: true - description: A message to display on the locked screen. name: lock_message description: 'Sends the "DeviceLock" command to a computer. This command logs the user out of the computer, restarts the computer, and then locks the computer. Optional: Displays a message on the computer when it locks.' name: jamf-computer-lock outputs: - contextPath: JAMF.ComputerCommand.name description: The command name. type: String - contextPath: JAMF.ComputerCommand.command_uuid description: The command UDID. type: String - contextPath: JAMF.ComputerCommand.computer_id description: The computer ID. type: String compliantpolicies: - EndPoint Isolation - arguments: - description: A 6-digit passcode that locks the computer after being erased. name: passcode required: true secret: true - description: The ID of the computer that you want to erase. name: id required: true description: Deprecated. Sends the “EraseDevice'' command to a computer. Permanently erases all the data on the computer and sets a passcode when required by the computer hardware type. name: jamf-computer-erase outputs: - contextPath: JAMF.ComputerCommand.name description: The command name. type: String - contextPath: JAMF.ComputerCommand.command_uuid description: The command UDID. type: String - contextPath: JAMF.ComputerCommand.computer_id description: The computer ID. type: String deprecated: true - arguments: - defaultValue: '50' description: Maximum number of users to retrieve. The maximal value is 200. name: limit - defaultValue: '0' description: The number of the requested page. name: page description: Returns a list of users with their IDs and names. By default, returns the first 50 users to the context (ID + name). name: jamf-get-users outputs: - contextPath: JAMF.User.id description: The user ID. type: Number - contextPath: JAMF.User.name description: The user name. type: String - contextPath: JAMF.User.Paging.total_results description: The number of users returned in this specific search. type: Number - contextPath: JAMF.User.Paging.page_size description: The number of users to be returned on each page. type: Number - contextPath: JAMF.User.Paging.current_page description: The number of requested page. type: Number - arguments: - description: |- The user ID. To get the user ID, run the `jamf-get-users` command to get all user names and IDs. name: id required: true description: Returns a specific user with general data about the user according to the given ID. name: jamf-get-user-by-id outputs: - contextPath: JAMF.User.id description: The user ID. type: Number - contextPath: JAMF.User.name description: The user name. type: String - contextPath: JAMF.User.full_name description: The user full name. type: String - contextPath: JAMF.User.email description: The user email. type: String - contextPath: JAMF.User.email_address description: The user email address. type: String - contextPath: JAMF.User.phone_number description: The user phone number. type: String - contextPath: JAMF.User.position description: The user position. type: String - contextPath: JAMF.User.managed_apple_id description: The user managed Apple ID. type: String - contextPath: JAMF.User.enable_custom_photo_url description: Whether the user custom photo URL is enabled. type: Boolean - contextPath: JAMF.User.custom_photo_url description: The user custom photo URL. type: String - contextPath: JAMF.User.ldap_server.id description: The user LDAP server ID. type: Number - contextPath: JAMF.User.ldap_server.name description: The user LDAP server name. type: String - contextPath: JAMF.User.extension_attributes.id description: The user extension attributes ID. type: Number - contextPath: JAMF.User.extension_attributes.name description: The user extension attributes name. type: String - contextPath: JAMF.User.extension_attributes.type description: The user extension attributes type. type: String - contextPath: JAMF.User.extension_attributes.value description: The user extension attributes value. type: String - contextPath: JAMF.User.sites.id description: The user's site ID. type: Number - contextPath: JAMF.User.sites.name description: The user's site name. type: String - contextPath: JAMF.User.links.total_vpp_code_count description: The user total VPP code acount. type: Number - contextPath: JAMF.User.links.vpp_assignments.id description: The VPP assignment ID that is linked to the user. type: Number - contextPath: JAMF.User.links.vpp_assignments.name description: The VPP assignment name that is linked to the user. type: String - contextPath: JAMF.User.links.computers.id description: The computer ID that is linked to the user. type: Number - contextPath: JAMF.User.links.computers.name description: The computer name that is linked to the user. type: String - contextPath: JAMF.User.links.peripherals.id description: The peripherals ID that is linked to the user. type: Number - contextPath: JAMF.User.links.peripherals.name description: The peripherals name that is linked to the user. type: String - contextPath: JAMF.User.links.mobile_devices.id description: The mobile device ID that is linked to the user. type: String - contextPath: JAMF.User.links.mobile_devices.name description: The mobile device name that is linked to the user. type: String - contextPath: JAMF.User.user_groups.size description: The user group size. type: Number - contextPath: JAMF.User.user_groups.user_group.id description: The user group ID. type: Number - contextPath: JAMF.User.user_groups.user_group.name description: The user group name. type: String - contextPath: JAMF.User.user_groups.user_group.is_smart description: Whether the user group is smart. type: Boolean - arguments: - description: The user name. name: name required: true description: Returns a specific user with general data about the user according to the given name. name: jamf-get-user-by-name outputs: - contextPath: JAMF.User.id description: The user ID. type: Number - contextPath: JAMF.User.name description: The user name. type: String - contextPath: JAMF.User.full_name description: The user full name. type: String - contextPath: JAMF.User.email description: The user email. type: String - contextPath: JAMF.User.email_address description: The user email address. type: String - contextPath: JAMF.User.phone_number description: The user phone number. type: String - contextPath: JAMF.User.position description: The user position. type: String - contextPath: JAMF.User.managed_apple_id description: The user managed Apple ID. type: String - contextPath: JAMF.User.enable_custom_photo_url description: Whether the user custom photo URL is enabled. type: Boolean - contextPath: JAMF.User.custom_photo_url description: The user custom photo URL. type: String - contextPath: JAMF.User.ldap_server.id description: The user LDAP server ID. type: Number - contextPath: JAMF.User.ldap_server.name description: The user LDAP server name. type: String - contextPath: JAMF.User.extension_attributes.id description: The user extension attributes ID. type: Number - contextPath: JAMF.User.extension_attributes.name description: The user extension attributes name. type: String - contextPath: JAMF.User.extension_attributes.type description: The user extension attributes type. type: String - contextPath: JAMF.User.extension_attributes.value description: The user extension attributes value. type: String - contextPath: JAMF.User.sites.site.id description: The user's site ID. type: Number - contextPath: JAMF.User.sites.site.name description: The user's site name. type: String - contextPath: JAMF.User.links.total_vpp_code_count description: The user total VPP code acount. type: Number - contextPath: JAMF.User.links.vpp_assignments.id description: The VPP assignment ID that is linked to the user. type: Number - contextPath: JAMF.User.links.vpp_assignments.name description: The VPP assignment name that is linked to the user. type: String - contextPath: JAMF.User.links.computers.id description: The computer ID that is linked to the user. type: Number - contextPath: JAMF.User.links.computers.name description: The computer name that is linked to the user. type: String - contextPath: JAMF.User.links.peripherals.id description: The peripherals ID that is linked to the user. type: Number - contextPath: JAMF.User.links.peripherals.name description: The peripherals name that is linked to the user. type: String - contextPath: JAMF.User.links.mobile_devices.id description: The mobile device ID that is linked to the user. type: String - contextPath: JAMF.User.links.mobile_devices.name description: The mobile device name that is linked to the user. type: String - contextPath: JAMF.User.user_groups.size description: The user groups size. type: Number - contextPath: JAMF.User.user_groups.user_group.id description: The user group ID. type: Number - contextPath: JAMF.User.user_groups.user_group.name description: The user group name. type: String - contextPath: JAMF.User.user_groups.user_group.is_smart description: Whether the user group is smart. type: Boolean - arguments: - description: The user email. name: email required: true description: Returns a specific user with general data about the user according to the given email. name: jamf-get-user-by-email outputs: - contextPath: JAMF.User.id description: The user ID. type: Number - contextPath: JAMF.User.name description: The user name. type: String - contextPath: JAMF.User.full_name description: The user full name. type: String - contextPath: JAMF.User.email description: The user email. type: String - contextPath: JAMF.User.email_address description: The user email address. type: String - contextPath: JAMF.User.phone_number description: The user phone number. type: String - contextPath: JAMF.User.position description: The user position. type: String - contextPath: JAMF.User.managed_apple_id description: The user managed Apple ID. type: String - contextPath: JAMF.User.enable_custom_photo_url description: Whether the user custom photo URL is enabled. type: Boolean - contextPath: JAMF.User.custom_photo_url description: The user custom photo URL. type: String - contextPath: JAMF.User.ldap_server.id description: The user LDAP server ID. type: Number - contextPath: JAMF.User.ldap_server.name description: The user LDAP server name. type: String - contextPath: JAMF.User.extension_attributes.id description: The user extension attributes ID. type: Number - contextPath: JAMF.User.extension_attributes.name description: The user extension attributes name. type: String - contextPath: JAMF.User.extension_attributes.type description: The user extension attributes type. type: String - contextPath: JAMF.User.extension_attributes.value description: The user extension attributes value. type: String - contextPath: JAMF.User.sites.site.id description: The user's site ID. type: Number - contextPath: JAMF.User.sites.site.name description: The user's site name. type: String - contextPath: JAMF.User.links.total_vpp_code_count description: The user total VPP code acount. type: Number - contextPath: JAMF.User.links.vpp_assignments.id description: The VPP assignment ID that is linked to the user. type: Number - contextPath: JAMF.User.links.vpp_assignments.name description: The VPP assignment name that is linked to the user. type: String - contextPath: JAMF.User.links.computers.id description: The computer ID that is linked to the user. type: Number - contextPath: JAMF.User.links.computers.name description: The computer name that is linked to the user. type: String - contextPath: JAMF.User.links.peripherals.id description: The peripherals ID that is linked to the user. type: Number - contextPath: JAMF.User.links.peripherals.name description: The peripherals name that is linked to the user. type: String - contextPath: JAMF.User.links.mobile_devices.id description: The mobile device ID that is linked to the user. type: String - contextPath: JAMF.User.links.mobile_devices.name description: The mobile device name that is linked to the user. type: String - contextPath: JAMF.User.user_groups.size description: The user groups size. type: Number - contextPath: JAMF.User.user_groups.user_group.id description: The user group ID. type: Number - contextPath: JAMF.User.user_groups.user_group.name description: The user group name. type: String - contextPath: JAMF.User.user_groups.user_group.is_smart description: If the user group is smart. type: Boolean - arguments: - defaultValue: '50' description: Maximum number of devices to retrieve. Maximal value is 200. name: limit - defaultValue: '0' description: Number of requested page. name: page description: Returns a list of devices with basic data on each. By default, returns the first 50 devices to the context (ID + name). name: jamf-get-mobile-devices outputs: - contextPath: JAMF.MobileDevice.id description: The mobile device ID. type: Number - contextPath: JAMF.MobileDevice.name description: The mobile device name. type: String - contextPath: JAMF.MobileDevice.device_name description: The mobile device name. type: String - contextPath: JAMF.MobileDevice.udid description: The mobile device UDID. type: String - contextPath: JAMF.MobileDevice.serial_number description: The mobile device serial number. type: String - contextPath: JAMF.MobileDevice.phone_number description: The mobile device phone number. type: String - contextPath: JAMF.MobileDevice.wifi_mac_address description: The mobile device WIFI MAC address. type: String - contextPath: JAMF.MobileDevice.managed description: Whether the mobile device is managed. type: Boolean - contextPath: JAMF.MobileDevice.supervised description: Whether the mobile device is supervised. type: Boolean - contextPath: JAMF.MobileDevice.model description: The mobile device model. type: String - contextPath: JAMF.MobileDevice.model_identifier description: The mobile device model ID. type: String - contextPath: JAMF.MobileDevice.modelDisplay description: The mobile device model display. type: String - contextPath: JAMF.MobileDevice.model_display description: The mobile device model display. type: String - contextPath: JAMF.MobileDevice.username description: The mobile device username. type: String - contextPath: JAMF.MobileDevice.Paging.total_results description: The number of mobile devices returned in this specific search. type: Number - contextPath: JAMF.MobileDevice.Paging.page_size description: The number of mobile devices to be returned on each page. type: Number - contextPath: JAMF.MobileDevice.Paging.current_page description: The number of the requested page. type: Number - arguments: - description: |- Gets the “general” subset of a specific device. To get the mobile device ID, run the `jamf-get-mobile-devices` command to get all mobile devices names and IDs. name: id required: true description: 'Returns the "general" subset of a specific mobile device, e.g.: name, MAC address, IP, serial number, UDID. etc.' name: jamf-get-mobile-device-by-id outputs: - contextPath: JAMF.MobileDevice.id description: The mobile device ID. type: Number - contextPath: JAMF.MobileDevice.display_name description: The mobile device display name. type: String - contextPath: JAMF.MobileDevice.device_name description: The mobile device name. type: String - contextPath: JAMF.MobileDevice.name description: The mobile device name. type: String - contextPath: JAMF.MobileDevice.asset_tag description: The mobile device asset ID. type: String - contextPath: JAMF.MobileDevice.last_inventory_update description: The date of the mobile device last inventory update. type: String - contextPath: JAMF.MobileDevice.last_inventory_update_epoch description: The date of the mobile device last inventory update in epoch format. type: Date - contextPath: JAMF.MobileDevice.last_inventory_update_utc description: The date of the mobile device last inventory update in UTC format. type: Date - contextPath: JAMF.MobileDevice.capacity description: The mobile device capacity. type: Number - contextPath: JAMF.MobileDevice.capacity_mb description: The mobile device capacity in MB. type: Number - contextPath: JAMF.MobileDevice.available description: The mobile device available storage. type: Number - contextPath: JAMF.MobileDevice.available_mb description: The mobile device available storage in MB. type: Number - contextPath: JAMF.MobileDevice.percentage_used description: The percentage of memory used. type: Number - contextPath: JAMF.MobileDevice.os_type description: The mobile device operating system type. type: String - contextPath: JAMF.MobileDevice.os_version description: The mobile device operating system version. type: String - contextPath: JAMF.MobileDevice.os_build description: The mobile device operating system build. type: String - contextPath: JAMF.MobileDevice.serial_number description: The mobile device serial number. type: String - contextPath: JAMF.MobileDevice.udid description: The mobile device UDID. type: String - contextPath: JAMF.MobileDevice.initial_entry_date_epoch description: The mobile device initial entry date in epoch format. type: Date - contextPath: JAMF.MobileDevice.initial_entry_date_utc description: The mobile device initial entry date in UTC format. type: Date - contextPath: JAMF.MobileDevice.phone_number description: The mobile device phone number. type: String - contextPath: JAMF.MobileDevice.ip_address description: The mobile device IP address. type: String - contextPath: JAMF.MobileDevice.wifi_mac_address description: The mobile device WIFI MAC address. type: String - contextPath: JAMF.MobileDevice.bluetooth_mac_address description: The mobile device bluetooth MAC address. type: String - contextPath: JAMF.MobileDevice.modem_firmware description: The mobile device modem fireware. type: String - contextPath: JAMF.MobileDevice.model description: The mobile device model. type: String - contextPath: JAMF.MobileDevice.model_identifier description: The mobile device model ID. type: String - contextPath: JAMF.MobileDevice.model_number description: The mobile device model number. type: String - contextPath: JAMF.MobileDevice.modelDisplay description: The mobile device model display. type: String - contextPath: JAMF.MobileDevice.model_display description: The mobile device model display. type: String - contextPath: JAMF.MobileDevice.device_ownership_level description: The mobile device ownership level. type: String - contextPath: JAMF.MobileDevice.enrollment_method description: The mobile device enrollment method. type: String - contextPath: JAMF.MobileDevice.last_enrollment_epoch description: The mobile device last enrollment in epoch. type: Number - contextPath: JAMF.MobileDevice.last_enrollment_utc description: The mobile device last enrollment in UTC format. type: String - contextPath: JAMF.MobileDevice.mdm_profile_expiration_epoch description: The mobile device MDM profile expiration in epoch format. type: Number - contextPath: JAMF.MobileDevice.mdm_profile_expiration_utc description: The mobile device MDM profile expiration in UTC format. type: String - contextPath: JAMF.MobileDevice.managed description: Whether the mobile device is managed. type: Boolean - contextPath: JAMF.MobileDevice.supervised description: Whether the mobile device is supervised. type: Boolean - contextPath: JAMF.MobileDevice.exchange_activesync_device_identifier description: The mobile device exchange active sync device ID. type: String - contextPath: JAMF.MobileDevice.shared description: Whether the device is shared. type: String - contextPath: JAMF.MobileDevice.diagnostic_submission description: The mobile device diagnostic submission. type: String - contextPath: JAMF.MobileDevice.app_analytics description: The mobile device app analytics. type: String - contextPath: JAMF.MobileDevice.tethered description: The mobile device tethered status. type: String - contextPath: JAMF.MobileDevice.battery_level description: The mobile device battery level. type: Number - contextPath: JAMF.MobileDevice.ble_capable description: Whether the mobile device is BLE capable. type: Boolean - contextPath: JAMF.MobileDevice.device_locator_service_enabled description: Whether the mobile device locator service is enabled. type: Boolean - contextPath: JAMF.MobileDevice.do_not_disturb_enabled description: Whether the mobile device do not disturb is enabled. type: Boolean - contextPath: JAMF.MobileDevice.cloud_backup_enabled description: Whether the mobile device cloud backup is enabled. type: Boolean - contextPath: JAMF.MobileDevice.last_cloud_backup_date_epoch description: The mobile device last cloud update backup date in epoch format. type: Date - contextPath: JAMF.MobileDevice.last_cloud_backup_date_utc description: The mobile device last cloud update backup date in UTC format. type: Date - contextPath: JAMF.MobileDevice.location_services_enabled description: Whether the mobile device location services is enabled. type: Boolean - contextPath: JAMF.MobileDevice.itunes_store_account_is_active description: Whether the mobile device iTunes store account is enabled. type: Boolean - contextPath: JAMF.MobileDevice.last_backup_time_epoch description: The mobile device last backup time in epoch format. type: Number - contextPath: JAMF.MobileDevice.last_backup_time_utc description: The mobile device last backup time in UTC format. type: String - contextPath: JAMF.MobileDevice.site.id description: The mobile device site ID. type: Number - contextPath: JAMF.MobileDevice.site.name description: The mobile device site name. type: String - arguments: - description: 'The specific characteristics by which to match devices such as: name, udid, serial_number, mac_address, username, email. e.g: “match=john*”, “match=C52F72FACB9T”. (Supports wildcards).' name: match predefined: - '' required: true - defaultValue: '50' description: Maximum number of devices to retrieve. (Maximal value is 200). name: limit - defaultValue: '0' description: The number of the requested page. name: page description: Matches mobile devices by specific characteristics and returns general data on each one of the mobile devices. name: jamf-get-mobile-device-by-match outputs: - contextPath: JAMF.MobileDevice.id description: The mobile device ID. type: Number - contextPath: JAMF.MobileDevice.name description: The mobile device name. type: String - contextPath: JAMF.MobileDevice.udid description: The mobile device UDID. type: String - contextPath: JAMF.MobileDevice.serial_number description: The mobile device serial number. type: String - contextPath: JAMF.MobileDevice.mac_address description: The mobile device MAC address. type: String - contextPath: JAMF.MobileDevice.wifi_mac_address description: The mobile device WIFI MAC address. type: String - contextPath: JAMF.MobileDevice.username description: The mobile device username. type: String - contextPath: JAMF.MobileDevice.realname description: The mobile device real name. type: String - contextPath: JAMF.MobileDevice.email description: The mobile device user email address. type: String - contextPath: JAMF.MobileDevice.email_address description: The mobile device user email address. type: String - contextPath: JAMF.MobileDevice.room description: The mobile device room. type: String - contextPath: JAMF.MobileDevice.position description: The mobile device position. type: String - contextPath: JAMF.MobileDevice.building description: The mobile device building. type: String - contextPath: JAMF.MobileDevice.building_name description: The mobile device building name. type: String - contextPath: JAMF.MobileDevice.department description: The mobile device department. type: String - contextPath: JAMF.MobileDevice.department_name description: The mobile device department name. type: String - contextPath: JAMF.MobileDevice.Paging.total_results description: The number of mobile devices returned in this specific search. type: Number - contextPath: JAMF.MobileDevice.Paging.page_size description: The number of mobile devices to be returned on each page. type: Number - contextPath: JAMF.MobileDevice.Paging.current_page description: The number of the requested page. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the general subset for a specific mobile device according to the given arguments. name: jamf-get-mobile-device-general-subset outputs: - contextPath: JAMF.MobileDeviceSubset.id description: The mobile device ID. type: String - contextPath: JAMF.MobileDeviceSubset.general.id description: The mobile device ID. type: Number - contextPath: JAMF.MobileDeviceSubset.general.display_name description: The mobile device display name. type: String - contextPath: JAMF.MobileDeviceSubset.general.device_name description: The mobile device name. type: String - contextPath: JAMF.MobileDeviceSubset.general.name description: The mobile device name. type: String - contextPath: JAMF.MobileDeviceSubset.general.asset_tag description: The mobile device asset ID. type: String - contextPath: JAMF.MobileDeviceSubset.general.last_inventory_update description: The date of the mobile device last inventory update. type: String - contextPath: JAMF.MobileDeviceSubset.general.last_inventory_update_epoch description: The date of the mobile device last inventory update in epoch format. type: Date - contextPath: JAMF.MobileDeviceSubset.general.last_inventory_update_utc description: The date of the mobile device last inventory update in UTC format. type: Date - contextPath: JAMF.MobileDeviceSubset.general.capacity description: The mobile device capacity. type: Number - contextPath: JAMF.MobileDeviceSubset.general.capacity_mb description: The mobile device capacity in MB. type: Number - contextPath: JAMF.MobileDeviceSubset.general.available description: The available memory in the mobile device. type: Number - contextPath: JAMF.MobileDeviceSubset.general.available_mb description: The available memory in the mobile device in MB. type: Number - contextPath: JAMF.MobileDeviceSubset.general.percentage_used description: The percentage of memory used in the mobile device. type: Number - contextPath: JAMF.MobileDeviceSubset.general.os_type description: The mobile device operating system type. type: String - contextPath: JAMF.MobileDeviceSubset.general.os_version description: The mobile device operating system version. type: String - contextPath: JAMF.MobileDeviceSubset.general.os_build description: The mobile device operating system build. type: String - contextPath: JAMF.MobileDeviceSubset.general.serial_number description: The mobile device serial number. type: String - contextPath: JAMF.MobileDeviceSubset.general.udid description: The mobile device UDID. type: String - contextPath: JAMF.MobileDeviceSubset.general.initial_entry_date_epoch description: The mobile device initial entry date in epoch format. type: Date - contextPath: JAMF.MobileDeviceSubset.general.initial_entry_date_utc description: The mobile device initial entry date in UTC format. type: Date - contextPath: JAMF.MobileDeviceSubset.general.phone_number description: The mobile device phone number. type: String - contextPath: JAMF.MobileDeviceSubset.general.ip_address description: The mobile device IP address. type: String - contextPath: JAMF.MobileDeviceSubset.general.wifi_mac_address description: The mobile device WIFI MAC address. type: String - contextPath: JAMF.MobileDeviceSubset.general.bluetooth_mac_address description: The mobile device bluetooth MAC address. type: String - contextPath: JAMF.MobileDeviceSubset.general.modem_firmware description: The mobile device modem fireware. type: String - contextPath: JAMF.MobileDeviceSubset.general.model description: The mobile device model. type: String - contextPath: JAMF.MobileDeviceSubset.general.model_identifier description: The mobile device model ID. type: String - contextPath: JAMF.MobileDeviceSubset.general.model_number description: The mobile device model number. type: String - contextPath: JAMF.MobileDeviceSubset.general.modelDisplay description: The mobile device model display. type: String - contextPath: JAMF.MobileDeviceSubset.general.model_display description: The mobile device model display. type: String - contextPath: JAMF.MobileDeviceSubset.general.device_ownership_level description: The mobile device ownership level. type: String - contextPath: JAMF.MobileDeviceSubset.general.enrollment_method description: The mobile device enrollment method. type: String - contextPath: JAMF.MobileDeviceSubset.general.last_enrollment_epoch description: The mobile device last enrollment in epoch format. type: Number - contextPath: JAMF.MobileDeviceSubset.general.last_enrollment_utc description: The mobile device last enrollment in UTC format. type: String - contextPath: JAMF.MobileDeviceSubset.general.mdm_profile_expiration_epoch description: The mobile device MDM profile expiration in epoch format. type: Number - contextPath: JAMF.MobileDeviceSubset.general.mdm_profile_expiration_utc description: The mobile device MDM profile expiration in UTC format. type: String - contextPath: JAMF.MobileDeviceSubset.general.managed description: Whether the mobile device is managed. type: Boolean - contextPath: JAMF.MobileDeviceSubset.general.supervised description: Whether the mobile device is supervised. type: Boolean - contextPath: JAMF.MobileDeviceSubset.general.exchange_activesync_device_identifier description: The mobile device exchange active sync device ID. type: String - contextPath: JAMF.MobileDeviceSubset.general.shared description: Whether the device is shared. type: String - contextPath: JAMF.MobileDeviceSubset.general.diagnostic_submission description: The mobile device diagnostic submission. type: String - contextPath: JAMF.MobileDeviceSubset.general.app_analytics description: The mobile device app analytics. type: String - contextPath: JAMF.MobileDeviceSubset.general.tethered description: The mobile device tethered status. type: String - contextPath: JAMF.MobileDeviceSubset.general.battery_level description: The mobile device battery level. type: Number - contextPath: JAMF.MobileDeviceSubset.general.ble_capable description: Whether the mobile device is BLE capable. type: Boolean - contextPath: JAMF.MobileDeviceSubset.general.device_locator_service_enabled description: Whether the mobile device locator service is enabled. type: Boolean - contextPath: JAMF.MobileDeviceSubset.general.do_not_disturb_enabled description: Whether the mobile device do not disturb is enabled. type: Boolean - contextPath: JAMF.MobileDeviceSubset.general.cloud_backup_enabled description: Whether the mobile device cloud backup is enabled. type: Boolean - contextPath: JAMF.MobileDeviceSubset.general.last_cloud_backup_date_epoch description: The mobie device last cloud update backup date in epoch format. type: Date - contextPath: JAMF.MobileDeviceSubset.general.last_cloud_backup_date_utc description: The mobie device last cloud update backup date in UTC format. type: Date - contextPath: JAMF.MobileDeviceSubset.general.location_services_enabled description: Whether the mobile device location services is enabled. type: Boolean - contextPath: JAMF.MobileDeviceSubset.general.itunes_store_account_is_active description: Whether the mobile device iTunes store account is enabled. type: Boolean - contextPath: JAMF.MobileDeviceSubset.general.last_backup_time_epoch description: The mobile device last backup time in epoch format. type: Number - contextPath: JAMF.MobileDeviceSubset.general.last_backup_time_utc description: The mobile device last backup time in UTC format. type: String - contextPath: JAMF.MobileDeviceSubset.general.site.id description: The mobile device site ID. type: Number - contextPath: JAMF.MobileDeviceSubset.general.site.name description: The mobile device site name. type: String - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the location subset for a specific mobile device according to the given arguments. name: jamf-get-mobile-device-location-subset outputs: - contextPath: JAMF.MobileDeviceSubset.id description: The mobile device ID. type: String - contextPath: JAMF.MobileDeviceSubset.location.username description: The mobile device username. type: String - contextPath: JAMF.MobileDeviceSubset.location.realname description: The mobile device real name. type: String - contextPath: JAMF.MobileDeviceSubset.location.real_name description: The mobile device real name. type: String - contextPath: JAMF.MobileDeviceSubset.location.email_address description: The mobile device email address. type: String - contextPath: JAMF.MobileDeviceSubset.location.position description: The mobile device position. type: String - contextPath: JAMF.MobileDeviceSubset.location.phone description: The mobile device phone number. type: String - contextPath: JAMF.MobileDeviceSubset.location.phone_number description: The mobile device phone number. type: String - contextPath: JAMF.MobileDeviceSubset.location.department description: The mobile device department. type: String - contextPath: JAMF.MobileDeviceSubset.location.building description: The mobile device building. type: String - contextPath: JAMF.MobileDeviceSubset.location.room description: The mobile device room. type: String - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the purchasing subset for a specific mobile device according to the given arguments. name: jamf-get-mobile-device-purchasing-subset outputs: - contextPath: JAMF.MobileDeviceSubset.id description: The mobile device ID. type: String - contextPath: JAMF.MobileDeviceSubset.purchasing.is_purchased description: Whether the mobile device is purchased. type: Boolean - contextPath: JAMF.MobileDeviceSubset.purchasing.is_leased description: Whether the mobile device is leased. type: Boolean - contextPath: JAMF.MobileDeviceSubset.purchasing.po_number description: The mobile device PO number. type: String - contextPath: JAMF.MobileDeviceSubset.purchasing.vendor description: The mobile device vendor. type: String - contextPath: JAMF.MobileDeviceSubset.purchasing.applecare_id description: The mobile device AppleCare ID. type: String - contextPath: JAMF.MobileDeviceSubset.purchasing.purchase_price description: The mobile device purchase price. type: String - contextPath: JAMF.MobileDeviceSubset.purchasing.purchasing_account description: The mobile device purchase account. type: String - contextPath: JAMF.MobileDeviceSubset.purchasing.po_date description: The mobile device purchase PO date. type: String - contextPath: JAMF.MobileDeviceSubset.purchasing.po_date_epoch description: The mobile device purchase PO date in epoch format. type: Number - contextPath: JAMF.MobileDeviceSubset.purchasing.po_date_utc description: The mobile device purchase PO date in UTC format. type: String - contextPath: JAMF.MobileDeviceSubset.purchasing.warranty_expires description: The mobile device warranty expiration date. type: String - contextPath: JAMF.MobileDeviceSubset.purchasing.warranty_expires_epoch description: The mobile device warranty expiration date in epoch format. type: Number - contextPath: JAMF.MobileDeviceSubset.purchasing.warranty_expires_utc description: The mobile device warranty expiration date in UTC format. type: String - contextPath: JAMF.MobileDeviceSubset.purchasing.lease_expires description: The mobile device lease expiration date. type: String - contextPath: JAMF.MobileDeviceSubset.purchasing.lease_expires_epoch description: The mobile device lease expiration date in epoch format. type: Number - contextPath: JAMF.MobileDeviceSubset.purchasing.lease_expires_utc description: The mobile device lease expiration date in UTC format. type: String - contextPath: JAMF.MobileDeviceSubset.purchasing.life_expectancy description: The mobile device life expectancy. type: Number - contextPath: JAMF.MobileDeviceSubset.purchasing.purchasing_contact description: The mobile device purchasing contact. type: String - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the applications subset for a specific mobile device according to the given arguments. name: jamf-get-mobile-device-applications-subset outputs: - contextPath: JAMF.MobileDeviceSubset.id description: The mobile device ID. type: String - contextPath: JAMF.MobileDeviceSubset.applications.application_name description: The mobile device application name. type: String - contextPath: JAMF.MobileDeviceSubset.applications.application_version description: The mobile device application version. type: String - contextPath: JAMF.MobileDeviceSubset.applications.application_short_version description: The mobile device application short version. type: String - contextPath: JAMF.MobileDeviceSubset.applications.identifier description: The mobile device application ID. type: String - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the security subset for a specific mobile device according to the given arguments. name: jamf-get-mobile-device-security-subset outputs: - contextPath: JAMF.MobileDeviceSubset.id description: The mobile device ID. type: String - contextPath: JAMF.MobileDeviceSubset.security.data_protection description: If the mobile device has data protection. type: Boolean - contextPath: JAMF.MobileDeviceSubset.security.block_level_encryption_capable description: If the mobile device is block level encryption capable. type: Boolean - contextPath: JAMF.MobileDeviceSubset.security.file_level_encryption_capable description: If the mobile device is file level encryption capable. type: Boolean - contextPath: JAMF.MobileDeviceSubset.security.passcode_present description: Whether the mobile device has a passcode present. type: Boolean - contextPath: JAMF.MobileDeviceSubset.security.passcode_compliant description: Whether the mobile device is passcode compliant. type: Boolean - contextPath: JAMF.MobileDeviceSubset.security.passcode_compliant_with_profile description: Whether the mobile device is passcode compliant with profile. type: Boolean - contextPath: JAMF.MobileDeviceSubset.security.passcode_lock_grace_period_enforced description: The mobile device passcode lock grace period enforced. type: String - contextPath: JAMF.MobileDeviceSubset.security.hardware_encryption description: The mobile device hardware encryption. type: Number - contextPath: JAMF.MobileDeviceSubset.security.activation_lock_enabled description: Whether the mobile device has activation lock enabled. type: Boolean - contextPath: JAMF.MobileDeviceSubset.security.jailbreak_detected description: The mobile device security jailbreak detected. type: String - contextPath: JAMF.MobileDeviceSubset.security.lost_mode_enabled description: The mobile device lost mode. type: String - contextPath: JAMF.MobileDeviceSubset.security.lost_mode_enforced description: Whether the mobile device has lost mode enforced. type: Boolean - contextPath: JAMF.MobileDeviceSubset.security.lost_mode_enable_issued_epoch description: The mobile device lost mode enable issued date in epoch. type: Date - contextPath: JAMF.MobileDeviceSubset.security.lost_mode_enable_issued_utc description: The mobile device lost mode enable issued date in UTC format. type: Date - contextPath: JAMF.MobileDeviceSubset.security.lost_mode_message description: The mobile device lost mode message. type: String - contextPath: JAMF.MobileDeviceSubset.security.lost_mode_phone description: The mobile device lost mode phone. type: String - contextPath: JAMF.MobileDeviceSubset.security.lost_mode_footnote description: The mobile device lost mode footnote. type: String - contextPath: JAMF.MobileDeviceSubset.security.lost_location_epoch description: The mobile device lost location date in epoch format. type: Date - contextPath: JAMF.MobileDeviceSubset.security.lost_location_utc description: The mobile device lost location date in UTC format. type: Date - contextPath: JAMF.MobileDeviceSubset.security.lost_location_latitude description: The mobile device security lost location latitude. type: Number - contextPath: JAMF.MobileDeviceSubset.security.lost_location_longitude description: The mobile device security lost location longitude. type: Number - contextPath: JAMF.MobileDeviceSubset.security.lost_location_altitude description: The mobile device security lost location altitude. type: Number - contextPath: JAMF.MobileDeviceSubset.security.lost_location_speed description: The mobile device security lost location speed. type: Number - contextPath: JAMF.MobileDeviceSubset.security.lost_location_course description: The mobile device security lost location course. type: Number - contextPath: JAMF.MobileDeviceSubset.security.lost_location_horizontal_accuracy description: The mobile device security lost location horizontal accuracy. type: Number - contextPath: JAMF.MobileDeviceSubset.security.lost_location_vertical_accuracy description: The mobile device security lost location vertical accuracy. type: Number - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the network subset for a specific mobile device according to the given arguments. name: jamf-get-mobile-device-network-subset outputs: - contextPath: JAMF.MobileDeviceSubset.id description: The mobile device ID. type: String - contextPath: JAMF.MobileDeviceSubset.network.home_carrier_network description: The mobile device home carrier network. type: String - contextPath: JAMF.MobileDeviceSubset.network.cellular_technology description: The mobile device cellular technology. type: String - contextPath: JAMF.MobileDeviceSubset.network.voice_roaming_enabled description: The mobile device voice roaming enabled. type: String - contextPath: JAMF.MobileDeviceSubset.network.imei description: The mobile device network IMEI. type: String - contextPath: JAMF.MobileDeviceSubset.network.iccid description: The mobile device network ICCID. type: String - contextPath: JAMF.MobileDeviceSubset.network.meid description: The mobile device network MEID. type: String - contextPath: JAMF.MobileDeviceSubset.network.current_carrier_network description: The mobile device current carrier network. type: String - contextPath: JAMF.MobileDeviceSubset.network.carrier_settings_version description: The mobile device network carrier settings version. type: String - contextPath: JAMF.MobileDeviceSubset.network.current_mobile_country_code description: The mobile device current mobile country code. type: String - contextPath: JAMF.MobileDeviceSubset.network.current_mobile_network_code description: The mobile device current mobile network code. type: String - contextPath: JAMF.MobileDeviceSubset.network.home_mobile_country_code description: The mobile device home mobile country code. type: String - contextPath: JAMF.MobileDeviceSubset.network.home_mobile_network_code description: The mobile device home mobile network code. type: String - contextPath: JAMF.MobileDeviceSubset.network.data_roaming_enabled description: Whether the mobile device has data roaming enabled. type: Boolean - contextPath: JAMF.MobileDeviceSubset.network.roaming description: Whether the mobile device has network roaming. type: Boolean - contextPath: JAMF.MobileDeviceSubset.network.phone_number description: The mobile device network phone number. type: String - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the certificates subset for a specific mobile device according to the given arguments. name: jamf-get-mobile-device-certificates-subset outputs: - contextPath: JAMF.MobileDeviceSubset.id description: The mobile device ID. type: String - contextPath: JAMF.MobileDeviceSubset.certificates.size description: The mobile device certificates size. type: String - contextPath: JAMF.MobileDeviceSubset.certificates.certificate.common_name description: The mobile device certificate common name. type: String - contextPath: JAMF.MobileDeviceSubset.certificates.certificate.identity description: Whether this is an identity certificate. type: Boolean - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the provisioning profiles subset for a specific mobile device according to the given arguments. name: jamf-get-mobile-device-provisioning-profiles-subset outputs: - contextPath: JAMF.MobileDeviceSubset.id description: The mobile device ID. type: String - contextPath: JAMF.MobileDeviceSubset.provisioning_profiles.size description: The mobile device provisioning profiles size. type: Number - contextPath: JAMF.MobileDeviceSubset.provisioning_profiles.mobile_device_provisioning_profile.display_name description: The mobile device provisioning profiles display name. type: String - contextPath: JAMF.MobileDeviceSubset.provisioning_profiles.mobile_device_provisioning_profile.expiration_date description: The mobile device provisioning profiles expiration date. type: String - contextPath: JAMF.MobileDeviceSubset.provisioning_profiles.mobile_device_provisioning_profile.expiration_date_epoch description: The mobile device provisioning profiles expiration date in epoch format. type: Number - contextPath: JAMF.MobileDeviceSubset.provisioning_profiles.mobile_device_provisioning_profile.expiration_date_utc description: The mobile device provisioning profiles expiration date in UTC format. type: String - contextPath: JAMF.MobileDeviceSubset.provisioning_profiles.mobile_device_provisioning_profile.uuid description: The mobile device provisioning profiles UUID. type: String - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the configuration profiles subset for a specific mobile device according to the given arguments. name: jamf-get-mobile-device-configuration-profiles-subset outputs: - contextPath: JAMF.MobileDeviceSubset.id description: The mobile device ID. type: String - contextPath: JAMF.MobileDeviceSubset.configuration_profiles.size description: The mobile device configuration profiles size. type: Number - contextPath: JAMF.MobileDeviceSubset.configuration_profiles.configuration_profile.display_name description: The mobile device configuration profiles display name. type: String - contextPath: JAMF.MobileDeviceSubset.configuration_profiles.configuration_profile.version description: The mobile device configuration profiles version. type: String - contextPath: JAMF.MobileDeviceSubset.configuration_profiles.configuration_profile.identifier description: The mobile device configuration profiles identifier. type: Number - contextPath: JAMF.MobileDeviceSubset.configuration_profiles.configuration_profile.uuid description: The mobile device configuration profiles UUID. type: String - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the mobile device groups subset for a specific mobile device according to the given arguments. name: jamf-get-mobile-device-groups-subset outputs: - contextPath: JAMF.MobileDeviceSubset.id description: The mobile device ID. type: String - contextPath: JAMF.MobileDeviceSubset.mobile_device_groups.id description: The mobile device group ID. type: Number - contextPath: JAMF.MobileDeviceSubset.mobile_device_groups.name description: The mobile device group name. type: String - arguments: - auto: PREDEFINED description: 'The identifier used to determine which computer is requested. Possible values: "id", "name", "udid", "serialnumber", and "macaddress".' name: identifier predefined: - id - name - udid - serialnumber - macaddress required: true - description: The value of the "identifier". For example, if you choose the "id" identifier, a computer ID should be passed. If you choose "macaddress" as the identifier, a computer’s MAC address should be passed, etc. name: identifier_value required: true description: Returns the extension attributes subset for a specific mobile device according to the given arguments. name: jamf-get-mobile-device-extension-attributes-subset outputs: - contextPath: JAMF.MobileDeviceSubset.id description: The mobile device ID. type: String - contextPath: JAMF.MobileDeviceSubset.extension_attributes.id description: The mobile device extension attribute ID. type: Number - contextPath: JAMF.MobileDeviceSubset.extension_attributes.name description: The mobile device extension attribute name. type: String - contextPath: JAMF.MobileDeviceSubset.extension_attributes.type description: The mobile device extension attribute type. type: String - contextPath: JAMF.MobileDeviceSubset.extension_attributes.multi_value description: The mobile device extension attribute multi value. type: Boolean - contextPath: JAMF.MobileDeviceSubset.extension_attributes.value description: The mobile device extension attribute value. type: String - arguments: - description: The application’s name (supports wildcards). name: application required: true - description: The application’s version (supports wildcards). Applicable only when “application” parameter value is set. name: version - defaultValue: '50' description: Maximum number of devices to retrieve. (Maximal value is 200). name: limit - defaultValue: '0' description: The number of the requested page. name: page description: Returns a list of computers with basic information on each. name: jamf-get-computers-by-application outputs: - contextPath: JAMF.ComputersByApp.Computer.id description: The computer ID. type: Number - contextPath: JAMF.ComputersByApp.Computer.name description: The computer name. type: String - contextPath: JAMF.ComputersByApp.Computer.udid description: The computer UDID. type: String - contextPath: JAMF.ComputersByApp.Computer.serial_number description: The computer serial number. type: String - contextPath: JAMF.ComputersByApp.Computer.mac_address description: The computer MAC address. type: String - contextPath: JAMF.ComputersByApp.Application description: The application the user serched for. type: String - contextPath: JAMF.ComputersByApp.Paging.total_results description: The number of computers returned in this specific search. type: Number - contextPath: JAMF.ComputersByApp.Paging.page_size description: The number of computers to be returned on each page. type: Number - contextPath: JAMF.ComputersByApp.Paging.current_page description: The number of the requested page. type: Number - arguments: - description: The mobile device’s ID. name: id required: true - description: A message that is displayed on the device’s lock screen. name: lost_mode_message description: |- This is a beta command - couldn't be tested due to technical limitations. Enables “lost mode” on a specific device. Lost Mode is a feature that allows you to lock a mobile device and track the device's location. The device reports the GPS coordinates of the point where the device received the command. This feature adds additional protection to mobile devices and their data in the event that a device is lost or stolen. name: jamf-mobile-device-lost-mode outputs: - contextPath: JAMF.MobileDeviceCommands.name description: The mobile device command name. type: String - contextPath: JAMF.MobileDeviceCommands.status description: The mobile device command status. type: String - contextPath: JAMF.MobileDeviceCommands.management_id description: The mobile device command management ID. type: String - contextPath: JAMF.MobileDeviceCommands.id description: The mobile device command ID. type: String - arguments: - description: The device’s ID. name: id required: true - auto: PREDEFINED defaultValue: 'False' description: Whether to retain cellular data plans (iOS 11 or later). name: preserve_data_plan predefined: - 'True' - 'False' - auto: PREDEFINED defaultValue: 'False' description: Whether to clear activation lock on the device. name: clear_activation_code predefined: - 'True' - 'False' description: |- This is a beta command - couldn't be tested due to technical limitations. Permanently erases all data on the device and deactivates the device. name: jamf-mobile-device-erase outputs: - contextPath: JAMF.MobileDeviceCommands.name description: The mobile device command name. type: String - contextPath: JAMF.MobileDeviceCommands.status description: The mobile device command status. type: String - contextPath: JAMF.MobileDeviceCommands.management_id description: The mobile device command managment ID. type: String - contextPath: JAMF.MobileDeviceCommands.id description: The mobile device command ID. type: String - arguments: - description: The endpoint ID. isArray: true name: id - default: true description: The endpoint IP address. isArray: true name: ip - description: The endpoint hostname. isArray: true name: hostname description: Returns information about an endpoint. name: endpoint outputs: - contextPath: Endpoint.Hostname description: The endpoint's hostname. type: String - contextPath: Endpoint.OS description: The endpoint's operating system. type: String - contextPath: Endpoint.IPAddress description: The endpoint's IP address. type: String - contextPath: Endpoint.ID description: The endpoint's ID. type: String - contextPath: Endpoint.Status description: The endpoint's status. type: String - contextPath: Endpoint.IsIsolated description: The endpoint's isolation status. type: String - contextPath: Endpoint.MACAddress description: The endpoint's MAC address. type: String - contextPath: Endpoint.Vendor description: The integration name of the endpoint vendor. type: String - arguments: - description: The ID of the mobile device. name: id required: true name: jamf-get-mobile-configuration-profiles-by-id description: Returns the configuration profiles subset for a specific mobile device according to the given arguments. outputs: - contextPath: JAMF.Mobile.ProfileConfiguration.general.id description: The ID of the configuration profile. type: Number - contextPath: JAMF.Mobile.ProfileConfiguration.general.name description: The name of the configuration profile. type: String - contextPath: JAMF.Mobile.ProfileConfiguration.general.description description: The mobile device configuration description. type: String - contextPath: JAMF.Mobile.ProfileConfiguration.general.level description: Level of the configuration profile (System or User). type: String - contextPath: JAMF.Mobile.ProfileConfiguration.general.site description: Site of the configuration profile. type: String - contextPath: JAMF.Mobile.ProfileConfiguration.general.category description: Category of the configuration profile. type: String - contextPath: JAMF.Mobile.ProfileConfiguration.general.uuid description: Unique identifier of the mobile profile configuration. type: String - contextPath: JAMF.Mobile.ProfileConfiguration.general.deployment_method description: Install Automatically or Make Available in Self Service. type: String - contextPath: JAMF.Mobile.ProfileConfiguration.general.payloads description: Payloads of the configuration profile for Mobile device. type: String - contextPath: JAMF.Mobile.ProfileConfiguration.scope description: Scope object of the configuration profile. type: String - contextPath: JAMF.Mobile.ProfileConfiguration.self_service description: Self-service object of the configuration profile. type: String - arguments: - description: The ID of the mobile device. name: id required: true name: jamf-get-computer-configuration-profiles-by-id description: Returns the configuration profiles subset for a specific mobile device according to the given arguments. outputs: - contextPath: JAMF.OSX.ProfileConfiguration.general.id description: The ID of the configuration profile. type: Number - contextPath: JAMF.OSX.ProfileConfiguration.general.name description: The name of the configuration profile. type: String - contextPath: JAMF.OSX.ProfileConfiguration.general.description description: The mobile device configuration description. - contextPath: JAMF.OSX.ProfileConfiguration.general.level description: Level of the configuration profile (System or User). type: String - contextPath: JAMF.OSX.ProfileConfiguration.general.site description: Site of the configuration profile. type: String - contextPath: JAMF.OSX.ProfileConfiguration.general.category description: Category of the configuration profile. type: String - contextPath: JAMF.OSX.ProfileConfiguration.general.uuid description: Unique identifier of the mobile profile configuration. type: String - contextPath: JAMF.OSX.ProfileConfiguration.general.distribution_method description: Install Automatically or Make Available in Self Service. type: String - contextPath: JAMF.OSX.ProfileConfiguration.general.payloads description: Payloads of the configuration profile for OSX device. type: String - contextPath: JAMF.OSX.ProfileConfiguration.scope description: Scope object of the configuration profile. type: String - contextPath: JAMF.OSX.ProfileConfiguration.self_service description: Self-service object of the configuration profile. type: String dockerimage: demisto/btfl-soup:1.0.1.10120494 runonce: false script: '-' subtype: python3 type: python tests: - Jamf_v2_test fromversion: 5.5.0