# 如何通过命令行安装D5（静默安装）？

::: info
方便 IT 管理员通过脚本进行自动化部署和配置。
:::

# 静默安装

## 1. 获取安装程序

点击 [D5 部署工具](https://cn.api.d5render.com/d5-admin/sl/Ht9KVeQ4) 下载安装 D5 所需的安装文件。请将下载的 .zip 文件解压得到以下三个安装包，放在同一个文件夹中。

- [**D5Launcher-windows-x.x.x.xxxx.exe**](https://cn.api.d5render.com/d5-admin/sl/LsY4vDq8)：用于统一管理 D5 Render 及后续可能推出的其他产品，以及项目文件等，必须安装
- [**D5\_Render\_installer-x.xx.xx.xxxx.exe**](https://cn.api.d5render.com/d5-admin/sl/TO81V9bi)：渲染器客户端，必须安装
- [**D5DeployTool-windows-1.1.0.0076.exe**](https://cn.api.d5render.com/d5-admin/sl/Qp7bLmA2)：安装管理工具

![image](https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1768532197152/image.png)

*示例——将三个安装文件放在 “D5 Deployment Kit” 的文件夹中*

::: tip 提示
若您需要同时安装适合您工作流的 DCC 同步插件，请前往官网下载对应的插件，并按照 2.4 节的说明进行安装。
:::

## 2. 静默安装

### 2.1 命令行参数

| 参数 | 说明 |
| --- | --- |
| **必要参数** | |
| `--agreeEula=true` | 同意最终用户许可协议 |
| `--launcherPath="path"` | 替换 `path` 为 _D5Launcher.exe_ 文件路径 |
| `--renderPath="path"` | 替换 `path` 为 D5Render.exe 文件路径 |
| `--installPath="path"` | 替换 `path` 为自定义 D5 Render 安装路径（D5 Launcher 不支持自定义路径） |
| **可选参数** | |
| `--pluginPath="path"` | 替换 `path` 为 D5 DCC 同步插件安装文件所在路径（见 2.4 节） |
| `--logDirPath="path"` | 替换 `path` 为自定义安装日志输出路径；若不指定则默认为 `%TEMP%/D5Deploy/` |
| `--isForCurrentUser=true/false` | 是否仅为当前用户安装；若不指定默认为 `true` |
| `--workspacePath="path"` | 替换 `path` 为自定义 D5 工作空间路径（“工作空间”功能支持设置全部在线素材库的素材、本地素材库，以及自定义 HDR / LUT / IES 文件和部分临时文件的存储位置）；若不指定则默认在剩余空间最大的盘符中创建 D5 Workspace 文件夹。覆盖安装时则会使用原有的工作空间路径 |
| `--configPath="path"` | 替换 `path` 为 .ini 格式配置文件路径，并按照配置文件内容进行安装（见 2.5 节） |

### 2.2 开始安装

1. 以管理员身份运行命令提示符。
2. 输入 `"X:\...\D5DeployTool-windows-x.x.x.xxx.exe"` 以及所有必要参数及可选参数后即可开始安装（所有参数之间用空格隔开）。

> 替换其中的 `X:\...\` 为你在第 1 节下载的 D5 部署工具所在路径，替换 `D5DeployTool-windows-x.x.x.xxx.exe` 为该部署工具的文件名称（实际名称可能因版本号不同而有所区别）。

### 2.3 安装示例 1：仅安装 D5 Launcher 和 D5 Render

在命令提示符窗口内输入以下命令，将安装 D5 Launcher 及 D5 Render（替换其中的路径、文件名、密钥为你的实际内容）。 **仅安装D5 Launcher和D5 Render ↓**

```cmd
"C:\D5 Deployment Kit\D5DeployTool-windows-1.1.0.0076.exe" --agreeEula="true" --launcherPath="C:\D5 Deployment Kit\D5Launcher-windows-1.1.0.0309.exe" --renderPath="C:\D5 Deployment Kit\D5_Render_installer-2.11.10.1771.exe" --installPath="C:\Program Files\D5 Render"
```

### 2.4 安装示例 2：同时安装 D5 Launcher、D5 Render 及 DCC 同步插件

> 若要同时安装 DCC 同步插件（如 SketchUp 同步插件、Revit 同步插件、Rhino 同步插件等），请先前往 [D5 渲染器官网](https://www.d5render.cn/) 工作流页面下载对应的插件安装包。

在命令提示符窗口内输入以下命令，将安装 D5 Launcher、D5 Render 及所选的 DCC 同步插件，多个插件可同时安装（替换其中的路径、文件名、密钥为你的实际内容）。 **同时安装D5 Launcher、D5 Render及DCC 同步插件 ↓**

```cmd
"C:\D5 Deployment Kit\D5DeployTool-windows-1.1.0.0076.exe" --agreeEula="true" --launcherPath="C:\D5 Deployment Kit\D5Launcher-windows-1.1.0.0309.exe" --renderPath="C:\D5 Deployment Kit\D5_Render_installer-2.11.10.1771.exe" --installPath="C:\Program Files\D5 Render" --pluginPath="C:\DCC\D5_LiveSync_Sketchup_usa_1.6.1.0020.exe" --pluginPath="C:\DCC\D5_Live_Sync_Rhino_usa_1.1.2.0005"
```

### 2.5 安装示例 3：使用 .ini 配置文件进行安装

支持 .ini 格式配置文件，你可以将所有参数存储在文件中进行部署。 **配置文件实例（config.ini）↓**

```ini
[InstallConfig]
agreeEula=true
launcherPath="C:\\D5 Deployment Kit\\D5Launcher-windows-1.1.0.0309.exe"
renderPath="C:\\D5 Deployment Kit\\D5_Render_installer-2.11.10.1771.exe"
pluginPath1="C:\\DCC\\D5_LiveSync_Sketchup_usa_1.6.1.0020.exe"
// 注意：此处参数名带有序号，即使只安装 1 个插件，也应使用 pluginPath1
pluginPath2="C:\\DCC\\D5_Live_Sync_Rhino_usa_1.1.2.0005"
// 注意：此处参数名带有序号
logDirPath="C:\\Logs"
workspacePath="C:\\D5Workspace"
installPath="C:\\Program Files\\D5 Render"
isForCurrentUser=false
```

在命令提示符窗口内输入以下命令，将使用配置文件进行安装（替换其中的路径、文件名为你的实际内容）。

::: warning 注意
在上述 config.ini 文件里，必须用两道斜杠：`\\`
::: **使用.ini配置文件进行安装 ↓**

```cmd
"C:\D5 Deployment Kit\D5DeployTool-windows-1.1.0.0076.exe" --configPath="C:\Config\deployment.ini"
```

## 3. 批量安装

你可以使用你的批量部署工具，按照上述命令进行批量安装。如需要协助，请与我们的销售人员联系。

---

# 静默升级程序

需要集中升级 D5 版本时，仅需把 **新的 D5 安装包** 下载下来，运行安装命令行时安装到上次相同的目录，并移除 `-workspacePath` 参数即可，覆盖安装等同升级。

[D5 Render 最新安装包下载链接](https://cn.api.d5render.com/d5-admin/sl/TO81V9bi)

```cmd
D5_Render_installer-cn2-2.x.x.xxxx.exe -silent -agreeEula -isForCurrentUser=false -installPath="E:/D5 Render" -logPath="E:/"
```

::: warning 注意
`D5_Render_installer-cn2-2.x.x.xxxx.exe` 请替换成对应下载更新的软件程序名称。
:::

---

# 静默卸载程序

卸载程序位于安装目录下 Uninstall.exe，找到文件位置运行如下命令行：

```cmd
"E:/D5 Render/Uninstall.exe" -silent -deleteUserConfig
```

![image](https://docs-static.d5render.cn/t/18217684-957c-4109-9021-5866cc58cc60/u/7531f9aa-9f13-43a5-858c-19dac517bbc6/1742199096147/image.png)

# 注意事项

1. 确保您已下载了 D5 渲染器的相应版本（例如 v2.9.5 或更高版本）。
2. 注意：在 Windows 上，命令行参数中的反斜杠 `\` 被视为转义符，使用以下方法处理：将文件路径括在双引号中，并使用 `/` 替代 `\`，例如 `"C:/Program Files/D5 Render"`。
3. 如果使用参数 `-isForCurrentUser=false` 为所有用户安装，则必须以管理员身份运行脚本或命令，否则会安装异常。
4. 在实际部署前，先在测试环境中运行静默安装，确保正确执行。
5. 注意备份用户配置和设置，以避免在安装或卸载过程中丢失数据。