適用於主機板、桌面和房間系列裝置的零觸控佈建 (ZTP)

可用性：

一般可針對執行 RoomOS 26.5.0 或更高版本的支援裝置使用零觸控佈建 (ZTP)。

主要優勢

自動裝置註冊：將裝置指派給共用工作區或個人使用者帳戶時，可以使用其 MAC 位址加入裝置，從而減少使用 MAC 位址登入時手動輸入啟動程式碼的需求。支援Webex Edge 的部署可以與部署呼叫使用相同的程序。
簡化設置： 利用 Control Hub 的預設設置和預配置，首次嚮導 (FTW) 體驗得到簡化，從而顯著減少物理設備設置期間的手動步驟。
高效的批量操作： 通過導入包含 MAC 位址的 CSV 檔，可以批量添加設備，從而輕鬆實現大規模部署。
預先啟動功能：設備可以提前激活，甚至在連接到網絡之前。您可以為工作區或個人使用者帳戶預先安裝裝置。
降低入職複雜性： 通過自動化網路入職和設備配置，ZTP 減少了傳統上與設備設置相關的時間、成本和複雜性。

Control Hub 中裝置載入的主要術語

無人認領： 設備的 MAC 位址未在組織內註冊。
已聲明： 設備的 MAC 位址已添加到您的組織中。
未指定：尚未連結至工作區或個人使用者帳戶的聲稱裝置。
已指派：連結至工作區或個人使用者帳戶的聲稱裝置。
擱置： Control Hub 中顯示的已認領和/或指派但尚未上線的裝置之狀態。
預配置： 在掛起的設備連接到網路或連線之前將設備配置設置應用於掛起設備的過程。
已啟動：裝置已完成適用的 Webex 或Webex Edge 啟用程序。
個人裝置：指派給一個使用者帳戶而非工作區的裝置。
Webex Edge：部署模型，其中裝置在接收支援的雲端功能和管理時仍保持在內部部署基礎架構上註冊。請參 Webex Edge閱文件。

需求

在部署之前，請確保您的環境滿足以下要求：

軟體版本： 裝置必須執行 RoomOS 26.5.0 或更高版本。不支援 RoomOS 11。
網路連接： 設備需要可靠的網路訪問，並連接到 Webex 服務。
配置預設值： 在 Control Hub 中定義時間和位置的時間格式、時區和語言預設值，以最大程度地減少首次精靈 (FTW) 期間的載入提示。

對於個人模式，使用者必須在控制中心中存在，才能指定裝置。

對於 Webex Edge ZTP，必須在部署需要的情況下提供 CUCM/TFTP 探索功能，在使用時包括 DHCP 選項 150。驗證 AllowDataLogging 的行為，並解決 CUCM 控制和控制中樞控制的組態之間的任何衝突，然後再加入。

先決條件：升級到零觸摸啟動的最低版本

要升級到版本 26.5，現在需要手動執行升級。在接下來的幾個月中，板載前升級功能將自動執行此過程，並且工廠映像將相應地更新。在此之前，客戶必須使用包連結或 xcommand 介面進行升級以安裝更新，然後執行恢復出廠設置以完成該過程。

入職期間的軟體版本：如果裝置低於 FTW 上線版本，ZTP 可能會在註冊前將其升級。無論工作區軟體通道為何，包括透過懸掛裝置組態設定設定的通道，都會進行此升級。完成 ZTP 後，將套用工作區的一般軟體規則，且裝置可能會升級或降級至該通道所需的版本。這種行為是預期的。Microsoft Teams 會議室裝置：如果 ZTP 將 MTR 裝置升級至比其 Microsoft 核准通道的版本以後的版本，則裝置在 MTR 模式下運作時不會自動降級。

包映射和命令

根據您的硬體選擇適當的套件。使用提供的 xCommand 來起始升級。

裝置種類	包名稱
思科 Room Navigator	`bifrost.pkg`
較新的產品（Codec Pro G2，Desk Pro G2）	`luna.pkg`
標準 RoomOS 端點（Room Bar, Room Kit EQ, Board Pro、Desk、Codec Pro）	`zenith.pkg`

對於 Cisco Room Navigator：


xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/bifrost.pkg" Forced: True

對於 Codec Pro G2 和 Desk Pro G2：


xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/luna.pkg" Forced: True

對於 Room Bar, Room Kit EQ, Board Pro、Desk 和 Codec Pro：


xCommand SystemUnit SoftwareUpgrade URL: "https://binaries.webex.com/collaboration-endpoint-ce-production-stable/20260415114153/zenith.pkg" Forced: True

Microsoft 目前不支援通過 pkg 安裝程式進行團隊安裝。我們正在等待所需的 COP (Cisco 選項包) 文件的發佈，該文件計劃在本月底之前提供。

透過 CLI 啟動零接觸啟動

您可以使用命令行介面 (CLI) 或 API 手動觸發零接觸激活過程。使用以下命令開始工作流：


