PSAppDeployToolkit中Show-InstallationWelcome的PersistPrompt参数失效问题分析

问题背景

在PSAppDeployToolkit 3.10.1版本中，用户报告了一个关于Show-InstallationWelcome命令的问题。具体表现为当使用-PersistPrompt参数时，窗口无法按预期在指定时间间隔后重新居中显示。这个问题在使用ServiceUI以系统账户运行并通过任务调度器执行时尤为明显。

问题重现

用户使用了以下典型命令配置：

Show-InstallationWelcome -CloseApps 'msrdcw' -PersistPrompt -MinimizeWindows $false -BlockExecution -CloseAppsCountdown 18000

尽管在AppDeployToolkitConfig.xml中设置了5小时的超时时间（InstallationUI_Timeout）和60秒的重新居中间隔（InstallationPrompt_PersistInterval），但窗口在被用户拖动到屏幕边缘后，未能按预期在60秒后自动回到屏幕中央。

技术分析

1. 参数交互问题：经过测试发现，-PersistPrompt参数的有效性与是否启用延迟选项（-AllowDefer）密切相关。当命令中包含延迟相关参数时，PersistPrompt功能正常工作；反之则失效。

2. 有效配置示例：

Show-InstallationWelcome -DeferTimes 50 -AllowDefer -PersistPrompt -MinimizeWindows $false
Show-InstallationWelcome -DeferTimes 50 -AllowDefer -PersistPrompt -MinimizeWindows $false -ForceCountdown 5000

3. 无效配置示例：

Show-InstallationWelcome -PersistPrompt -MinimizeWindows $false -ForceCountdown 5000
Show-InstallationWelcome -CloseApps 'notepad' -PersistPrompt -MinimizeWindows $false -ForceCountdown 5000

解决方案

1. 版本升级：该问题在PSAppDeployToolkit 3.10.2版本中已得到修复。建议用户升级到此版本或更高版本。

2. 临时解决方案：如果必须使用3.10.1版本，可以添加延迟相关参数来启用PersistPrompt功能。

3. 配置建议：

   • 确保同时使用-AllowDefer和-DeferTimes参数
   • 合理设置InstallationPrompt_PersistInterval值
   • 测试不同环境下的表现

总结

PSAppDeployToolkit作为一款强大的应用程序部署工具，其UI交互功能在实际部署中非常重要。这个特定的PersistPrompt参数问题展示了参数间可能存在的依赖关系，提醒开发者在复杂参数组合时要进行充分测试。对于仍在使用3.10.x版本的用户，建议按照上述方案进行调整或升级到最新版本以获得最佳体验。