Use a ferramenta de conexão de serviço para Configuration Manager

  • Artigo

Aplica-se a: Configuration Manager (branch atual)

Use a ferramenta de conexão de serviço quando o ponto de conexão de serviço estiver no modo offline. Você também pode usá-lo quando os servidores do sistema de site Configuration Manager não estiverem conectados à Internet. A ferramenta pode ajudá-lo a manter seu site atualizado com as atualizações mais recentes para Configuration Manager.

Quando você executa a ferramenta, ela se conecta ao serviço de nuvem Configuration Manager, carrega informações de uso para sua hierarquia e baixa atualizações. Carregar dados de uso é necessário para permitir que o serviço de nuvem forneça as atualizações corretas para seu ambiente.

Pré-requisitos

  • O site tem um ponto de conexão de serviço e você o configura para uma conexão offline sob demanda.

  • Execute a ferramenta de um prompt de comando como administrador. Não há interface do usuário.

  • Você executa a ferramenta do ponto de conexão de serviço e um computador que pode se conectar à Internet. Cada um desses computadores precisa ter um sistema operacional x64 bits e ter os seguintes componentes:

    • Os arquivos Pacote Redistribuível do Visual C++ x86 e x64. Por padrão, Configuration Manager instala a versão x64 no computador que hospeda o ponto de conexão de serviço. Essa ferramenta requer o pacote redistribuível Microsoft Visual C++ 2015-2019 (14.28.29914.0) ou posterior no computador do qual você está executando. Para baixar esse componente, consulte Microsoft Visual C++ Downloads com suporte mais recentes redistribuíveis.

      Observação

      Se a atualização de uma versão sem suporte de Configuration Manager anterior a 2107, a ferramenta exigirá o pacote redistributalbe do Visual C++ 2013 (12.0.40660.0), que está disponível no mesmo link.

    • Essa ferramenta requer o .NET versão 4.6.2 e a versão 4.8 é recomendada. Para obter mais informações, consulte Pré-requisitos do sistema de sites e sites.

  • A conta que você usa para executar a ferramenta precisa das seguintes permissões:

    • Administrador local no computador que hospeda o ponto de conexão de serviço

    • Ler permissões para o banco de dados do site

  • Você precisa de um método para transferir os arquivos entre o computador com acesso à Internet e o ponto de conexão de serviço. Por exemplo, uma unidade USB com espaço livre suficiente para armazenar os arquivos e atualizações.

Visão geral

  1. Preparar: execute a ferramenta no ponto de conexão de serviço. Ele coloca seus dados de uso em um arquivo .cab no local especificado. Copie o arquivo de dados para o computador com uma conexão com a Internet.

  2. Conectar: execute a ferramenta no computador com uma conexão com a Internet. Ele carrega seus dados de uso e, em seguida, baixa Configuration Manager atualizações. Copie as atualizações baixadas para o ponto de conexão de serviço.

    Você pode carregar vários arquivos de dados ao mesmo tempo, cada um de uma hierarquia diferente. Você também pode especificar um servidor proxy e um usuário para o servidor proxy.

  3. Importação: execute a ferramenta no ponto de conexão de serviço. Ele importa as atualizações e as adiciona ao seu site. Em seguida, você pode exibir e instalar essas atualizações no console Configuration Manager.

Carregar vários arquivos de dados

  • Coloque todos os arquivos de dados exportados de hierarquias separadas na mesma pasta. Dê a cada arquivo um nome exclusivo. Se necessário, você pode renomeá-los manualmente.

  • Ao executar a ferramenta para carregar dados na Microsoft, especifique a pasta que contém os arquivos de dados.

  • Quando você executa a ferramenta para importar dados, a ferramenta importa apenas os dados para essa hierarquia.

Especificar um servidor proxy

Se o computador com uma conexão com a Internet exigir um servidor proxy, a ferramenta oferecerá suporte a uma configuração básica de proxy. Use os parâmetros opcionais -proxyserveruri e -proxyusername. Para obter mais informações, confira Parâmetros de linha de comando.

Especificar o tipo de atualizações a serem baixadas

A ferramenta dá suporte a opções para controlar quais arquivos você baixa. Por padrão, a ferramenta baixa apenas a atualização disponível mais recente que se aplica à versão do seu site. Ele não baixa hotfixes.

