共用方式為


使用 Configuration Manager 的服務連線工具

適用於:Configuration Manager (目前的分支)

當您的服務連接點處於離線模式時,請使用 服務連接工具 。 當你的 Configuration Manager 站點系統伺服器沒有連上網際網路時,也可以使用它。 這個工具可以幫助你讓網站隨時掌握 Configuration Manager 的最新更新。

當你執行這個工具時,它會連接到 Configuration Manager 雲端服務,上傳你的階層使用資訊,並下載更新。 上傳使用資料是讓雲端服務能為你的環境提供正確更新的必要步驟。

必要條件

  • 網站有一個服務連接點,你可以設定成 離線、按需連線

  • 以管理員身份從命令提示字元執行工具。 沒有使用者介面。

  • 你從服務連接點和能連網的電腦上運行這個工具。 這些電腦每台都需要搭載 x64 位元作業系統,並具備以下元件:

    • 包括 C++ 可轉散發套件 x86 與 x64 檔案。 預設情況下,Configuration Manager 會在承載服務連接點的電腦上安裝 x64 版本。 此工具需要在你執行的電腦上安裝 Microsoft Visual C++ 2015-2019 可再發佈套件 (14.28.29914.0) 或更新版本。 欲下載此元件,請參閱 Microsoft Visual C++ 最新支援的可再分版下載

      注意事項

      若從 2107 之前已不支援的 Configuration Manager 版本升級,該工具需使用 Visual C++ 2013 可再發佈套件 (12.0.40660.0) ,該套件可從同一連結取得。

    • 此工具需要 .NET 版本 4.6.2,建議使用版本 4.8。 欲了解更多資訊,請參閱 場地及場地系統的前提條件

    • 從版本 2309 開始,此工具需安裝 SQL Server (x64) 的 ODBC 驅動程式 18。 要下載此元件,請參閱下載 SQL Server 的 ODBC 驅動程式

  • 你用來執行這個工具的帳號需要以下權限:

    • 在主機服務連接點的電腦上,本地管理員

    • 網站資料庫的讀取 權限

  • 你需要一種方法在有網路連線的電腦和服務連接點之間傳輸檔案。 例如,一個有足夠空間用來存放檔案和更新的 USB 隨身碟。

概觀

  1. 準備:在服務連接點執行該工具。 它會把你的使用資料放到你指定的位置的 .cab 檔案中。 把資料檔案複製到有網路連線的電腦上。

  2. 連線:在有網路連線的電腦上執行這個工具。 它會上傳你的使用資料,然後下載 Configuration Manager 的更新。 將下載的更新複製到服務連接點。

    你可以同時上傳多個資料檔案,每個檔案來自不同的階層結構。 你也可以指定代理伺服器和代理伺服器的使用者。

  3. 匯入:在服務連接點執行工具。 它會匯入更新,然後把它們加入你的網站。 接著你可以在 Configuration Manager 主控台中查看並安裝這些更新

上傳多個資料檔案

  • 把所有從不同階層匯出的資料檔案放到同一個資料夾。 給每個檔案一個獨特的名稱。 如果需要,你可以手動重新命名它們。

  • 當你執行工具上傳資料到 Microsoft 時,你會指定包含資料檔案的資料夾。

  • 當你執行這個工具匯入資料時,工具只會匯入該階層的資料。

指定代理伺服器

若有網路連線的電腦需要代理伺服器,該工具支援基本代理設定。 請使用可選參數 -proxyserveruri-proxyusername。 欲了解更多資訊,請參閱 命令列參數

請指定要下載的更新類型

這個工具支援控制你下載的檔案選項。 預設情況下,工具只會下載適用於你網站版本的最新可用更新。 它不會下載熱修正。

