共用方式為


使用 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

後續步驟

安裝主控台內更新

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