- Previously installed apps with a
filepath validation now display "Previously Installed" (instead of a generic "Installed"; Issue No. 13; thanks for the idea, @Manikandan!)
- Allow "first name" to correctly handle names in "Lastname, Firstname" format (Pull Request No. 11; thanks @meschwartz!)
- Corrected
PATH (thanks, @Theile!)
Configuration no longer displays in SYM's infobox when welcomeDialog is set to false or video (Addresses Issue No. 12; thanks, @Manikandan!)- Updated icon hashes
toggleJamfLaunchDaemon function (Pull Request No. 16; thanks, @robjschroeder!)- Formatted policyJSON with Erik Lynd's JSON Tools
- Corrected an issue where inventory would be submitted twice (thanks, @Manikandan!)
- Added
currentLoggedInUser function to better validate loggedInUser (Addresses Issue No. 2)
- Added new Microsoft Office 365 Remote Validation (Pull Request No. 3)
- Improved logging when
welcomeDialog is video or false (Addresses Issue No. 4)
- Create
overlayicon from Self Service's custom icon (thanks, @meschwartz!)
Release-specific Blog Post
- Introduces fully customizable "Configurations" (thanks, @drtaru!)
- Required: Minimum organizational apps (i.e., full disk encryption, endpoint security, VPN, communication tools, etc.)
- Recommended: Required apps and Microsoft Office
- Complete: Recommended apps, Adobe Acrobat Reader and Google Chrome
- Play video at Welcome dialog (Script Parameter
6) by specifying video (Addresses Issue No. 36)
- 🔥 Breaking Change for users of Setup Your Mac prior to
1.8.0 🔥
- To capture user input,
welcomeDialog (Script Parameter 6) must be set to userInput
- Addresses Issue No. 39 (thanks big bunches, @wako!)
- Addresses Issue No. 43 (thanks, @wako)
- Removed the following fields from the Welcome dialog
- Comment
- Select B
- Select C
- Reordered Pre-Flight Check to not validate OS until AFTER Setup Assistant / Finder & Dock
- Added
disabled option for requiredMinimumBuild
- Added check for Self Service's
brandingimage.png (Addresses Issue No. 40)
- Pre-flight Check logging messages now saved to client-side log
- Addresses Issue No. 41
- Addresses Issue No. 35
- Improves user-interaction with
helpmessage under certain circumstances (thanks, @bartreardon!)
- Increased
debugMode delay (thanks for the heads-up, @Lewis B!)
- Changed Banner Image (to something much, much smaller)
Release-specific Blog Post
- Adds compatibility for and leverages new features of swiftDialog
2.1
bannertexthelpmessageinfoboxprogress-related racing-stripes (which now require swiftDialog 2.1+)
- Completion Actions
- Adjusted default code option (to hopefully help Mac Admins using an Enrollment Complete trigger [i.e.,
runAsUser doesn't work too well when _mbsetupuser is the logged-in user])
- Combined
listitem steps for installation and validation (thanks, @roiegat!)
- Validate Operating System Version, Build and Outdated OS Action
- Addresses Issue No. 31
- Introduces the ability to specify a
requiredMinimumBuild as Script Parameter 8 (thanks, @SirDrSpiderpig!)
- For example, to only allow macOS Ventura 13.2 (or later), specify:
22D
- Introduces Outdated OS Action
- Open Self Service to your OS update policy:
jamfselfservice://content?entity=policy&id=117&action=view
- Open Software Update (default):
/System/Library/CoreServices/Software Update.app
- Temporarily disables
jamf binary check-in (thanks, @mactroll and @cube!)
- Purposely commented-out the code to re-enable the
jamf binary; presumes the Mac will be restarted
- Separated "Global Variables" from "Dialog Variables" to allow for additional Script Parameters
- Improved Pre-flight Check messaging
- Introduces
verbose as an option for Debug Mode
- Most useful when first deploying Setup Your Mac
Release-specific Blog Post
- Addresses Issue No. 21
- 🔥 Breaking Change 🔥 (for users of Setup Your Mac prior to
1.6.0)
policy_array's "path" has been replaced with "validation"
- 🆕 The
confirmPolicyExecution function confirms if the policy needs to be executed for filepath validations
- A validation of
None always executes the Jamf Pro trigger when debug mode is set to false
- 🆕 The
validatePolicyResult function validates if the policy succeeded and the related service is running, based on the specified validation option
- Feature-specific Blog Post
- Validation Options:
- {absolute path} (simulates pre-
1.6.0 behavior, for example: "/Applications/Microsoft Teams.app/Contents/Info.plist")
Local (for validation within this script, for example: "filevault")Remote (for validation validation via a single-script Jamf Pro policy, for example: "symvGlobalProtect")None (for triggers which don't require validation, for example: recon; always evaluates as successful)
- Enhanced policy logging options to address Issue No. 25
- Search for and comment-out:
eval "${jamfBinary} policy -trigger ${trigger}"
- Uncomment:
eval "${jamfBinary} policy -trigger ${trigger} -verbose | tee -a ${scriptLog}"
- Ensure
debug mode is set to false
- Added Rosetta 2 policy execution and validation
- Enhanced Logging
Release-specific Blog Post
- Updates to "Pre-flight Checks"
- Moved section to start of script
- 🆕 Added additional check for Setup Assistant (for Mac Admins using an "Enrollment Complete" trigger)
Release-specific Blog Post
- 🆕 Prompt user for additional fields at Welcome dialog
- New fields are included in a single
welcomeJSON variable (thanks for all your efforts and feedback, @drtaru and @Andrew!)
- Dynamic
reconOptions based on user's input at the Welcome dialog
- Thanks for your patience, @remusache, @midiman1000, @erikmadams, @colorenz and @benphilware
- 🔥 Breaking Changes 🔥 (for users of Setup Your Mac prior to
1.5.0)
- Script Parameter Reordering (sorry; I'll strive not to ever do this again)
- Parameter 4: Script Log Location [
/var/tmp/org.churchofjesuschrist.log ]
- Parameter 5: Debug Mode [
true (default) | false ]
- Parameter 6: Welcome dialog [
true (default) | false ]
- Parameter 7: Completion Action [
wait | sleep (with seconds) | Shut Down | Shut Down Attended | Shut Down Confirm | Restart | Restart Attended(default) | Restart Confirm | Log Out | Log Out Attended | Log Out Confirm ]
- Miscellaneous Improvements
- Moved code blocks and variables to better reflect the Welcome > Setup Your Mac > Failure workflow
- Random code clean-up
Release-specific Blog Post
- Significantly enhanced Completion Action options
- ✅ Addresses Issue 15 (thanks, @mvught, @riddl0rd, @iDrewbs and @master-vodawagner)
- 🎉 Dynamically set
button1text based on the value of completionActionOption (thanks, @jared-a-young)
- 🥳 Dynamically set
progresstext based on the value of completionActionOption (thanks, @iDrewbs)
- 🆕 Three new flavors: Shut Down, Restart or Log Out
- 🚨 Forced: Zero user-interaction
- Added brute-force
killProcess "Self Service"
- Added
hack to allow Policy Logs to be shipped to Jamf Pro server
- ⚠️ Attended: Forced, but only after user-interaction (thanks, @owainiorwerth)
- Added
hack to allow Policy Logs to be shipped to Jamf Pro server
- 👤 Confirm: Displays built-in macOS user-dismissible dialog box
- Sleep
- Wait (default)
- Improved Debug Mode behavior
- 🐛
DEBUG MODE | now only displayed as infotext (i.e., bottom, left-hand corner)
completionAction informational-only with simple dialog box (thanks, @_____???)- Swapped
blurscreen for moveable
- General peformance increases
- Miscellaneous Improvements
- Removed
jamfDisplayMessage function and reverted dialogCheck function to use osascript (with an enhanced error message)
- Replaced "Installing …" with "Updating …" for
recon-flavored trigger
- Changed "Updating Inventory" to "Computer Inventory" for
recon-flavored listitem
- Changed exit code to
1 when user quits "Welcome" screen
- Changed
welcomeIcon URLs
- Changed URL for Harvesting Self Service icons screencast (thanks, @nstrauss)
Release-specific Blog Post
- Script Parameter Changes:
- ⚠️ Parameter 4:
debug mode enabled by default
- 🆕 Parameter 7: Script Log Location
- 🆕 Embraced drastic speed improvements in 🚅
swiftDialog v2💨
- Caffeinated script (thanks, @grahampugh!)
- Enhanced
wait exiting logic
- General script standardization
- Modifications for swiftDialog v2 (thanks, @bartreardon!)
- Added I/O pause to
dialog_update_setup_your_mac
- Added
list: show when displaying policy_array
- Re-ordered Setup Your Mac progress bar commands
- More specific logging for various dialog update functions
- Confirm Setup Assistant complete and user at Desktop (thanks, @ehemmete!)
- Added
setupYourMacPolicyArrayIconPrefixUrl variable (thanks for the idea, @mani2care!)
- Removed unnecessary
listitem icon updates (thanks, @bartreardon!)
- Output swiftDialog version when running in debug mode
- Updated URL for Zoom icon
- Replaced "ugly"
completionAction if … then … else with "more readabale" case statement (thanks, @pyther!)
- Updated "method for determining laptop/desktop" (thanks, @acodega and @scriptingosx!)
- Additional tweaks discovered during internal production deployment
Release-specific Blog Post
- Adjust I/O timing (for policy_array loop)
Release-specific Blog Post
- Swap "Installing …" and "Pending …" status indicators (thanks, @joncrain)
- Updates for switftDialog v1.11.2
- Report failures in Jamf Pro Policy Triggers
- Added "dark mode" for logo (thanks, @mm2270)
- Added "compact" for
--liststyle
- Made Asset Tag Capture optional (via Jamf Pro Script Paramter 5)
- Changed
--infobuttontext to --infotext
- Added
regex and regexerror for Asset Tag Capture
- Replaced @adamcodega's
apps with @smithjw's policy_array
- Added progress update
- Added filepath validation
- Added initial "Welcome Screen" with Asset Tag Capture and Debug Mode