Het hulpprogramma voor serviceverbindingen gebruiken voor Configuration Manager

  • Artikel

Van toepassing op: Configuration Manager (current branch)

Gebruik het hulpprogramma voor serviceverbindingen wanneer uw serviceverbindingspunt zich in de offlinemodus bevindt. U kunt deze ook gebruiken wanneer uw Configuration Manager sitesysteemservers niet zijn verbonden met internet. Het hulpprogramma kan u helpen uw site up-to-date te houden met de nieuwste updates voor Configuration Manager.

Wanneer u het hulpprogramma uitvoert, maakt het verbinding met de Configuration Manager cloudservice, uploadt het gebruiksgegevens voor uw hiërarchie en downloadt het updates. Het uploaden van gebruiksgegevens is nodig om ervoor te zorgen dat de cloudservice de juiste updates voor uw omgeving kan leveren.

Vereisten

  • De site heeft een serviceverbindingspunt en u configureert deze voor een offlineverbinding op aanvraag.

  • Voer het hulpprogramma uit vanaf een opdrachtprompt als beheerder. Er is geen gebruikersinterface.

  • U voert het hulpprogramma uit vanaf het serviceverbindingspunt en een computer die verbinding kan maken met internet. Elk van deze computers moet een x64-bits besturingssysteem hebben en de volgende onderdelen hebben:

    • Zowel de Visual C++ Redistributable x86- als x64-bestanden. Standaard installeert Configuration Manager de x64-versie op de computer waarop het serviceverbindingspunt wordt gehost. Voor dit hulpprogramma is het herdistribueerbare pakket Microsoft Visual C++ 2015-2019 (14.28.29914.0) of hoger vereist op de computer waarop u het uitvoert. Zie Microsoft Visual C++ Redistributable meest recente ondersteunde downloads om dit onderdeel te downloaden.

      Opmerking

      Als u een upgrade uitvoert van een niet-ondersteuningsversie van Configuration Manager ouder dan 2107, vereist het hulpprogramma visual C++ 2013 redistributalbe packate (12.0.40660.0), dat beschikbaar is via dezelfde koppeling.

    • Voor dit hulpprogramma is .NET versie 4.6.2 vereist en wordt versie 4.8 aanbevolen. Zie Vereisten voor site- en sitesysteem voor meer informatie.

  • Het account dat u gebruikt om het hulpprogramma uit te voeren, heeft de volgende machtigingen nodig:

    • Lokale beheerder op de computer waarop het serviceverbindingspunt wordt gehost

    • Leesmachtigingen voor de sitedatabase

  • U hebt een methode nodig om de bestanden over te dragen tussen de computer met internettoegang en het serviceverbindingspunt. Bijvoorbeeld een USB-station met voldoende vrije ruimte om de bestanden en updates op te slaan.

Overzicht

  1. Voorbereiden: voer het hulpprogramma uit op het serviceverbindingspunt. Uw gebruiksgegevens worden in een .cab-bestand op de locatie die u opgeeft. Kopieer het gegevensbestand naar de computer met een internetverbinding.

  2. Verbinding maken: voer het hulpprogramma uit op de computer met een internetverbinding. Uw gebruiksgegevens worden geüpload en vervolgens Configuration Manager updates gedownload. Kopieer de gedownloade updates naar het serviceverbindingspunt.

    U kunt meerdere gegevensbestanden tegelijk uploaden, elk vanuit een andere hiërarchie. U kunt ook een proxyserver en een gebruiker voor de proxyserver opgeven.

  3. Importeren: voer het hulpprogramma uit op het serviceverbindingspunt. De updates worden geïmporteerd en toegevoegd aan uw site. U kunt deze updates vervolgens weergeven en installeren in de Configuration Manager-console.

Meerdere gegevensbestanden uploaden

  • Zet alle geëxporteerde gegevensbestanden uit afzonderlijke hiërarchieën in dezelfde map. Geef elk bestand een unieke naam. Indien nodig kunt u de naam handmatig wijzigen.

  • Wanneer u het hulpprogramma uitvoert om gegevens te uploaden naar Microsoft, geeft u de map op die de gegevensbestanden bevat.

  • Wanneer u het hulpprogramma uitvoert om gegevens te importeren, importeert het hulpprogramma alleen de gegevens voor die hiërarchie.

Een proxyserver opgeven

Als de computer met een internetverbinding een proxyserver vereist, ondersteunt het hulpprogramma een basisproxyconfiguratie. Gebruik de optionele parameters -proxyserveruri en -proxyusername. Zie Opdrachtregelparameters voor meer informatie.

Geef het type updates op dat moet worden gedownload

Het hulpprogramma ondersteunt opties om te bepalen welke bestanden u downloadt. Standaard downloadt het hulpprogramma alleen de meest recente beschikbare update die van toepassing is op de versie van uw site. Er worden geen hotfixes gedownload.

