Powershell: L'aide basée sur les commentaires ne fonctionne pas pour les scripts qui commencent par un shebang

PowerShell n'analyse pas l'aide basée sur les commentaires pour un script à moins que le commentaire d'aide ne commence sur la première ligne du script. Cela empêche les scripts utilisant un shebang d'être utiles via Get-Help .

PowerShell doit ignorer la première ligne d'un fichier de script s'il commence par #! .

Étapes à reproduire

Créez un nouveau script appelé thing.ps1 avec un shebang :

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

Comportement prévisible

PS> Get-Help thing.ps1

NAME
    /Users/aaron/src/thing.ps1

SYNOPSIS
    This does a thing

…

Comportement réel

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

Données environnementales

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