Utilizar a ferramenta de ligação de serviço para o Configuration Manager
Aplica-se a: Configuration Manager (branch atual)
Utilize a ferramenta de ligação de serviço quando o ponto de ligação de serviço estiver no modo offline. Também pode utilizá-lo quando os servidores do sistema de sites do Configuration Manager não estiverem ligados à Internet. A ferramenta pode ajudá-lo a manter o seu site atualizado com as atualizações mais recentes para o Configuration Manager.
Quando executa a ferramenta, esta liga-se ao serviço cloud do Configuration Manager, carrega as informações de utilização da hierarquia e transfere as atualizações. O carregamento de dados de utilização é necessário para permitir que o serviço 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 pode configurá-lo para uma ligação offline a pedido.
Execute a ferramenta a partir de uma linha de comandos como administrador. Não existe interface de utilizador.
Executa a ferramenta a partir do ponto de ligação de serviço e de um computador que se pode ligar à Internet. Cada um destes computadores tem de ter um SO de x64 bits e ter os seguintes componentes:
Ambos os ficheiros Visual C++ Redistributable x86 e x64. Por predefinição, o Configuration Manager instala a versão x64 no computador que aloja o ponto de ligação de serviço. Esta ferramenta requer o pacote redistribuível microsoft Visual C++ 2015-2019 (14.28.29914.0) ou posterior no computador a partir do qual está a executá-lo. Para transferir este componente, veja Microsoft Visual C++ Redistributable latest supported downloads (Transferências suportadas mais recentes do Microsoft Visual C++ Redistributable).
Observação
Se atualizar a partir de uma versão de suporte do Configuration Manager anterior à versão 2107, a ferramenta requer o pacote redistributalbe do Visual C++ 2013 (12.0.40660.0), que está disponível a partir da mesma ligação.
Esta ferramenta requer a versão 4.6.2 do .NET e a versão 4.8 é recomendada. Para obter mais informações, veja Pré-requisitos do site e do sistema de sites.
A partir da versão 2309, esta ferramenta requer a instalação do Controlador ODBC 18 para SQL Server (x64). Para transferir este componente, veja Transferir o Controlador ODBC para o SQL Server.
A conta que utiliza para executar a ferramenta precisa das seguintes permissões:
Administrador local no computador que aloja o ponto de ligação de serviço
Permissões de leitura 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 pen USB com espaço livre suficiente para armazenar os ficheiros e as atualizações.
Visão Geral
Preparar: execute a ferramenta no ponto de ligação de serviço. Coloca os seus dados de utilização num ficheiro .cab na localização que especificar. Copie o ficheiro de dados para o computador com uma ligação à Internet.
Ligar: execute a ferramenta no computador com uma ligação à Internet. Carrega os dados de utilização e, em seguida, transfere as atualizações do Configuration Manager. Copie as atualizações transferidas para o ponto de ligação de serviço.
Pode carregar múltiplos ficheiros de dados de uma só vez, cada um a partir de uma hierarquia diferente. Também pode especificar um servidor proxy e um utilizador para o servidor proxy.
Importar: execute a ferramenta no ponto de ligação de serviço. Importa as atualizações e adiciona-as ao seu site. Em seguida, pode ver e instalar essas atualizações na consola do Configuration Manager.
Carregar vários ficheiros de dados
Coloque todos os ficheiros de dados exportados de hierarquias separadas na mesma pasta. Atribua um nome exclusivo a cada ficheiro. Se necessário, pode mudar manualmente o nome dos mesmos.
Quando executa a ferramenta para carregar dados para a Microsoft, especifica a pasta que contém os ficheiros de dados.
Quando executa a ferramenta para importar dados, a ferramenta só importa os dados dessa hierarquia.
Especificar um servidor proxy
Se o computador com uma ligação à Internet precisar de um servidor proxy, a ferramenta suporta uma configuração de proxy básica. Utilize os parâmetros opcionais -proxyserveruri e -proxyusername. Para obter mais informações, veja Parâmetros da linha de comandos.
Especificar o tipo de atualizações a transferir
A ferramenta suporta opções para controlar os ficheiros que transfere. Por predefinição, a ferramenta transfere apenas a atualização mais recente disponível que se aplica à versão do seu site. Não transfere correções.
Para modificar este comportamento, utilize um dos seguintes parâmetros para alterar os ficheiros que transfere:
-downloadall: transfira todas as atualizações, incluindo atualizações e correções, independentemente da versão do seu site.
-downloadhotfix: transfira todas as correções independentemente da versão do seu site.
-downloadsiteversion: transfere atualizações e correções com uma versão posterior à versão do seu site.
Importante
Devido a um problema conhecido na versão 2002 do Configuration Manager, o comportamento predefinido não funciona conforme esperado. Atualize para a versão 2006 ou utilize o parâmetro -downloadsiteversion para transferir as atualizações necessárias para a versão 2002.
Para obter mais informações, veja Parâmetros da linha de comandos.
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 com o nome com a versão do site.
Utilizar a ferramenta
A ferramenta de ligação de serviço encontra-se no suporte de dados de instalação do Configuration Manager no seguinte caminho: SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe
. Utilize sempre a ferramenta de ligação de serviço que corresponde à versão do Configuration Manager que utiliza. Todos estes ficheiros têm de estar na mesma pasta para que a ferramenta de ligação de serviço funcione.
Copie a pasta ServiceConnectionTool com todos os respetivos conteúdos para o computador com uma ligação à Internet.
Neste procedimento, os exemplos da linha de comandos utilizam os seguintes nomes de ficheiro e localizações de pastas. Não precisa de utilizar estes caminhos e nomes de ficheiros. Pode utilizar alternativas que correspondam ao seu ambiente e preferências.
O caminho para os ficheiros de origem do suporte de dados de instalação do Configuration Manager no ponto de ligação de serviço:
C:\Source
O caminho para uma pen USB onde armazena os dados a transferir entre computadores:
D:\USB\
O nome do ficheiro de dados que exporta a partir do site:
UsageData.cab
O nome da pasta vazia onde a ferramenta armazena as atualizações transferidas para o Configuration Manager:
UpdatePacks
Preparar
No computador que aloja o ponto de ligação de serviço, abra uma linha de comandos como administrador e altere o diretório para a localização da ferramenta. Por exemplo:
cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\
Execute o seguinte comando para preparar o ficheiro de dados:
ServiceConnectionTool.exe -prepare -usagedatadest D:\USB\UsageData.cab
Observação
Se carregar ficheiros de dados de mais do que uma hierarquia ao mesmo tempo, atribua um nome exclusivo a cada ficheiro de dados. Se necessário, pode mudar o nome dos ficheiros mais tarde.
Os dados no ficheiro baseiam-se no nível de dados de diagnóstico e utilização que configurar para o site. Para obter mais informações, veja Descrição geral dos diagnósticos e dos dados de utilização. Pode utilizar a ferramenta para exportar os dados para um ficheiro CSV para ver os conteúdos. Para obter mais informações, veja -export.
Depois de a ferramenta terminar de exportar os dados de utilização, copie o ficheiro de dados para um computador que tenha acesso à Internet.
Conectar
No computador com acesso à Internet, abra uma linha de comandos 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\
Execute o seguinte comando para carregar o ficheiro de dados e transferir as atualizações do Configuration Manager:
ServiceConnectionTool.exe -connect -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks
Para obter mais exemplos, veja Parâmetros da linha de comandos.
Observação
Ao executar esta linha de comandos, poderá ver o seguinte erro:
Exceção Não Processada: System.UnauthorizedAccessException: acesso ao caminho "C:\Users\jqpublic\AppData\Local\Temp\extractmanifestcab\95F8A562.sql" é negado.
Pode ignorar este erro com segurança. Feche a janela de erro para continuar.
Quando a ferramenta terminar de transferir as atualizações, copie-as para o ponto de ligação de serviço.
Importar
No computador que aloja o ponto de ligação de serviço, abra uma linha de comandos como administrador e altere o diretório para a localização da ferramenta. Por exemplo:
cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\
Execute o seguinte comando para importar as atualizações:
ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks
Depois de concluída a importação, feche a linha de comandos. Só importa atualizações para a hierarquia aplicável.
Na consola do Configuration Manager, aceda à área de trabalho Administração e selecione o nó Atualizações e Manutenção . As atualizações importadas estão agora disponíveis para instalação. Para obter mais informações, veja Instalar atualizações na consola.
Arquivos de log
ServiceConnectionTool.log: sempre que executar a ferramenta de ligação de serviço, esta escreve neste ficheiro de registo. O caminho do ficheiro de registo é sempre a mesma localização que a ferramenta. Este ficheiro de registo fornece detalhes simples sobre a utilização da ferramenta com base nos parâmetros que utiliza. Sempre que executar a ferramenta, a ferramenta substitui qualquer ficheiro de registo existente.
ConfigMgrSetup.log: durante a fase Ligar , a ferramenta escreve neste ficheiro de registo na raiz da unidade do sistema. Este ficheiro de registo fornece informações mais detalhadas. Por exemplo, que ficheiros a ferramenta transfere e se as verificações de hash são efetuadas com êxito.
Parâmetros da linha de comandos
Esta secção lista por ordem alfabética todos os parâmetros disponíveis para a ferramenta de ligação de serviço.
-connect
Utilize durante a fase Ligar no computador com acesso à Internet. Liga-se ao serviço cloud do Configuration Manager para carregar o ficheiro de dados e transferir atualizações.
Requer os seguintes parâmetros:
- -usagedatasrc: a localização do ficheiro de dados a carregar
- -updatepackdest: um caminho para as atualizações transferidas
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: transfira tudo, incluindo atualizações e correções, qualquer que seja a versão do seu site.
- -downloadhotfix: transfira todas as correções, independentemente da versão do seu site.
- -downloadsiteversion: transfira atualizações e correções que tenham uma versão posterior à 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 ligação para transferir apenas as atualizações aplicáveis da 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 de ficheiro do ficheiro CSV a exportar. Para obter mais informações, veja -export.
-downloadall
Um parâmetro opcional com o parâmetro -connect para transferir tudo, incluindo atualizações e correções, seja qual for a versão do seu site. Para obter mais informações, consulte -connect.
-downloadhotfix
Um parâmetro opcional com o parâmetro -connect para transferir apenas todas as correções, independentemente da versão do seu site. Para obter mais informações, consulte -connect.
-downloadsiteversion
Um parâmetro opcional com o parâmetro -connect para transferir apenas atualizações e correções que tenham uma versão posterior à versão do seu site. Para obter mais informações, consulte -connect.
-export
Utilize durante a fase De preparação para exportar dados de utilização para um ficheiro CSV. Execute-o como administrador no ponto de ligação de serviço. Esta ação permite-lhe rever os conteúdos dos dados de utilização antes de carregar para a Microsoft. Requer o parâmetro -dest para especificar a localização do ficheiro CSV.
Exemplo de exportação
-export -dest D:\USB\usagedata.csv
-import
Utilize 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 transferidas.
Exemplo de importação
ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks
-preparar
Utilize 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 -usagedatadest 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 -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 utilizador a 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 transferidas. 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 transferidas. Para obter mais informações, consulte -import.
-usagedatadest
Um parâmetro necessário com o parâmetro -prepare para especificar um caminho e nome de ficheiro do ficheiro de dados exportado. Para obter mais informações, consulte -prepare.