Automation actions are the steps in a pipeline where work gets done! Some actions are pre-built, and others (like scripts) allow for total customization and flexibility. Some actions do work on devices, and others help you do work inside the Level app itself.
Once an action type is selected, any parameters specific to that action (if any) will be revealed. Every action has a required "condition" parameter, as well as additional optional parameters.
System Actions
Restart
This action will restart the targeted devices.
Run Script
This action will run a script from your Level script library.
Please note that unless the script exits in a failure state, the default behavior is for the pipeline to continue to run (even if the script itself fails). Therefore, controlling the exit type will play an important role in flow control of the automation. In PowerShell, Bash, and others use "exit 1" to exit the script in an error state.
See the On Action Failure section below for more details on how an action handles a failure.
Shell
This action is similar to a script, however the script commands can be entered into the action itself. The script commands will not be saved to the script library, and will only exist in the automation. This is useful if the commands required are simple and code reuse is not a concern.
Start Process
The Start Process action allows you to launch an executable on an endpoint. Provide the full path to the executable, optional arguments, and a timeout period. This action is ideal for launching scripts, installing applications, or running maintenance tasks as part of an automation workflow.
Stop Process
The Stop Process action terminates a running process on an endpoint. Simply specify the process name, and Level will attempt to stop it. This is useful for force-closing unresponsive applications, stopping unauthorized software, or managing system resources efficiently.
Manage Service
The Manage Service action allows you to control system services on an endpoint. You can specify a service name, set its startup type, and define its current state (start, stop, or restart). This is useful for ensuring critical services are running, restarting problematic ones, or disabling unnecessary services as part of an automation workflow.
Flow Actions
Wait For Approval
This action will stop all devices in the automation pipeline until a Level technician approves the device to move along in the pipeline.
When a device is pending approval, it will show in the active device status pane on the left, and an icon representing the device will appear next to the Wait For Approval step in the pipeline.
Delay
This action will insert a timed delay step in the pipeline. The duration is in seconds.
File Actions
Download File
The Download File action allows you to push files stored in Level’s built-in Automation File Storage directly to endpoints. Simply select the file, define the destination path, and specify the file name—Level handles the rest. This action ensures secure and seamless file distribution without requiring an external hosting service.
This action supports Level Variables for dynamic file paths and names, making them flexible for various deployment scenarios.
Download File via URL
The Download File via URL lets you retrieve files from an external source by providing a direct URL. This is useful for dynamically pulling files from a web server or cloud storage. Just enter the file URL, set the destination path, and assign a file name. Level will download and store the file on the endpoint.
This action supports Level Variables for dynamic file paths and names, making them flexible for various deployment scenarios.
Level Actions
Level actions do not actually do anything or run any code on the devices. Instead they run actions in the Level app that pertain to organization and management of devices.
Set Custom Field
This action allows you to set a custom field using a variable from an automation.
Create Alert
This action creates an alert in Level, allowing users to define a title, description, severity, and custom payload. It also enables email notifications for specified recipients when the alert is triggered.
Apply Tags
This action step will apply a Level tag to a device.
Remove Tags
This action step will remove a Level tag from a device.
Assign to Group
This action step will move an agent into the group selected.
Enable Maintenance Mode
This action step will put the device into maintenance mode in Level. When a device is in maintenance mode, the device will not trigger alerts from monitor policies. This is a useful action if the other steps in the pipeline are likely to cause the agent to trigger monitor policies.
Disable Maintenance Mode
This action step will disable maintenance mode on a device.
Security Actions
Install Windows Updates
This action initiates the installation of Windows updates on the target devices. You can configure it to include specific types of updates such as critical updates, security updates, and definition updates (see Windows Patch Management Categories).
Key Parameters:
Update Categories: Choose from critical updates, security updates, definition updates, service packs, and more. Each category can be customized with specific timing for installation (e.g., install immediately or delay by a set number of days).
Reboot after Updates: If selected, the device will reboot after the update is applied, ensuring a clean update process.
Loop Until Complete: If this option is enabled, the device will continue to reboot until all updates have been successfully installed.
Install macOS Updates
This action applies available macOS updates to the target devices. The updates can include macOS system updates and App Store updates.
Key Parameters:
Update Categories: You can configure macOS system updates and App Store updates, and specify whether updates should be applied immediately or after a delay.
Reboot after Updates: For some macOS updates, a reboot is required. Enabling this ensures the device reboots as necessary.
Install Linux Updates
This action installs updates on Linux devices, including updates to the kernel, security-related patches, and general system updates.
Key Parameters:
Update Categories: Choose from kernel updates, security updates, and general updates. These categories help you control which types of updates should be installed on the device.
Reboot after Updates: Some updates, especially kernel updates, require a reboot to take effect. This option ensures the device is rebooted after updates.
Windows Defender Update
This action will trigger Windows Defender to update its security signatures/definitions. The "Add Level to Windows Defender as an exclusion" option adds Level to Defender's file exclusion list.
Windows Defender Scan
This action will start a full system scan with Windows Defender. The "Add Level to Windows Defender as an exclusion" option adds Level to Defender's file exclusion list.
App Management Actions
Install Winget
This action installs the Winget package manager on Windows devices. Winget is developed and maintained by Microsoft and provides a centralized way to manage and automate the installation of applications on Windows endpoints.
Key Parameters:
None: This action does not have any specific configuration options beyond general conditions and additional options. Once executed, Winget will be installed on the device if it is not already present. This version of Winget will only be accessible to Level.
Install Winget Package(s)
This action installs one or more applications from the Winget repository onto the targeted Windows devices. With over 4,000 applications available (e.g., Chrome, Firefox, Zoom, Teams), Winget simplifies software deployment.
Key Parameters:
Package(s): Enter the Winget package ID(s) for the applications you want to install. You can visit winget.run for a complete list of available packages. Multiple packages can be added in the same action.
Upgrade Winget Package(s)
This action upgrades applications installed on the target devices using the Winget repository. It can upgrade all applications available via Winget, even if they were not originally installed using Winget.
Key Parameters:
Upgrade Type:
Upgrade All Available Packages: This option will upgrade all applications on the device that have updates available through Winget.
Upgrade Specific Package(s): If you prefer to upgrade certain applications only, specify the package ID(s) in the provided field.
Uninstall Winget Package(s)
This action removes one or more applications from the targeted Windows devices using Winget.
Key Parameters:
Package(s): Enter the Winget package ID(s) for the applications you want to uninstall. As with the installation, you can visit winget.run for a complete list of available packages.
Install Microsoft 365 for Windows
The Install Microsoft 365 for Windows action simplifies the deployment of Microsoft 365 across your managed devices. This action allows technicians to quickly install the Office suite, ensuring users have access to productivity tools like Word, Excel, PowerPoint, and Teams.
Key Parameters:
Product(s):
Microsoft 365 Apps for Business
Microsoft 365 Apps for Business (No Teams)
Microsoft 365 Apps for Enterprise
Microsoft 365 Apps for Enterprise (No Teams)
Office LTSC Professional Plus 2024 (Volume License)
Office LTSC Standard 2024 (Volume License)
Office LTSC Professional Plus 2021 (Volume License)
Office LTSC Standard 2021 (Volume License)
Office LTSC Professional Plus 2019 (Volume License)
Office LTSC Standard 2019 (Volume License)
Install Microsoft 365 for Mac
The Install Microsoft 365 for Mac action enables IT admins to seamlessly deploy Microsoft 365 on macOS devices. This action ensures users have access to critical Microsoft Office applications such as Word, Excel, PowerPoint, and Outlook, tailored for macOS.
Key Parameters:
Product(s):
Microsoft 365 Apps for Business
Microsoft 365 Apps for Business (No Teams)
Notification Actions
User Approval
This action will prompt the end user of the device to approve or reject this step of the pipeline. The question field is where the desired text to be sent to the end user should go. The Prompt Frequency controls when a reprompt should appear in the event that the delay button is pressed.
The Force Compliance checkbox means that the delay button will no longer be an option after the max attempt value has been reached. After that, the only option the device end user will have is an accept button.
The notification only pushes to a user session logged in to the console. This means it will not work for other sessions including those using Microsoft Remote Desktop Protocol.
Notify User
This action will send a toast notification to the device end user. The notification has no impact on the pipeline flow and only serves to send a notice to the end user of the device.
The notification only pushes to a user session logged in to the console. This means it will not work for other sessions including those using Microsoft Remote Desktop Protocol.