Verwenden des Dienstverbindungstools für Configuration Manager

  • Artikel

Gilt für: Configuration Manager (Current Branch)

Verwenden Sie das Dienstverbindungstool , wenn sich Ihr Dienstverbindungspunkt im Offlinemodus befindet. Sie können es auch verwenden, wenn Ihre Configuration Manager Standortsystemserver nicht mit dem Internet verbunden sind. Das Tool kann Ihnen helfen, Ihre Website mit den neuesten Updates für Configuration Manager auf dem neuesten Stand zu halten.

Wenn Sie das Tool ausführen, stellt es eine Verbindung mit dem Configuration Manager Clouddienst her, lädt Nutzungsinformationen für Ihre Hierarchie hoch und lädt Updates herunter. Das Hochladen von Nutzungsdaten ist erforderlich, damit der Clouddienst die richtigen Updates für Ihre Umgebung bereitstellen kann.

Voraussetzungen

  • Der Standort verfügt über einen Dienstverbindungspunkt, den Sie für eine bedarfsgesteuerte Offlineverbindung konfigurieren.

  • Führen Sie das Tool an einer Eingabeaufforderung als Administrator aus. Es gibt keine Benutzeroberfläche.

  • Sie führen das Tool über den Dienstverbindungspunkt und einen Computer aus, der eine Verbindung mit dem Internet herstellen kann. Jeder dieser Computer benötigt ein x64-Bit-Betriebssystem und die folgenden Komponenten:

    • Sowohl die Visual C++ Redistributable x86- als auch x64-Dateien. Standardmäßig installiert Configuration Manager die x64-Version auf dem Computer, auf dem der Dienstverbindungspunkt gehostet wird. Dieses Tool erfordert das Microsoft Visual C++ verteilbare Paket 2015-2019 (14.28.29914.0) oder höher auf dem Computer, auf dem Sie es ausführen. Informationen zum Herunterladen dieser Komponente finden Sie unter Microsoft Visual C++ Verteilbare neueste unterstützte Downloads.

      Hinweis

      Wenn ein Upgrade von einer nicht unterstützten Version von Configuration Manager vor 2107 durchgeführt wird, erfordert das Tool das Visual C++ 2013 redistributalbe packate (12.0.40660.0), das über denselben Link verfügbar ist.

    • Dieses Tool erfordert .NET-Version 4.6.2, und Version 4.8 wird empfohlen. Weitere Informationen finden Sie unter Voraussetzungen für Standort- und Standortsystem.

  • Das Konto, das Sie zum Ausführen des Tools verwenden, benötigt die folgenden Berechtigungen:

    • Lokaler Administrator auf dem Computer, der den Dienstverbindungspunkt hostet

    • Leseberechtigungen für die Standortdatenbank

  • Sie benötigen eine Methode zum Übertragen der Dateien zwischen dem Computer mit Internetzugriff und dem Dienstverbindungspunkt. Beispielsweise ein USB-Laufwerk mit ausreichend freiem Speicherplatz zum Speichern der Dateien und Updates.

Übersicht

  1. Vorbereiten: Führen Sie das Tool auf dem Dienstverbindungspunkt aus. Ihre Nutzungsdaten werden in einer .cab-Datei am angegebenen Speicherort gespeichert. Kopieren Sie die Datendatei auf den Computer mit einer Internetverbindung.

  2. Verbinden: Führen Sie das Tool auf dem Computer mit Internetverbindung aus. Es lädt Ihre Nutzungsdaten hoch und lädt dann Configuration Manager Updates herunter. Kopieren Sie die heruntergeladenen Updates auf den Dienstverbindungspunkt.

    Sie können mehrere Datendateien gleichzeitig hochladen, die jeweils aus einer anderen Hierarchie stammen. Sie können auch einen Proxyserver und einen Benutzer für den Proxyserver angeben.

  3. Importieren: Führen Sie das Tool auf dem Dienstverbindungspunkt aus. Sie importiert die Updates und fügt sie Ihrer Website hinzu. Anschließend können Sie diese Updates in der Configuration Manager-Konsole anzeigen und installieren.

