严重程度等级:错误
默认状态:禁用
Description
该规则检测与你指定 PowerShell 目标版本不兼容的语法元素。 当你用PowerShell 3或4运行这个规则时,它无法检测与这些版本不兼容的语法,因为这些版本无法解析较新的语法结构。
Example
非符合性
以下示例使用PowerShell 7语法。 如果 TargetVersions 包含 5.1 或更早,则该规则会标记这些语句。
$message = $IsReady ? 'Ready' : 'Not ready'
$displayName = $name ?? 'Unknown'
合规的
if ($IsReady) {
$message = 'Ready'
} else {
$message = 'Not ready'
}
if ($name -ne $null) {
$displayName = $name
} else {
$displayName = 'Unknown'
}
配置规则
@{
Rules = @{
PSUseCompatibleSyntax = @{
Enable = $true
TargetVersions = @(
'6.0',
'5.1',
'4.0'
)
}
}
}
参数
启用
该参数控制 ScriptAnalyzer 是否会根据该规则检查代码。 它接受一个布尔值。 要启用该规则,将该参数设为 $true。 默认值为 $false。
目标版本
该参数指定了你的代码必须兼容的PowerShell版本。 它接受数组版本字符串,如 '7.0'、 '5.1'、 或 '4.0'。 ScriptAnalyzer 会标记任何你目标版本中不支持的语法。