如何设置PowerShell中Update-Help的帮助文件安装路径？

以下是几种可行的解决方法，涵盖临时和永久方案：

方法一：单次会话临时指定帮助文件路径 #

在运行Update-Help前，手动修改PowerShell的用户文档环境变量，将帮助文件导向目标路径：

# 先创建目标文件夹（示例为PowerShell 7安装目录下的Help文件夹，可自行替换）
New-Item -Path "C:\Program Files\PowerShell\7\Help" -ItemType Directory -Force
# 临时覆盖用户文档路径
$env:PSDOCUMENTSDIR = "C:\Program Files\PowerShell\7"
# 执行帮助文件更新
Update-Help -Force -UICulture en-us

执行后，帮助文件会直接安装到指定的C:\Program Files\PowerShell\7\Help目录。

方法二：永久配置自定义帮助文件路径 #

编辑PowerShell的用户配置文件（$PROFILE），添加以下内容，让每次启动PowerShell时自动生效：

# 替换为你想要的目标根路径
$targetDir = "C:\Program Files\PowerShell\7"
# 设置PowerShell文档路径
$env:PSDOCUMENTSDIR = $targetDir
# 确保Help文件夹存在，不存在则创建
if (-not (Test-Path "$targetDir\Help")) {
    New-Item -Path "$targetDir\Help" -ItemType Directory -Force | Out-Null
}

保存配置文件后，重启PowerShell，再运行Update-Help即可将文件安装到指定位置。

方法三：用符号链接绕开OneDrive同步 #

如果不想修改环境变量，可以通过符号链接让PowerShell读取指定路径的帮助文件：

# 先将OneDrive中已有的Help文件夹移动到目标路径（示例路径自行替换）
Move-Item -Path "$env:OneDrive\Documents\PowerShell\Help" -Destination "C:\Program Files\PowerShell\7\Help" -Force
# 创建符号链接，让原OneDrive路径指向新的目标路径
New-Item -Path "$env:OneDrive\Documents\PowerShell\Help" -ItemType SymbolicLink -Target "C:\Program Files\PowerShell\7\Help"

后续运行Update-Help时，文件会实际存储在目标路径，OneDrive中仅保留一个不占用同步空间的链接。

补充说明 #

• 修改PSModulePath无效的原因：帮助文件的存储位置与PSModulePath无关，它默认绑定PowerShell的用户文档目录（由PSDOCUMENTSDIR环境变量控制，默认继承系统的“文档”文件夹），你的系统“文档”被OneDrive同步，所以路径指向OneDrive。
• 复制文件后失效的原因：PowerShell优先搜索$PSDOCUMENTSDIR\Help目录下的帮助文件，仅当该目录为空时才会查找其他路径，因此单纯复制到模块目录无法被识别。

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