Utilize a Ferramenta de Ligação de Serviço no System Center Configuration ManagerUse the Service Connection Tool for System Center Configuration Manager

Aplica-se a: O System Center Configuration Manager (ramo atual)Applies to: System Center Configuration Manager (Current Branch)

Utilize o ferramenta de ligação de serviço quando o ponto de ligação de serviço está no modo offline, ou quando os servidores de sistema de sites do Configuration Manager não estiverem ligados à 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. A ferramenta pode ajudar a manter o site atualizados com as atualizações mais recentes do Configuration Manager.The tool can help you keep your site up-to-date with the latest updates to Configuration Manager.

Quando executada, a ferramenta manualmente estabelece ligação ao serviço de nuvem do Configuration Manager para carregar as informações de utilização para a sua hierarquia e para transferir as atualizações.When run, the tool manually connects to the Configuration Manager cloud service to upload usage information for your hierarchy, and to download updates. O carregamento dos dados de utilização é necessário para permitir ao serviço em nuvem fornecer as atualizações corretas para a sua implementação.Uploading usage data is necessary to enable the cloud service to provide the correct updates for your deployment.

Pré-requisitos para utilizar a ferramenta de ligação de serviçoPrerequisites for using the service connection tool

Seguem-se os pré-requisitos e problemas conhecidos.The following are prerequisites, and known issues.

Pré-requisitos:Prerequisites:

  • Ter um ponto de ligação de serviço instalado e definido como Offline, ligação a pedido.You have a service connection point installed, and it is set to Offline, on-demand connection.

  • A ferramenta tem de ser executada a partir de uma linha de comandos.The tool must be run from a command prompt.

  • Cada computador onde a ferramenta é executada (o computador do ponto de ligação de serviço e o computador que está ligado à Internet) tem de ser um sistema de x64 bits e tem de ter os seguintes elementos instalados: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:

    • Os ficheiros do Visual C++ Redistributable , tanto x86 como x64.Both the Visual C++ Redistributable x86 and x64 files. Por predefinição, o Configuration Manager instala o x64 versão no computador que aloja o ponto de ligação de serviço.By default, Configuration Manager installs the x64 version on the computer that hosts the service connection point.

      Para transferir uma cópia dos ficheiros do Visual C++, visite a página Visual C++ Redistributable Packages for Visual Studio 2013 no Centro de Transferências da 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 ou posterior..NET Framework 4.5.2 or later.

  • A conta que utiliza para executar a ferramenta tem de ter:The account you use to run the tool must have:

    • Permissões deadministrador local no computador que aloja o ponto de ligação de serviço (onde a ferramenta é executada).Local administrator permissions on the computer that hosts the service connection point (where the tool is run).
    • Permissões deLeitura para a base de dados do site.Read permissions to the site database.
  • É necessário uma pen USB com espaço livre suficiente para armazenar ficheiros e atualizações ou outro método para transferir ficheiros entre o computador do ponto de ligação de serviço e o computador que tem acesso à 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. (Este cenário pressupõe que o site e os computadores geridos não têm uma ligação direta à Internet).(This scenario assumes that your site and managed computers do not have a direct connection to the Internet.)

Utilizar a ferramenta de ligação de serviçosUse the service connection tool

Pode encontrar a ferramenta de ligação de serviço (serviceconnectiontool.exe), no suporte de instalação do Configuration Manager no %path%\smssetup\tools\ServiceConnectionTool pasta.You can find the service connection tool (serviceconnectiontool.exe), in the Configuration Manager installation media in %path%\smssetup\tools\ServiceConnectionTool folder. Utilize sempre a ferramenta de ligação de serviço que corresponde à versão do Configuration Manager que utilizar.Always use the service connection tool that matches the version of Configuration Manager that you use.

Neste procedimento, os exemplos da linha de comandos utilizam os seguintes nomes de ficheiros e localizações de pastas (não é necessário utilizar estes caminhos e nomes de ficheiros e, em vez disso, pode utilizar alternativas que correspondam ao seu ambiente e preferências):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):

  • O caminho para uma pen USB onde os dados são armazenados para transferência entre servidores: D:\USB\The path to a USB Stick where data is stored for transfer between servers: D:\USB\

  • O nome do ficheiro. cab que contém dados exportados a partir do seu site: UsageData.cabThe name of the .cab file that contains data exported from your site: UsageData.cab

  • O nome da pasta vazia onde serão armazenadas as atualizações para o Configuration Manager para transferência entre servidores: UpdatePacksThe name of the empty folder where downloaded updates for Configuration Manager will be stored for transfer between servers: UpdatePacks

