Uso de la herramienta de conexión de servicio para System Center Configuration ManagerUse the Service Connection Tool for System Center Configuration Manager

Se aplica a: System Center Configuration Manager (ramificación actual)Applies to: System Center Configuration Manager (Current Branch)

Use la herramienta de conexión de servicio cuando el punto de conexión de servicio esté en modo sin conexión o cuando los servidores de sistema de sitio de Configuration Manager no estén conectados a Internet.Use the service connection tool when your service connection point is in offline mode, or when your Configuration Manager site system servers are not connected to the Internet. La herramienta puede ayudarle a mantener actualizado el sitio con las últimas actualizaciones de Configuration Manager.The tool can help you keep your site up-to-date with the latest updates to Configuration Manager.

Cuando se ejecuta, la herramienta se conecta manualmente al servicio en la nube de Configuration Manager para cargar información de uso de la jerarquía y descargar actualizaciones.When run, the tool manually connects to the Configuration Manager cloud service to upload usage information for your hierarchy, and to download updates. La carga de los datos de uso es necesaria para habilitar el servicio en la nube para proporcionar las actualizaciones correctas para su implementación.Uploading usage data is necessary to enable the cloud service to provide the correct updates for your deployment.

Requisitos previos para usar la herramienta de conexión de servicioPrerequisites for using the service connection tool

A continuación se indican los requisitos previos y los problemas conocidos.The following are prerequisites, and known issues.

Requisitos previos:Prerequisites:

  • Tener instalado un punto de conexión de servicio, que estará establecido en Sin conexión, conexión a petición.You have a service connection point installed, and it is set to Offline, on-demand connection.

  • La herramienta se debe ejecutar desde un símbolo del sistema.The tool must be run from a command prompt.

  • Cada equipo en el que se ejecuta la herramienta (el equipo de punto de conexión de servicio y el equipo que está conectado a Internet) debe ser un sistema de x64 bits y tener instalado lo siguiente:Each computer where the tool runs (the service connection point computer, and the computer that is connected to the internet) must be a x64 bit system and have the following installed:

    • Los archivos de x86 y x64 de Visual C++ Redistributable .Both the Visual C++ Redistributable x86 and x64 files. De forma predeterminada, Configuration Manager instala la versión x64 en el equipo que hospeda el punto de conexión de servicio.By default, Configuration Manager installs the x64 version on the computer that hosts the service connection point.

      Para descargar una copia de los archivos de Visual C++, visite Paquetes redistribuibles de Visual C++ para Visual Studio 2013 en el Centro de descarga de Microsoft.To download a copy of the Visual C++ files, visit Visual C++ Redistributable Packages for Visual Studio 2013 at the Microsoft Download Center.

    • .NET Framework 4.5.2 o una versión posterior..NET Framework 4.5.2 or later.

  • La cuenta que utilice para ejecutar la herramienta debe tener:The account you use to run the tool must have:

    • Permisos deadministrador local en el equipo que hospeda el punto de conexión de servicio (donde se ejecuta la herramienta).Local administrator permissions on the computer that hosts the service connection point (where the tool is run).
    • Permisos deLectura para la base de datos del sitio.Read permissions to the site database.
  • Necesitará una unidad USB con suficiente espacio libre para almacenar los archivos y las actualizaciones, u otro método para transferir archivos entre el equipo de punto de conexión de servicio y el equipo que tiene acceso a Internet.You will need a USB drive with sufficient free space to store the files and updates, or another method to transfer files between the service connection point computer, and the computer that has access to the Internet. (En este escenario se supone que su sitio y los equipos administrados no tienen una conexión directa a Internet).(This scenario assumes that your site and managed computers do not have a direct connection to the Internet.)

Uso de la herramienta de conexión de servicioUse the service connection tool

