Skip to main content

CLI / Scripted

Install with a single PowerShell snippet that downloads the installer, verifies its SHA-256, and installs it. This script verifies the hash of the downloaded installer against the expected hash and stops on mismatch.

warning

The script below is just a placeholder. You should always use the app's deploy wizard to get the exact values for your environment, including the current agent and hash values.

Run it as an administrator. Fill in the <ring> (your workspace's release ring), the expected hash, and the property set for your deployment scope. The app's deploy wizard shows the exact values so you copy a ready-to-run command rather than filling placeholders by hand.

$ErrorActionPreference = 'Stop'
$url  = 'https://cdn.sparklogs.app/agent/data/<version>/windows_x86_64/sha256_<hash>/SparkLogsAgentSetup-x64-1.6.0.exe'
$sha = '<expected_hash>'
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 -ne 0) { 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 -ne 0) { throw "Install failed with exit code $($p.ExitCode)" }

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

-Wait -PassThru is deliberate. PowerShell does not block on the installer's window process on its own, so $p.ExitCode is how you read 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.