Powershell: لا تعمل المساعدة القائمة على التعليق مع البرامج النصية التي تبدأ بـ shebang

لا يقوم PowerShell بتحليل التعليمات المستندة إلى التعليقات لبرنامج نصي ما لم يبدأ تعليق التعليمات في السطر الأول من البرنامج النصي. هذا يمنع البرامج النصية التي تستخدم shebang من أن تكون مفيدة عبر 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