Deploy Device Protection with SCCM
Deploy Aikido Device Protection to managed Windows devices with a Microsoft Configuration Manager (SCCM) package that runs the install command.
Use Microsoft Configuration Manager (SCCM) to deploy Aikido Device Protection across your managed Windows fleet with the required permissions in place.
Installation
All devices must run the Configuration Manager client and be members of a device collection before you begin.
Prepare the package source
- Copy the PowerShell install command from the Aikido app (click Connect Device).
- Save it as
aikido-install.ps1in a folder on a network share the site server can read, for example\\<server>\<share>\Aikido. - In the same folder, save the following script as
aikido-applocker.ps1. It turns on the Application Identity service that AppLocker needs to enforce rules, then adds an AppLocker rule that stops users from launching the Aikido uninstaller.
aikido-applocker.ps1 sc.exe config appidsvc start= auto Start-Service -Name AppIDSvc $tmp = "$env:TEMP\aikido-applocker.xml" Invoke-WebRequest -Uri "https://raw.githubusercontent.com/AikidoSec/safechain-internals/refs/heads/main/docs/aikido-applocker-deny.xml" -OutFile $tmp Set-AppLockerPolicy -XmlPolicy $tmp -Merge Remove-Item $tmp -ForceCreate the package and install program
- In the Configuration Manager console, go to Software Library → Application Management → Packages and click Create Package.
- Enter a name (e.g. "Aikido Device Protection"), select This package contains source files, browse to the UNC path of the folder, then click Next.
- Select Standard program, then click Next.
- Set the following, then finish the wizard:
- Name:
Install - Command line:
%windir%\Sysnative\WindowsPowerShell\v1.0\powershell.exe -NoProfile -ExecutionPolicy Bypass -File aikido-install.ps1 - Run: Hidden
- Program can run: Whether or not a user is logged on (runs as SYSTEM)
- Name:
Add the lockdown program
- Select the Aikido Device Protection package, open the Programs tab, and click Create Program.
- Select Standard program and set the following:
- Name:
Block uninstall - Command line:
%windir%\Sysnative\WindowsPowerShell\v1.0\powershell.exe -NoProfile -ExecutionPolicy Bypass -File aikido-applocker.ps1 - Run: Hidden
- Program can run: Whether or not a user is logged on
- Name:
- On the Requirements page, check Run another program first, select the Aikido Device Protection package and the Install program, then finish the wizard.
- On the Programs tab, right-click Block uninstall and select Properties.
- On General, set After running to Configuration Manager restarts computer, then click OK.
The agent fully activates on the next boot, so the restart after this program completes the installation.
If end users are local administrators, AppLocker rules can be bypassed. Combine this policy with App Control for Business (WDAC) and removal of local admin rights for stronger enforcement.
Distribute and deploy the package
- Select the Aikido Device Protection package, click Distribute Content, and add your distribution points.
- Select the Block uninstall program and click Deploy. Configuration Manager runs Install first.
- On General, select the target device collection.
- On Deployment Settings, set Purpose to Required.
- On Scheduling, add an assignment schedule of As soon as possible, then finish the wizard.
Clients pick up new deployments at the next machine policy polling interval (60 minutes by default). To force a faster run on a test device, right-click it in the console and select Client Notification → Download Computer Policy.
Troubleshooting
| Problem | Fix |
|---|---|
| Device doesn't appear in the dashboard after the script runs | Reboot the device; the agent fully registers on the next boot |
| Script exits with an error in the MDM console | Run the script manually as SYSTEM on a test host to see the full error; confirm the device has internet access to download the installer |
| Agent service is not running | Reboot the device; if the service is still absent, re-run the install script |
| Script is blocked by execution policy | Scripts run via MDM execute as SYSTEM and bypass user-level execution policy restrictions; confirm the MDM is not applying an additional policy that restricts script execution |
| Device shows as inactive after installation | The agent needs a reboot to fully activate; check back after rebooting |