要修改此行為,請使用以下參數之一來更改下載的檔案:

  • -下載全部:下載所有更新,包括更新和熱修補,無論你網站的版本如何。

  • -下載熱修補丁:下載所有熱修補丁,不論你網站的版本。

  • -downloadsiteversion:下載更新與熱修補程式,更新版本比你網站版本晚。

    重要事項

    由於 Configuration Manager 2002 版本中已知的問題,預設行為無法如預期運作。 更新至 2006 版,或使用 -downloadsiteversion 參數下載 2002 版所需的更新。

欲了解更多資訊,請參閱 命令列參數

提示

工具會根據資料檔案判定你網站的版本。 要確認版本,請在 .cab 檔案中尋找標示網站版本的文字檔。

使用這個工具

服務連接工具位於 Configuration Manager 安裝媒體中,路徑如下:SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe。 務必使用與你所使用的 Configuration Manager 版本相符的服務連線工具。 這些檔案必須放在同一個資料夾裡,服務連接工具才能正常運作。

ServiceConnectionTool 資料夾及其所有內容複製到有網路連線的電腦。

在此程序中,命令列範例使用以下檔案名稱與資料夾位置。 你不需要使用這些路徑和檔名。 你可以選擇符合你環境和偏好的替代方案。

  • 服務連接點上 Configuration Manager 安裝媒體原始碼的路徑:C:\Source

  • 連接到 USB 隨身碟的路徑,用來儲存電腦間傳輸的資料: D:\USB\

  • 你從網站匯出的資料檔案名稱: UsageData.cab

  • 該工具存放已下載更新的 Configuration Manager 資料夾名稱:UpdatePacks

準備

  1. 在主機服務連接點的電腦上,以管理員身份開啟命令提示字元,並將目錄改為工具所在位置。 例如:

    cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\

  2. 執行以下指令來準備資料檔案:

    ServiceConnectionTool.exe -prepare -usagedatadest D:\USB\UsageData.cab

    注意事項

    如果你同時上傳多個階層的資料檔案,請給每個資料檔案一個獨特的名稱。 如果需要,之後可以重新命名檔案。

    檔案中的資料是根據你為該站設定的診斷與使用資料層級而定。 欲了解更多資訊,請參閱 診斷與使用資料概述。 你可以使用這個工具將資料匯出成 CSV 檔案,查看內容。 欲了解更多資訊,請參閱 -export

  3. 工具匯出使用資料後,將資料檔案複製到有網路存取權的電腦。

連線

  1. 在有網路連線的電腦上,以管理員身份開啟命令提示字元,並將目錄改為工具所在位置。 這個位置是整個 ServiceConnectionTool 資料夾的副本。 例如:

    cd D:\USB\ServiceConnectionTool\

  2. 執行以下指令上傳資料檔並下載 Configuration Manager 更新:

    ServiceConnectionTool.exe -connect -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks

    更多範例請參見 命令列參數

    注意事項

    當你執行這個命令列時,可能會看到以下錯誤:

    未處理的例外:System.UnauthorizedAccessException:拒絕存取路徑 'C:\Users\jqpublic\AppData\Local\Temp\extractmanifestcab\95F8A562.sql'。

    你可以放心忽略這個錯誤。 關閉錯誤視窗以繼續。

  3. 工具下載完更新後,複製到服務連接點。

匯入

  1. 在主機服務連接點的電腦上,以管理員身份開啟命令提示字元,並將目錄改為工具所在位置。 例如:

    cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\

  2. 執行以下指令來匯入更新:

    ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks

  3. 匯入完成後,關閉命令提示字元。 它只會匯入適用階層的更新。

  4. 在 Configuration Manager 主控台中,前往管理工作區,選擇匯報與服務節點。 匯入更新現在可以安裝。 更多資訊請參閱 安裝主機內更新

記錄檔

  • ServiceConnectionTool.log:每次執行服務連線工具時,它都會寫入這個日誌檔。 日誌檔案的路徑永遠與工具相同。 這個日誌檔根據你所使用的參數,提供工具使用情況的簡單細節。 每次執行該工具時,工具會替換任何現有的日誌檔。

  • ConfigMgrSetup.log在 Connect 階段,工具會寫入系統磁碟根部的這個日誌檔。 此日誌檔案提供更詳細的資訊。 例如,工具下載了哪些檔案,以及雜湊檢查是否成功。

