Utilize a ferramenta de ligação de serviço para o Gestor de Configuração

  • Artigo

Aplica-se a: Gestor de Configuração (ramo atual)

Utilize a ferramenta de ligação de serviço quando o seu ponto de ligação de serviço estiver no modo offline. Também pode usá-lo quando os servidores do sistema de site do Seu Gestor de Configuração não estão ligados à internet. A ferramenta pode ajudá-lo a manter o seu site atualizado com as últimas atualizações para o Gestor de Configuração.

Quando executa a ferramenta, ela conecta-se ao serviço de nuvem Do Gestor de Configuração, envia informações de utilização para a sua hierarquia e descarrega atualizações. O upload de dados de utilização é necessário para permitir que o serviço de cloud forneça as atualizações corretas para o seu ambiente.

Pré-requisitos

  • O site tem um ponto de ligação de serviço, e configura-o para uma ligação offline, a pedido.

  • Executar a ferramenta a partir de um pedido de comando como administrador. Não há interface de utilizador.

  • Você executou a ferramenta a partir do ponto de ligação de serviço e um computador que pode ligar-se à internet. Cada um destes computadores precisa de ter um SISTEMA x64-bit, e ter os seguintes componentes:

    • Os ficheiros do Visual C++ Redistributable , tanto x86 como x64. Por predefinição, o Gestor de Configuração instala a versão x64 no computador que acolhe o ponto de ligação de serviço. Para descarregar este componente, consulte Pacotes Redistribuíveis Visual C++ para Visual Studio 2013.

    • .NET Framework 4.5.2 ou mais tarde

  • A conta que utiliza para executar a ferramenta necessita das seguintes permissões:

    • Administrador local no computador que acolhe o ponto de ligação de serviço

    • Ler permissões para a base de dados do site

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

Descrição Geral

  1. Preparar: Executar a ferramenta no ponto de ligação de serviço. Coloca os seus dados de utilização num ficheiro .cab no local que especificou. Copie o ficheiro de dados para o computador com uma ligação à Internet.

  2. Ligação: Executar a ferramenta no computador com uma ligação à Internet. Ele carrega os seus dados de utilização e, em seguida, descarrega as atualizações do Gestor de Configuração. Copie as atualizações descarregadas para o ponto de ligação do serviço.

    Pode carregar vários ficheiros de dados de uma só vez, cada um de uma hierarquia diferente. Também pode especificar um servidor proxy e um utilizador para o servidor proxy.

  3. Importação: Executar a ferramenta no ponto de ligação de serviço. Importa as atualizações e adiciona-as ao seu site. Em seguida, pode visualizar e instalar essas atualizações na consola 'Gestor de Configuração'.

Carregar vários ficheiros de dados

  • Coloque todos os ficheiros de dados exportados de hierarquias separadas na mesma pasta. Dê a cada ficheiro um nome único. Se necessário, pode rebatizá-los manualmente.

  • Quando executar a ferramenta para enviar dados para a Microsoft, especifica a pasta que contém os ficheiros de dados.

  • Quando executam a ferramenta para importar dados, a ferramenta apenas importa os dados para essa hierarquia.

Especificar um servidor proxy

Se o computador com uma ligação à Internet necessitar de um servidor proxy, a ferramenta suporta uma configuração de procuração básica. Utilize os parâmetros opcionais -proxyserveruri e -proxyusername. Para obter mais informações, consulte os parâmetros da linha de comando.

Especificar o tipo de atualizações para descarregar

A ferramenta suporta opções para controlar os ficheiros que descarrega. Por predefinição, a ferramenta descarrega apenas a mais recente atualização disponível que se aplica à versão do seu site. Não descarrega hotfixes.

Para modificar este comportamento, utilize um dos seguintes parâmetros para alterar os ficheiros que descarrega:

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

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

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

    Importante

    Devido a um problema conhecido na versão 2002 do Gestor de Configuração, o comportamento padrão não funciona como esperado. Atualize a versão 2006 ou use o parâmetro de versão de descarregamento para descarregar as atualizações necessárias para a versão de 2002.

Para obter mais informações, consulte os parâmetros da linha de comando.

Dica

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

Use a ferramenta

A ferramenta de ligação de serviço encontra-se no meio de instalação do Gestor de Configuração no seguinte caminho: SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe . Utilize sempre a ferramenta de ligação de serviço que corresponda à versão do Gestor de Configuração que utiliza. Todos estes ficheiros devem estar na mesma pasta para que a ferramenta de ligação de serviço funcione.

Copie a pasta ServiceConnectionTool com todo o seu conteúdo para o computador com uma ligação à Internet.

Neste procedimento, os exemplos da linha de comando utilizam os seguintes nomes de ficheiros e localizações de pastas. Não precisas de usar estes caminhos e nomes de ficheiros. Pode utilizar alternativas que correspondam ao seu ambiente e preferências.

  • O caminho para os ficheiros de origem de origem de instalação do Gestor de Configuração no ponto de ligação de serviço: C:\Source

  • O caminho para uma unidade USB onde armazena os dados para transferir entre computadores: D:\USB\

  • O nome do ficheiro de dados que exporta do site: UsageData.cab

  • O nome da pasta vazia onde a ferramenta armazena atualizações descarregadas para o Gestor de Configuração: UpdatePacks

