PowerShell 2.0 遗留兼容与现代化

收集调用入口、计划任务、服务、宿主应用、模块、.NET 依赖、运行身份、数据源、输出与业务负责人；先证明“哪里依赖”，不要先打开旧引擎。

先在 Windows PowerShell 5.1 建立行为基线，再以 PowerShell 7 为目标逐项替换命令、模块和 .NET API；静态分析只能发现一部分问题，最终仍需真实测试。

灰度切换到受支持运行时，观察错误率、耗时和输出差异；回滚窗口结束后删除 2.0 功能、旧凭据、旧任务与镜像，并更新资产台账。

Windows PowerShell 2.0–5.1 基于 Windows/.NET Framework；PowerShell 7 使用 pwsh、基于现代 .NET 且可跨平台。两者可并行，但模块与 .NET API 不保证相同。

依次检查：脚本由哪个宿主启动、语法能否解析、命令/参数是否存在、模块和 .NET 类型能否加载、输出/副作用是否符合业务契约。

CIM cmdlet、类/枚举、工作流、PowerShell 7 的并行、三元/空合并与管道链等分属不同版本；维护者应标注目标版本，不靠记忆猜测。

回答：它缺少后来版本的增强日志和 AMSI 防护，又已经退出支持；“旧脚本能跑”只说明兼容，不说明运行时安全。

先记录当前引擎、版本、Edition、CLR 与平台；不要把 powershell.exe 和 pwsh.exe 当作同一个运行时。

$PSVersionTable | Format-List PSVersion, PSEdition, BuildVersion, CLRVersion, Platform, OS

PSScriptAnalyzer 的兼容规则能提示目标版本缺少的语法、命令、cmdlet 和类型；把结果当作待验证线索，不当作完整证明。

Invoke-ScriptAnalyzer -Path . -Recurse -Severity Warning,Error | Format-Table RuleName,Severity,ScriptName,Line,Message -Wrap

先列出仓库中的脚本与模块清单文件，再由维护者逐项补充入口、调用者、负责人和最后运行时间；不自动执行发现的脚本。

Get-ChildItem -LiteralPath . -Recurse -File | Where-Object Extension -in '.ps1','.psm1','.psd1' | Select-Object FullName,Length,LastWriteTime

每个任务记录：宿主/版本、运行身份、触发器、模块和 .NET 依赖、输入输出、外部系统、可接受停机、测试样本、目标运行时、退出日期。

任务：
当前宿主/版本：
触发器与身份：
模块/.NET 依赖：
输入/输出契约：
外部系统：
测试样本：
目标运行时：
负责人/退出日期：

优先原生 PowerShell 7 模块；其次更新为兼容版本；Windows 专属模块可暂用 Windows PowerShell Compatibility；实在不可替代时封装成受限服务边界并安排退役。

比较对象属性、类型、退出码和写入结果，不比较易受格式系统影响的终端文本；为日期、编码、区域设置和空值准备边界样本。

核对实际启动的可执行文件与 $PSVersionTable；定位新语法、文件编码、引号或续行差异，把失败缩到最小脚本。

用 Get-Command 和 Get-Help 核对命令来源、模块版本、参数集与平台；不要用同名别名或自定义函数掩盖差异。

Get-Command -Name '<command>' -All | Format-List Name,CommandType,Source,Version,Definition

检查模块清单的 CompatiblePSEditions、所需程序集与 .NET Framework API。短期可评估兼容会话，但返回对象可能经序列化而失去方法。

检查对象类型、属性、排序、文化区域、编码、时区、原生命令退出码和错误流；用固定样本比较结构化输出与真实副作用。

为一组自有示例脚本画出触发器—宿主—模块—外部系统—输出图，标注版本证据、数据敏感度与负责人。

创建合成输入、Pester 契约测试和结构化基线，在 Windows PowerShell 5.1 与 PowerShell 7 上形成可比较报告。

移除示例中的旧版本绑定，替换一个不兼容依赖，加入 CI 测试、回滚说明、观察指标与剩余风险。

在克隆环境禁用旧路径，验证计划任务、告警和业务结果；完成回滚窗口后删除旧镜像、身份和例外策略并归档证据。