命令列參數

本節依字母順序列出所有可用於服務連接工具的參數。

-連接

在有網路連線的電腦上使用連接階段。 它會連接到 Configuration Manager 雲端服務,上傳資料檔案並下載更新。

它需要以下參數:

  • -usagedatasrc:上傳資料檔案的位置
  • -updatepackdest:下載更新的路徑

您也可以使用以下可選參數:

  • -proxyserveruri:代理伺服器的 FQDN
  • -proxyusername:代理伺服器的使用者名稱
  • -全部下載:下載所有內容,包括更新和熱修補,不論你網站的版本如何。
  • -下載熱修補丁:下載所有熱修補,不論你網站的版本。
  • -downloadsiteversion:下載比你網站版本更新的更新和熱修補程式。

無代理伺服器連線的範例

ServiceConnectionTool.exe -connect -usagedatasrc D:\USB\ -updatepackdest D:\USB\UpdatePacks

連接代理伺服器的範例

ServiceConnectionTool.exe -connect -usagedatasrc D:\USB\Usagedata.cab -updatepackdest D:\USB\UpdatePacks -proxyserveruri itproxy.contoso.com -proxyusername jqpublic

僅連結下載網站版本適用更新範例

ServiceConnectionTool.exe -connect -downloadsiteversion -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks

-最

必須設定一個包含 -export 參數的參數,用來指定 CSV 檔案的路徑與檔案名稱。 欲了解更多資訊,請參閱 -export

-全部下載

一個可選的參數,裡面有 -connect 參數,可以下載所有東西,包括更新和熱修正,不論你網站的版本。 欲了解更多資訊,請參閱 -connect

-下載熱修補

一個可選參數,裡面有 -connect 參數,只下載所有熱修補,不論你網站的版本。 欲了解更多資訊,請參閱 -connect

-下載網站版

一個帶有 -connect 參數的可選參數,只下載比你網站版本更新的更新和熱修正。 欲了解更多資訊,請參閱 -connect

-出口

準備 階段使用時,可以將使用資料匯出成 CSV 檔案。 在服務連接點以管理員身份執行。 此操作允許你在上傳給 Microsoft 前檢視使用資料內容。 它需要 -dest 參數來指定 CSV 檔案的位置。

出口範例

-export -dest D:\USB\usagedata.csv

-進口

在服務連接點的 匯入 階段,將更新匯入到網站。 它需要 -updatepacksrc 參數來指定下載更新的位置。

進口範例

ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks

-準備

在服務連接點的 準備 階段使用,從站點匯出使用資料。 它需要 -usagedatadest 參數來指定匯出資料檔案的位置。

準備的範例

ServiceConnectionTool.exe -prepare -usagedatadest D:\USB\UsageData.cab

-proxyserveruri

一個可選的參數,帶有 -connect 參數,用來指定你代理伺服器的 FQDN。 如果你的代理伺服器需要非 80 埠,而你沒指定或指定錯誤埠口,工具可能會失敗並回報 CAB does not contain telemetry data. 錯誤。 欲了解更多資訊,請參閱 -connect

-proxyusername

一個可選的參數,用 -connect 參數來指定要與代理伺服器認證的使用者名稱。 欲了解更多資訊,請參閱 -connect

-更新包

一個必須的參數,包含 -connect 參數,用來指定下載更新的路徑。 欲了解更多資訊,請參閱 -connect

-更新包

一個必須的參數,包含 -import 參數,用來指定下載更新的路徑。 欲了解更多資訊,請參閱 -import

-UsageDataDest

一個必須的參數,包含 -prepare 參數,用以指定匯出資料檔案的路徑與檔案名稱。 更多資訊請參見 -prepare

後續步驟

安裝主控台內更新

如何檢視診斷和使用狀況資料