Configuration

Show-sqmToolGui

Launches the sqmSQLTool main WinForms GUI — a dark-themed launcher that lists all public module functions, supports filtering by name, and runs the selected function in a new PowerShell window.

Module: sqmSQLTool
Requires: none (WinForms)
ShouldProcess: No
Output: None (modal GUI)

Execution Flow

START 1. Get-Command -Module sqmSQLTool | Where-Object Name -like $Filter 2. Build WinForms window (dark VS palette) with ListBox + filter TextBox 3. Populate ListBox with sorted function names 4. Show modal GUI — user filters list, selects function, clicks Run Run clicked with selection? return (Close) 5. Start-Process pwsh — launches selected function in a new PowerShell window with -NoExit DONE
The GUI remains open after launching a function — allowing multiple functions to be run in sequence without re-opening the launcher. The filter TextBox uses -like wildcard matching and updates the ListBox in real time as the user types. The launched PowerShell window imports sqmSQLTool automatically.

Parameters

ParameterTypeRequiredDescription
-FilterStringOptionalWildcard filter applied to function names at startup. Default: '*' (all functions).

Return Value

No pipeline output. The function opens a modal WinForms window and returns when the window is closed.

Examples

Example 1 — Open the full function launcher

Show-sqmToolGui

Example 2 — Pre-filter to backup-related functions

Show-sqmToolGui -Filter '*Backup*'

Example 3 — Pre-filter to AlwaysOn functions

Show-sqmToolGui -Filter '*AlwaysOn*'