Para modificar esse comportamento, use um dos seguintes parâmetros para alterar os arquivos que ele baixa:

  • -downloadall: baixe todas as atualizações, incluindo atualizações e hotfixes, qualquer que seja a versão do seu site.

  • -downloadhotfix: baixe todos os hotfixes qualquer que seja a versão do seu site.

  • -downloadsiteversion: baixa atualizações e hotfixes com uma versão posterior do que a versão do seu site.

    Importante

    Devido a um problema conhecido no Configuration Manager versão 2002, o comportamento padrão não funciona conforme o esperado. Atualize para a versão 2006 ou use o parâmetro -downloadsiteversion para baixar as atualizações necessárias para a versão 2002.

Para obter mais informações, confira Parâmetros de linha de comando.

Dica

A ferramenta determina a versão do seu site do arquivo de dados. Para verificar a versão, procure no arquivo .cab para o arquivo de texto nomeado com a versão do site.

Usar a ferramenta

A ferramenta de conexão de serviço está no Configuration Manager mídia de instalação no seguinte caminho: SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe. Use sempre a ferramenta de conexão de serviço que corresponda à versão de Configuration Manager que você usa. Todos esses arquivos devem estar na mesma pasta para que a ferramenta de conexão de serviço funcione.

Copie a pasta ServiceConnectionTool com todo o conteúdo para o computador com uma conexão com a Internet.

Neste procedimento, os exemplos de linha de comando usam os seguintes nomes de arquivo e locais de pasta. Você não precisa usar esses caminhos e nomes de arquivo. Você pode usar alternativas que correspondam ao seu ambiente e preferências.

  • O caminho para os arquivos de origem da mídia de instalação Configuration Manager no ponto de conexão de serviço:C:\Source

  • O caminho para uma unidade USB em que você armazena os dados para transferir entre computadores: D:\USB\

  • O nome do arquivo de dados que você exporta do site: UsageData.cab

  • O nome da pasta vazia em que a ferramenta armazena atualizações baixadas para Configuration Manager:UpdatePacks

Preparar

  1. No computador que hospeda o ponto de conexão de serviço, abra um prompt de comando como administrador e altere o diretório para o local da ferramenta. Por exemplo:

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

  2. Execute o seguinte comando para preparar o arquivo de dados:

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

    Observação

    Se você carregar arquivos de dados de mais de uma hierarquia ao mesmo tempo, dê a cada arquivo de dados um nome exclusivo. Se necessário, você pode renomear arquivos posteriormente.

    Os dados no arquivo são baseados no nível de dados de diagnóstico e uso que você configura para o site. Para obter mais informações, consulte Visão geral dos dados de uso e diagnóstico. Você pode usar a ferramenta para exportar os dados para um arquivo CSV para exibir o conteúdo. Para obter mais informações, consulte -export.

  3. Depois que a ferramenta terminar de exportar os dados de uso, copie o arquivo de dados para um computador que tenha acesso à Internet.

Conectar

  1. No computador com acesso à Internet, abra um prompt de comando como administrador e altere o diretório para o local da ferramenta. Esse local é uma cópia de toda a pasta ServiceConnectionTool . Por exemplo:

    cd D:\USB\ServiceConnectionTool\

  2. Execute o seguinte comando para carregar o arquivo de dados e baixar as atualizações Configuration Manager:

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

    Para obter mais exemplos, confira Parâmetros de linha de comando.

    Observação

    Ao executar essa linha de comando, você poderá ver o seguinte erro:

    Exceção sem tratamento: System.UnauthorizedAccessException: o acesso ao caminho 'C:\Users\jqpublic\AppData\Local\Temp\extractmanifestcab\95F8A562.sql' é negado.

    Você pode ignorar esse erro com segurança. Feche a janela de erro para continuar.

  3. Depois que a ferramenta terminar de baixar as atualizações, copie-as para o ponto de conexão de serviço.

Importar

  1. No computador que hospeda o ponto de conexão de serviço, abra um prompt de comando como administrador e altere o diretório para o local da ferramenta. Por exemplo:

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

  2. Execute o seguinte comando para importar as atualizações:

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

  3. Após a conclusão da importação, feche o prompt de comando. Ele importa apenas atualizações para a hierarquia aplicável.

  4. No console Configuration Manager, acesse o workspace Administração e selecione o nó Atualizações e Manutenção. As atualizações importadas agora estão disponíveis para instalação. Para obter mais informações, consulte Instalar atualizações no console.

