PSAppDeployToolkit中Get-ADTMsiTableProperty函数使用注意事项

函数输出类型变更解析

在PSAppDeployToolkit 4.0版本中，Get-ADTMsiTableProperty函数的输出类型发生了重要变更。该函数现在返回System.Collections.ObjectModel.ReadOnlyDictionary`2类型的对象，这是一个只读字典集合，包含MSI文件的属性键值对。

变更背景与原因

这一变更主要是为了解决MSI文件中可能存在的键名大小写敏感问题。在Windows Installer技术规范中，MSI文件可以包含大小写不同但拼写相同的属性键名（例如"productcode"和"PRODUCTCODE"）。旧版本的处理方式会导致键值对被覆盖，而使用字典类型可以完整保留所有属性。

正确使用方法

由于输出类型变为字典，访问属性的方式也需要相应调整：

1. 直接通过键名访问属性值：

(Get-ADTMsiTableProperty -Path 'AppDeploy.msi' -Table 'Property').ProductCode

2. 需要注意字典键名是大小写敏感的：
   • .ProductCode 可以正确访问
   • .productcode 会返回空值

常见问题解决

如果遇到"Property cannot be found"错误，请检查：

1. 属性名称的大小写是否与MSI文件中完全一致
2. 确保属性确实存在于指定的MSI表中
3. 考虑使用Get-Member命令查看所有可用属性

最佳实践建议

1. 在脚本开发阶段，先使用以下命令查看所有可用属性：

Get-ADTMsiTableProperty -Path 'AppDeploy.msi' -Table 'Property' | Get-Member

2. 对于关键属性访问，建议添加错误处理逻辑：

$msiProps = Get-ADTMsiTableProperty -Path 'AppDeploy.msi' -Table 'Property'
if ($msiProps.ContainsKey('ProductCode')) {
    $productCode = $msiProps['ProductCode']
}

3. 考虑将常用属性存储在变量中，避免重复查询MSI文件

总结

PSAppDeployToolkit 4.0对Get-ADTMsiTableProperty函数的改进提高了对MSI文件属性处理的准确性和可靠性。虽然使用方式有所变化，但这种变更确保了在各种情况下都能正确获取MSI文件属性。开发者在升级到4.0版本时，应注意调整相关脚本代码以适应新的输出类型。