-
Notifications
You must be signed in to change notification settings - Fork 2
Troubleshooting
pete-mc edited this page Jul 9, 2026
·
5 revisions
Start here when something doesn't work. The single most useful step:
Dataverse PowerTools: Show Log — opens the extension's output channel, where every connection, build, and deploy step is logged. Most fixes start with reading it.
| Symptom | Fix |
|---|---|
| Status bar shows Dataverse Not Connected | Run Refresh Dataverse Connection. If it persists, Update Dataverse Authentication and re-enter details. |
Error refreshing authorization token |
The token expired or the secret changed — Refresh Dataverse Connection, or re-run Update Dataverse Authentication. |
| Environment list is empty (service principal) | The app isn't an Application User in that environment; add it, or type the URL manually when prompted. |
| Credentials seem lost between sessions | Reconnect with Refresh Dataverse Connection. Secrets live in VS Code secret storage per machine — a fresh clone always needs to authenticate once. |
More: Connecting & Authentication.
| Symptom | Fix |
|---|---|
| A row is ❌ in System Requirements | Install the missing tool (Getting Started); use Add Missing npm Globals for npm packages, then Recheck Requirements. |
Commands that call dotnet/pac do nothing |
Confirm .NET SDK and pac are installed and on PATH; reopen the terminal/VS Code after installing so PATH refreshes. |
npm ERESOLVE while creating a Web Resources project |
Fixed in current versions (TypeScript pinned). Update the extension; if you still hit it, delete node_modules and re-run Restore Dependencies. |
The extension runs on Windows, macOS, and Linux. Two things are Windows-only because they wrap Windows binaries:
-
Web resource typings (
XrmDefinitelyTyped.exe) — see Web Resources. Build and deploy still work on macOS/Linux; you just won't get generated form typings there. - The deprecated pre-v3 (
spkl) plugin path — create a new (v3) plugin project to move to the cross-platformpac/dotnetflow.
Everything else — solutions, plugin build/deploy, web resource build/deploy, portals — is cross-platform.
- Solutions → Solutions › Troubleshooting
- Web Resources → Web Resources › Troubleshooting
- Plugins → Plugins › Troubleshooting
- Portals → Portals › Troubleshooting
Open an issue on the GitHub repository with the relevant output from Show Log (redact any secrets first).