PowerShell Get-Help filename.ps1仅显示文件名

Question

在PowerShell 5.0 Get-Help中,不显示脚本的基于注释的帮助.而是仅打印文件名.

对于此代码,不显示注释块的值:

# dare.ps1
<# 
.SYNOPSIS
     The answer
.DESCRIPTION
     Answer to the Ultimate Question of Life, the Universe, and Everything.
#>
"The answer to the Ultimate Question of Life, the Universe and Everything is {0}" -f 42 

命令

PS C:\> Get-Help .\dare.ps1

产量

dare.ps1

Answer 1

基于注释的帮助的打开需要在第一行,或者在第一个注释或代码与基于注释的帮助块之间需要更多空间.

选项1 - 添加行间距

代码有额外的空间

# dare.ps1

<# 
.SYNOPSIS
     The answer
.DESCRIPTION
     Answer to the Ultimate Question of Life, the Universe, and Everything.
#>
"The answer to the Ultimate Question of Life, the Universe and Everything is {0}" -f 42 

选项2 - 首先放置基于注释的帮助块

基于注释的帮助块首先

<# 
.SYNOPSIS
     The answer
.DESCRIPTION
     Answer to the Ultimate Question of Life, the Universe, and Everything.
#>
"The answer to the Ultimate Question of Life, the Universe and Everything is {0}" -f 42 

结果

NAME
    C:\dare.ps1

SYNOPSIS
    The answer


SYNTAX
    C:\dare.ps1 [<CommonParameters>]


DESCRIPTION
    Answer to the Ultimate Question of Life, the Universe, and Everything.