Preparação

  1. No computador que acolhe o ponto de ligação de serviço, abra um pedido de comando como administrador e altere o diretório para a localização da ferramenta. Por exemplo:

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

  2. Executar o seguinte comando para preparar o ficheiro de dados:

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

    Nota

    Se fizer o upload de ficheiros de dados de mais de uma hierarquia ao mesmo tempo, dê a cada ficheiro de dados um nome único. Se necessário, pode mudar o nome dos ficheiros mais tarde.

    Os dados do ficheiro baseiam-se no nível de diagnóstico e dados de utilização que configura para o site. Para obter mais informações, consulte a visão geral dos diagnósticos e dados de utilização. Pode utilizar a ferramenta para exportar os dados para um ficheiro CSV para visualizar o conteúdo. Para mais informações, consulte -exportação.

  3. Depois de a ferramenta terminar de exportar os dados de utilização, copie o ficheiro de dados para um computador que tenha acesso à internet.

Ligar

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

    cd D:\USB\ServiceConnectionTool\

  2. Executar o seguinte comando para carregar o ficheiro de dados e descarregar as atualizações do Gestor de Configuração:

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

    Para mais exemplos, consulte os parâmetros da linha de comando.

    Nota

    Quando executar esta linha de comando, poderá ver o seguinte erro:

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

    Pode ignorar com segurança este erro. Feche a janela de erro para continuar.

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

Importar

  1. No computador que acolhe o ponto de ligação de serviço, abra um pedido de comando como administrador e altere o diretório para a localização da ferramenta. Por exemplo:

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

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

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

  3. Após a importação concluída, feche o aviso de comando. Apenas importa atualizações para a hierarquia aplicável.

  4. Na consola 'Gestor de Configuração', vá ao espaço de trabalho da Administração e selecione as Atualizações e o nó de manutenção. As atualizações importadas estão agora disponíveis para instalar. Para obter mais informações, consulte instalar atualizações na consola.

Ficheiros de registo

  • ServiceConnectionTool.log: De cada vez que executar a ferramenta de ligação de serviço, escreve para este ficheiro de registo. O caminho do ficheiro de registo é sempre o mesmo local que a ferramenta. Este ficheiro de registo fornece detalhes simples sobre a utilização da ferramenta com base nos parâmetros utilizados. Cada vez que executar a ferramenta, a ferramenta substitui qualquer ficheiro de registo existente.

  • ConfigMgrSetup.log: Durante a fase Ligação, a ferramenta escreve para este ficheiro de registo na raiz da unidade do sistema. Este ficheiro de registo fornece informações mais detalhadas. Por exemplo, quais os ficheiros que a ferramenta transfere e se as verificações de hash são bem-sucedidas.

Parâmetros de linha de comando

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

-ligar

Utilizar durante a fase Ligação no computador com acesso à Internet. Conecta-se ao serviço de nuvem Do Gestor de Configuração para carregar o ficheiro de dados e descarregar atualizações.

Requer os seguintes parâmetros:

  • -datadatasrc: A localização do ficheiro de dados para carregar
  • -atualizar embalado: Um caminho para as atualizações descarregadas

Também pode utilizar os seguintes parâmetros opcionais:

  • -proxyserveruri: O FQDN do servidor proxy
  • -proxyusername: Um nome de utilizador para o servidor proxy
  • -downloadall: Descarregue tudo, incluindo atualizações e hotfixes, qualquer que seja a versão do seu site.
  • -downloadhotfix: Descarregue todos os hotfixes, qualquer que seja a versão do seu site.
  • -downloadsiteversion: Descarregue atualizações e hotfixes que tenham uma versão posterior que a versão do seu site.

Exemplo de ligação sem um servidor proxy

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

Exemplo de ligaçã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 ligar para descarregar apenas a versão do site aplicável

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

-dest

Um parâmetro necessário com o parâmetro de exportação para especificar o caminho e o nome do ficheiro CSV para exportação. Para mais informações, consulte -exportação.

-descarregar tudo

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

-downloadhotfix

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

-downloadsiteversion

Um parâmetro opcional com o parâmetro de ligar apenas para descarregar 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 -ligar.

-exportação

Utilize durante a fase preparar para exportar dados de utilização para um ficheiro CSV. Executá-lo como administrador no ponto de ligação de serviço. Esta ação permite-lhe rever o conteúdo dos dados de utilização antes de fazer o upload para a Microsoft. Requer o parâmetro de dest para especificar a localização do ficheiro CSV.

Exemplo de exportação

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

-importação

Utilização durante a fase de importação no ponto de ligação de serviço para importar as atualizações para o site. Requer o parâmetro -updatepacksrc para especificar a localização das atualizações descarregadas.

Exemplo de importação

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

-preparar

Utilização durante a fase de preparação no ponto de ligação de serviço para exportar dados de utilização do site. Requer o parâmetro de datadest de utilização para especificar a localização do ficheiro de dados exportado.

Exemplo de preparação

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

-proxyserveruri

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

-proxyusername

Um parâmetro opcional com o parâmetro de ligar o utilizador para especificar o nome de utilizador para autenticar com o seu servidor proxy. Para obter mais informações, consulte -ligar.

-atualizar embalado

Um parâmetro necessário com o parâmetro de ligação para especificar um caminho para as atualizações descarregadas. Para obter mais informações, consulte -ligar.

-atualizar opacksrc

Um parâmetro necessário com o parâmetro de importação para especificar um caminho das atualizações descarregadas. Para mais informações, consulte -importar.

-dados de utilização

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

Passos seguintes

Instalar atualizações na consola

Como visualizar diagnósticos e dados de utilização