PSAppDeployToolkit中Start-ADTProcess命令路径变量使用指南

问题背景

在使用PSAppDeployToolkit（PSADT）4.0.2版本进行应用程序部署时，开发人员可能会遇到一个常见问题：当尝试使用$dirFiles变量在Start-ADTProcess命令中指定文件路径时，系统会报错提示文件未找到。这实际上是PSADT版本升级后引入的一个变量访问方式变更问题。

问题分析

在PSADT 4.0.2版本中，工具包引入了面向对象的设计改进，将许多全局变量封装到了$adtSession对象中。这意味着：

1. 传统的$dirFiles变量不再直接可用
2. 需要通过$adtSession.DirFiles属性来访问相同的路径信息
3. 当在双引号字符串中使用时，需要使用子表达式语法$($adtSession.DirFiles)

解决方案

正确的路径引用方式应该是：

Start-ADTProcess -FilePath "$($adtSession.DirFiles)\test\AudioMothConfigurationAppSetup1.12.0.exe" -ArgumentList "/S" -WindowStyle "Hidden" -WaitForMsiExec

关键注意事项：

1. 使用反斜杠\作为路径分隔符（Windows标准）
2. 通过$adtSession.DirFiles访问文件目录路径
3. 在双引号字符串中使用子表达式$()来正确解析对象属性

技术细节

PSADT 4.0.2版本引入的面向对象改进带来了更结构化的代码组织方式。$adtSession是一个会话对象，包含了部署过程中需要的各种上下文信息，其中：

• DirFiles属性替代了原来的$dirFiles变量
• 类似的，其他全局变量也被封装为对象的属性
• 这种改进提高了代码的封装性和可维护性

最佳实践

1. 在PSADT 4.0.2及更高版本中，始终使用$adtSession对象访问部署上下文信息
2. 路径字符串中使用正确的Windows路径分隔符（反斜杠）
3. 在双引号字符串中引用对象属性时，使用子表达式语法
4. 查阅最新文档了解其他已变更的变量访问方式

总结

PSAppDeployToolkit 4.0.2版本的这一变更反映了工具向更现代、更结构化的设计演进。虽然这带来了短暂的兼容性问题，但从长远看提高了工具的可靠性和可维护性。开发人员应适应这一变化，更新现有脚本以使用新的对象属性访问方式。

对于从旧版本迁移的用户，建议全面检查脚本中所有全局变量的使用，将其替换为相应的$adtSession属性访问方式，以确保部署过程的顺利进行。