Compartir vía

Uso de la herramienta de conexión de servicio para Configuration Manager

  • Artículo

Se aplica a: Configuration Manager (rama actual)

Use la herramienta de conexión de servicio cuando el punto de conexión de servicio esté en modo sin conexión. También puede usarlo cuando los servidores del sistema de sitio de Configuration Manager no están conectados a Internet. La herramienta puede ayudarle a mantener el sitio actualizado con las actualizaciones más recientes de Configuration Manager.

Al ejecutar la herramienta, se conecta al servicio en la nube de Configuration Manager, carga información de uso de la jerarquía y descarga las actualizaciones. Es necesario cargar datos de uso para permitir que el servicio en la nube proporcione las actualizaciones correctas para su entorno.

Requisitos previos

  • El sitio tiene un punto de conexión de servicio y lo configura para una conexión sin conexión a petición.

  • Ejecute la herramienta desde un símbolo del sistema como administrador. No hay ninguna interfaz de usuario.

  • Ejecute la herramienta desde el punto de conexión de servicio y un equipo que pueda conectarse a Internet. Cada uno de estos equipos debe tener un sistema operativo de x64 bits y tener los siguientes componentes:

    • Los archivos x86 y x64 redistribuibles de Visual C++ . De forma predeterminada, Configuration Manager instala la versión x64 en el equipo que hospeda el punto de conexión de servicio. Esta herramienta requiere el paquete redistribuible de Microsoft Visual C++ 2015-2019 (14.28.29914.0) o posterior en el equipo desde el que se ejecuta. Para descargar este componente, consulte Descargas admitidas más recientes de Microsoft Visual C++ Redistributable.

      Nota:

      Si se actualiza desde una versión fuera de soporte técnico de Configuration Manager anterior a 2107, la herramienta requiere el paquete redistributalbe de Visual C++ 2013 (12.0.40660.0), que está disponible en el mismo vínculo.

    • Esta herramienta requiere la versión 4.6.2 de .NET y se recomienda la versión 4.8. Para obtener más información, consulte Requisitos previos del sitio y del sistema de sitio.

    • A partir de la versión 2309, esta herramienta requiere la instalación del controlador ODBC 18 para SQL Server (x64). Para descargar este componente, consulte Descarga del controlador ODBC para SQL Server.

  • La cuenta que usa para ejecutar la herramienta necesita los permisos siguientes:

    • Administrador local en el equipo que hospeda el punto de conexión de servicio

    • Permisos de lectura en la base de datos del sitio

  • Necesita un método para transferir los archivos entre el equipo con acceso a Internet y el punto de conexión de servicio. Por ejemplo, una unidad USB con espacio libre suficiente para almacenar los archivos y las actualizaciones.

Información general

  1. Preparar: ejecute la herramienta en el punto de conexión de servicio. Coloca los datos de uso en un archivo .cab en la ubicación especificada. Copie el archivo de datos en el equipo con una conexión a Internet.

  2. Conectar: ejecute la herramienta en el equipo con una conexión a Internet. Carga los datos de uso y, a continuación, descarga las actualizaciones de Configuration Manager. Copie las actualizaciones descargadas en el punto de conexión de servicio.

    Puede cargar varios archivos de datos a la vez, cada uno de una jerarquía diferente. También puede especificar un servidor proxy y un usuario para el servidor proxy.

  3. Importar: ejecute la herramienta en el punto de conexión de servicio. Importa las actualizaciones y las agrega al sitio. A continuación, puede ver e instalar esas actualizaciones en la consola de Configuration Manager.

Carga de varios archivos de datos

  • Coloque todos los archivos de datos exportados de jerarquías independientes en la misma carpeta. Asigne un nombre único a cada archivo. Si es necesario, puede cambiarles el nombre manualmente.

  • Al ejecutar la herramienta para cargar datos en Microsoft, se especifica la carpeta que contiene los archivos de datos.

  • Al ejecutar la herramienta para importar datos, la herramienta solo importa los datos de esa jerarquía.

Especificar un servidor proxy

Si el equipo con una conexión a Internet requiere un servidor proxy, la herramienta admite una configuración de proxy básica. Use los parámetros opcionales -proxyserveruri y -proxyusername. Para obtener más información, vea Parámetros de la línea de comandos.

Especificar el tipo de actualizaciones que se van a descargar

La herramienta admite opciones para controlar los archivos que descarga. De forma predeterminada, la herramienta descarga solo la última actualización disponible que se aplica a la versión de su sitio. No descarga revisiones.