Encontrará la herramienta de conexión de servicio (serviceconnectiontool.exe) en los medios de instalación de Configuration Manager, en la carpeta %path%\smssetup\tools\ServiceConnectionTool.You can find the service connection tool (serviceconnectiontool.exe), in the Configuration Manager installation media in %path%\smssetup\tools\ServiceConnectionTool folder. Use siempre la herramienta de conexión de servicio que coincida con la versión de Configuration Manager que use.Always use the service connection tool that matches the version of Configuration Manager that you use.

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 otros alternativos en su lugar que coincidan con su entorno y preferencias):In this procedure, the command-line examples use the following file names and folder locations (you do not need to use these paths and file names and instead can use alternatives that match your environment and preferences):

  • La ruta de acceso a un Stick USB donde se almacenan los datos para la transferencia entre servidores: D:\USB\The path to a USB Stick where data is stored for transfer between servers: D:\USB\

  • El nombre del archivo .cab que contiene los datos exportados desde su sitio: UsageData.cabThe name of the .cab file that contains data exported from your site: UsageData.cab

  • El nombre de la carpeta vacía donde se almacenarán las actualizaciones descargadas de Configuration Manager para la transferencia entre servidores: UpdatePacksThe name of the empty folder where downloaded updates for Configuration Manager will be stored for transfer between servers: UpdatePacks

En el equipo que hospeda el punto de conexión de servicio:On the computer that hosts the service connection point:

  • Abra un símbolo del sistema con privilegios administrativos y, a continuación, cambie los directorios a la ubicación que contiene serviceconnectiontool.exe.Open a command prompt with administrative privileges, and then change directories to the location that contains serviceconnectiontool.exe.

    De forma predeterminada, encontrará esta herramienta en los medios de instalación de Configuration Manager, en la carpeta %path%\smssetup\tools\ServiceConnectionTool.By default, you can find this tool in the Configuration Manager installation media in %path%\smssetup\tools\ServiceConnectionTool folder. Todos los archivos en esta carpeta deben estar en la misma carpeta para que funcione la herramienta de conexión de servicio.All of the files in this folder must be in the same folder for the service connection tool to work.

Al ejecutar el comando siguiente, la herramienta prepara un archivo .cab que contiene la información de uso y la copia a una ubicación que especifique.When you run the following command, the tool prepares a .cab file that contains usage information and to copies it to a location you specify. Los datos del archivo .cab se basan en el nivel de datos de uso de diagnóstico que recopilará el sitio de acuerdo con su configuración.The data in the .cab file is based on the level of diagnostic usage data your site is configured to collect. (consulte Diagnostics and usage data for System Center Configuration Manager [Diagnósticos y datos de uso para System Center Configuration Manager]).(see Diagnostics and usage data for System Center Configuration Manager). Ejecute el siguiente comando para crear el archivo .cab:Run the following command to create the .cab file:

  • serviceconnectiontool.exe -prepare -usagedatadest D:\USB\UsageData.cabserviceconnectiontool.exe -prepare -usagedatadest D:\USB\UsageData.cab

También necesitará copiar la carpeta ServiceConnectionTool con todo su contenido en la unidad USB o, de lo contrario, habilitarla en el equipo que utilizará para los pasos 3 y 4.You will also need to copy the ServiceConnectionTool folder with all of its contents to the USB drive, or otherwise make it available on the computer you will use for steps 3 and 4.

Información generalOverview

Hay tres pasos principales para usar la herramienta de conexión de servicioThere are three primary steps to using the service connection tool

  1. Preparar: este paso se ejecuta en el equipo que hospeda el punto de conexión de servicio.Prepare: This step runs on the computer that hosts the service connection point. Cuando la herramienta se ejecuta, coloca los datos de uso en un archivo .cab y lo almacena en una unidad USB (o la ubicación alternativa de transferencia que especifique).When the tool is run it puts your usage data into a .cab file and stores it on a USB drive (or alternate transfer location you specify).

  2. Conectar: para este paso, debe ejecutar la herramienta en un equipo remoto que se conecte a Internet para poder cargar datos de uso y descargar actualizaciones.Connect: For this step you run the tool on a remote computer that connects to the Internet so you can upload your usage data and then download updates.

  3. Importar: este paso se ejecuta en el equipo que hospeda el punto de conexión de servicio.Import: This step runs on the computer that hosts the service connection point. Cuando se ejecuta, la herramienta importa las actualizaciones descargadas y las agrega al sitio para que pueda verlas e instalarlas desde la consola de Configuration Manager.When run, the tool imports the updates you downloaded and adds them to your site so you can then view and install those updates from the Configuration Manager console.

