jjzjj

windows - 重复的HelpFiles(about_)阻止Get-Help显示信息。如何解决？

coder 2024-06-11 原文

问题:我有两个about_psreadline帮助主题: about_psreadline 和 about_PSReadLine 。 Get-Help cmdlet无法显示有关它们的任何信息。 Get-Help about_psreadline仅显示包含两个提及的帮助文件的表。

问题:如何处理重复的HelpFile？可以/应该删除其中之一吗？

Powershell版本:6.1.3;我还检查了PSModulePath，包含PSReadline的唯一路径是C:\program files\powershell\6\Modules

最佳答案

只要Get-Help显示主题列表而不是所请求主题的内容(尽管提供了特定主题的名称)，就可以在各个列表项上调用.ToString()来显示其内容；例如，显示第一项的内容:

(Get-Help about_PSReadLine)[0].ToString()

为了显示所有内容，一个紧接一个显示:
Get-Help about_PSReadLine | ForEach-Object ToString

正如您所发现的，重命名或删除重复的文件可以持久解决问题。有关如何查找的信息，请参见下文。

但是，这样做不是必需的，因为观察到的行为可能是一个错误-请参见this GitHub issue;详细信息如下。

从PowerShell Core 6.2.0-rc.1开始适用

问题源于可用的给定概念性帮助主题的多个版本，原因是:
  • 正在安装基础PowerShell模块的多个版本...
  • 和/或-对于内置模块(PowerShell附带的模块)-即使在安装了较新版本的内置模块之后，预安装的帮助文件仍然可以使用。
  • 从Windows PowerShell v5.1/PowerShell Core 6.2.0开始，这仅是内置模块(PSReadLine，Microsoft.PowerShell.Archive，PackageManagement，PowerShellGet)的子集的一个选项。

    • 笔记:
  • 多版本问题似乎仅影响概念性帮助主题(about_*)，这些主题作为单独的*.help.txt文件实现。
  • 相反，给定模块的cmdlet的帮助主题通常作为单个MAML文件(其名称包含模块名称的*-help.xml文件)的一部分提供。仅将此类主题的一个版本视为当前版本，因此直接显示其内容(不列出多个版本)。
    • 鉴于此，具有多个概念性帮助主题的不同且晦涩的行为是，很可能是错误，尤其是在您无法确定所列项目与哪个版本相关的情况下。在相关说明中，对于非概念性主题，目前尚没有来查看其他版本的帮助，这似乎是设计限制。
  • 帮助主题可以作为给定模块的一部分提供，或者对于内置模块，可以在与PowerShell可执行文件相同的文件夹中的以该语言命名的子文件夹(例如en-US)中提供。
    至少在PowerShell Core中，按需安装的模块似乎还可以将主题放置在Help文件夹中，该文件夹是$env:PSModulePath中列出的其他文件夹的同级文件夹；在这些Help文件夹中，概念性的帮助主题似乎可以同时出现在顶层(特定于语言的文件夹中)和为模块命名的子文件夹中(特定于语言的文件夹中)-我不清楚其背后的逻辑。

    • 我不清楚给定帮助主题的多个版本之间的确切优先顺序规则/列出顺序；在Windows PowerShell中，似乎首先安装了与powershell.exe一起安装的概念性帮助主题版本，但在PowerShell Core中似乎并非如此。

    不幸的是，检查列表项的属性不会显示其源文件，而仅显示其源文件的长度(以字节为单位)。

    但是，您可以独立定位帮助文件:以下帮助函数(功能更全的版本可以从this Gist下载)基于您自己的命令，用于为给定的概念性帮助主题或模块查找所有帮助文件。姓名:
    function Get-HelpFile($fileNamePart) { 
  # Note the use of Split-Path -Parent, because help files can be in sibling
  # folders of $env:PSModulePath folders.
  Split-Path -Parent ($env:PSModulePath -split [IO.Path]::PathSeparator) | 
      Get-ChildItem -File -Recurse -Filter *$fileNamePart* |
        Where-Object Name -match '(?:\.help\.txt|-help.xml)$'
}

