PSAppDeployToolkit中Show-ADTInstallationWelcome函数参数传递的正确方式

在使用PSAppDeployToolkit进行应用程序部署时，Show-ADTInstallationWelcome函数是一个常用的功能，它可以在安装前显示欢迎界面并关闭可能干扰安装的进程。然而，在版本4.0.6中，许多用户发现当尝试使用变量传递需要关闭的进程列表时，函数无法正常工作。

问题现象

用户通常会尝试以下方式定义变量：

[string]$CloseAppsList = 'wordpad,notepad'

然后在函数调用中使用：

Show-ADTInstallationWelcome -CloseProcesses $CloseAppsList

虽然日志中显示进程列表看起来正确，但实际上函数并没有成功关闭这些进程。这个问题在PSADT v3中可以正常工作，但在v4中出现了异常。

根本原因

这个问题的根源在于参数类型的改变。在PSADT v4中，设计团队修正了一个历史遗留的设计缺陷：

1. 在旧版本中，函数接受一个逗号分隔的字符串作为输入
2. 在新版本中，函数期望接收一个字符串数组(string[])，而不是单个字符串

这种改变是为了更符合PowerShell的最佳实践，使API设计更加一致和可预测。

正确解决方案

要正确传递需要关闭的进程列表，应该使用以下格式定义变量：

[string[]]$CloseAppsList = 'wordpad','notepad'

这种定义方式明确指定了变量类型为字符串数组，并将每个进程名称作为独立的数组元素传递。这种方式与函数期望的参数类型完全匹配。

技术细节

1. 参数类型匹配：PowerShell函数对参数类型有严格要求，类型不匹配会导致意外行为
2. 数组定义：在PowerShell中，数组可以通过逗号分隔的值列表创建
3. 类型约束：使用[string[]]明确告诉PowerShell这是一个字符串数组，而不是单个字符串

最佳实践建议

1. 始终检查函数文档中的参数类型要求
2. 对于接受多个值的参数，优先考虑使用数组而不是分隔字符串
3. 在定义变量时显式指定类型可以提高代码的清晰度和可靠性
4. 测试时不仅要检查日志输出，还要验证实际功能是否按预期工作

总结

PSAppDeployToolkit v4对API进行了改进，使参数传递更加符合PowerShell的标准实践。理解并适应这些变化可以帮助开发者编写更健壮、更可靠的部署脚本。通过正确使用字符串数组而不是逗号分隔的字符串，可以确保Show-ADTInstallationWelcome函数按预期工作，在安装前成功关闭指定的应用程序进程。