A partir de la versión 1606, al conectarse a Microsoft puede cargar varios archivos .cab a la vez (cada uno desde una jerarquía distinta) y especificar un servidor proxy y un usuario para el servidor proxy.Beginning with version 1606, when connecting to Microsoft you can upload multiple .cab files at one time (each from a different hierarchy), and specify a proxy server and a user for the proxy server.

Para cargar varios archivos .cabTo upload multiple .cab files

  • Coloque cada archivo .cab que exporte de jerarquías independientes en la misma carpeta.Place each .cab file you export from separate hierarchies into the same folder. El nombre de cada archivo debe ser único y puede cambiarlo manualmente si lo precisa.The name of each file must be unique, and you can manually rename them if necessary.
  • Después, al ejecutar el comando para cargar datos a Microsoft, especifique la carpeta que contiene los archivos .cab.Then, when you run the command to upload data to Microsoft, you specify the folder that contains the .cab files. (Antes de la actualización 1606, solo puede cargar datos desde una única jerarquía a la vez y la herramienta requerirá que especifique el nombre del archivo .cab en la carpeta).(Prior to update 1606, you could only upload data from a single hierarchy at a time, and the tool required you to specify the name of the .cab file in the folder.)
  • Más adelante, cuando ejecute la tarea de importación en el punto de conexión de servicio de una jerarquía, la herramienta importa automáticamente solo los datos de esa jerarquía.Later, when you run the import task on the service connection point of a hierarchy, the tool automatically imports only the data for that hierarchy.

Para especificar un servidor proxyTo specify a proxy server

Puede utilizar los siguientes parámetros opcionales para especificar un servidor proxy (para más información acerca del uso de estos parámetros, consulte la sección de parámetros de línea de comandos de este tema):You can use the following optional parameters to specify a proxy server (More information about using these parameters is available in the Command line parameters section of this topic):

  • -proxyserveruri [FQDN_of_proxy_server] Utilice este parámetro para especificar el servidor proxy para esta conexión.-proxyserveruri [FQDN_of_proxy_server] Use this parameter to specify the proxy server to use for this connection.
  • -proxyusername [nombreDeUsuario] Utilice este parámetro cuando deba especificar un usuario para el servidor proxy.-proxyusername [username] Use this parameter when you must specify a user for the proxy server.

Especificar el tipo de actualizaciones que quiere descargarSpecify the type of updates to download

A partir de la versión 1706, se ha modificado el comportamiento de descarga de herramientas predeterminado, así como las opciones de compatibilidad con herramientas para controlar los archivos descargados.Beginning with version 1706, the tools default download behavior has changed, and the tool supports options to control what files you download.

  • De forma predeterminada, la herramienta descarga únicamente la última actualización disponible que sea válida para la versión de su sitio.By default, the tool downloads only the latest available update that applies to the version of your site. No descarga ninguna revisión.It does not download hotfixes.

Para modificar este comportamiento, use uno de los parámetros siguientes para cambiar qué archivos se descargarán.To modify this behavior, use one of the following parameters to change what files are downloaded.

Nota

La versión de su sitio se determina a partir de los datos del archivo .cab que se carga al ejecutar la herramienta.The version of your site is determined from the data in the .cab file that is uploaded when the tool runs.

Puede comprobar la versión buscando el archivo SiteVersion.txt dentro del archivo. cab.You can verify the version by looking for the SiteVersion.txt file within the .cab file.

  • -downloadall: esta opción descarga todo, incluidas las actualizaciones y las revisiones, independientemente de la versión de su sitio.-downloadall This option downloads everything, including updates and hotfixes, regardless of the version of your site.
  • -downloadhotfix: esta opción descarga todas las revisiones independientemente de la versión de su sitio.-downloadhotfix This option downloads all hotfixes regardless of the version of your site.
  • -downloadsiteversion: esta opción descarga todas las actualizaciones y revisiones con una versión posterior a la de su sitio.-downloadsiteversion This option downloads updates and hotfixes that have a version that is higher than the version of your site.