Arquivos de log

  • ServiceConnectionTool.log: sempre que você executa a ferramenta de conexão de serviço, ela grava neste arquivo de log. O caminho do arquivo de log é sempre o mesmo local que a ferramenta. Este arquivo de log fornece detalhes simples sobre o uso da ferramenta com base nos parâmetros que você usa. Sempre que você executa a ferramenta, a ferramenta substitui qualquer arquivo de log existente.

  • ConfigMgrSetup.log: durante a fase Connect , a ferramenta grava neste arquivo de log na raiz da unidade do sistema. Este arquivo de log fornece informações mais detalhadas. Por exemplo, quais arquivos a ferramenta baixa e se as verificações de hash são bem-sucedidas.

Parâmetros de linha de comando

Esta seção lista em ordem alfabética todos os parâmetros disponíveis para a ferramenta de conexão de serviço.

-Conectar

Use durante a fase Conectar no computador com acesso à Internet. Ele se conecta ao serviço de nuvem Configuration Manager para carregar o arquivo de dados e baixar atualizações.

Ele requer os seguintes parâmetros:

  • -usedatasrc: o local do arquivo de dados a ser carregado
  • -updatepackdest: um caminho para as atualizações baixadas

Você também pode usar os seguintes parâmetros opcionais:

  • -proxyserveruri: O FQDN do servidor proxy
  • -proxyusername: um nome de usuário para o servidor proxy
  • -downloadall: baixe tudo, incluindo atualizações e hotfixes, qualquer que seja a versão do seu site.
  • -downloadhotfix: baixe todos os hotfixes, qualquer que seja a versão do seu site.
  • -downloadsiteversion: baixar atualizações e hotfixes que têm uma versão posterior do que a versão do seu site.

Exemplo de conexão sem um servidor proxy

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

Exemplo de conexão com um servidor proxy

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

Exemplo de conexão para baixar apenas atualizações aplicáveis à versão do site

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

-Dest

Um parâmetro necessário com o parâmetro -export para especificar o caminho e o nome do arquivo CSV a ser exportado. Para obter mais informações, consulte -export.

-downloadall

Um parâmetro opcional com o parâmetro -connect para baixar tudo, incluindo atualizações e hotfixes, qualquer que seja a versão do seu site. Para obter mais informações, consulte -connect.

-downloadhotfix

Um parâmetro opcional com o parâmetro -connect para baixar apenas todos os hotfixes, qualquer que seja a versão do seu site. Para obter mais informações, consulte -connect.

-downloadsiteversion

Um parâmetro opcional com o parâmetro -connect para baixar apenas atualizações e hotfixes que têm uma versão posterior do que a versão do seu site. Para obter mais informações, consulte -connect.

-Exportação

Use durante a fase Preparar para exportar dados de uso para um arquivo CSV. Execute-o como um administrador no ponto de conexão de serviço. Essa ação permite que você examine o conteúdo dos dados de uso antes de carregar na Microsoft. Ele requer o parâmetro -dest para especificar o local do arquivo CSV.

Exemplo de exportação

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

-Importação

Use durante a fase Importar no ponto de conexão de serviço para importar as atualizações para o site. Ele requer o parâmetro -updatepacksrc para especificar o local das atualizações baixadas.

Exemplo de importação

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

-Preparar

Use durante a fase Preparar no ponto de conexão de serviço para exportar dados de uso do site. Ele requer o parâmetro -usagedatadest para especificar o local do arquivo de dados exportado.

Exemplo de preparação

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

-proxyserveruri

Um parâmetro opcional com o parâmetro -connect para especificar o FQDN do servidor proxy. Para obter mais informações, consulte -connect.

-Proxyusername

Um parâmetro opcional com o parâmetro -connect para especificar o nome de usuário para autenticar com o servidor proxy. Para obter mais informações, consulte -connect.

-updatepackdest

Um parâmetro necessário com o parâmetro -connect para especificar um caminho para as atualizações baixadas. Para obter mais informações, consulte -connect.

-updatepacksrc

Um parâmetro necessário com o parâmetro -import para especificar um caminho das atualizações baixadas. Para obter mais informações, consulte -import.

-usagedatadest

Um parâmetro necessário com o parâmetro -prepare para especificar um caminho e um nome de arquivo do arquivo de dados exportado. Para obter mais informações, consulte -prepare.

Próximas etapas

Instalar atualizações no console

Como exibir dados de diagnóstico e uso