Använd tjänstanslutningsverktyget för Configuration Manager

Gäller för: Configuration Manager (aktuell gren)

Använd tjänstanslutningsverktyget när tjänstanslutningspunkten är i offlineläge. Du kan också använda den när dina Configuration Manager platssystemservrar inte är anslutna till Internet. Verktyget kan hjälpa dig att hålla webbplatsen uppdaterad med de senaste uppdateringarna för Configuration Manager.

När du kör verktyget ansluter det till Configuration Manager molntjänst, laddar upp användningsinformation för hierarkin och laddar ned uppdateringar. Du måste ladda upp användningsdata för att göra det möjligt för molntjänsten att tillhandahålla rätt uppdateringar för din miljö.

Förutsättningar

• Webbplatsen har en tjänstanslutningspunkt och du konfigurerar den för en offlineanslutning på begäran.

• Kör verktyget från en kommandotolk som administratör. Det finns inget användargränssnitt.

• Du kör verktyget från tjänstanslutningspunkten och en dator som kan ansluta till Internet. Var och en av dessa datorer måste ha ett x64-bitars operativsystem och ha följande komponenter:

  • Både Visual C++ Redistributable x86- och x64-filerna. Som standard installerar Configuration Manager x64-versionen på den dator som är värd för tjänstanslutningspunkten. Det här verktyget kräver Microsoft Visual C++ 2015-2019 redistributable-paketet (14.28.29914.0) eller senare på den dator som du kör det från. Information om hur du laddar ned den här komponenten finns i Microsoft Visual C++ Redistributable latest supported downloads (Microsoft Visual C++ Redistributable latest supported downloads).

    Obs!

    Om du uppgraderar från en supportversion av Configuration Manager före 2107 kräver verktyget Visual C++ 2013 redistributalbe packate (12.0.40660.0), som är tillgängligt från samma länk.

  • Det här verktyget kräver .NET version 4.6.2 och version 4.8 rekommenderas. Mer information finns i Krav för plats- och platssystem.

• Kontot som du använder för att köra verktyget behöver följande behörigheter:

  • Lokal administratör på den dator som är värd för tjänstanslutningspunkten

  • Läsbehörigheter till platsdatabasen

• Du behöver en metod för att överföra filerna mellan datorn med Internetåtkomst och tjänstanslutningspunkten. Till exempel en USB-enhet med tillräckligt med ledigt utrymme för att lagra filer och uppdateringar.

Översikt

1. Förbered: Kör verktyget på tjänstanslutningspunkten. Det placerar dina användningsdata i en .cab fil på den plats som du anger. Kopiera datafilen till datorn med en Internetanslutning.

2. Anslut: Kör verktyget på datorn med en Internetanslutning. Den laddar upp dina användningsdata och laddar sedan ned Configuration Manager uppdateringar. Kopiera de nedladdade uppdateringarna till tjänstanslutningspunkten.

   Du kan ladda upp flera datafiler samtidigt, var och en från en annan hierarki. Du kan också ange en proxyserver och en användare för proxyservern.

3. Importera: Kör verktyget på tjänstanslutningspunkten. Den importerar uppdateringarna och lägger till dem på webbplatsen. Du kan sedan visa och installera uppdateringarna i Configuration Manager-konsolen.

Ladda upp flera datafiler

• Placera alla exporterade datafiler från separata hierarkier i samma mapp. Ge varje fil ett unikt namn. Om det behövs kan du byta namn på dem manuellt.

• När du kör verktyget för att ladda upp data till Microsoft anger du den mapp som innehåller datafilerna.

• När du kör verktyget för att importera data importerar verktyget endast data för den hierarkin.

Ange en proxyserver

Om datorn med en Internetanslutning kräver en proxyserver stöder verktyget en grundläggande proxykonfiguration. Använd de valfria parametrarna -proxyserveruri och -proxyusername. Mer information finns i Kommandoradsparametrar.

Ange vilken typ av uppdateringar som ska laddas ned

Verktyget stöder alternativ för att styra vilka filer du laddar ned. Som standard laddar verktyget bara ned den senaste tillgängliga uppdateringen som gäller för versionen av webbplatsen. Snabbkorrigeringar laddas inte ned.

Om du vill ändra det här beteendet använder du någon av följande parametrar för att ändra vilka filer som laddas ned:

