Table of Contents

Hosts

Universal Data Generator ships four hosts. Each one acquires a run configuration, hands it to the Core engine, and reports progress. None of them reimplements scheduling, value generation, or target writes.

PowerShell module

A binary cmdlet module. It exports two cmdlets.

Cmdlet Purpose
Import-UniDataGenCatalog Writes the embedded catalog to the pipeline.
Start-UniDataGenRun Runs a configuration until stopped with Ctrl-C.
Import-Module ./hosts/UniDataGen.PowerShell/bin/Debug/net10.0/UniDataGen.PowerShell.dll
Start-UniDataGenRun -ConfigPath ./run-config.json -Offline -Verbose
Parameter Description
-ConfigPath Path to the run configuration.
-TickSeconds The engine tick interval. Defaults to 2.
-Offline Skips Foundry and uses placeholder values.
-AppInsightsConnectionString Routes logs to Application Insights.

Azure Functions host

An isolated worker. The GeneratorTimer function runs a bounded generation pass on a timer. It reads the run-config path from app settings. The catalog is embedded.

App setting Purpose
DATAGEN_CONFIG Path to the run configuration.
DATAGEN_OFFLINE true to skip Foundry.
APPLICATIONINSIGHTS_CONNECTION_STRING Application Insights connection string.

Note: The timer drives batch cadence. For continuous real-time generation that must survive host recycles, promote the timer function to a Durable Functions orchestration. See Architecture overview.

WinForms client

A desktop client for Windows. It loads the embedded catalog into pick lists, builds each entity profile through a grid, previews boost ramp curves, selects targets, and runs locally or saves the run configuration. The toolbar has a field for the Application Insights connection string, and the log box mirrors every structured log line.

Configuration editor

UniDataGen.ConfigEditor is a Windows desktop application for editing the run configuration through a property grid. It reads and writes the same run-config JSON the other hosts consume, and keeps its reference lists and preferences in local JSON files. See Configuration editor.

Foundry agent tool

A console wrapper that exposes the engine as a single callable operation for an Azure AI Foundry agent. The function schema is in hosts/UniDataGen.Foundry.Tool/tool-manifest.json.

UniDataGen.Foundry.Tool ./run-config.json --offline --seconds 30