Powershell: Справка на основе комментариев не работает для скриптов, начинающихся с shebang.

PowerShell не анализирует справку на основе комментариев для сценария, если комментарий справки не начинается в первой строке сценария. Это не позволяет скриптам, использующим шебанг, быть полезными через Get-Help .

PowerShell следует пропускать первую строку файла сценария, если он начинается с #! .

Действия по воспроизведению

Создайте новый скрипт с именем thing.ps1 с помощью shebang:

#!/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