powershell参数通过类型标注和验证属性实现类型与业务规则控制：先自动转换类型，再执行validate*检查；可组合使用，如string[validatescript({test-path $_ -pathtype container})][parameter(mandatory)]$logpath。
powershell 脚本参数本身不强制类型限制，但可通过 参数声明中的类型标注 和 验证属性（validate*） 实现有效控制。类型标注让 powershell 自动尝试转换并报错拦截非法值；验证属性则在转换后进一步检查业务逻辑是否合规。
用中括号标注参数类型
这是最基础、最常用的方式。PowerShell 会在传入参数时自动尝试转换为指定类型，失败则直接报错。
-
[string]：只接受字符串或可转为字符串的值（如数字
42会转成"42"） -
[int] 或 [int32]：只接受整数，
"123"可转，"abc"或"12.5"会报错 -
[bool]：接受
$true、$false、"true"、"false"、"1"、"0"等，其他字符串报错 -
[DateTime]：支持多种格式（如
"2026-10-09"、"Oct 9, 2026"），解析失败即终止 - [ValidateSet("Start", "Stop", "Restart")]：限定只能是这几个字符串之一，大小写敏感
用验证属性强化业务规则
类型标注解决“是不是这个类型”，验证属性解决“符不符合使用要求”。它们可组合使用，顺序是：先类型转换 → 再验证属性检查。
- [ValidateRange(1, 100)]：适用于数值型参数，确保值在闭区间内
- [ValidateLength(3, 20)]：限制字符串长度，对用户名、密码等很实用
- [ValidatePattern("^\d{3}-\d{2}-\d{4}$")]：用正则校验格式，比如社保号
- [ValidateScript({ Test-Path $_ -PathType Container })]：执行任意脚本判断，例如确认路径存在且是文件夹
-
[AllowNull()] 或 [AllowEmptyString()]：显式允许空值，否则
[string]类型默认拒绝空字符串
参数位置与必选性控制
类型和验证之外，还需明确参数是否必须提供、是否支持管道输入等，这影响调用体验和健壮性。
- [Parameter(Mandatory)]：该参数必须传入，否则报错
- [Parameter(ValueFromPipeline)]：支持从管道接收对象（按属性名匹配）
- [Parameter(ValueFromPipelineByPropertyName)]：按属性名绑定，适合处理对象流
-
[Parameter(Position = 0)]：设为位置参数，调用时可省略参数名（如
.script.ps1 value）
完整示例：一个带多重限制的参数声明
下面这段代码定义了一个参数 $LogPath，它要求是字符串、非空、长度 5–255、必须是合法路径且为文件夹：
[CmdletBinding()]
param(
[Parameter(Mandatory)]
[ValidateLength(5, 255)]
[ValidateScript({ Test-Path $_ -PathType Container })]
[string]$LogPath
)
