Skip to main content

CLI / Scripted

This PowerShell script downloads the installer, checks its SHA-256 against the expected hash, and installs it. It stops if the hash does not match.

The URL and hash are the current published Windows x64 EXE (1.14.13). Replace the sample registration token with the one from the app's deploy wizard. If your workspace release ring is not this build, take the URL and hash from the wizard too.

Run it as an administrator. Pick the property set for your deployment scope.

$ErrorActionPreference = 'Stop'
$url = 'https://cdn.sparklogs.app/agent/data/1.14.13/windows_x86_64/sha256_c01da4bb31617cef850abda814f49037b38a9620271dc79f323d542f4cf550be/SparkLogsAgentSetup-x64-1.14.13.exe'
$sha = 'c01da4bb31617cef850abda814f49037b38a9620271dc79f323d542f4cf550be'
Invoke-WebRequest $url -OutFile $env:TEMP\SparkLogsAgentSetup.exe
if ((Get-FileHash $env:TEMP\SparkLogsAgentSetup.exe -Algorithm SHA256).Hash -ne $sha) { throw 'SHA-256 mismatch' }
$p = Start-Process $env:TEMP\SparkLogsAgentSetup.exe -Wait -PassThru -ArgumentList '/qn /norestart EULA=ACCEPT REGISTRATION_TOKEN=us_97... USEPARENTORG=1'
if ($p.ExitCode -notin 0, 3010, 1641) { throw "Install failed with exit code $($p.ExitCode)" }

For a client-org install, swap the argument list for the client's identifiers:

$p = Start-Process $env:TEMP\SparkLogsAgentSetup.exe -Wait -PassThru -ArgumentList '/qn /norestart EULA=ACCEPT REGISTRATION_TOKEN=us_97... RMMCLIENTID=<RMM_CLIENT_ID> CLIENTNAME="<CLIENT_NAME>"'
if ($p.ExitCode -notin 0, 3010, 1641) { throw "Install failed with exit code $($p.ExitCode)" }

EULA=ACCEPT is the first property after the install flags and accepts the SparkLogs Agent license.

PowerShell does not wait for the installer unless you use -Wait, and -PassThru returns the process so $p.ExitCode holds the real result (0, 3010, or 1641 on success). See why PowerShell does not wait on the installer.

Confirm the install​

Get-Service SparkLogsAgent

See Manage and verify agents and Troubleshooting.