No computador que aloja o ponto de ligação de serviço:On the computer that hosts the service connection point:

  • Abra uma linha de comandos com privilégios administrativos e, em seguida, mude de diretório para a localização que contém serviceconnectiontool.exe.Open a command prompt with administrative privileges, and then change directories to the location that contains serviceconnectiontool.exe.

    Por predefinição, pode encontrar esta ferramenta no suporte de instalação do Configuration Manager no %path%\smssetup\tools\ServiceConnectionTool pasta.By default, you can find this tool in the Configuration Manager installation media in %path%\smssetup\tools\ServiceConnectionTool folder. Todos os ficheiros nesta pasta têm de estar na mesma pasta para que a ferramenta de ligação de serviço funcione.All of the files in this folder must be in the same folder for the service connection tool to work.

Ao executar o seguinte comando, a ferramenta prepara um ficheiro. cab que contém informações de utilização e copia-as para a localização que especificar.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. Os dados no ficheiro. cab baseiam-se no nível de dados de utilização de diagnóstico que o seu site estiver configurado para recolher.The data in the .cab file is based on the level of diagnostic usage data your site is configured to collect. (veja Dados de diagnóstico e de utilização para o System Center Configuration Manager).(see Diagnostics and usage data for System Center Configuration Manager). Execute o seguinte comando para criar o ficheiro. 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

Também terá da copiar a pasta ServiceConnectionTool com todo o conteúdo para a unidade USB ou pode disponibilizá-la no computador que irá utilizar para os passos 3 e 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.

Descrição GeralOverview

Existem três passos principais para utilizar a ferramenta de ligação de serviçoThere are three primary steps to using the service connection tool

  1. Preparar: Este passo é executado no computador que aloja o ponto de ligação de serviço.Prepare: This step runs on the computer that hosts the service connection point. Quando a ferramenta é executada coloca os dados de utilização num ficheiro. cab e armazena-a numa unidade USB (ou localização de transferência alternativa que especificar).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. Ligar: Para este passo, execute a ferramenta num computador remoto que liga à Internet para que possa carregar os dados de utilização e, em seguida, transferir as atualizações.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 passo é executado no computador que aloja o ponto de ligação de serviço.Import: This step runs on the computer that hosts the service connection point. Quando executada, a ferramenta importa que transferiu e adiciona-os para o seu site para que possa ver e instalar essas atualizações a partir da consola do Configuration Manager.When run, the tool imports the you downloaded and adds them to your site so you can then view and install those updates from the Configuration Manager console.

A partir da versão 1606, quando ligar à Microsoft, pode carregar vários ficheiros .cab ao mesmo tempo (cada um deles a partir de uma hierarquia diferente) e especificar um servidor proxy e um utilizador para o 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 carregar ficheiros. cab de váriosTo upload multiple .cab files

  • Coloque cada ficheiro .cab que exportar de hierarquias separadas na mesma pasta.Place each .cab file you export from separate hierarchies into the same folder. O nome de cada ficheiro tem de ser exclusivo e pode mudar o nomes do mesmo manualmente, se necessário.The name of each file must be unique, and you can manually rename them if necessary.
  • Em seguida, ao executar o comando para carregar dados para a Microsoft, especifique a pasta que contém os ficheiros .cab.Then, when you run the command to upload data to Microsoft, you specify the folder that contains the .cab files. (Antes da atualização 1606, só podia carregar dados de uma única hierarquia de cada vez e a ferramenta necessários para especificar o nome do ficheiro .cab na pasta.)(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.)
  • Mais tarde, quando executar a tarefa de importação no ponto de ligação de serviço de uma hierarquia, a ferramenta só importa automaticamente os dados para essa hierarquia.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 um servidor proxyTo specify a proxy server

Pode utilizar os seguintes parâmetros opcionais para especificar um servidor proxy (mais informações sobre como utilizar estes parâmetros estão disponíveis na secção Parâmetros de linha de comandos deste tópico):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_sever] Utilize este parâmetro para especificar o servidor proxy a utilizar para esta ligação.-proxyserveruri [FQDN_of_proxy_sever] Use this parameter to specify the proxy server to use for this connection.
  • -proxyusername [username] Utilize este parâmetro quando tiver de especificar um utilizador para o servidor proxy.-proxyusername [username] Use this parameter when you must specify a user for the proxy server.