xCommand Webex Registration ZeroTouchProvisioning Start SecurityAction: <Harden, NoAction>
Parameters:
Harden: Applies enhanced security settings to the device during the activation process.
NoAction: Proceeds with the activation using the current device security configuration.

Control Hub 中的設定步驟

設定預設值
設置預設值有助於設備在載入過程中跳過手動設置步驟。導覽至 Control Hub 並設定以下項目：
- 時間 -> 時間格式 (例如，12h/24h)
- 時>區 (例如，美國/New_York)
- 使用者介面 -> 語言 (例如英語)
（可選）將工作區分配到配置這些預設值的位置，或應用組織範圍的預設值。

在使用「零觸控啟動」之前，請確認裝置不需要混合通話。需要混合通話的裝置必須使用啟動程式碼或手動上線工作流程。
透過 MAC 位址新增裝置
1. 移至 Control Hub ->裝置 -> 新增裝置 (或建立工作區)。您也可以從「使用者」開始，選取使用者，開啟 [裝置] 索引標籤，然後選取 [新 增裝置]。
2. 選取 Cisco 房間或桌面裝置，選擇共用使用或個人使用情況，然後選取 MAC 位址。輸入有線乙太網路 MAC 位址、產品類型和平台 (RoomOS 或微軟團隊)。如果選擇 Microsoft Teams，平臺將在嚮導完成後自動安裝。
3. 對於個人裝置，請選取要指定的使用者帳戶。對於支援 Webex Edge的部署，請選取可用時選取「部署呼叫」，然後遵循設定的 CUCM/內部部署佈建路徑。
4. 如果裝置已被聲稱但未指派，請在 Control Hub 中開啟裝置，選取指派，然後選擇指派裝置給使用者。 尚未連線的聲稱裝置會顯示為「待處理」。
請參閱查找設備的物理 MAC 位址標籤部分，瞭解如何查找設備的 MAC 位址。

您可以使用裝置頁面上的「擁有權」篩選並選取「已申請」，篩選所有已申請的裝置 (無論是線上還是離線)。
將預設定套用於掛起的裝置 (可選，推薦)
您可以按照以下步驟在裝置連線之前為任何受支援的設定套用裝置級預設定：
- 在 Control Hub 中打開待處理裝置頁面。
- 按兩下所有配置。
- 應用必要的設置。
在載入期間，設備按層次結構順序使用來自以下源的配置設置：
- 組織等級預設值
- 位置等級預設值
- 掛起的裝置上的裝置級預設定
在上述任何級別定義的設置都會在首次嚮導載入流程期間自動應用。

要使自動載入精靈成功完成，必須設定以下設定：

所有裝置：
- 時間>時間格式 (例如，12h/24h)
- 時>區 (例如，美國/New_York)
- 使用者介面>語言 (例如英語)
僅限 Board 系列：
- 音訊>放置 (壁掛式、獨立式)
結果：
- 根據入職方式而定，裝置會顯示為「已申請」、「已指派」或「等待處理」。當設備連接時，它將完成自動上線。
- 它預配置了位置和設備級設置。
- 當恢復出廠設置的設備連接到網路時，它將自動註冊並載入。

找到裝置的實體 MAC 位址標籤

如果您找不到 MAC 位址，它通常印在設備背面或底部的產品標籤上。此標籤通常包括其他重要標識碼，例如序列號和產品 ID。對於許多 Cisco 產品，MAC 位址標籤已明確標記，可以在機箱或標籤托盤上找到。如果您無法實際找到它，某些設備還允許您通過其使用者介面或網頁在產品或系統資訊設置下查看 MAC 位址。尋找 MAC 位址

入職流程

Webex Edge支援裝置優先和雲端先導入序列。視部署而定，裝置可能會先探索 CUCM/TFTP 設定，然後完成啟用，或在Webex Edge 連線到內部部署佈建環境之前使用其 Control Hub 指派。

在 Control Hub 中認領和分配裝置後：

確保設備已恢復出廠設置。
將設備連接到網路。
在歡迎螢幕上，選擇自動載入選項。
裝置啟動正在進行中
對於 Control Hub 中未設定的項目，請遵循任何剩餘的提示。
- 如果在預配置期間未完成某些設置，設置精靈將提示您在設備載入期間配置這些專案。
- 此外，請完成必要的硬體設置，例如正確放置相機，以確保最佳設備性能。

如果未顯示自動載入選項，請驗證以下內容：

MAC 位址已正確輸入並指定給預定的工作區或個人使用者帳戶
裝置已恢復出廠設定。
設備已驗證對 Webex 服務的互聯網訪問。
裝置執行的最低要求軟體版本 (RoomOS 26.5.0+)。

大量裝置載入 (CSV)

使用批量載入流程在單次導入中認領和分配多個設備。

