> For the complete documentation index, see [llms.txt](https://docs.poshtools.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.poshtools.com/open-source-tools/psmsi/troubleshooting.md).

# Troubleshooting

* Use `-Verbose` on `New-Installer` to see WiX compiler and linker output.
* Verify every file referenced by `New-InstallerFile`, `AddRemoveProgramsIcon`, shortcut icons, and UI parameters exists before building.
* Keep file and directory IDs unique when you specify them manually.
* Use a stable `UpgradeCode` and increase `Version` for upgrade releases.
* Use `-RequiresElevation` for installers that write to protected machine locations such as Program Files.
* Inspect the generated `.wxs` file when WiX reports validation or linking errors.