• -downloadall: Ladda ned alla uppdateringar, inklusive uppdateringar och snabbkorrigeringar, oavsett vilken version av din webbplats.

• -downloadhotfix: Ladda ned alla snabbkorrigeringar oavsett vilken version av webbplatsen du har.

• -downloadsiteversion: Laddar ned uppdateringar och snabbkorrigeringar med en senare version än versionen av webbplatsen.

  Viktigt

  På grund av ett känt problem i Configuration Manager version 2002 fungerar standardbeteendet inte som förväntat. Uppdatera till version 2006 eller använd parametern -downloadsiteversion för att ladda ned nödvändiga uppdateringar för version 2002.

Mer information finns i Kommandoradsparametrar.

Tips

Verktyget bestämmer versionen av webbplatsen från datafilen. Kontrollera versionen genom att titta i .cab-filen efter textfilen med namnet med webbplatsversionen.

Använda verktyget

Verktyget för tjänstanslutning finns i Configuration Manager installationsmediet på följande sökväg: SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe. Använd alltid tjänstanslutningsverktyget som matchar den version av Configuration Manager som du använder. Alla dessa filer måste finnas i samma mapp för att tjänstanslutningsverktyget ska fungera.

Kopiera mappen ServiceConnectionTool med allt dess innehåll till datorn med en Internetanslutning.

I den här proceduren använder kommandoradsexemplen följande filnamn och mappplatser. Du behöver inte använda dessa sökvägar och filnamn. Du kan använda alternativ som matchar din miljö och dina inställningar.

• Sökvägen till Configuration Manager installationsmediakällans filer på tjänstanslutningspunkten:C:\Source

• Sökvägen till en USB-enhet där du lagrar data som ska överföras mellan datorer: D:\USB\

• Namnet på den datafil som du exporterar från platsen: UsageData.cab

• Namnet på den tomma mappen där verktyget lagrar nedladdade uppdateringar för Configuration Manager:UpdatePacks

Förbereda

1. På den dator som är värd för tjänstanslutningspunkten öppnar du en kommandotolk som administratör och ändrar katalogen till verktygsplatsen. Till exempel:

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

2. Kör följande kommando för att förbereda datafilen:

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

   Obs!

   Om du laddar upp datafiler från mer än en hierarki samtidigt ger du varje datafil ett unikt namn. Om det behövs kan du byta namn på filer senare.

   Data i filen baseras på den nivå av diagnostik- och användningsdata som du konfigurerar för webbplatsen. Mer information finns i Översikt över diagnostik- och användningsdata. Du kan använda verktyget för att exportera data till en CSV-fil för att visa innehållet. Mer information finns i -export.

3. När verktyget har exporterat användningsdata kopierar du datafilen till en dator som har åtkomst till Internet.

Ansluta

1. Öppna en kommandotolk som administratör på datorn med Internetåtkomst och ändra katalogen till verktygsplatsen. Den här platsen är en kopia av hela mappen ServiceConnectionTool . Till exempel:

   cd D:\USB\ServiceConnectionTool\

2. Kör följande kommando för att ladda upp datafilen och ladda ned Configuration Manager uppdateringar:

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

   Fler exempel finns i Kommandoradsparametrar.

   Obs!

   När du kör den här kommandoraden kan följande fel visas:

   Ohanterat undantag: System.UnauthorizedAccessException: Åtkomst till sökvägen "C:\Users\jqpublic\AppData\Local\Temp\extractmanifestcab\95F8A562.sql" nekas.

   Du kan ignorera det här felet på ett säkert sätt. Stäng felfönstret för att fortsätta.

3. När verktyget har laddat ned uppdateringarna kopierar du dem till tjänstanslutningspunkten.

Importera

1. På den dator som är värd för tjänstanslutningspunkten öppnar du en kommandotolk som administratör och ändrar katalogen till verktygsplatsen. Till exempel:

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

2. Kör följande kommando för att importera uppdateringarna:

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

3. När importen är klar stänger du kommandotolken. Den importerar endast uppdateringar för den tillämpliga hierarkin.

4. I Configuration Manager-konsolen går du till arbetsytan Administration och väljer noden Uppdateringar och Service. Importerade uppdateringar är nu tillgängliga för installation. Mer information finns i Installera uppdateringar i konsolen.

