diff --git a/aspnetcore/testing/troubleshoot.md b/aspnetcore/testing/troubleshoot.md index 7ce1f2a0ab..24b061c21e 100644 --- a/aspnetcore/testing/troubleshoot.md +++ b/aspnetcore/testing/troubleshoot.md @@ -24,8 +24,8 @@ The following links provide troubleshooting guidance: ## .NET Core SDK warnings -### Both the 32 and 64 bit versions of the .NET Core SDK are installed -In the **New Project** dialog for ASP.NET Core, you may see the following warning appear at the top: +### Both the 32 bit and 64 bit versions of the .NET Core SDK are installed +In the **New Project** dialog for ASP.NET Core, you may see the following warning: Both 32 and 64 bit versions of the .NET Core SDK are installed. Only templates from the 64 bit version(s) installed at C:\Program Files\dotnet\sdk\" will be displayed. @@ -40,12 +40,24 @@ This warning appears when both 32-bit (x86) and 64-bit (x64) versions of the [.N Uninstall the 32-bit .NET Core SDK to prevent this warning. Uninstall from **Control Panel** > **Programs and Features** > **Uninstall or change a program**. If you understand why the warning occurs and its implications, you can ignore the warning. ### The .NET Core SDK is installed in multiple locations -In the **New Project** dialog for ASP.NET Core you may see the following warning appear at the top: +In the **New Project** dialog for ASP.NET Core you may see the following warning: The .NET Core SDK is installed in multiple locations. Only templates from the SDK(s) installed at 'C:\Program Files\dotnet\sdk\' will be displayed. ![A screenshot of the OneASP.NET dialog showing the warning message](troubleshoot/_static/multiplelocations.png) -You are seeing this message because you have at least one installation of the .NET Core SDK in a directory outside of *C:\Program Files\dotnet\sdk\*. Usually that happens when the .NET Core SDK has been deployed on a machine using copy/paste instead of the MSI installer. +You see this message when you have at least one installation of the .NET Core SDK in a directory outside of *C:\Program Files\dotnet\sdk\*. Usually that happens when the .NET Core SDK has been deployed on a machine using copy/paste instead of the MSI installer. Uninstall the 32-bit .NET Core SDK to prevent this warning. Uninstall from **Control Panel** > **Programs and Features** > **Uninstall or change a program**. If you understand why the warning occurs and its implications, you can ignore the warning. + +### No .NET Core SDKs were detected +In the **New Project** dialog for ASP.NET Core you may see the following warning: + +**No .NET Core SDKs were detected, ensure they are included in the environment variable 'PATH'** + +![A screenshot of the OneASP.NET dialog showing the warning message](troubleshoot/_static/NoNetCore.png) + +This warning appears when the environment variable `PATH` doesn’t point to any .NET Core SDKs on the machine. To resolve this problem: + +* Install or verify the .NET Core SDK is installed. +* Verify the `PATH` environment variable points to the location the SDK is installed. The installer normally sets the `PATH`. \ No newline at end of file diff --git a/aspnetcore/testing/troubleshoot/_static/NoNetCore.png b/aspnetcore/testing/troubleshoot/_static/NoNetCore.png new file mode 100644 index 0000000000..968286abd8 Binary files /dev/null and b/aspnetcore/testing/troubleshoot/_static/NoNetCore.png differ