使用 Configuration Manager 的服務連線工具

發行項
06/15/2024

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

當服務連接點處於離線模式時，請使用 服務連線工具 。當 Configuration Manager 月台系統伺服器未連線到因特網時，您也可以使用它。此工具可協助您使用 Configuration Manager 的最新更新，讓您的月臺保持在最新狀態。

當您執行此工具時，它會連線到 Configuration Manager 雲端服務、上傳階層的使用方式資訊，以及下載更新。必須上傳使用量數據，才能讓雲端服務為您的環境提供正確的更新。

必要條件

月臺有服務連接點，而您會將它設定為 離線隨選連線。
以系統管理員身分從命令提示字元執行工具。沒有使用者介面。
您可以從服務連接點和可連線到因特網的電腦執行此工具。每部計算機都必須有 x64 位作業系統，並具有下列元件：
- Visual C++可轉散發 x86 和 x64 檔案。根據預設，Configuration Manager 會在裝載服務連接點的計算機上安裝 x64 版本。此工具需要Microsoft執行 Visual C++ 2015-2019 可轉散發套件 (14.28.29914.0) 或更新版本，若要下載此元件，請參閱Microsoft Visual C++可轉散發的最新支持下載。
  
  注意事項
  
  如果從 2107 之前的 Configuration Manager 支援版本升級，此工具需要 Visual C++ 2013 redistributalbe packate (12.0.40660.0) ，這可從相同的連結取得。
- 此工具需要 .NET 4.6.2 版，建議使用 4.8 版。如需詳細資訊，請參閱月臺和月臺系統必要條件。
- 從 2309 版開始，此工具需要安裝 ODBC Driver 18 for SQL Server (x64) 。若要下載此元件，請參閱下載 ODBC Driver for SQL Server。
您用來執行工具的帳戶需要下列權限：
- 裝載服務連接點之電腦上的本機系統管理員
- 月臺資料庫的讀取許可權
您需要方法，以在具有因特網存取權的計算機與服務連接點之間傳輸檔案。例如，具有足夠可用空間來儲存檔案和更新的USB磁碟驅動器。

概觀

準備：在服務連接點上執行工具。它會將您的使用量資料放入您指定位置的 .cab 檔案中。將數據檔案複製到具有因特網連線的電腦。
線上：在具有因特網連線的計算機上執行工具。它會上傳您的使用量數據，然後下載 Configuration Manager 更新。將下載的更新複製到服務連接點。

您可以一次上傳多個數據檔，每個都來自不同的階層。您也可以指定 Proxy 伺服器和 Proxy 伺服器的使用者。
匯入：在服務連接點上執行工具。它會匯入更新，並將其新增至您的網站。然後，您可以在 Configuration Manager 控制台中檢視並安裝這些更新。

上傳多個數據檔

將來自不同階層的所有匯出資料檔放入相同的資料夾中。為每個檔案指定唯一的名稱。如有必要，您可以手動重新命名它們。
當您執行工具將資料上傳至 Microsoft 時，您可以指定包含資料夾。
當您執行匯入數據的工具時，此工具只會匯入該階層的數據。

指定 Proxy 伺服器

如果具有因特網連線的計算機需要 Proxy 伺服器，此工具支援基本 Proxy 設定。使用選擇性參數 -proxyserveruri 和 -proxyusername。如需詳細資訊，請參閱命令行參數。

指定要下載的更新類型

此工具支援控制您下載之檔案的選項。根據預設，此工具只會下載適用於您網站版本的最新可用更新。它不會下載 Hotfix。

若要修改此行為，請使用下列其中一個參數來變更其所下載的檔案：

-downloadall：下載所有更新，包括更新和 Hotfix，無論您的網站版本為何。
-downloadhotfix：下載所有 Hotfix，不論您的網站版本為何。
-downloadsiteversion：下載更新和 Hotfix 的版本比您的網站版本還舊。

重要事項

由於 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

準備

在裝載服務連接點的計算機上，以系統管理員身分開啟命令提示字元，並將目錄變更為工具位置。例如：

cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\
執行下列命令來準備資料檔案：

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

注意事項

如果您要同時從多個階層上傳數據檔，請為每個數據檔提供唯一的名稱。如有必要，您可以稍後重新命名檔案。

