Common Parameters
The following table shows commonly used parameters:
| Parameter | Description | Example Value |
|---|---|---|
-windowType | Style of the window | utility, hud, or fs |
-title | Window title text | "Software Update" |
-description | Main message text | "Updates are being installed..." |
-button1 | Primary button text | "OK" |
-button2 | Secondary button text (optional) | "Cancel" |
-icon | Path to the icon file | /System/Library/CoreServices/Software Update.app/Contents/Resources/SoftwareUpdate.icns |
-timeout | Auto-close time in seconds | 60 |
For a complete list of all available parameters and their usage, run the Jamf Helper on a managed computer with the -help parameter:
/Library/Application Support/JAMF/bin/jamfHelper.app/Contents/MacOS/jamfHelper -help
Example Use Cases
- Display a Message with a Timeout
#!/bin/bash "/Library/Application Support/JAMF/bin/jamfHelper.app/Contents/MacOS/jamfHelper" \ -windowType "hud" \ -title "Maintenance Notice" \ -description "Maintenance will begin in 5 minutes. Please save your work." \ -timeout 300 \ -countdown- Request User Confirmation
#!/bin/bash "/Library/Application Support/JAMF/bin/jamfHelper.app/Contents/MacOS/jamfHelper" \ -windowType "utility" \ -title "Software Installation" \ -description "Click Install to begin the installation process." \ -button1 "Install" \ -button2 "Cancel" \ -defaultButton 1- Request User Input
#!/bin/bash # Ask for t-shirt size SELECTION=$("/Library/Application Support/JAMF/bin/jamfHelper.app/Contents/MacOS/jamfHelper" \ -windowType "utility" \ -title "T-Shirt Size Survey" \ -heading "Company Swag Order" \ -description "Please select your t-shirt size for the upcoming company event:" \ -icon "/System/Library/CoreServices/CoreTypes.bundle/Contents/Resources/Clipboard.icns" \ -button1 "Small" \ -button2 "Medium" \ -button3 "Large" \ -button4 "XL" \ -defaultButton 2) # Store the response case $SELECTION in 0) SIZE="Small";; 1) SIZE="Medium";; 2) SIZE="Large";; 3) SIZE="XL";; *) SIZE="No selection made";; esac # Display confirmation "/Library/Application Support/JAMF/bin/jamfHelper.app/Contents/MacOS/jamfHelper" \ -windowType "utility" \ -title "Thank You" \ -description "Your size ($SIZE) has been recorded." \ -icon "/System/Library/CoreServices/CoreTypes.bundle/Contents/Resources/ToolbarFavoritesIcon.icns" \ -button1 "OK"Note:This example shows the basic concept of collecting user input. For production use, you'll need to add code to store the collected data, such as updating an extension attribute. Contact your IT administrator for complete implementation details.