Ejemplo de una línea de comandos que usa -downloadsiteversion:Example command line that uses -downloadsiteversion:

  • serviceconnectiontool.exe -connect -downloadsiteversion -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacksserviceconnectiontool.exe -connect -downloadsiteversion -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks

Para usar la herramienta de conexión de servicioTo use the service connection tool

  1. En el equipo que hospeda el punto de conexión de servicio:On the computer that hosts the service connection point:

    • Abra un símbolo del sistema con privilegios administrativos y, a continuación, cambie los directorios a la ubicación que contiene serviceconnectiontool.exe.Open a command prompt with administrative privileges, and then change directories to the location that contains serviceconnectiontool.exe.
  2. Ejecute el comando siguiente para que la herramienta prepare un archivo .cab que contiene la información de uso y la copia a una ubicación que especifique:Run the following command to have the tool prepare a .cab file that contains usage information and to copy it to a location you specify:

    • serviceconnectiontool.exe -prepare -usagedatadest D:\USB\UsageData.cabserviceconnectiontool.exe -prepare -usagedatadest D:\USB\UsageData.cab

    Si va a cargar los archivos .cab de más de una jerarquía al mismo tiempo, cada archivo .cab de la carpeta debe tener un nombre único.If you will upload .cab files from more than one hierarchy at the same time, each .cab file in the folder must have a unique name. Puede cambiar manualmente el nombre de los archivos que agregue a la carpeta.You can manually rename files that you add to the folder.

    Si desea ver la información de uso que se recopila para cargarse en el servicio en la nube de Configuration Manager, ejecute el siguiente comando para exportar los mismos datos como un archivo .csv que puede ver con una aplicación como Excel:If you want to view the usage information that is gathered to be uploaded to the Configuration Manager cloud service, run the following command to export the same data as a .csv file which you can then view using an application like Excel:

    • serviceconnectiontool.exe -export -dest D:\USB\UsageData.csvserviceconnectiontool.exe -export -dest D:\USB\UsageData.csv
  3. Una vez completado el paso de preparación, mueva la unidad USB (o transfiera los datos exportados mediante otro método) a un equipo que tenga acceso a Internet.After the prepare step is complete, move the USB drive (or transfer the exported data by another method) to a computer that has access to the Internet.

  4. En el equipo con acceso a Internet, abra un símbolo del sistema con privilegios administrativos y, a continuación, cambie los directorios a la ubicación que contiene una copia de la herramienta serviceconnectiontool.exe y los archivos adicionales de esa carpeta.On the computer with Internet access, open a command prompt with administrative privileges, and then change directories to the location that contains a copy of the tool serviceconnectiontool.exe and the additional files from that folder.

  5. Ejecute el siguiente comando para iniciar la carga de información de uso y la descarga de actualizaciones de Configuration Manager:Run the following command to begin the upload of usage information and the download of updates for Configuration Manager:

    • serviceconnectiontool.exe -connect -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacksserviceconnectiontool.exe -connect -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks

    Para obtener más ejemplos de esta línea de comandos, consulte la sección Opciones de línea de comandos más adelante en este tema.For more examples of this command line, see the Command line options section later in this topic.

    Nota

    Cuando se ejecuta la línea de comandos para conectar con el servicio en la nube de Configuration Manager, podría producirse un error similar al siguiente:When you run the command line to connect to the Configuration Manager cloud service, an error similar to the following might occur:

    • Excepción no controlada: System.UnauthorizedAccessException:Unhandled Exception: System.UnauthorizedAccessException:

      El acceso a la ruta de acceso 'C:Access to the path 'C:\
      Users\br\AppData\Local\Temp\extractmanifestcab\95F8A562.sql' se ha denegado.Users\br\AppData\Local\Temp\extractmanifestcab\95F8A562.sql' is denied.

    Este error puede omitirse sin problemas, puede cerrar la ventana de error y continuar.This error can be safely ignored and you can close the error window, and continue.

  6. Cuando se complete la descarga de actualizaciones para Configuration Manager, mueva la unidad USB (o transfiera los datos exportados mediante otro método) al equipo que hospeda el punto de conexión de servicio.After the download of updates for Configuration Manager is complete, move the USB drive (or transfer the exported data by another method) to the computer that hosts the service connection point.

  7. En el equipo que hospeda el punto de conexión de servicio, abra un símbolo del sistema con privilegios administrativos, cambie los directorios a la ubicación que contiene serviceconnectiontool.exey, a continuación, ejecute el siguiente comando:On the computer that hosts the service connection point, open a command prompt with administrative privileges, change directories to the location that contains serviceconnectiontool.exe, and then run the following command:

    • serviceconnectiontool.exe -import -updatepacksrc D:\USB\UpdatePacksserviceconnectiontool.exe -import -updatepacksrc D:\USB\UpdatePacks
  8. Una vez finalizada la importación, puede cerrar el símbolo del sistema.After the import completes, you can close the command prompt. (Solo se importan las actualizaciones para la jerarquía aplicable).(Only updates for the applicable hierarchy are imported).

  9. Abra la consola de Configuration Manager y vaya a Administración > Actualizaciones y mantenimiento.Open the Configuration Manager console and navigate to Administration > Updates and Servicing. Ahora están disponibles para instalar las actualizaciones que se han importado.Updates that were imported are now available to install. (Antes de la versión 1702, la opción Actualizaciones y mantenimiento se encontraba en Administración > Cloud Services).(Prior to version 1702, Updates and Servicing was under Administration > Cloud Services.)

    Para obtener más información sobre la instalación de actualizaciones, consulte Install in-console updates for System Center Configuration Manager (Instalación de actualizaciones en la consola para System Center Configuration Manager).For information about installing updates, see Install in-console updates for System Center Configuration Manager.