Para modificar este comportamiento, use uno de los parámetros siguientes para cambiar los archivos que descarga:

  • -downloadall: descargue todas las actualizaciones, incluidas las actualizaciones y revisiones, sea cual sea la versión de su sitio.

  • -downloadhotfix: descargue todas las revisiones sea cual sea la versión de su sitio.

  • -downloadsiteversion: descarga actualizaciones y revisiones con una versión posterior a la versión del sitio.

    Importante

    Debido a un problema conocido en la versión 2002 de Configuration Manager, el comportamiento predeterminado no funciona según lo esperado. Actualice a la versión 2006 o use el parámetro -downloadsiteversion para descargar las actualizaciones necesarias para la versión 2002.

Para obtener más información, vea Parámetros de la línea de comandos.

Sugerencia

La herramienta determina la versión del sitio desde el archivo de datos. Para comprobar la versión, busque en el archivo .cab el archivo de texto denominado con la versión del sitio.

Uso de la herramienta

La herramienta de conexión de servicio está en el medio de instalación de Configuration Manager en la ruta de acceso siguiente: SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe. Use siempre la herramienta de conexión de servicio que coincida con la versión de Configuration Manager que use. Todos estos archivos deben estar en la misma carpeta para que funcione la herramienta de conexión de servicio.

Copie la carpeta ServiceConnectionTool con todo su contenido en el equipo con una conexión a Internet.

En este procedimiento, los ejemplos de línea de comandos usan los siguientes nombres de archivo y ubicaciones de carpeta. No es necesario usar estas rutas de acceso y nombres de archivo. Puede usar alternativas que coincidan con su entorno y preferencias.

  • Ruta de acceso a los archivos de origen del medio de instalación de Configuration Manager en el punto de conexión del servicio: C:\Source

  • Ruta de acceso a una unidad USB donde se almacenan los datos para transferirlos entre equipos: D:\USB\

  • Nombre del archivo de datos que se exporta desde el sitio: UsageData.cab

  • Nombre de la carpeta vacía donde la herramienta almacena las actualizaciones descargadas para Configuration Manager: UpdatePacks

Preparar

  1. En el equipo que hospeda el punto de conexión de servicio, abra un símbolo del sistema como administrador y cambie el directorio a la ubicación de la herramienta. Por ejemplo:

    cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\

  2. Ejecute el siguiente comando para preparar el archivo de datos:

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

    Nota:

    Si va a cargar archivos de datos de más de una jerarquía al mismo tiempo, asigne un nombre único a cada archivo de datos. Si es necesario, puede cambiar el nombre de los archivos más adelante.

    Los datos del archivo se basan en el nivel de datos de diagnóstico y uso que configure para el sitio. Para obtener más información, consulte Introducción a los datos de diagnóstico y uso. Puede usar la herramienta para exportar los datos a un archivo CSV para ver el contenido. Para obtener más información, vea -export.

  3. Una vez que la herramienta termine de exportar los datos de uso, copie el archivo de datos en un equipo que tenga acceso a Internet.

Conectar

  1. En el equipo con acceso a Internet, abra un símbolo del sistema como administrador y cambie el directorio a la ubicación de la herramienta. Esta ubicación es una copia de toda la carpeta ServiceConnectionTool . Por ejemplo:

    cd D:\USB\ServiceConnectionTool\

  2. Ejecute el siguiente comando para cargar el archivo de datos y descargar las actualizaciones de Configuration Manager:

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

    Para obtener más ejemplos, vea Parámetros de línea de comandos.

    Nota:

    Al ejecutar esta línea de comandos, es posible que vea el siguiente error:

    Excepción no controlada: System.UnauthorizedAccessException: se deniega el acceso a la ruta de acceso "C:\Users\jqpublic\AppData\Local\Temp\extractmanifestcab\95F8A562.sql".

    Puede omitir este error de forma segura. Cierre la ventana de error para continuar.

  3. Una vez que la herramienta termine de descargar las actualizaciones, cópielas en el punto de conexión de servicio.

Importar

  1. En el equipo que hospeda el punto de conexión de servicio, abra un símbolo del sistema como administrador y cambie el directorio a la ubicación de la herramienta. Por ejemplo:

    cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\

  2. Ejecute el siguiente comando para importar las actualizaciones:

    ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks

  3. Una vez completada la importación, cierre el símbolo del sistema. Solo importa las actualizaciones de la jerarquía aplicable.

  4. En la consola de Configuration Manager, vaya al área de trabajo Administración y seleccione el nodo Actualizaciones y mantenimiento . Las actualizaciones importadas ahora están disponibles para instalarse. Para obtener más información, consulte Instalación de actualizaciones en la consola.