檔案中的數據是以您為月臺設定的診斷和使用方式數據層級為基礎。如需詳細資訊，請參閱診斷和使用方式數據概觀。您可以使用工具將數據匯出至 CSV 檔案，以檢視內容。如需詳細資訊，請參閱 -export。
在工具完成匯出使用量數據之後，將數據檔複製到可存取因特網的計算機。

連線

在可存取因特網的計算機上，以系統管理員身分開啟命令提示字元，並將目錄變更為工具位置。此位置是整個 ServiceConnectionTool 資料夾的複本。例如：

cd D:\USB\ServiceConnectionTool\
執行下列命令來上傳資料檔並下載 Configuration Manager 更新：

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

如需詳細範例，請參閱命令行參數。

注意事項

當您執行此指令列時，可能會看到下列錯誤：

未處理的例外狀況：System.UnauthorizedAccessException：無法存取路徑 'C：\Users\jqpublic\AppData\Local\Temp\extractmanifestcab\95F8A562.sql'。

您可以放心地忽略此錯誤。關閉錯誤視窗以繼續。
在工具完成下載更新之後，請將更新複製到服務連接點。

匯入

在裝載服務連接點的計算機上，以系統管理員身分開啟命令提示字元，並將目錄變更為工具位置。例如：

cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\
執行下列命令以匯入更新：

ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks
匯入完成之後，關閉命令提示字元。它只會匯入適用階層的更新。
在 Configuration Manager 控制台中，移至 [ 系統管理 ] 工作區，然後選取 [ 更新與服務 ] 節點。匯入的更新現在可供安裝。如需詳細資訊，請參閱安裝控制台內更新。

記錄檔

ServiceConnectionTool.log：每次您執行服務連線工具時，它都會寫入此記錄檔。記錄檔的路徑一律與工具的位置相同。此記錄檔會根據您使用的參數，提供工具使用方式的簡單詳細數據。每次執行工具時，此工具都會取代任何現有的記錄檔。
ConfigMgrSetup.log：在連線階段期間，工具會寫入系統磁碟驅動器根目錄的這個記錄檔。此記錄檔提供更詳細的資訊。例如，工具下載的檔案，以及哈希檢查是否成功。

命令行參數

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

-連接

在具有因特網存取的電腦上，於連線階段使用。它會連線到 Configuration Manager 雲端服務來上傳數據檔，並下載更新。

它需要下列參數：

-usagedatasrc：要上傳的數據檔位置
-updatepackdest：已下載更新的路徑

您也可以使用下列選擇性參數：

-proxyserveruri:P roxy 伺服器的 FQDN
-proxyusername:P roxy 伺服器的用戶名稱
-downloadall：下載所有專案，包括更新和 Hotfix，無論您的網站版本為何。
-downloadhotfix：下載所有 Hotfix，不論您的網站版本為何。
-downloadsiteversion：下載版本比月臺版本還舊的更新和 Hotfix。

不使用 Proxy 伺服器進行連線的範例

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

與 Proxy 伺服器連線的範例

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

-dest

具有 - export 參數的必要參數，以指定要匯出之 CSV 檔案的路徑和檔名。如需詳細資訊，請參閱 -export。

-downloadall

具有 -connect 參數的選擇性參數，可下載所有專案，包括更新和 Hotfix，不論您的月臺版本為何。如需詳細資訊，請參閱 -connect。

-downloadhotfix

具有 -connect 參數的選擇性參數，僅下載所有 Hotfix，不論您的網站版本為何。如需詳細資訊，請參閱 -connect。

-downloadsiteversion

具有 -connect 參數的選擇性參數，僅下載版本比月臺版本還舊的更新和 Hotfix。如需詳細資訊，請參閱 -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 參數的選擇性參數，用來指定 Proxy 伺服器的 FQDN。如需詳細資訊，請參閱 -connect。

-proxyusername

具有 -connect 參數的選擇性參數，可指定要向 Proxy 伺服器驗證的用戶名稱。如需詳細資訊，請參閱 -connect。

-updatepackdest

具有 -connect 參數的必要參數，以指定所下載更新的路徑。如需詳細資訊，請參閱 -connect。

-updatepacksrc

具有 - import 參數的必要參數，以指定已下載更新的路徑。如需詳細資訊，請參閱 -import。

-usagedatadest

具有 -prepare 參數的必要參數，以指定匯出數據文件的路徑和檔名。如需詳細資訊，請參閱 -prepare。

後續步驟

安裝主控台內更新

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

共用方式為