如何在 PowerShell 函数中添加帮助?
当我们写一个程序的时候,那些没有编程背景的人通常希望获得很多关于这个程序的帮助。当我们编写一个函数并声明参数时,那些不知道参数需要何种输入的人通常会先使用Get-Help命令来搜索帮助,然后他们只会找到参数,而没有找到其描述。例如,
function TestFunct{
param(
#16 Digit Application ID
[parameter(Mandatory=$true)]
[String]$AppID,
#Date in the Unix Format - 2020-10-31T17:12:10+0530
[String]$Date
)
}在上面的示例中,指定了两个参数,当用户获得此函数的帮助时,它不会指定提供参数描述的注释。例如,
PS C:\> help TestFunct -Parameter * -AppID <string> Required? true Position? 0 Accept pipeline input? false Parameter set name (All) Aliases None Dynamic? false -Date <string> Required? false Position? 1 Accept pipeline input? false Parameter set name (All) Aliases None Dynamic? false
要从注释中添加描述,我们需要添加基于注释的帮助,并需要使用基于注释的帮助中的SYNOPSIS。
示例
function TestFunct{
<#
.SYNOPSIS
This is test function for parameter based help
#>
param(
#16 Digit Application ID
[parameter(Mandatory=$true)]
[String]$AppID,
#Date in the Unix Format - 2020-10-31T17:12:10+0530
[String]$Date
)
}现在我们检查参数时,会得到基于注释的描述。
PS C:\> help TestFunct -Parameter * -AppID <String> 16 Digit Application ID Required? true Position? 1 Default value Accept pipeline input? false Accept wildcard characters? false -Date <String> Date in the Unix Format - 2020-10-31T17:12:10+0530 Required? false Position? 2 Default value Accept pipeline input? false Accept wildcard characters? false
广告
数据结构
网络
关系型数据库管理系统
操作系统
Java
iOS
HTML
CSS
Android
Python
C 编程
C++
C#
MongoDB
MySQL
Javascript
PHP