命令行参数

在本部分中，您可以找到可用于 Task Capture 应用程序的命令行参数。

安装命令行参数说明

如果您有 task-capture-setup.msi 安装程序，可以使用下述命令行安装或更新 Task Capture。下表列出了所有可用参数，并结合一些示例进行说明。

• 安装命令行参数不能使用，也无法在 TaskCapture.exe 上运作。

• 此包在本机支持所有msiexec命令。

• 需要管理员权限才能执行这些命令。

项目	命令	描述
安装选项	/i	用于正常安装
-	/a	用于管理员安装
-	/x	用于卸载包
-	APPLICATIONROOTDIRECTORY='{folder_path}'	用于更改安装目录
显示选项	/quiet	安静模式
-	/passive	无人值守模式
-	/q[n|b|r|f]	设置用户界面级别，如下所示：f - 完整用户界面（默认），b - 基本用户界面，r - 减少的用户界面，n - 无用户界面
重新启动选项	/norestart	安装完成后，不会重新启动计算机。
-	/promptrestart	如果需要重新启动，将提示用户
-	/forcerestart	安装完成后，不会重新启动计算机。
自定义参数	LICENSECODE=1111-1111-1111-1111 或 LICENSECODE=offline_activation_string	通过许可证代码或许可证激活字符串（用于离线激活）激活独立版应用程序。
-	TEMPLATES=template1.ssword;template2.ssword;...	默认安装自定义模板。
-	PROXYCONFIG="config.json" 以及配置文件的路径	配置代理设置。

重要提示：

• 使用空格传递值时，需要使用双引号将这些值引用起来。

• 请记住，双引号需要转义。

• 在需要转义的字符前使用反引号`（适用于 PowerShell）以及^（适用于命令提示符）。

• 模板文件应为 .ssword 格式。请参阅导出，了解如何使用 Task Capture 创建文件

示例:

下面的示例演示了该工具的静默安装 (q) 与基本用户界面 (b) 和许可证激活 (LICENSECODE)：

在msiexec /i ${task-capture-setup.msi} /qb LICENSECODE=${license_code}中，以下元素可用：

• ${task-capture-setup.msi} ，即 .msi 安装程序文件，

  例如“C:\user.name\Downloads\task-capture-setup.msi”

• ${license_code}是以下之一：

  • 在线激活的许可证代码，例如 1111-1111-1111-1111

  • 离线激活字符串：Task Capture 离线激活的最后阶段使用的字符串。

下面的示例说明如何使用 TEMPLATES 参数安装预定义的自定义模板：

我们将从以下内容开始：msiexec /i task-capture-setup.msi /qb TEMPLATES=^"C:\Users\username\Documents\MyTemplate.ssword^" 适用于 CMD；msiexec /i task-capture-setup.msi /qb TEMPLATES=`"C:\Users\username\Documents\MyTemplate.ssword`" 适用于 POWERSHELL，以下元素可用：

• task-capture-setup.msi，即.msi 安装程序文件的路径

• “TEMPLATES=”参数包含以下信息：

  • ^"C:\Users\username\Documents\MyTemplate.ssword^ (CMD) 或 `"C:\Users\username\Documents\MyTemplate.ssword`" (POWERSHELL)，即指向您设置的预定义自定义模板的路径。

应用程序命令行参数说明

Task Capture 的可执行文件接受以下 CLI 参数：

备注：

• 当使用 LICENSECODE 或 TEMPLATES 参数调用安装程序时，这些参数将用于 .msi 安装过程。

• 通过使用它，无需打开其他窗口即可静默调用 Task Capture。

许可证激活参数：

--activate=${license} ，其中${license}具有以下值之一：

• 在线激活的许可证代码，

  例如 --activate=1111-1111-1111-1111

• 离线激活字符串：Task Capture 离线激活的最后阶段使用的字符串。

许可证停用参数：

--deactivate 用于停用活动许可证。Task Capture 通过它向许可证服务器发送停用请求，并删除许可证文件。

默认安装自定义模板：

--import-templates={template1};{template2};... 会将选定的模板添加到安装文件夹中。

• 若有多个模板，请使用分号 (;) 作为分隔符。

• Task Capture 会尝试导入每个给定模板。

• 如果无法导入其中某个所选模板，系统将显示代码 1。

• 所有错误都将写入日志文件。

用法:

适用于 MSI 版本的某些操作可能需要管理员权限。

可执行文件的名称为 Task Capture.exe，该文件将根据安装类型确定以下安装位置：

• .exe 安装程序的 %localappdata%/Programs/task-capture 文件夹；

• .msi 安装程序的 %programfiles%/Task Capture 文件夹。

由于文件和文件夹的名称包含空格，因此请不要忘记使用双引号将可执行文件的路径引用起来。

示例:

• "%programfiles%/Task Capture/Task Capture.exe" --activate=1111-1111-1111-1111 可以激活 .msi 版本。

• %localappdata%/Programs/task-capture/Task Capture.exe” --deactivate - 停用 .exe 版本。