Als u dit gedrag wilt wijzigen, gebruikt u een van de volgende parameters om te wijzigen welke bestanden worden gedownload:

  • -downloadall: Download alle updates, inclusief updates en hotfixes, ongeacht de versie van uw site.

  • -downloadhotfix: Download alle hotfixes, ongeacht de versie van uw site.

  • -downloadsiteversion: downloadt updates en hotfixes met een latere versie dan de versie van uw site.

    Belangrijk

    Vanwege een bekend probleem in Configuration Manager versie 2002 werkt het standaardgedrag niet zoals verwacht. Werk bij naar versie 2006 of gebruik de parameter -downloadsiteversion om de benodigde updates voor versie 2002 te downloaden.

Zie Opdrachtregelparameters voor meer informatie.

Tip

Het hulpprogramma bepaalt de versie van uw site uit het gegevensbestand. Als u de versie wilt controleren, zoekt u in het bestand .cab naar het tekstbestand met de naam met de siteversie.

Het hulpprogramma gebruiken

Het hulpprogramma voor serviceverbinding bevindt zich in het Configuration Manager installatiemedium op het volgende pad: SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe. Gebruik altijd het hulpprogramma voor serviceverbindingen dat overeenkomt met de versie van Configuration Manager die u gebruikt. Al deze bestanden moeten zich in dezelfde map bevinden om het hulpprogramma voor serviceverbindingen te kunnen gebruiken.

Kopieer de map ServiceConnectionTool met alle inhoud naar de computer met een internetverbinding.

In deze procedure gebruiken de opdrachtregelvoorbeelden de volgende bestandsnamen en maplocaties. U hoeft deze paden en bestandsnamen niet te gebruiken. U kunt alternatieven gebruiken die overeenkomen met uw omgeving en voorkeuren.

  • Het pad naar de Configuration Manager installatiemediabronbestanden op het serviceverbindingspunt:C:\Source

  • Het pad naar een USB-station waar u de gegevens voor overdracht tussen computers opslaat: D:\USB\

  • De naam van het gegevensbestand dat u van de site exporteert: UsageData.cab

  • De naam van de lege map waarin het hulpprogramma gedownloade updates voor Configuration Manager opslaat:UpdatePacks

Voorbereiden

  1. Open op de computer waarop het serviceverbindingspunt wordt gehost een opdrachtprompt als beheerder en wijzig de map naar de locatie van het hulpprogramma. Bijvoorbeeld:

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

  2. Voer de volgende opdracht uit om het gegevensbestand voor te bereiden:

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

    Opmerking

    Als u gegevensbestanden uit meerdere hiërarchieën tegelijk uploadt, geeft u elk gegevensbestand een unieke naam. Indien nodig kunt u later de naam van bestanden wijzigen.

    De gegevens in het bestand zijn gebaseerd op het niveau van diagnostische gegevens en gebruiksgegevens dat u voor de site configureert. Zie Overzicht van diagnostische gegevens en gebruiksgegevens voor meer informatie. U kunt het hulpprogramma gebruiken om de gegevens te exporteren naar een CSV-bestand om de inhoud weer te geven. Zie -exporteren voor meer informatie.

  3. Nadat het hulpprogramma klaar is met het exporteren van de gebruiksgegevens, kopieert u het gegevensbestand naar een computer die toegang heeft tot internet.

Verbinding maken

  1. Open op de computer met internettoegang een opdrachtprompt als beheerder en wijzig de map naar de locatie van het hulpprogramma. Deze locatie is een kopie van de volledige map ServiceConnectionTool . Bijvoorbeeld:

    cd D:\USB\ServiceConnectionTool\

  2. Voer de volgende opdracht uit om het gegevensbestand te uploaden en de Configuration Manager updates te downloaden:

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

    Zie Opdrachtregelparameters voor meer voorbeelden.

    Opmerking

    Wanneer u deze opdrachtregel uitvoert, ziet u mogelijk de volgende fout:

    Niet-verwerkte uitzondering: System.UnauthorizedAccessException: Toegang tot het pad 'C:\Users\jqpublic\AppData\Local\Temp\extractmanifestcab\95F8A562.sql' is geweigerd.

    U kunt deze fout veilig negeren. Sluit het foutvenster om door te gaan.

  3. Nadat het hulpprogramma klaar is met het downloaden van de updates, kopieert u deze naar het serviceverbindingspunt.

Importeren

  1. Open op de computer waarop het serviceverbindingspunt wordt gehost een opdrachtprompt als beheerder en wijzig de map naar de locatie van het hulpprogramma. Bijvoorbeeld:

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

  2. Voer de volgende opdracht uit om de updates te importeren:

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

  3. Nadat het importeren is voltooid, sluit u de opdrachtprompt. Er worden alleen updates voor de toepasselijke hiërarchie geïmporteerd.

  4. Ga in de Configuration Manager-console naar de werkruimte Beheer en selecteer het knooppunt Updates en onderhoud. Geïmporteerde updates zijn nu beschikbaar om te installeren. Zie Updates in de console installeren voor meer informatie.

