win-acme项目中WMIC命令弃用问题及解决方案

背景介绍

在Windows Server 2025和Windows 11操作系统中，微软已经正式弃用了WMIC（Windows Management Instrumentation Command-line）工具。这一变化影响了win-acme项目中几个关键脚本的正常运行，特别是与远程桌面服务证书管理相关的脚本。

问题分析

win-acme项目中的以下脚本受到了影响：

• ImportRDListener.ps1
• ImportRDS.ps1
• ImportRDSFull.ps1

这些脚本原本使用WMIC命令来配置远程桌面服务的SSL证书指纹。当在较新版本的Windows系统上运行时，会收到"wmic不被识别"的错误提示，因为微软已经移除了这个工具。

技术解决方案

原始WMIC命令分析

原脚本中使用的是如下WMIC命令格式：

wmic /namespace:\\root\cimv2\TerminalServices PATH Win32_TSGeneralSetting Set-SSLCertificateSHA1Hash = "$($CertInStore.Thumbprint)"

这条命令通过WMIC工具访问WMI命名空间中的远程桌面服务设置类，并设置SSL证书的SHA1指纹。

现代替代方案

微软推荐使用PowerShell的CIM（Common Information Model）命令来替代传统的WMIC。具体实现方式如下：

# 获取远程桌面服务通用设置实例
$tsGeneralSetting = Get-CimInstance -Namespace "root/CIMV2/TerminalServices" -ClassName Win32_TSGeneralSetting

# 设置SSL证书指纹
$tsGeneralSetting | Set-CimInstance -Property @{ SSLCertificateSHA1Hash = $certThumbprint }

实现细节

1. Get-CimInstance：这个cmdlet用于获取指定命名空间和类名的CIM实例，相当于原来WMIC的查询部分。

2. Set-CimInstance：用于修改CIM实例的属性值，这里用来设置SSL证书的指纹。

3. 命名空间路径：注意从原来的反斜杠格式(\\root\cimv2\TerminalServices)改为正斜杠格式(root/CIMV2/TerminalServices)，这是CIM cmdlet的标准格式要求。

兼容性考虑

这个修改方案已经经过实际测试验证，可以正常工作在：

• Windows Server 2025
• Windows 11
• 以及支持CIM cmdlet的其他Windows版本

实施建议

对于使用win-acme项目的用户，建议：

1. 检查项目中所有使用WMIC的脚本
2. 按照上述模式进行替换
3. 测试修改后的脚本在各种环境下的表现

总结

随着Windows系统的更新迭代，传统的管理工具逐渐被更现代、更强大的PowerShell cmdlet所取代。win-acme项目中的WMIC命令替换为CIM cmdlet不仅解决了兼容性问题，还使脚本更加符合现代Windows管理的最佳实践。这一修改确保了项目在最新Windows平台上的持续可用性。