Archivos de registroLog Files

ServiceConnectionTool.logServiceConnectionTool.log

Cada vez que se ejecute la herramienta de conexión de servicio, se generará un archivo de registro en la misma ubicación que la herramienta denominada ServiceConnectionTool.log.Each time you run the service connection tool, a log file will generate in the same location as the tool called ServiceConnectionTool.log. Este archivo de registro proporcionará detalles simples sobre la ejecución de la herramienta en función de qué comandos se usan.This log file will provide simple details about the execution of the tool based on what commands are used. Un archivo de registro existente se sustituirá cada vez que ejecute la herramienta.An existing log file will be replaced each time you run the tool.

ConfigMgrSetup.logConfigMgrSetup.log

Al utilizar la herramienta para conectarse y descargar actualizaciones, se generará un archivo de registro en la raíz de la unidad del sistema denominado ConfigMgrSetup.log.When using the tool to connect and download updates, a log file will generate on the root of the system drive called ConfigMgrSetup.log. Este archivo de registro le proporcionará información más detallada, como qué archivos se descargan y extraen, y si las comprobaciones del hash se realizan correctamente.This log file will provide you with more detailed information such as what files are downloaded, extracted, and if the hash checks are successful.

opciones de línea de comandosCommand line options

Para ver la información de ayuda para la herramienta de punto de conexión de servicio, abra el símbolo del sistema para la carpeta que contiene la herramienta y ejecute el comando: serviceconnectiontool.exe.To view help information for the service connection point tool, open command prompt to the folder that contains the tool and run the command: serviceconnectiontool.exe.

Opciones de línea de comandosCommand-line options DetallesDetails
-prepare -usagedatadest [unidad:][ruta][nombrearchivo.cab]-prepare -usagedatadest [drive:][path][filename.cab] Este comando almacena los datos de uso actuales en un archivo .cab.This command stores current usage data in a .cab file.