Logboekbestanden

  • ServiceConnectionTool.log: telkens wanneer u het hulpprogramma voor serviceverbindingen uitvoert, wordt er naar dit logboekbestand geschreven. Het pad van het logboekbestand is altijd dezelfde locatie als het hulpprogramma. Dit logboekbestand bevat eenvoudige details over het hulpprogrammagebruik op basis van de parameters die u gebruikt. Telkens wanneer u het hulpprogramma uitvoert, vervangt het hulpprogramma elk bestaand logboekbestand.

  • ConfigMgrSetup.log: tijdens de verbindingsfase schrijft het hulpprogramma naar dit logboekbestand in de hoofdmap van het systeemstation. Dit logboekbestand bevat meer gedetailleerde informatie. Bijvoorbeeld welke bestanden het hulpprogramma downloadt en of de hashcontroles zijn geslaagd.

Opdrachtregelparameters

In deze sectie worden in alfabetische volgorde alle beschikbare parameters voor het hulpprogramma voor serviceverbindingen weergegeven.

-Verbinding

Gebruik tijdens de verbindingsfase op de computer met internettoegang. Het maakt verbinding met de Configuration Manager cloudservice om het gegevensbestand te uploaden en updates te downloaden.

Hiervoor zijn de volgende parameters vereist:

  • -usagedatasrc: de locatie van het gegevensbestand dat moet worden geüpload
  • -updatepackdest: een pad voor de gedownloade updates

U kunt ook de volgende optionele parameters gebruiken:

  • -proxyserveruri: de FQDN van de proxyserver
  • -proxyusername: een gebruikersnaam voor de proxyserver
  • -downloadall: Download alles, inclusief updates en hotfixes, ongeacht de versie van uw site.
  • -downloadhotfix: Download alle hotfixes, ongeacht de versie van uw site.
  • -downloadsiteversion: download updates en hotfixes met een latere versie dan de versie van uw site.

Voorbeeld van verbinding maken zonder proxyserver

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

Voorbeeld van verbinding maken met een proxyserver

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

Voorbeeld van verbinding maken om alleen updates die van toepassing zijn op de siteversie te downloaden

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

-Dest

Een vereiste parameter met de parameter -export om het pad en de bestandsnaam op te geven van het CSV-bestand dat moet worden geëxporteerd. Zie -exporteren voor meer informatie.

-downloadalle

Een optionele parameter met de parameter -connect om alles te downloaden, inclusief updates en hotfixes, ongeacht de versie van uw site. Zie -connect voor meer informatie.

-downloadhotfix

Een optionele parameter met de parameter -connect om alleen alle hotfixes te downloaden, ongeacht de versie van uw site. Zie -connect voor meer informatie.

-downloadsiteversion

Een optionele parameter met de parameter -connect om alleen updates en hotfixes te downloaden die een latere versie dan de versie van uw site hebben. Zie -connect voor meer informatie.

-Exporteren

Gebruik tijdens de voorbereidingsfase om gebruiksgegevens te exporteren naar een CSV-bestand. Voer deze uit als beheerder op het serviceverbindingspunt. Met deze actie kunt u de inhoud van de gebruiksgegevens controleren voordat u uploadt naar Microsoft. Hiervoor is de parameter -dest vereist om de locatie van het CSV-bestand op te geven.

Voorbeeld van exporteren

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

-Importeren

Gebruik tijdens de importfase op het serviceverbindingspunt om de updates naar de site te importeren. Hiervoor is de parameter -updatepacksrc vereist om de locatie van de gedownloade updates op te geven.

Voorbeeld van importeren

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

-Voorbereiden

Gebruik tijdens de voorbereidingsfase op het serviceverbindingspunt om gebruiksgegevens van de site te exporteren. Hiervoor is de parameter -usagedatadest vereist om de locatie van het geëxporteerde gegevensbestand op te geven.

Voorbeeld van voorbereiden

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

-proxyserveruri

Een optionele parameter met de parameter -connect om de FQDN van uw proxyserver op te geven. Zie -connect voor meer informatie.

-proxyusername

Een optionele parameter met de parameter -connect om de gebruikersnaam voor verificatie bij uw proxyserver op te geven. Zie -connect voor meer informatie.

-updatepackdest

Een vereiste parameter met de parameter -connect om een pad voor de gedownloade updates op te geven. Zie -connect voor meer informatie.

-updatepacksrc

Een vereiste parameter met de parameter -import om een pad naar de gedownloade updates op te geven. Zie -importeren voor meer informatie.

-usagedatadest

Een vereiste parameter met de parameter -prepare om een pad en bestandsnaam van het geëxporteerde gegevensbestand op te geven. Zie voorbereiden voor meer informatie.

Volgende stappen

Updates in de console installeren

Diagnostische gegevens en gebruiksgegevens bekijken