Commands / Uninstall-sqmOdbcDriver
Driver Install/Uninstall

Uninstall-sqmOdbcDriver

Finds the installed Microsoft ODBC Driver for SQL Server in the Windows uninstall registry (64-bit and WOW6432Node) and removes it silently via msiexec /x. Typically run right before installing a newer driver version.

Module: sqmSQLTool
Requires: Local Administrator
ShouldProcess: No
Output: PSCustomObject

Execution Flow

START Scan Uninstall registry (64-bit + WOW6432Node) for -DriverName pattern Entry found? Status = NotFound Resolve ProductCode (registry key name or parsed from UninstallString) ProductCode resolved? Status = Error msiexec /x <ProductCode> /quiet /norestart ExitCode? 0 / 1605 / 3010 / other 0 or 3010 → Status = Uninstalled 1605 → NotFound other → Error Return PSCustomObject (Status, Message) DONE
Exit code 1605 ("this action is only valid for products that are currently installed") is treated as NotFound, not an error, the driver simply wasn't there. Exit code 3010 means the uninstall succeeded but a reboot is recommended. Without -DriverName, the registry is scanned for the pattern Microsoft ODBC Driver \d+ for SQL Server and the highest version number found is removed.

Parameters

ParameterTypeRequiredDescription
-DriverNameStringOptionalSpecific driver display name to match. Default: wildcard pattern Microsoft ODBC Driver * for SQL Server (matches the highest installed version).

Return Value

Returns a single PSCustomObject with: Status (Uninstalled, NotFound, or Error), Message.

Examples

Example 1, Remove whichever ODBC driver version is installed

Uninstall-sqmOdbcDriver

Example 2, Target a specific driver version explicitly

Uninstall-sqmOdbcDriver -DriverName "Microsoft ODBC Driver 17 for SQL Server"

Example 3, Uninstall, then install the newer driver

Uninstall-sqmOdbcDriver
Install-sqmOdbcDriver
⬆ Index
All Commands