通过

使用 Configuration Manager 的服务连接工具

  • 项目

适用于: Configuration Manager(current branch)

当 服务连接 点处于脱机模式时，请使用服务连接工具。 当 Configuration Manager 站点系统服务器未连接到 Internet 时，也可以使用它。 该工具可帮助你使用 Configuration Manager 的最新更新使站点保持最新状态。

运行该工具时，它会连接到 Configuration Manager 云服务，上传层次结构的使用情况信息，并下载更新。 必须上传使用情况数据才能使云服务为环境提供正确的更新。

先决条件

  • 站点有一个服务连接点，你可以将其配置为 脱机按需连接。

  • 以管理员身份从命令提示符运行该工具。 没有用户界面。

  • 可以从服务连接点和可连接到 Internet 的计算机运行该工具。 其中每台计算机都需要具有 x64 位 OS，并具有以下组件：

    • 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 再发行包 (12.0.40660.0) ，可从同一 链接获取。

    • 此工具需要 .NET 版本 4.6.2，建议使用版本 4.8。 有关详细信息，请参阅 站点和站点系统先决条件。

    • 从版本 2309 开始，此工具需要安装 ODBC Driver 18 for SQL Server (x64) 。 若要下载此组件，请参阅 下载 ODBC Driver for SQL Server。

  • 用于运行该工具的帐户需要以下权限：

    • 承载服务连接点的计算机上的本地管理员

    • 对站点数据库的读取权限

  • 需要一种方法在具有 Internet 访问的计算机和服务连接点之间传输文件。 例如，具有足够可用空间来存储文件和更新的 U 盘。

概述

  1. 准备：在服务连接点上运行该工具。 它会将使用情况数据放入指定位置的 .cab 文件中。 将数据文件复制到具有 Internet 连接的计算机。

  2. 连接：在具有 Internet 连接的计算机上运行该工具。 它会上传使用情况数据，然后下载 Configuration Manager 更新。 将下载的更新复制到服务连接点。

    可以一次上传多个数据文件，每个数据文件来自不同层次结构。 还可以为代理服务器指定代理服务器和用户。

  3. 导入：在服务连接点上运行该工具。 它会导入更新，并将其添加到站点。 然后，可以在 Configuration Manager 控制台中查看和 安装这些更新 。

上传多个数据文件

  • 将来自不同层次结构的所有导出数据文件放入同一文件夹中。 为每个文件指定唯一名称。 如有必要，可以手动重命名它们。

  • 运行工具将数据上传到Microsoft时，请指定包含数据文件的文件夹。

  • 运行工具导入数据时，该工具仅导入该层次结构的数据。

指定代理服务器

如果具有 Internet 连接的计算机需要代理服务器，该工具支持基本代理配置。 使用可选参数 -proxyserveruri 和 -proxyusername。 有关详细信息，请参阅 命令行参数。

指定要下载的更新的类型

该工具支持用于控制下载的文件的选项。 默认情况下，该工具仅下载适用于站点版本的最新可用更新。 它不会下载修补程序。

若要修改此行为，请使用以下参数之一来更改它下载的文件：

  • -downloadall：下载所有更新，包括更新和修补程序，无论站点的版本如何。

  • -downloadhotfix：下载所有修补程序，无论站点的版本如何。

  • -downloadsiteversion：下载版本高于站点版本的更新和修补程序。

    重要

    由于 Configuration Manager 版本 2002 中的已知问题，默认行为无法按预期工作。 更新到版本 2006，或使用 -downloadsiteversion 参数下载版本 2002 的必要更新。

有关详细信息，请参阅 命令行参数。

提示

该工具根据数据文件确定站点的版本。 若要验证版本，请在 .cab 文件中查找使用站点版本命名的文本文件。

使用工具

服务连接工具位于 Configuration Manager 安装介质中，路径如下： SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe。 始终使用与所使用的 Configuration Manager 版本匹配的服务连接工具。 所有这些文件都必须位于同一文件夹中，服务连接工具才能正常工作。

将 ServiceConnectionTool 文件夹及其所有内容复制到具有 Internet 连接的计算机。

在此过程中，命令行示例使用以下文件名和文件夹位置。 无需使用这些路径和文件名。 可以使用与环境和首选项匹配的替代项。

  • 服务连接点上的 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. 该工具导出完使用情况数据后，将数据文件复制到有权访问 Internet 的计算机。

连接

  1. 在具有 Internet 访问权限的计算机上，以管理员身份打开命令提示符，并将目录更改为工具位置。 此位置是整个 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：在 “连接” 阶段，该工具将写入系统驱动器根目录中的此日志文件。 此日志文件提供了更详细的信息。 例如，该工具下载的文件，以及哈希检查是否成功。

命令行参数

本部分按字母顺序列出服务连接工具的所有可用参数。

-连接

在具有 Internet 访问的计算机上的 “连接” 阶段使用。 它连接到 Configuration Manager 云服务以上传数据文件并下载更新。

它需要以下参数：

  • -usagedatasrc：要上传的数据文件的位置
  • -updatepackdest：下载的更新的路径

还可以使用以下可选参数：

  • -proxyserveruri：代理服务器的 FQDN
  • -proxyusername：代理服务器的用户名
  • -downloadall：下载所有内容，包括更新和修补程序，无论你的站点版本如何。
  • -downloadhotfix：下载所有修补程序，无论站点的版本如何。
  • -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

-dest

具有 -export 参数的必需参数，用于指定要导出的 CSV 文件的路径和文件名。 有关详细信息，请参阅 -export。

-downloadall

带有 -connect 参数的可选参数，用于下载所有内容（包括更新和修补程序），无论站点的版本如何。 有关详细信息，请参阅 -connect。

-downloadhotfix

具有 -connect 参数的可选参数，用于仅下载所有修补程序（无论站点的版本如何）。 有关详细信息，请参阅 -connect。

-downloadsiteversion

具有 -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。 有关详细信息，请参阅 -connect。

-proxyusername

具有 -connect 参数的可选参数，用于指定要在代理服务器中进行身份验证的用户名。 有关详细信息，请参阅 -connect。

-updatepackdest

一个具有 -connect 参数的必需参数，用于指定下载的更新的路径。 有关详细信息，请参阅 -connect。

-updatepacksrc

一个具有 -import 参数的必需参数，用于指定下载的更新的路径。 有关详细信息，请参阅 -import。

-usagedatadest

一个具有 -prepare 参数的必需参数，用于指定导出数据文件的路径和文件名。 有关详细信息，请参阅 -prepare。

后续步骤

安装控制台内更新

如何查看诊断和使用情况数据