Revit Server 模型创建命令行实用程序

可以使用 Revit Server 模型创建命令行实用程序 (RevitServerTool.exe) 来自动创建本地模型，以更好地利用工作共享。

您可以将新的本地模型直接置于团队成员的计算机中或他们可访问的目录内。

在安装了 Revit 或 Revit Server 的任何计算机上，只要 Host 或 Accelerator 角色处于启用状态，就会自动安装 RevitServerTool.exe。

在 Revit 用户的计算机上，该工具的默认位置是：%ProgramFiles%\Autodesk\Autodesk Revit 2025INSTALLDIR\RevitServerToolCommand\。 在 Revit Server 的实例上，该工具的默认位置是：%ProgramFiles%\Autodesk\Autodesk Revit 2025\tools\RevitServerToolCommand。

注： 要使用命令行实用程序，应熟悉 DOS 并了解命令行结构。 另请注意，该实用程序只能与相应版本的 Revit Server 结合使用，即 2025 Release 版本的 RevitServerTool.exe 只能与 2025 Release 版本的 Revit Server 结合使用。

命令和选项

命令	结果
L、createLocalRvt	从基于服务器的指定中心模型创建本地模型
RevitServerTool -?	显示 ReverServerTool 实用程序的帮助。

选项	结果
<模型路径>	相对于 Revit Server 项目目录的模型路径（例如“Hospital \North Wing.rvt”）。 这是必需的参数。
-d、-destination	用来指定新模型的位置和文件名的路径。 支持绝对路径、相对路径及 UNC 路径。 默认情况下，新模型创建在用户的文档文件夹下的“RevitServerTool”子文件夹中。 例如，C:\\Users| <用户名> \Document\RevitServerTool\ <模型名称>.rvt 注： 如果在目标路径中未指定新模型的名称，默认情况下将使用基于服务器的中心模型的名称。
-s、-server	中心模型所在的 Revit Server Host 名称。 这是必需的参数。
-a, -accelerator	Revit Server Accelerator 的名称。 未提供此参数时，该实用程序将检查 RSACCELERATOR2025 Release 环境变量，以确定是否已指定 Accelerator。如果已指定，则在该 Accelerator 处于最新状态时使用该 Accelerator 上的缓存数据。如果未列出 Accelerator，该实用程序将直接从 Revit Server Host 复制中心模型数据。 同样，如果 Accelerator 名称无效，或 Accelerator 停止运行，则直接从 Host 检索数据。
-O、-overwrite	覆盖目标模型（如果已存在）。

用法：

RevitServerTool createLocalRVT <模型路径> [-s | -server <服务器名称>] [-a | -accelerator <Accelerator 名称>] [-d|-destination <路径>] [-o|-overwrite]

用途	结果
RevitServerTool createLocalRVT <模型路径> [-server <服务器名称>]	由指定的 Revit Server Host 上的模型路径指定的中心模型的本地副本将使用操作系统中定义的用户名在用户的个人目录中创建。
RevitServerTool createLocalRVT <模型路径> [-server <服务器名称>] [-destination <路径>] [-overwrite]	由指定的 Revit Server Host 上的模型路径指定的中心模型的本地副本将在目标路径位置创建，覆盖该位置存在的所有早期版本。
RevitServerTool createLocalRVT <模型路径> [-server <服务器名称>] [-destination <路径>] [-accelerator <Accelerator 名称>]	由指定的 Revit Server Host 上的模型路径指定的中心模型的本地副本将从指定 Revit Server Accelerator 上的缓存中创建，并放置在指定的目标位置。

命令行用法示例

注： 为了正确处理包含空格的参数，下面示例中所使用的引号是必需的。

从名为 SERVER01 的 Revit Server Host 上的“2025 Release Hospital Project”目录中的名为“As-Built complex.rvt”的中心模型创建本地模型

• RevitServerTool createLocalRvt "2025 Release Hospital Project\As-Built complex.rvt" -s SERVER01 -o

或

• RevitServerTool L "2025 Release Hospital Project\As-Built complex.rvt" -s SERVER01 -o

从同一中心模型创建本地模型，将其命名为“As-Built complex myLocal.rvt”并存储在“C:\local files”文件夹中

• RevitServerTool createLocalRvt "2025 Release Hospital Project\As-Built complex.rvt" -s SERVER01 -d "c:\local files\As-Built complex_myLocal.rvt" -o

或

• RevitServerTool L "2025 Release Hospital Project\As-Built complex.rvt" -s SERVER01 -d "c:\local files\As-Built complex_myLocal.rvt" - o

用法注意事项

• 用户指定的选项顺序无关紧要。
• 该实用程序支持在路径中使用反斜杠和正斜杠。 此外，该工具接受带有前导斜杠或尾随斜杠的输入信息。
• 作为一般规则，在遇到异常情况时，该实用程序将重试。
• 如果指定的 Accelerator 在操作中停机，该实用程序将失败，然后重试。
• 如果用户没有为目标值指定“.rvt”文件，将使用以下规则：
  • 如果目标值以 \ 或 / 结尾，则输出文件名将与源文件名相同，且将在由目标选项值指定的目录中创建。
  • 如果目标值不以 \ 或 / 结尾，则输出文件名将为目标选项值的最后一个 \ 或 / 后的内容，然后把“.rvt”作为扩展名。
  • 如果目标值并非路径（即不使用 \ 或 /），则输出文件名就是该值本身，并把“.rvt”作为扩展名。

错误条件和实用程序响应

条件：用户指定了模型路径，但没有指定必需的 -server 参数。

响应：命令中缺少必需的 server 参数。

条件：服务器上不存在指定的模型路径。

响应：无法创建本地模型，因为 Revit Server“<服务器>”上不存在模型“<模型路径>”。

条件：指定的目标路径不存在。 如果用户具有权限，则将创建新路径，并且新模型将放置于该处。

响应：已成功创建本地模型“<目标路径>”。

条件：目标路径（新模型）已存在，且用户没有明确使用 [-overwrite] 选项。

响应：无法创建本地模型，因为模型“<模型路径>”已存在。

条件：指定的服务器不可访问，或者网络掉线。

响应：无法创建本地模型，因为 Revit Server 目前不可用。

条件：服务器上的模型当前正在使用中。

响应：无法创建本地模型，因为模型“<模型路径>”正在使用中。

条件：

未知原因导致执行失败，或者由于模型已损坏，或者用户对目标路径没有访问权限，或者目标路径的路径总长度大于 255 个字符，或者用户未指定目标路径，总之无法创建该路径。

响应：无法在位置“<目标路径>”创建本地模型。