Especifique o tipo de atualizações a transferirSpecify the type of updates to download

A partir da versão 1706, foi alterado o comportamento de transferência da predefinição de ferramentas e a ferramenta suporta opções para controlar os ficheiros que transfere.Beginning with version 1706, the tools default download behavior has changed, and the tool supports options to control what files you download.

  • Por predefinição, a ferramenta transfere apenas a atualização mais recente disponível que se aplica à versão do seu site.By default, the tool downloads only the latest available update that applies to the version of your site. Não transfere as correções.It does not download hotfixes.

Para modificar este comportamento, utilize um dos parâmetros seguintes para alterar a que os ficheiros são transferidos.To modify this behavior, use one of the following parameters to change what files are downloaded. A versão do seu site é determinada a partir dos dados no ficheiro. cab que é carregado quando a ferramenta é executada.The version of your site is determined from the data in the .cab file that is uploaded when the tool runs.

  • -downloadall esta opção transfere tudo, incluindo atualizações e correções, independentemente da versão do seu site.-downloadall This option downloads everything, including updates and hotfixes, regardless of the version of your site.
  • -downloadhotfix esta opção transfere todas as correções, independentemente da versão do seu site.-downloadhotfix This option downloads all hotfixes regardless of the version of your site.
  • -downloadsiteversion esta opção transfere atualizações e correções que tenham uma versão superior à versão do seu site.-downloadsiteversion This option downloads updates and hotfixes that have a version that is higher than the version of your site.

Linha de comandos de exemplo que utiliza - downloadsiteversion:Example command line that uses -downloadsiteversion:

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

Para utilizar a ferramenta de ligação de serviçoTo use the service connection tool

  1. No computador que aloja o ponto de ligação de serviço:On the computer that hosts the service connection point:

    • Abra uma linha de comandos com privilégios administrativos e, em seguida, mude de diretório para a localização que contém serviceconnectiontool.exe.Open a command prompt with administrative privileges, and then change directories to the location that contains serviceconnectiontool.exe.
  2. Execute o seguinte comando para que a ferramenta prepare um ficheiro .cab que contém informações de utilização e o copie para a localização que especificar: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

    Se for carregar ficheiros .cab a partir de mais do que uma hierarquia em simultâneo, cada ficheiro .cab na pasta tem de ter um nome exclusivo.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. Pode mudar o nome dos ficheiros que adicionar à pasta manualmente.You can manually rename files that you add to the folder.

    Se pretender ver as informações de utilização recolhidas para serem carregadas para o serviço em nuvem do Configuration Manager, execute o comando seguinte para exportar os mesmos dados como um ficheiro .csv que pode ver, em seguida, com uma aplicação como o 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. Quando o passo de preparação estiver concluído, coloque a pen USB (ou transfira os dados exportados através de outro método) num computador que tenha acesso à 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. No computador com acesso à Internet, abra uma linha de comandos com privilégios administrativos e, em seguida, mude de diretório para a localização que contém uma cópia da ferramenta serviceconnectiontool.exe e os ficheiros adicionais dessa pasta.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. Execute o seguinte comando para iniciar o carregamento de informações de utilização e a transferência de atualizações para o 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 obter mais exemplos desta linha de comandos, veja a secção Opções de linha de comandos mais à frente neste tópico.For more examples of this command line, see the Command line options section later in this topic.

    Nota

    Quando executa a linha de comandos para ligar ao serviço em nuvem do Configuration Manager, poderá ocorrer um erro semelhante ao seguinte:When you run the command line to connect to the Configuration Manager cloud service, an error similar to the following might occur:

    • Exceção não processada: System. unauthorizedaccessexception:Unhandled Exception: System.UnauthorizedAccessException:

      O acesso ao caminho "C:\Access to the path 'C:\
      Users\br\AppData\Local\Temp\extractmanifestcab\95F8A562.sql" foi negado.Users\br\AppData\Local\Temp\extractmanifestcab\95F8A562.sql' is denied.

    Este erro pode ser ignorado com segurança e pode fechar a janela de erro e continuar.This error can be safely ignored and you can close the error window, and continue.

  6. Após a conclusão da transferência das atualizações para o Configuration Manager, coloque a unidade USB (ou transfira os dados exportados através de outro método) no computador que aloja o ponto de ligação de serviço.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. No computador que aloja o ponto de ligação de serviço, abra uma linha de comandos com privilégios administrativos, mude de diretório para a localização que contém serviceconnectiontool.exee execute o seguinte 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. Quando a importação estiver concluída, pode fechar a linha de comandos.After the import completes, you can close the command prompt. (Apenas são importadas atualizações para a hierarquia aplicável).(Only updates for the applicable hierarchy are imported).

  9. Abra a consola do Configuration Manager e navegue para administração > atualizações e manutenção.Open the Configuration Manager console and navigate to Administration > Updates and Servicing. As atualizações que foram importadas estão agora disponíveis para instalação.Updates that were imported are now available to install. (Antes da versão 1702, atualizações e manutenção estava administração > serviços em nuvem.)(Prior to version 1702, Updates and Servicing was under Administration > Cloud Services.)

    Para obter informações sobre como instalar atualizações, veja Instalar atualizações na consola para o System Center Configuration Manager.For information about installing updates, see Install in-console updates for System Center Configuration Manager.