Ejecute este comando como administrador local en el servidor que hospeda el punto de conexión de servicio.Run this command as a local administrator on the server that hosts the service connection point.

Ejemplo: -prepare -usagedatadest D:\USB\Usagedata.cabExample: -prepare -usagedatadest D:\USB\Usagedata.cab
-connect -usagedatasrc [unidad:][rutaAcceso] -updatepackdest [unidad:][rutaAcceso] -proxyserveruri [nombreCompletoServidorProxy] -proxyusername [nombreUsuario]-connect -usagedatasrc [drive:][path] -updatepackdest [drive:][path] -proxyserveruri [FQDN of proxy server] -proxyusername [username]

Si utiliza una versión de Configuration Manager anterior a 1606, debe especificar el nombre del archivo .cab y no podrá utilizar las opciones de un servidor proxy.If you use a version of Configuration Manager prior to 1606, you must specify the name of the .cab file, and cannot use the options for a proxy server. Los parámetros de comando admitidos son los siguientes:The supported command parameters are:
connect -usagedatasrc [unidad:][rutaAcceso][nombreDeArchivo] -updatepackdest [unidad:][rutaAcceso]-connect -usagedatasrc [drive:][path][filename] -updatepackdest [drive:][path]
Este comando se conecta al servicio en la nube de Configuration Manager para cargar los archivos .cab de datos de uso desde la ubicación especificada y descargar los paquetes de actualización disponibles y el contenido de la consola.This command connects to the Configuration Manager cloud service to Upload the usage data .cab files from the specified location, and to download available update packs and console content. Las opciones para los servidores proxy son opcionales.The options for proxy servers are optional.

Ejecute este comando como administrador local en un equipo que pueda conectarse a Internet.Run this command as a local administrator on a computer that can connect to the Internet.

Ejemplo de la conexión sin un servidor proxy: -connect -usagedatasrc D:\USB\ -updatepackdest D:\USB\UpdatePacksExample for connecting without a proxy server: -connect -usagedatasrc D:\USB\ -updatepackdest D:\USB\UpdatePacks

Ejemplo para la conexión cuando se utiliza un servidor proxy: -connect -usagedatasrc D:\USB\Usagedata.cab -updatepackdest D:\USB\UpdatePacks -proxyserveruri itgproxy.redmond.corp.microsoft.com -proxyusername MegExample for connecting when you use a proxy server: -connect -usagedatasrc D:\USB\Usagedata.cab -updatepackdest D:\USB\UpdatePacks -proxyserveruri itgproxy.redmond.corp.microsoft.com -proxyusername Meg

Si utiliza una versión anterior a 1606, debe especificar un nombre de archivo para el archivo .cab y no se puede especificar un servidor proxy.If you use a version prior to 1606, you must specify a file name for the .cab file, and you cannot specify a proxy server. Use la siguiente línea de comandos de ejemplo: -connect -usagedatasrc D:\USB\Usagedata.cab -updatepackdest D:\USB\UpdatePacksUse the following example command line: -connect -usagedatasrc D:\USB\Usagedata.cab -updatepackdest D:\USB\UpdatePacks
-import -updatepacksrc [unidad:][ruta]-import -updatepacksrc [drive:][path] Este comando importa los paquetes de actualización y el contenido de la consola que ha descargado anteriormente a la consola de Configuration Manager.This command imports the update packs and console content you previously downloaded into your Configuration Manager console.

Ejecute este comando como administrador local en el servidor que hospeda el punto de conexión de servicio.Run this command as a local administrator on the server that hosts the service connection point.

Ejemplo: -import -updatepacksrc D:\USB\UpdatePacksExample: -import -updatepacksrc D:\USB\UpdatePacks
-export -dest [unidad:][ruta][nombrearchivo.csv]-export -dest [drive:][path][filename.csv] Este comando exporta los datos de uso a un archivo .csv, que puede ver.This command exports usage data to a .csv file, which you can then view.

Ejecute este comando como administrador local en el servidor que hospeda el punto de conexión de servicio.Run this command as a local administrator on the server that hosts the service connection point.

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