Hochladen mehrerer Datendateien

  • Speichern Sie alle exportierten Datendateien aus separaten Hierarchien in demselben Ordner. Geben Sie jeder Datei einen eindeutigen Namen. Bei Bedarf können Sie sie manuell umbenennen.

  • Wenn Sie das Tool ausführen, um Daten in Microsoft hochzuladen, geben Sie den Ordner an, der die Datendateien enthält.

  • Wenn Sie das Tool ausführen, um Daten zu importieren, importiert das Tool nur die Daten für diese Hierarchie.

Angeben eines Proxyservers

Wenn der Computer mit einer Internetverbindung einen Proxyserver erfordert, unterstützt das Tool eine grundlegende Proxykonfiguration. Verwenden Sie die optionalen Parameter -proxyserveruri und -proxyusername. Weitere Informationen finden Sie unter Befehlszeilenparameter.

Geben Sie den Typ der herunterzuladenden Updates an.

Das Tool unterstützt Optionen, um zu steuern, welche Dateien Sie herunterladen. Standardmäßig lädt das Tool nur das neueste verfügbare Update herunter, das für die Version Ihrer Website gilt. Es werden keine Hotfixes heruntergeladen.

Um dieses Verhalten zu ändern, verwenden Sie einen der folgenden Parameter, um zu ändern, welche Dateien heruntergeladen werden:

  • -downloadall: Laden Sie alle Updates herunter, einschließlich Updates und Hotfixes, unabhängig von der Version Ihrer Website.

  • -downloadhotfix: Laden Sie alle Hotfixes unabhängig von der Version Ihrer Website herunter.

  • -downloadsiteversion: Lädt Updates und Hotfixes mit einer höheren Version als die Version Ihrer Website herunter.

    Wichtig

    Aufgrund eines bekannten Problems in Configuration Manager Version 2002 funktioniert das Standardverhalten nicht wie erwartet. Aktualisieren Sie auf Version 2006, oder verwenden Sie den Parameter -downloadsiteversion , um die erforderlichen Updates für Version 2002 herunterzuladen.

Weitere Informationen finden Sie unter Befehlszeilenparameter.

Tipp

Das Tool bestimmt die Version Ihrer Website aus der Datendatei. Um die Version zu überprüfen, suchen Sie in der .cab-Datei nach der Textdatei mit dem Namen mit der Websiteversion.

Verwenden des Tools

Das Dienstverbindungstool befindet sich im Configuration Manager Installationsmedium unter folgendem Pfad: SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe. Verwenden Sie immer das Dienstverbindungstool, das der Version von Configuration Manager entspricht, die Sie verwenden. Alle diese Dateien müssen sich im selben Ordner befinden, damit das Dienstverbindungstool funktioniert.

Kopieren Sie den Ordner ServiceConnectionTool mit dem gesamten Inhalt auf den Computer mit Internetverbindung.

In diesem Verfahren verwenden die Befehlszeilenbeispiele die folgenden Dateinamen und Ordnerspeicherorte. Sie müssen diese Pfade und Dateinamen nicht verwenden. Sie können Alternativen verwenden, die Ihrer Umgebung und Ihren Präferenzen entsprechen.

  • Der Pfad zu den Configuration Manager Installationsmedienquellendateien auf dem Dienstverbindungspunkt:C:\Source

  • Der Pfad zu einem USB-Laufwerk, auf dem Sie die Daten speichern, die zwischen Computern übertragen werden sollen: D:\USB\

  • Der Name der Datendatei, die Sie von der Website exportieren: UsageData.cab

  • Der Name des leeren Ordners, in dem das Tool heruntergeladene Updates für Configuration Manager speichert:UpdatePacks

