PowerShell：脚本 Comment_Based_Help 出现“Get-Help 找不到主题帮助”错误

Posted 2023-02-16

【中文标题】PowerShell：脚本 Comment_Based_Help 出现“Get-Help 找不到主题帮助”错误

【英文标题】：PowerShell: "Get-Help Cannot find Help for topic" error with script Comment_Based_Help

【发布时间】：2012-01-15 06:55:27

【问题描述】：

尝试从脚本中检索帮助会出现以下错误：

Get-Help : Cannot find Help for topic ".\Process-Test.ps1".
At line:1 char:9
+ get-help <<<<  .\Process-Test.ps1
    + CategoryInfo          : ResourceUnavailable: (:) [Get-Help], HelpNotFoundException
    + FullyQualifiedErrorId : HelpNotFound,Microsoft.PowerShell.Commands.GetHelpCommand

我在尝试从 任何 自定义 PowerShell 脚本中检索帮助信息时遇到了同样的错误。从内置 cmdlet 查看帮助信息时不会发生这种情况。

测试脚本如下：

<#
    .SYNOPSIS 
    Adds a file name extension to a supplied name.

    .DESCRIPTION
    Adds a file name extension to a supplied name. 
    Takes any strings for the file name or extension.

    .EXAMPLE
    C:\PS> extension -name "File"
    File.txt
#>

Write-Host "Test script"

我已采取的故障排除步骤：

我已将此脚本（或类似脚本）复制到其他安装了 PowerShell 的计算机上，并使用它成功查看了帮助。 我还能够在我的计算机上使用其他帐户 (User2) 成功查看帮助，但仅在以其他用户身份登录时（与以 User1 身份登录时以 User2 身份运行 PowerShell 控制台相比）。 我尝试在加载和不加载 PowerShell 配置文件的情况下查看帮助，结果相同（我只加载了一个配置文件，我的个人配置文件与机器配置文件）。 我认为这表明我的 Windows 用户配置文件存在问题，因此我删除了我的配置文件并重新创建它，结果相同。我也尝试过运行系统还原，没有任何变化。 这发生在 PowerShell 控制台和 ISE 中。 同时使用 Get-Help 和帮助时发生。

但是，我注意到，在删除和重新创建 Windows 用户配置文件（高度、宽度、颜色等）的过程中，我的 PowerShell 控制台设置保持一致，这是我在删除用户配置文件后没有预料到的。

由于我使用的是 Windows 7，我无法卸载 PowerShell 并重新安装，因为它已嵌入操作系统。

在这种情况下，Google 对我没有帮助，但我的 Google 技能可能有所欠缺。有关进一步的故障排除步骤的任何想法，或者以前见过此错误的任何人？

编辑：这仅发生在 64 位版本的控制台和 ISE 上，不适用于 32 位版本，并且通过配置文件删除持续存在

【问题讨论】：

我刚刚在我的机器上运行它并且它工作正常。您是否尝试在有问题的机器上创建新用户？

如果 PowerShell 目录中存在某些问题，您可以从工作机器复制 PowerShell 目录并在其上运行文件夹 diffmerge 以查看是否有任何文件不同。

作为故障排除步骤的一部分，我在问题机器上以其他用户身份登录时能够获得帮助。尽管我可以访问两个不同的帐户，但我无法创建新的用户帐户，因为它是一台工作笔记本电脑。

啊，是的，这很奇怪。删除您的配置文件应该清除您的 C:\users\user 目录并包括 HKCU 注册表配置单元。

使用 diffmerge 将问题机器上的 PowerShell 目录与已​​知良好的机器进行比较，唯一的区别在于安装的 RSAT 工具/添加的功能。

【参考方案1】：

您是否尝试过设置执行策略？

Set-ExecutionPolicy -ExecutionPolicy remotesigned -Scope process

然后做Get-Help .\script.ps1。

【讨论】：

.\ 是我所缺少的。

【参考方案2】：

我遇到了同样的问题。那是因为我的脚本位于 DFS 文件夹中的网络共享上。所以我指的是网络文件。当我将文件复制到本地，直接在我的 C 驱动器的根目录上，并使用普通的 get-help myscript.ps1 参数调用我的脚本的帮助选项时，它起作用了！