在 Control Hub 中導覽至裝置，然後按下 添加裝置。
選擇 批量添加設備。
批次新增裝置
從範本下拉清單中 ，選擇零接觸入職 範本並下載 CSV 檔。
零接觸範本選擇
在 CSV 檔中填充您的設備和作業資訊，確保完成所有必填欄位。對於「個人模式」裝置，請在「帳戶」欄中輸入使用者的電子郵件地址。現有的共用和工作區 CSV 行為保持不變。
上傳完成的 CSV 檔並提交導入。
打開“任務” 頁以監視導入進度，並在任何行失敗時下載錯誤 CSV 檔。
批量匯入工作狀態
驗證「設備」清單中導入的設備，這些設備在首次連接之前最初可能顯示為 「已聲明 」和 「掛起 」。
處於擱置狀態的匯入裝置

裝置網頁載入 (遠端)

當您無法實際存取裝置介面時，請使用裝置網頁進行遠端載入。此方法對於未附加 Room Navigator 的部署尤其有用，例如 Room Bar BYOD 和 Room Bar Pro BYOD 裝置。

打開網路瀏覽器，然後在位址欄中輸入設備的 IP 位址。
使用使用者名 admin 登錄，不帶密碼。
裝置網頁 Home
在裝置網頁上，開啟系統頁面，然後按一下「註冊至 Webex」。
註冊到 Webex
在註冊對話框中，按兩下 開始自動載入 以開始該過程。自動入門也支援已指派給個人使用者帳戶的裝置。對於支援Webex Edge的部署，裝置會繼續經過設定的 CUCM/ 內部部署佈建路徑。
自動載入開始
等待載入開始。然後，在 Control Hub 中驗證設備狀態和註冊狀態，以確保成功加入。

其他資訊

此載入方法使你能夠遠端配置和管理設備，而無需物理 Room Navigator 或直接設備交互。
註冊后，可以通過 Cisco Webex Control Hub 管理和監控設備。
對於 Room Bar BYOD 設備，此過程允許啟用網路連接和 Control Hub 註冊，從而解鎖軟體管理、外圍設備可見性和 Remote Access 等高級功能。
在開始載入過程之前，請確保設備已連接到網路並可通過其 IP 位址訪問。

這種簡化的遠端入職流程有助於在物理訪問受限或不可用的環境中簡化 Cisco 協作設備的部署和管理。

首次精靈 (FTW) 行為

首次精靈 (FTW) 指導 Cisco 協作裝置的初始加入過程。其行為包括以下關鍵操作：

自動載入開始： 一旦使用者在歡迎螢幕上選擇自動載入選項，FTW 就會開始載入。 FTW 可識別裝置是共用還是個人裝置。個人裝置會使用指定的使用者帳戶，並且選取 Mac 型入門時，不需要手動輸入啟動代碼。請注意，個人模式裝置在預定使用者解鎖之前，才能完成精靈。如果用戶的帳戶上設置了 PIN，則用戶必須先解鎖該密碼，或前往 https://user.webex.com/ 重置其密碼。如果他們沒有使用引腳，則必須先與設備配對（QR 碼，超聲波或 USB-C）才能解鎖。
Webex Edge佈建：對於支援的部署，FTW 會在完成啟動之前保留 CUCM/TFTP 佈建路徑。Webex Edge
使用設定的預設值： 如果可用，精靈將應用已設定的預設值，例如語言和時區。
預配置的應用程式： 它應用組織、位置中的配置以及 Control Hub 中設置的任何待定裝置預配置。
提示輸入缺少的設定： 精靈會提示使用者輸入 Control Hub 中尚未設定的任何設定。
Microsoft Teams 安裝： 如果在添加設備過程中選擇了 Microsoft Teams 平臺，則嚮導會在載入結束時安裝 Microsoft Teams。
手動硬體檢查： 某些硬體設置任務 (如相機定位) 需要使用者手動完成。

限制與手動工作

實際硬體安裝 (如攝影機定位和安裝) 仍需手動執行。
不支援使用者中心自助指派 MAC 位址。
不支援在註冊後在主要通話模式之間更改裝置。
如果未在 Control Hub 中設定相應的預設設定，您可能需要手動完成某些首次精靈步驟。
混合通話：零觸控佈建不支援混合通話。請勿使用 ZTP 工作流程佈建需要混合通話的裝置。改為使用現有的啟動程式碼或手動入職工作流程。混合通話選項不會出現在 ZTP 設定流程中，這是預期的。
零觸摸配對在初始版本中不可用。計劃在將來的更新中支援此功能。
目前不支援 TLS 攔截代理。要使零接觸啟動正常運行，設備必須與 Webex 服務建立直接、受信任的連接。目前正在開發這些環境的簡化信任引導過程。
對於需要 802.1X 或 SCEP 的部署，證書註冊仍為手動過程，獨立於零接觸激活進行處理。雖然目前正在開發自動證書載入工具，但當前的零接觸工作流程假定設備已建立與 Webex 服務的網路連接。

Cisco AI Assistant

感謝您的意見回饋。