Vorbereiten

  1. Öffnen Sie auf dem Computer, auf dem der Dienstverbindungspunkt gehostet wird, eine Eingabeaufforderung als Administrator, und wechseln Sie zum Speicherort des Tools. Zum Beispiel:

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

  2. Führen Sie den folgenden Befehl aus, um die Datendatei vorzubereiten:

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

    Hinweis

    Wenn Sie Datendateien aus mehreren Hierarchien gleichzeitig hochladen, geben Sie jeder Datendatei einen eindeutigen Namen. Bei Bedarf können Sie Dateien später umbenennen.

    Die Daten in der Datei basieren auf der Ebene der Diagnose- und Nutzungsdaten, die Sie für den Standort konfigurieren. Weitere Informationen finden Sie unter Übersicht über Diagnose- und Nutzungsdaten. Sie können das Tool verwenden, um die Daten in eine CSV-Datei zu exportieren, um den Inhalt anzuzeigen. Weitere Informationen finden Sie unter -export.

  3. Nachdem das Tool den Export der Nutzungsdaten abgeschlossen hat, kopieren Sie die Datendatei auf einen Computer, der Zugriff auf das Internet hat.

Verbinden

  1. Öffnen Sie auf dem Computer mit Internetzugriff eine Eingabeaufforderung als Administrator, und wechseln Sie zum Speicherort des Tools. Dieser Speicherort ist eine Kopie des gesamten ServiceConnectionTool-Ordners . Zum Beispiel:

    cd D:\USB\ServiceConnectionTool\

  2. Führen Sie den folgenden Befehl aus, um die Datendatei hochzuladen und die Configuration Manager-Updates herunterzuladen:

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

    Weitere Beispiele finden Sie unter Befehlszeilenparameter.

    Hinweis

    Wenn Sie diese Befehlszeile ausführen, wird möglicherweise der folgende Fehler angezeigt:

    Unbehandelte Ausnahme: System.UnauthorizedAccessException: Der Zugriff auf den Pfad "C:\Users\jqpublic\AppData\Local\Temp\extractmanifestcab\95F8A562.sql" wird verweigert.

    Sie können diesen Fehler ignorieren. Schließen Sie das Fehlerfenster, um den Vorgang fortzusetzen.

  3. Nachdem das Tool das Herunterladen der Updates abgeschlossen hat, kopieren Sie sie an den Dienstverbindungspunkt.

Import

  1. Öffnen Sie auf dem Computer, auf dem der Dienstverbindungspunkt gehostet wird, eine Eingabeaufforderung als Administrator, und wechseln Sie zum Speicherort des Tools. Zum Beispiel:

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

  2. Führen Sie den folgenden Befehl aus, um die Updates zu importieren:

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

  3. Schließen Sie nach Abschluss des Imports die Eingabeaufforderung. Es importiert nur Updates für die anwendbare Hierarchie.

  4. Wechseln Sie in der Configuration Manager-Konsole zum Arbeitsbereich Verwaltung, und wählen Sie den Knoten Updates und Wartung aus. Importierte Updates können jetzt installiert werden. Weitere Informationen finden Sie unter Installieren konsoleninterner Updates.

Protokolldateien

  • ServiceConnectionTool.log: Jedes Mal, wenn Sie das Dienstverbindungstool ausführen, schreibt es in diese Protokolldatei. Der Pfad der Protokolldatei ist immer derselbe Speicherort wie das Tool. Diese Protokolldatei enthält einfache Details zur Verwendung des Tools basierend auf den von Ihnen verwendeten Parametern. Jedes Mal, wenn Sie das Tool ausführen, ersetzt das Tool jede vorhandene Protokolldatei.

  • ConfigMgrSetup.log: Während der Verbindungsphase schreibt das Tool in diese Protokolldatei im Stammverzeichnis des Systemlaufwerks. Diese Protokolldatei enthält ausführlichere Informationen. Beispielsweise, welche Dateien das Tool herunterlädt und ob die Hashprüfungen erfolgreich sind.

Befehlszeilenparameter

In diesem Abschnitt werden alle verfügbaren Parameter für das Dienstverbindungstool in alphabetischer Reihenfolge aufgelistet.

-Verbinden

Verwenden Sie während der Verbindungsphase auf dem Computer mit Internetzugriff. Es stellt eine Verbindung mit dem Configuration Manager Clouddienst her, um die Datendatei hochzuladen und Updates herunterzuladen.