# Find help source files whose name contains 'about_psreadline'
Get-HelpFile about_psreadline

    您可以传递帮助文件名称中包含的任何子字符串，例如模块名称，例如PSReadLine，但是请注意，由于概念性帮助主题不一定包含与之关联的模块的名称，因此不一定显示与该模块关联的所有帮助文件。
    此外，某些模块名称未反射(reflect)在其帮助文件名称中，尤其是模块Microsoft.PowerShell.Core(帮助文件名为System.Management.Automation.dll-Help.xml)和Microsoft.PowerShell.Management(帮助文件名为Microsoft.PowerShell.Commands.Management.dll-Help.xml)。

    如果将上述命令通过管道传递给| Select FullName, Length，它将在完整路径旁边列出以字节为单位的文件大小(属性.Length)，该文件大小可以与Get-Help about_PSReadLine | Select Length报告的大小相关联，从而推断出主题的顺序被列出。

    关于windows - 重复的HelpFiles(about_)阻止Get-Help显示信息。如何解决？，我们在Stack Overflow上找到一个类似的问题： https://stackoverflow.com/questions/55111945/

    HelpFilesGet-HelpcodestrongPowerShellwindowspowershell-core

    有关windows - 重复的HelpFiles(about_)阻止Get-Help显示信息。如何解决？的更多相关文章

    1. ruby - 如何使用 Nokogiri 的 xpath 和 at_xpath 方法 - 2

      我正在学习如何使用Nokogiri，根据这段代码我遇到了一些问题:require'rubygems'require'mechanize'post_agent=WWW::Mechanize.newpost_page=post_agent.get('http://www.vbulletin.org/forum/showthread.php?t=230708')puts"\nabsolutepathwithtbodygivesnil"putspost_page.parser.xpath('/html/body/div/div/div/div/div/table/tbody/tr/td/div

    2. ruby - 如何从 ruby​​ 中的字符串运行任意对象方法？ - 2

      总的来说，我对ruby​​还比较陌生，我正在为我正在创建的对象编写一些rspec测试用例。许多测试用例都非常基础，我只是想确保正确填充和返回值。我想知道是否有办法使用循环结构来执行此操作。不必为我要测试的每个方法都设置一个assertEquals。例如:describeitem,"TestingtheItem"doit"willhaveanullvaluetostart"doitem=Item.new#HereIcoulddotheitem.name.shouldbe_nil#thenIcoulddoitem.category.shouldbe_nilendend但我想要一些方法来使用

    3. ruby - Facter::Util::Uptime:Module 的未定义方法 get_uptime (NoMethodError) - 2

      我正在尝试设置一个puppet节点，但ruby​​gems似乎不正常。如果我通过它自己的二进制文件(/usr/lib/ruby/gems/1.8/gems/facter-1.5.8/bin/facter)在cli上运行facter，它工作正常，但如果我通过由ruby​​gems(/usr/bin/facter)安装的二进制文件，它抛出:/usr/lib/ruby/1.8/facter/uptime.rb:11:undefinedmethod`get_uptime'forFacter::Util::Uptime:Module(NoMethodError)from/usr/lib/ruby

    4. ruby - 在 Ruby 程序执行时阻止 Windows 7 PC 进入休眠状态 - 2

      我需要在客户计算机上运行Ruby应用程序。通常需要几天才能完成(复制大备份文件)。问题是如果启用sleep，它会中断应用程序。否则，计算机将持续运行数周，直到我下次访问为止。有什么方法可以防止执行期间休眠并让Windows在执行后休眠吗？欢迎任何疯狂的想法;-) 最佳答案 Here建议使用SetThreadExecutionStateWinAPI函数，使应用程序能够通知系统它正在使用中，从而防止系统在应用程序运行时进入休眠状态或关闭显示。像这样的东西:require'Win32API'ES_AWAYMODE_REQUIRED=0x0

    5. python - 如何使用 Ruby 或 Python 创建一系列高音调和低音调的蜂鸣声？ - 2

      关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题？更新问题，以便editingthispost可以用事实和引用来回答它.关闭4年前。Improvethisquestion我想在固定时间创建一系列低音和高音调的哔哔声。例如:在150毫秒时发出高音调的蜂鸣声在151毫秒时发出低音调的蜂鸣声200毫秒时发出低音调的蜂鸣声250毫秒的高音调蜂鸣声有没有办法在Ruby或Python中做到这一点？我真的不在乎输出编码是什么(.wav、.mp3、.ogg等等)，但我确实想创建一个输出文件。

    6. ruby-on-rails - 如何验证 update_all 是否实际在 Rails 中更新 - 2

      给定这段代码defcreate@upgrades=User.update_all(["role=?","upgraded"],:id=>params[:upgrade])redirect_toadmin_upgrades_path,:notice=>"Successfullyupgradeduser."end我如何在该操作中实际验证它们是否已保存或未重定向到适当的页面和消息？ 最佳答案 在Rails3中，update_all不返回任何有意义的信息，除了已更新的记录数(这可能取决于您的DBMS是否返回该信息)。http://ar.ru

    7. ruby-on-rails - 'compass watch' 是如何工作的/它是如何与 rails 一起使用的 - 2

      我在我的项目目录中完成了compasscreate.和compassinitrails。几个问题:我已将我的.sass文件放在public/stylesheets中。这是放置它们的正确位置吗？当我运行compasswatch时，它不会自动编译这些.sass文件。我必须手动指定文件:compasswatchpublic/stylesheets/myfile.sass等。如何让它自动运行？文件ie.css、print.css和screen.css已放在stylesheets/compiled。如何在编译后不让它们重新出现的情况下删除它们？我自己编译的.sass文件编译成compiled/t

    8. ruby-on-rails - Rails 编辑表单不显示嵌套项 - 2

      我得到了一个包含嵌套链接的表单。编辑时链接字段为空的问题。这是我的表格:Editingkategori{:action=>'update',:id=>@konkurrancer.id})do|f|%>'Trackingurl',:style=>'width:500;'%>'Editkonkurrence'%>|我的konkurrencer模型:has_one:link我的链接模型:classLink我的konkurrancer编辑操作:defedit@konkurrancer=Konkurrancer.find(params[:id])@konkurrancer.link_attrib

    9. ruby-on-rails - Rails 常用字符串(用于通知和错误信息等) - 2

      大约一年前，我决定确保每个包含非唯一文本的Flash通知都将从模块中的方法中获取文本。我这样做的最初原因是为了避免一遍又一遍地输入相同的字符串。如果我想更改措辞，我可以在一个地方轻松完成，而且一遍又一遍地重复同一件事而出现拼写错误的可能性也会降低。我最终得到的是这样的:moduleMessagesdefformat_error_messages(errors)errors.map{|attribute,message|"Error:#{attribute.to_s.titleize}#{message}."}enddeferror_message_could_not_find(obje

    10. ruby - 如何将脚本文件的末尾读取为数据文件(Perl 或任何其他语言) - 2

      我正在寻找执行以下操作的正确语法(在Perl、Shell或Ruby中):#variabletoaccessthedatalinesappendedasafileEND_OF_SCRIPT_MARKERrawdatastartshereanditcontinues. 最佳答案 Perl用__DATA__做这个:#!/usr/bin/perlusestrict;usewarnings;while(){print;}__DATA__Texttoprintgoeshere 关于ruby-如何将脚

    随机推荐