Opções de linha de comandosCommand line options

Para ver informações de ajuda relativas à ferramenta de ponto de ligação de serviço, abra a linha de comandos para a pasta que contém a ferramenta e execute o 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.

Opções da linha de comandosCommand-line options DetalhesDetails
-prepare -usagedatadest [drive:][path][filename.cab]-prepare -usagedatadest [drive:][path][filename.cab] Este comando armazena os dados de utilização atuais num ficheiro .cab.This command stores current usage data in a .cab file.

Execute este comando como Administrador local no servidor que aloja o ponto de ligação de serviço.Run this command as a local administrator on the server that hosts the service connection point.

Exemplo: -prepare -usagedatadest D:\USB\Usagedata.cabExample: -prepare -usagedatadest D:\USB\Usagedata.cab
-connect -usagedatasrc [unidade:][caminho] -updatepackdest [unidade:][caminho] -proxyserveruri [FQDN do servidor proxy] -proxyusername [nome de utilizador]-connect -usagedatasrc [drive:][path] -updatepackdest [drive:][path] -proxyserveruri [FQDN of proxy server] -proxyusername [username]

Se utilizar uma versão do Configuration Manager anterior à versão 1606, tem de especificar o nome do ficheiro .cab e não pode utilizar as opções para um 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. Os parâmetros de comando suportados são:The supported command parameters are:
-connect -usagedatasrc [unidade:][caminho][nome do ficheiro] -updatepackdest [unidade:][caminho]-connect -usagedatasrc [drive:][path][filename] -updatepackdest [drive:][path]
Este comando liga ao serviço em nuvem do Configuration Manager para carregar os ficheiros .cab de dados de utilização a partir da localização especificada e para transferir os pacotes de atualização disponíveis e conteúdo da 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. As opções para servidores proxy são opcionais.The options for proxy servers are optional.

Execute este comando como administrador local num computador que possa ser ligado à Internet.Run this command as a local administrator on a computer that can connect to the Internet.

Exemplo de ligação sem um servidor proxy: -connect -usagedatasrc D:\USB\ -updatepackdest D:\USB\UpdatePacksExample for connecting without a proxy server: -connect -usagedatasrc D:\USB\ -updatepackdest D:\USB\UpdatePacks

Exemplo de ligação ao utilizar um 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

Se utilizar uma versão anterior à versão 1606, tem de especificar um nome de ficheiro para o ficheiro .cab e não pode especificar um 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. Utilize a seguinte linha de comandos de exemplo: -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 [drive:][path]-import -updatepacksrc [drive:][path] Este comando importa os pacotes de atualizações e o conteúdo da consola que transferiu anteriormente para a consola do Configuration Manager.This command imports the update packs and console content you previously downloaded into your Configuration Manager console.

Execute este comando como Administrador local no servidor que aloja o ponto de ligação de serviço.Run this command as a local administrator on the server that hosts the service connection point.

Exemplo: -import -updatepacksrc D:\USB\UpdatePacksExample: -import -updatepacksrc D:\USB\UpdatePacks
-export -dest [drive:][path][filename.csv]-export -dest [drive:][path][filename.csv] Este comando exporta dados de utilização para um ficheiro .csv, que poderá ver em seguida.This command exports usage data to a .csv file, which you can then view.

Execute este comando como Administrador local no servidor que aloja o ponto de ligação de serviço.Run this command as a local administrator on the server that hosts the service connection point.

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