Powershell: 基于注释的帮助不适用于以 shebang 开头的脚本

除非帮助注释从脚本的第一行开始，否则 PowerShell 不会解析脚本的基于注释的帮助。 这会阻止使用shebang 的脚本通过Get-Help 。

如果脚本文件以#!开头，PowerShell 应该跳过它的第一行。

重现步骤

使用shebang创建一个名为thing.ps1的新脚本：

#!/usr/bin/env pwsh
<#
.SYNOPSIS
This does a thing
#>

预期行为

PS> Get-Help thing.ps1

NAME
    /Users/aaron/src/thing.ps1

SYNOPSIS
    This does a thing

…

实际行为

PS> Get-Help thing.ps1
thing.ps1
…

环境数据

PS> $PSVersionTable

Name                           Value
----                           -----
PSVersion                      6.0.0-beta.9
PSEdition                      Core
GitCommitId                    v6.0.0-beta.9
OS                             Darwin 16.7.0 Darwin Kernel Version 16.7.0: Thu Jun 15 17:36:27 PDT 2017; root:xnu...
Platform                       Unix
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1
WSManStackVersion              3.0