PowerShell met Qixium Agent: scripts en resultaten

Wiki · 1.1

LocalScripting configureren en uitvoeren via planning, User Action of IDU; exitcodes, JSON en webhook-afhandeling.

Je bestaande PowerShell-kennis blijft bruikbaar

Met LocalScripting voer je een lokaal PowerShell-script uit via de Qixium Agent. Bijvoorbeeld voor een bestaande beheeractie of een export uit Active Directory. Je hoeft een vertrouwd script niet los van het proces handmatig te blijven starten: een planning, User Action of ingerichte IDU-automatisering kan de uitvoering aanroepen.

LocalScripting instellen

Maak bij Connector > Connections > Connections een connectie van type LocalScripting en selecteer de juiste Agent.
Open de Agent en kies Herladen Agent Configuraties.
Open het gegenereerde bestand onder C:\Qixium\configs\LocalScripting. De bestandsnaam volgt de connectienaam.
Stel ScriptFolder in op de beheerde scriptmap, bijvoorbeeld "C:\\psscripts" in JSON. Behoud andere instellingen.
Plaats het goedgekeurde .ps1-bestand daar, herlaad de Agent-configuraties en controleer de status.

Hoe start je een script?

Scheduler: voeg een actie toe met Applicatie LocalScripting en Actie Run Script. Selecteer de vaste connector en het juiste script.
User Action: koppel de actie aan een ondersteunde trigger op de tabel of het record. Een nieuwe rij kan bijvoorbeeld een lokale exportactie starten.
IDU: gebruik de scriptactie in de ingerichte medewerkerautomatisering. De beschikbare invoer- en uitvoeropties hangen af van de versie.

Leg toegestane invoer, controle op dubbele uitvoering, uitvoeringsrechten en foutopvolging vast. Voer geen vrij door bezoekers ingevoerde PowerShell-opdrachten uit.

Een fout moet als fout terugkomen

De aanvullende IDU-scriptingnaslag beschrijft 0 als succes en een andere exitcode als fout. Een cmdlet-fout mag niet onbedoeld eindigen met succes, omdat het proces anders ten onrechte kan doorgaan. Gebruik passende foutafhandeling en controleer het werkelijke resultaat.

Result Variables: uitsluitend JSON op stdout

Wanneer Result Variables actief zijn, interpreteert Qixium stdout als JSON. Schrijf daar één JSON-object naartoe, zonder extra meldingen van Write-Host, hulpcmdlets of transcript-start/stop. Sla gedetailleerde logging apart op en voorkom dat geheimen in logs terechtkomen.

Onderstaand illustratief voorbeeld verandert geen AD of database. Pas het resultaatmodel en de foutcodes aan jouw ingerichte actie aan; dit is niet op jouw Agent uitgevoerd.

$ErrorActionPreference = 'Stop'
try {
    # Voorbeeld zonder wijzigingen in AD of databases.
    $result = [pscustomobject]@{
        success = $true
        checkedAtUtc = (Get-Date).ToUniversalTime().ToString('o')
    }
    $result | ConvertTo-Json -Compress | Write-Output
    exit 0
}
catch {
    [pscustomobject]@{ success = $false; errorCode = 'SCRIPT_FAILED' } |
        ConvertTo-Json -Compress | Write-Output
    exit 1
}

Webhook bij asynchrone afhandeling

De aanvullende naslag beschrijft Output Capture Mode: Webhook voor bepaalde uitgebreide scripts en sessies. Daarbij meldt het script de afronding aan de juiste instantie met de requestcontext en resultaatvelden output, success en exitCode. Kies dit uitsluitend als jouw connectorversie en actie hiervoor zijn ingericht. Kopieer geen callback met een andere instantie of vaste sleutel.

Deze aanvullende IDU-naslag staat in Confluence als gearchiveerd. Verifieer daarom de capture-mode en callback voor jouw versie voordat je deze route gebruikt. De actuele LocalScripting-handleiding bevestigt het uitvoeren via Agent, Scheduler, User Action en IDU.

PowerShell-export naar CSV naar je serviceproces

Een goedgekeurd script leest alleen de benodigde AD-velden en schrijft een CSV-export. De CSV Reader leest het bestand; Data Link verwerkt de rijen op een stabiele sleutel. Daarna kan de ingerichte verwerking de afgesproken gegevens in je servicetool bijwerken, bijvoorbeeld TOPdesk. Controleer exportfouten, een leeg bestand en ontbrekende sleutels voordat een vervolgactie schrijft.

Bekijk PowerShell-integraties en voorbeeldprocessen

Terug naar Agent en connectoren

Bronnen en versie

Bronnen gecontroleerd op 6 november 2026. Schermnamen en mogelijkheden hangen af van je geïnstalleerde versie en inrichting.

Bekijk de actuele versie in de wiki