使用 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磁碟驅動器。
概觀
準備:在服務連接點上執行工具。 它會將您的使用量資料放入您指定位置的 .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。