Summary
The Logitech Script DFU software is a tool to update firmware of supported devices. Intended to be used by IT Managers and Administrators.
IMPORTANT: Deployment type should be Install and Available, NOT Required. This will prevent devices becoming unusable during critical work use. For example if the client (user) is in the middle of a presentation, or critical work, they will lose keyboard input during this time.
For easier printing and sharing, a PDF of this process can be found here.
Prerequisites
Ensure that the following prerequisites are met when composing shell scripts and assigning them to macOS devices
- Devices are running macOS 10.13 or later.
- Devices are managed by Intune.
- Shell scripts begin with #! and must be in a valid location such as #!/bin/sh or #!/usr/bin/env zsh.
- Command line needs to include --pop-up (this allows Bolt devices to update when a popup screen appears asking the user to restart the device)
- Command-line interpreters for the applicable shells are installed.
- Download the Logitech ScriptDFU from the following link
Create and assign a shell script policy
- Sign in to the Microsoft Endpoint Manager Admin Center.
- Select Devices > macOS > Shell scripts > Add.
- In Basics, enter the following properties, and select Next:
-
- Name: Enter a name for the shell script.
- Description: Enter a description for the shell script.
- In Script settings, enter the following properties, and select Next:
-
- Upload script: Browse to the shell script
- Run script as signed-in user: NO
- Hide script notifications on devices: Yes
- Script frequency: Select how often the script is to be run. Choose Not configured (default) to run a script only once.
- Max number of times to retry if script fails: Select how many times the script should be run if it returns a non-zero exit code (zero meaning success).
- In Scope tags, optionally add scope tags for the script, and select Next.
- Select Assignments > Select groups to include.
- In Review + add, a summary is shown of the settings you configured. Select Add to save the script. When you select Add, the script policy is deployed to the groups you chose.
The script you created now appears in the list of scripts.
Monitor a shell script policy
You can monitor the run status of all assigned scripts for users and devices by choosing one of the following reports:
- Scripts > select the script to monitor > Device status
- Scripts > select the script to monitor > User status
Log Collections
You can collect device logs to help troubleshoot script issues on macOS devices:
To find these, go to the folder: /private/var/log/Script_dfu.log