使用 Configuration Manager 的服務連線工具

適用於：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磁碟驅動器。

概觀

1. 準備：在服務連接點上執行工具。 它會將您的使用量資料放入您指定位置的 .cab 檔案中。 將數據檔案複製到具有因特網連線的電腦。

2. 線上：在具有因特網連線的計算機上執行工具。 它會上傳您的使用量數據，然後下載 Configuration Manager 更新。 將下載的更新複製到服務連接點。

   您可以一次上傳多個數據檔，每個都來自不同的階層。 您也可以指定 Proxy 伺服器和 Proxy 伺服器的使用者。

3. 匯入：在服務連接點上執行工具。 它會匯入更新，並將其新增至您的網站。 然後，您可以在 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

準備

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：在 連線 階段期間，工具會寫入系統磁碟驅動器根目錄的這個記錄檔。 此記錄檔提供更詳細的資訊。 例如，工具下載的檔案，以及哈希檢查是否成功。

命令行參數

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

-連接

在具有因 特 網存取的電腦上，於連線階段使用 。 它會連線到 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。

後續步驟

安裝主控台內更新

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