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