Hierfür sind die folgenden Parameter erforderlich:

  • -usagedatasrc: Der Speicherort der hochzuladenden Datendatei
  • -updatepackdest: Ein Pfad für die heruntergeladenen Updates

Sie können auch die folgenden optionalen Parameter verwenden:

  • -proxyserveruri: Der FQDN des Proxyservers
  • -proxyusername: Ein Benutzername für den Proxyserver
  • -downloadall: Laden Sie alles herunter, einschließlich Updates und Hotfixes, unabhängig von der Version Ihrer Website.
  • -downloadhotfix: Laden Sie alle Hotfixes herunter, unabhängig von der Version Ihrer Website.
  • -downloadsiteversion: Laden Sie Updates und Hotfixes herunter, die eine höhere Version als die Version Ihrer Website haben.

Beispiel für eine Verbindung ohne Proxyserver

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

Beispiel für eine Verbindung mit einem Proxyserver

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

Beispiel für eine Verbindung zum Herunterladen ausschließlich anwendbarer Updates der Websiteversion

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

-Dest

Ein erforderlicher Parameter mit dem Parameter -export , um den Pfad und Dateinamen der zu exportierenden CSV-Datei anzugeben. Weitere Informationen finden Sie unter -export.

-downloadall

Ein optionaler Parameter mit dem Parameter -connect , um alles herunterzuladen, einschließlich Updates und Hotfixes, unabhängig von der Version Ihrer Website. Weitere Informationen finden Sie unter -connect.

-downloadhotfix

Ein optionaler Parameter mit dem Parameter -connect , um nur alle Hotfixes herunterzuladen, unabhängig von der Version Ihrer Website. Weitere Informationen finden Sie unter -connect.

-downloadsiteversion

Ein optionaler Parameter mit dem Parameter -connect , um nur Updates und Hotfixes herunterzuladen, die eine höhere Version als die Version Ihrer Website aufweisen. Weitere Informationen finden Sie unter -connect.

-Exportieren

Verwenden Sie während der Vorbereitungsphase , um Nutzungsdaten in eine CSV-Datei zu exportieren. Führen Sie ihn als Administrator auf dem Dienstverbindungspunkt aus. Mit dieser Aktion können Sie den Inhalt der Nutzungsdaten überprüfen, bevor Sie auf Microsoft hochladen. Der Parameter -dest ist erforderlich, um den Speicherort der CSV-Datei anzugeben.

Beispiel für den Export

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

-Importieren

Verwenden Sie während der Importphase auf dem Dienstverbindungspunkt, um die Updates an den Standort zu importieren. Er erfordert den Parameter -updatepacksrc , um den Speicherort der heruntergeladenen Updates anzugeben.

Beispiel für den Import

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

-Zubereiten

Verwenden Sie während der Vorbereitungsphase auf dem Dienstverbindungspunkt, um Nutzungsdaten vom Standort zu exportieren. Er erfordert den Parameter -usagedatadest , um den Speicherort der exportierten Datendatei anzugeben.

Beispiel für die Vorbereitung

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

-proxyserveruri

Ein optionaler Parameter mit dem Parameter -connect , um den FQDN Ihres Proxyservers anzugeben. Weitere Informationen finden Sie unter -connect.

-proxyusername

Ein optionaler Parameter mit dem Parameter -connect , um den Benutzernamen anzugeben, der bei Ihrem Proxyserver authentifiziert werden soll. Weitere Informationen finden Sie unter -connect.

-updatepackdest

Ein erforderlicher Parameter mit dem Parameter -connect , um einen Pfad für die heruntergeladenen Updates anzugeben. Weitere Informationen finden Sie unter -connect.

-updatepacksrc

Ein erforderlicher Parameter mit dem Parameter -import , um einen Pfad der heruntergeladenen Updates anzugeben. Weitere Informationen finden Sie unter -import.

-usagedatadest

Ein erforderlicher Parameter mit dem Parameter -prepare , um einen Pfad und Dateinamen der exportierten Datendatei anzugeben. Weitere Informationen finden Sie unter -prepare.

Nächste Schritte

Installieren konsoleninterner Updates

So zeigen Sie Diagnose- und Nutzungsdaten an