Scheduled Actions Guide
Version 1.0
AJ Singh
Scheduled Actions:
Ninja offers a decent amount of scripts out-of-the-box that can be used for day-to-day IT
operations.
They can be run on-demand or on a schedule.
To run a scheduled action, go to a policy, click on the “Scheduled Actions” tab, and click
“Add a scheduled action” and provide a name. and an optional description.
Select the schedule (Daily, weekly, monthly, Run once, Run once immediately, none).
-
Daily/Weekly/Monthly are self-explanatory.
-
Run once means it’ll run once at a schedule you pick.
-
Run once immediately means it’ll run right after you save this policy.
-
None is used when you don’t want to run this script on all the endpoints. This is
used in cases where you want to run it on-demand on some of the endpoints.
When you choose None, the script gets saved under the policy, and on the
device you want to run it on, go to the device in Ninja, click on the play-button,
and select Schedule actions and select the Action you created.
You also have options to create a ticket if you the PSA integration turned on.
Here is an explanation of all the actions available through Ninja:
Install application:
This helps install an .EXE or .MSI on all endpoints inside a policy.
In the ‘Architecture’ section, you can select the operating system type on the end points.
It could be x86 or x64.
If you select x86 it will skip all x64 machines in that policy.
There is two ways you can provide the installer to ninja. One is by uploading it to
Amazon S3 server or you could provide the path to the MSI or EXE by using a HTTP or
HTTPS URL.
Please specify the Application name and also the list of any optional parameters that
you want to run as a part of the installation process.
Lastly you have an option to run the installation either under the system context or
under the currently logged-in user.
Clear DNS Cache
This runs the command IPCONFIG /FLUSHDNS
Clear Event logs
This clears out all event logs
Defrag
This runs hard drive defragmentation on the endpoints; you have options to
include/exclude boot volume and/or the recovery volume.
Delete temporary files
This allows you to delete temporary files located under C:\Windows\Temp
Empty the recycle bin
This allows you to run empty recycle bin on the endpoints
Fix file system editors
This runs the command CHKDSK /R
Log off current user
This allows you to logout all logged in users from an endpoint.
Reboot
Reboots the machine
Release and renew IP address
This runs the commands IPCONFIG /RELEASE and IPCONFIG /RENEW
Removable Media
This allows you to turn on/off a USB port to essentially enable/disable the external USB
drives.
Run Script
This is Ninja’s custom scripting module and allows you to run a .BAT (batch), .CMD,
.PS1 (PowerShell), .VBS (vbscript) and .JS (JavaScript) files.
In the ‘Architecture’ section, you can select the operating system type on the end points.
It could be x86 or x64.
If you select x86 it will skip all x64 machines in that policy.
You need to upload the script using Browse under the ‘File’ section, and also any
optional parameters that you want to run as a part of the installation process.
Lastly you have an option to run the installation either under the system context or
under the currently logged-in user.
Run Application
This allows you to run an existing software on an endpoint.
Example: If you run CCleaner on the endpoints, you can evoke that using Ninja, making
sure you know the path to the Executable.
In the ‘Architecture’ section, you can select the operating system type on the end points.
It could be x86 or x64.
If you select x86 it will skip all x64 machines in that policy.
Provide a name to the application you want to run. Then the patch to the .EXE (like
“C:\program files\CCleaner\Ccleaner.exe”)
Lastly you have an option to run the program either under the system context (mostly
used for applications that don’t have a UI element to them) or under the currently
logged-in user.
Run Windows Cleanup
This runs the Windows Disk cleanup tool with the option /SAGERUN:1
The full command is (CLEANMGR /SAGERUN:1)
For more information on this tool, please refer to the following link:
https://support.microsoft.com/en-us/kb/253597
System Restore
This toggles the registry key to 0 or 1 to enable/disable System restore.
The registry key that is responsible for System restore is:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\SystemRestore
Windows Service
This allows you to start/stop a Windows Service.
The list of services that show up in the drop-down is created by cumulating all the
service from all customers under that MSP so it’s a superset of all the services for that
MSP.