Show error message when activate.sh/ps1 is invoked directly instead of sourced (#7731)

Helps users avoid a common mistake which is otherwise not obvious.

1 files changed, 8 insertions, 1 deletions

diff --git a/activate.ps1 b/activate.ps1
index 78e8557fc8..194ac8d349 100644
--- a/activate.ps1
+++ b/activate.ps1
@@ -1,9 +1,16 @@
 #
 # This file must be used by invoking ". .\activate.ps1" from the command line.
-# You cannot run it directly.
+# You cannot run it directly. See https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_scripts#script-scope-and-dot-sourcing
+#
 # To exit from the environment this creates, execute the 'deactivate' function.
 #
 
+if ($MyInvocation.CommandOrigin -eq 'runspace') {
+    Write-Host -f Red "This script cannot be invoked directly."
+    Write-Host -f Red "To function correctly, this script file must be 'dot sourced' by calling `". $PSCommandPath`" (notice the dot at the beginning)."
+    exit 1
+}
+
 function deactivate ([switch]$init) {
 
     # reset old environment variables