Revit Server 模型建立指令行公用程式

您可以使用 Revit Server 模型建立指令行公用程式 (RevitServerTool.exe) 來自動建立本端模型以協助以伺服器為基礎的協同合作。

您可以在小組成員的電腦或目錄中可以存取的位置上放置新本端模型。

RevitServerTool.exe 會自動安裝在任何安裝了已啟用主體或加速器角色的 Revit 或 Revit Server 的電腦上。

在 Revit 使用者電腦上，工具的預設位置為：%ProgramFiles%\Autodesk\Autodesk Revit 2022INSTALLDIR\RevitServerToolCommand\。在 Revit Server 的例證中，工具的預設位置為：%ProgramFiles%\Autodesk\Autodesk Revit 2022\tools\RevitServerToolCommand。

註: 若要使用指令行公用程式，您務必熟悉 DOS 並瞭解指令行的結構。另請注意，此公用程式僅適用於相應版本的 Revit Server；即 2022 版的 RevitServerTool.exe 僅適用於 2022 版的 Revit Server。

指令和選項

指令	結果
l、createLocalRvt	從指定的以伺服器為基礎的中央模型建立本端模型。
RevitServerTool -?	顯示 RevitServerTool 公用程式的說明。

選項	結果
<模型路徑>	相對於 Revit Server 專案目錄的模型路徑 (例如："Hospital \North Wing.rvt")。這是必要引數。
-d、-destination	指定新模型的位置和檔案名稱的路徑。支援絕對路徑、相對路徑和 UNC 路徑。依預設，新模型將建立在使用者「文件」資料夾下的 "RevitServerTool" 子資料夾中。例如，C:\\Users|<使用者名稱>\Document\RevitServerTool\ <模型名稱>.rvt 註: 如果尚未在目標路徑中指定新模型名稱，依預設將使用以伺服器為基礎的中央模型的名稱。
-s、-server	中央模型所在的 Revit Server 主體的名稱。這是必要引數。
-a、-accelerator	Revit Server 加速器的名稱。未提供此引數時，公用程式會檢查 RSACCELERATOR2022 環境變數，以決定是否指定加速器，若指定，請使用該加速器上的快取資料 (如果是最新的資料)。如果未列示任何加速器，公用程式會直接從 Revit Server 主體複製中央模型資料。同樣地，如果加速器名稱無效，或加速器向下運作，則會直接從主體擷取資料。
-o、-overwrite	如果目標模型已存在會覆寫它。

用法：

RevitServerTool createLocalRVT <模型路徑> [-s | -server <伺服器名稱>] [-a | -accelerator <加速器名稱>] [-d|-destination <路徑>] [-o|-overwrite]

用法	結果
RevitServerTool createLocalRVT <模型路徑> [-server <伺服器名稱>]	由指定 Revit Server 主體上的模型路徑指定的中央模型本端複本，將使用作業系統中定義的使用使用者名稱建立在使用者的個人目錄中。
RevitServerTool createLocalRVT <模型路徑> [-server <伺服器名稱>] [-destination <路徑>] [-overwrite]	由指定 Revit Server 主體上的模型路徑指定的中央模型本端複本將建立在目標路徑位置，覆蓋任何已存在的舊版。
RevitServerTool createLocalRVT <模型路徑> [-server <伺服器名稱>] [-destination <路徑>] [-accelerator <加速器名稱>]	由指定 Revit Server 主體上的模型路徑指定的中央模型本端複本將從指定 Revit Server 加速器上的快取記憶體進行建立，並放置在指定目的地。

指令行用法範例

註: 若要正確處理包含空格的引數，需要在以下範例中使用引號。

從在名為 SERVER01 的 Revit Server 主體上的 2022 Hospital Project 目錄中找到的名為 As-Built complex.rvt 的中央模型建立本端模型的步驟

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

或

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

若要從此同一中央模型建立本端模型，請為其提供名稱 As-Built complex myLocal.rvt 並將其儲存在資料夾 C:\local files 中。

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

或

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

使用注意事項

• 使用者指定選項的順序無關緊要。
• 公用程式支援在路徑中使用反斜線和正斜線。此外，工具接受帶有前導斜線或結尾斜線的輸入。
• 一般而言，公用程式會在遇到例外情況時嘗試重試
• 如果指定的加速器在作業中途向下運作，則公用程式將無法執行並會進行重試。
• 如果使用者未為目標值指定 ".rvt" 檔案，則使用以下規則：
  • 如果目標值以 \ 或 / 結束，則輸出檔案名稱與來源檔案名稱相同，而且它會建立在目標選項值指定的目錄中。
  • 如果目標值不以 \ 或 / 結束，則輸出檔案名稱將附在目標選項值的最後一個 \ 或 / 之後並會將 ".rvt" 作為副檔名。
  • 如果目標值未對路徑進行編碼 (即，不使用 \ 或 /)，則輸出檔案名稱將為值本身，將 ".rvt" 作為副檔名。

錯誤情況和公用程式回應

條件：使用者指定模型路徑，但不指定所需的 -server 引數。

回應： 指令缺少必要引數 server。

情況：指定模型路徑不存在於伺服器上。

回應： 無法建立本端模型，因為模型 "<模型名稱>" 不存在於 Revit Server "<伺服器>"。

情況： 指定的目標路徑不存在。如果使用者具有權限，則將建立新路徑，並會將新模型放在該處。

回應：本端模型 "<目標路徑>" 成功建立。

情況：目標路徑 (新模型) 已存在且使用者未明確使用 [-overwrite] 選項。

回應： 無法建立本端模型，因為模型 "<模型路徑>" 已存在。

情況： 指定的伺服器無法存取或網路斷開。

回應： 無法建立本端模型，因為 Revit Server 目前不可用。

情況：伺服器上的模型目前正在使用中。

回應： 無法建立本端模型，因為模型 "<模型路徑>" 目前正在使用中。

情況：

因以下原因導致執行失敗：未知原因、或模型已損壞、或使用者無法存取目標路徑、或目標路徑的總路徑長度大於 255、或使用者未指定目標路徑，但無法建立路徑。

回應： 無法在位置 "<目標路徑>" 建立本端模型。