helpmessage 参数属性用于为 mandatory = $true 的参数提供交互式提示，当用户遗漏必需参数时，powershell 暂停并显示该提示（如“请输入目标文件夹路径，例如：c:\temp”），等待用户输入；仅对强制参数生效，建议包含示例值且与验证规则一致。
在 powershell 脚本中，使用 helpmessage 参数属性可以为参数提供简短、实用的提示信息，当用户运行脚本但遗漏了必需参数时，powershell 会自动显示该提示，引导用户正确输入。
HelpMessage 的作用场景
它主要用在带有 [Parameter(Mandatory = $true)] 的参数上。当用户没提供该参数又没加 -WhatIf 或跳过确认时，PowerShell 不会直接报错退出，而是暂停并显示你写的 HelpMessage，等待用户手动输入值。
基本写法（函数或脚本块中）
在参数声明中通过 Parameter 特性设置 HelpMessage：
param(
[Parameter(Mandatory = $true, HelpMessage = "请输入目标文件夹路径，例如：C:\Temp")]
[string]$Path,
[Parameter(Mandatory = $true, HelpMessage = "请选择操作模式：Backup 或 Restore")]
[ValidateSet("Backup", "Restore")]
[string]$Mode
)
实际运行效果
假设保存为 Deploy.ps1，执行时只输入：
.\Deploy.ps1
PowerShell 会依次提示：
-
cmdlet Deploy.ps1 at command pipeline position 1
Supply values for the following parameters:
Type help for more info. - Path: （此时光标等待输入，上方已显示你写的提示）
- 输入完 Path 后，继续提示 Mode:
注意事项和技巧
- HelpMessage 只对
Mandatory = $true的参数生效；非必需参数即使写了也不会触发交互提示 - 提示内容建议包含典型值或格式示例（如路径、日期格式、可选值），避免只写“请输入XXX”
- 如果参数有
ValidateScript或ValidateSet，HelpMessage 应与校验规则一致，减少用户输错重试 - 不支持换行，若需多行说明，可用
`n拼接，但实际显示可能被截断，建议保持单行简洁
HelpMessage 是提升脚本易用性的轻量级方式，不需要额外文档就能让用户快速上手。
