UseCompatibleSyntax

严重程度等级:错误

默认状态:禁用

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 会标记任何你目标版本中不支持的语法。