Archivos de registro

  • ServiceConnectionTool.log: cada vez que se ejecuta la herramienta de conexión de servicio, se escribe en este archivo de registro. La ruta de acceso del archivo de registro siempre es la misma ubicación que la herramienta. Este archivo de registro proporciona detalles sencillos sobre el uso de la herramienta en función de los parámetros que use. Cada vez que se ejecuta la herramienta, la herramienta reemplaza cualquier archivo de registro existente.

  • ConfigMgrSetup.log: durante la fase de conexión , la herramienta escribe en este archivo de registro en la raíz de la unidad del sistema. Este archivo de registro proporciona información más detallada. Por ejemplo, qué archivos descarga la herramienta y si las comprobaciones hash se realizan correctamente.

Parámetros de línea de comandos

En esta sección se enumeran en orden alfabético todos los parámetros disponibles para la herramienta de conexión de servicio.

-conectar

Use durante la fase De conexión en el equipo con acceso a Internet. Se conecta al servicio en la nube de Configuration Manager para cargar el archivo de datos y descargar las actualizaciones.

Requiere los parámetros siguientes:

  • -usagedatasrc: ubicación del archivo de datos que se va a cargar
  • -updatepackdest: ruta de acceso para las actualizaciones descargadas

También puede usar los siguientes parámetros opcionales:

  • -proxyserveruri: el FQDN del servidor proxy
  • -proxyusername: un nombre de usuario para el servidor proxy
  • -downloadall: descargue todo, incluidas las actualizaciones y revisiones, sea cual sea la versión de su sitio.
  • -downloadhotfix: descargue todas las revisiones, sea cual sea la versión de su sitio.
  • -downloadsiteversion: descargue las actualizaciones y revisiones que tengan una versión posterior a la versión del sitio.

Ejemplo de conexión sin un servidor proxy

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

Ejemplo de conexión con un servidor proxy

ServiceConnectionTool.exe -connect -usagedatasrc D:\USB\Usagedata.cab -updatepackdest D:\USB\UpdatePacks -proxyserveruri itproxy.contoso.com -proxyusername jqpublic

Ejemplo de conexión para descargar solo las actualizaciones aplicables a la versión del sitio

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

-dest

Parámetro necesario con el parámetro -export para especificar la ruta de acceso y el nombre de archivo del archivo CSV que se va a exportar. Para obtener más información, vea -export.

-downloadall

Parámetro opcional con el parámetro -connect para descargar todo, incluidas las actualizaciones y revisiones, sea cual sea la versión del sitio. Para obtener más información, consulte -connect.

-downloadhotfix

Parámetro opcional con el parámetro -connect para descargar solo todas las revisiones, sea cual sea la versión del sitio. Para obtener más información, consulte -connect.

-downloadsiteversion

Parámetro opcional con el parámetro -connect para descargar solo actualizaciones y revisiones que tengan una versión posterior a la versión del sitio. Para obtener más información, consulte -connect.

-exportar

Use durante la fase de preparación para exportar datos de uso a un archivo CSV. Ejecútelo como administrador en el punto de conexión de servicio. Esta acción le permite revisar el contenido de los datos de uso antes de cargarlos en Microsoft. Requiere el parámetro -dest para especificar la ubicación del archivo CSV.

Ejemplo de exportación

-export -dest D:\USB\usagedata.csv

-importación

Use durante la fase de importación en el punto de conexión de servicio para importar las actualizaciones al sitio. Requiere el parámetro -updatepacksrc para especificar la ubicación de las actualizaciones descargadas.

Ejemplo de importación

ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks

-preparar

Use durante la fase de preparación en el punto de conexión de servicio para exportar datos de uso desde el sitio. Requiere el parámetro -usagedatadest para especificar la ubicación del archivo de datos exportado.

Ejemplo de preparación

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

-proxyserveruri

Parámetro opcional con el parámetro -connect para especificar el FQDN del servidor proxy. Para obtener más información, consulte -connect.

-proxyusername

Parámetro opcional con el parámetro -connect para especificar el nombre de usuario que se va a autenticar con el servidor proxy. Para obtener más información, consulte -connect.

-updatepackdest

Parámetro necesario con el parámetro -connect para especificar una ruta de acceso para las actualizaciones descargadas. Para obtener más información, consulte -connect.

-updatepacksrc

Parámetro necesario con el parámetro -import para especificar una ruta de acceso de las actualizaciones descargadas. Para obtener más información, vea -import.

-usagedatadest

Parámetro necesario con el parámetro -prepare para especificar una ruta de acceso y un nombre de archivo del archivo de datos exportado. Para obtener más información, vea -prepare.

Pasos siguientes

Instalar actualizaciones en la consola

Cómo ver los datos de diagnóstico y uso