Loggfiler

• ServiceConnectionTool.log: Varje gång du kör tjänstanslutningsverktyget skrivs det till den här loggfilen. Sökvägen till loggfilen är alltid samma plats som verktyget. Den här loggfilen innehåller enkel information om verktygsanvändningen baserat på de parametrar som du använder. Varje gång du kör verktyget ersätter verktyget alla befintliga loggfiler.

• ConfigMgrSetup.log: Under anslutningsfasen skriver verktyget till den här loggfilen i roten på systemenheten. Den här loggfilen innehåller mer detaljerad information. Till exempel vilka filer verktyget laddar ned och om hash-kontrollerna lyckas.

Kommandoradsparametrar

I det här avsnittet visas i alfabetisk ordning alla tillgängliga parametrar för tjänstanslutningsverktyget.

-Ansluta

Använd under fasen Anslut på datorn med Internetåtkomst. Den ansluter till Configuration Manager molntjänst för att ladda upp datafilen och ladda ned uppdateringar.

Det kräver följande parametrar:

• -usagedatasrc: Platsen för datafilen som ska laddas upp
• -updatepackdest: En sökväg för de nedladdade uppdateringarna

Du kan också använda följande valfria parametrar:

• -proxyserveruri: FQDN för proxyservern
• -proxyusername: Ett användarnamn för proxyservern
• -downloadall: Ladda ned allt, inklusive uppdateringar och snabbkorrigeringar, oavsett vilken version av din webbplats.
• -downloadhotfix: Ladda ned alla snabbkorrigeringar, oavsett vilken version av din webbplats.
• -downloadsiteversion: Ladda ned uppdateringar och snabbkorrigeringar som har en senare version än versionen av webbplatsen.

Exempel på anslutning utan proxyserver

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

Exempel på anslutning med en proxyserver

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

Exempel på anslutning för att endast ladda ned tillämpliga uppdateringar av webbplatsversion

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

-Dest

En obligatorisk parameter med parametern -export för att ange sökvägen och filnamnet för CSV-filen som ska exporteras. Mer information finns i -export.

-downloadall

En valfri parameter med parametern -connect för att ladda ned allt, inklusive uppdateringar och snabbkorrigeringar, oavsett vilken version av webbplatsen du har. Mer information finns i -connect.

-downloadhotfix

En valfri parameter med parametern -connect för att endast ladda ned alla snabbkorrigeringar, oavsett vilken version av webbplatsen du har. Mer information finns i -connect.

-downloadsiteversion

En valfri parameter med parametern -connect för att endast ladda ned uppdateringar och snabbkorrigeringar som har en senare version än versionen av webbplatsen. Mer information finns i -connect.

-Exportera

Använd under fasen Förbered för att exportera användningsdata till en CSV-fil. Kör den som administratör på tjänstanslutningspunkten. Med den här åtgärden kan du granska innehållet i användningsdata innan du laddar upp till Microsoft. Den kräver parametern -dest för att ange platsen för CSV-filen.

Exempel på export

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

-Importera

Använd under importfasen på tjänstanslutningspunkten för att importera uppdateringarna till platsen. Det kräver parametern -updatepacksrc för att ange platsen för de nedladdade uppdateringarna.

Exempel på import

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

-Förbereda

Använd under förberedelsefasen på tjänstanslutningspunkten för att exportera användningsdata från platsen. Den kräver parametern -usagedatadest för att ange platsen för den exporterade datafilen.

Exempel på förberedelse

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

-proxyserveruri

En valfri parameter med parametern -connect för att ange FQDN för proxyservern. Mer information finns i -connect.

-proxyusername

En valfri parameter med parametern -connect för att ange användarnamnet för att autentisera med proxyservern. Mer information finns i -connect.

-updatepackdest

En obligatorisk parameter med parametern -connect för att ange en sökväg för de nedladdade uppdateringarna. Mer information finns i -connect.

-updatepacksrc

En obligatorisk parameter med parametern -import för att ange en sökväg för de nedladdade uppdateringarna. Mer information finns i -import.

-usagedatadest

En obligatorisk parameter med parametern -prepare för att ange en sökväg och ett filnamn för den exporterade datafilen. Mer information finns i -prepare.

Nästa steg

Installera uppdateringar i konsolen

Så här visar du diagnostik- och användningsdata