如何为PowerShell内置命令'.'创建可用的source别名或函数？

问题现象 #

1. 创建别名无效 #

尝试用Set-Alias给.创建别名source，执行时报错：

PS C:\> Set-Alias source .
PS C:\> source $profile.CurrentUserAllHosts
source : The term '.' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name,
or if a path was included, verify that the path is correct and try again.
At line:1 char:1
+ source $profile.CurrentUserAllHosts
+ ~~~~~~
    + CategoryInfo          : ObjectNotFound: (.:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

2. 简单source函数无法加载脚本中的命令 #

创建简单函数后，用source加载脚本，脚本中定义的lastBoot命令无法被识别：

PS C:\> Get-Command source | % Definition
param($script)

        if( $script ) {
                . $script
        }

PS C:\> source $profile.CurrentUserAllHosts
PS C:\> lastBoot
lastBoot : The term 'lastBoot' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of
the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
+ lastBoot
+ ~~~~~~~~
    + CategoryInfo          : ObjectNotFound: (lastBoot:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

直接使用.命令正常工作 #

直接用内置的.点源脚本，lastBoot可以正常运行：

PS C:\> . $profile.CurrentUserAllHosts
PS C:\> lastBoot

CSName LastBootUpTime
------ --------------
myPC  15/07/2025 12:02:15

问题原因 #

1. 别名无效：Set-Alias仅能为cmdlet、函数、可执行文件等命令类型创建别名，而.是PowerShell的语言关键字，不属于命令范畴，因此无法通过Set-Alias映射。
2. 简单函数失效：函数默认在自身的局部作用域内执行.命令，脚本中定义的函数/变量只会存在于该局部作用域，函数执行完毕后作用域销毁，外部会话无法访问这些内容。

解决方法 #

创建能在调用者作用域内执行脚本的source函数，确保脚本中定义的内容留在当前会话作用域：

完整实现函数 #

function source {
    param(
        [Parameter(Mandatory=$true, Position=0)]
        [ValidateScript({ Test-Path $_ -PathType Leaf })]
        [string]$ScriptPath
    )

    # 在调用者的作用域中点源脚本
    $ExecutionContext.InvokeCommand.InvokeScript(
        $false, # useLocalScope: false 表示使用调用者的作用域
        ([scriptblock]::Create(". `"$ScriptPath`"")),
        $null,
        $null
    )
}

简化版（支持直接传参） #

function source {
    if (-not $args) {
        Write-Warning "请指定要加载的脚本路径"
        return
    }

    $scriptPath = Resolve-Path $args[0] -ErrorAction Stop
    $ExecutionContext.InvokeCommand.InvokeScript(
        $false,
        ([scriptblock]::Create(". `"$scriptPath`"")),
        $null,
        $null
    )
}

验证效果 #

执行以下命令测试：

# 加载配置文件
source $profile.CurrentUserAllHosts
# 执行脚本中定义的命令
lastBoot

此时lastBoot命令应该可以正常运行，和直接使用.的效果一致。

内容的提问来源于stack exchange，提问作者SebMa