从浏览器表单提交中接受一个文件，作为构建参数。上传后的文件将会放在工作空间中指定的位置，你 可以在构建任务中访问并使用它。

这对于很多场景下是有帮助的，例如：

1. 让用户基于他们构建出来的成品运行测试。
2. 允许用户在自动化上传、发布、部署过程中替换文件。
3. 通过上传一个数据集来处理数据。

表单提交中的文件名称就是文件的路径，并且是在环境变量中可见的。例如：你把文件路径设置为 `abc.zip`，然后`${abc.zip}`会从浏览器传递给你原始的文件名称。 （例如`my.zip`。）这里的名称不会包含目录部分。

文件的上传是可选的。如果用户不上传任何文件，Jenkins只是简单地跳过这个参数并不会替换 任何文件（但是也不会删除任何已经存在的文件）。

在命令行模式下参数`-p`对于构建命令`build`会选择一个本地文件 （`-remoting`），或者从标准输出中读取。（在字符模式下，只允许定义一个文件参数）