Verwenden des Dienstverbindungstools für Configuration Manager
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, Ihren Standort 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 die x64-Dateien. Standardmäßig installiert Configuration Manager die x64-Version auf dem Computer, auf dem der Dienstverbindungspunkt gehostet wird. Dieses Tool erfordert das verteilbare Microsoft Visual C++ 2015-2019-Paket (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++ Redistributable neueste unterstützte Downloads.
Hinweis
Wenn ein Upgrade von einer Configuration Manager-Version vor 2107 nicht unterstützt 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.
Ab Version 2309 erfordert dieses Tool die Installation des ODBC-Treibers 18 für SQL Server (x64). Informationen zum Herunterladen dieser Komponente finden Sie unter Herunterladen des ODBC-Treibers für SQL Server.
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
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.
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.
Importieren: Führen Sie das Tool auf dem Dienstverbindungspunkt aus. Sie importiert die Updates und fügt sie Ihrer Website hinzu. Sie können diese Updates dann 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 auf dem Configuration Manager-Installationsmedium unter folgendem Pfad: SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe
. Verwenden Sie immer das Dienstverbindungstool, das der von Ihnen verwendeten Version von Configuration Manager entspricht. 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-Installationsmedienquelldateien 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
Öffnen Sie auf dem Computer, auf dem der Dienstverbindungspunkt gehostet wird, eine Eingabeaufforderung als Administrator, und wechseln Sie zum Speicherort des Tools. Beispiel:
cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\
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.
Nachdem das Tool den Export der Nutzungsdaten abgeschlossen hat, kopieren Sie die Datendatei auf einen Computer, der Zugriff auf das Internet hat.
Verbinden
Ö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 . Beispiel:
cd D:\USB\ServiceConnectionTool\
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.
Nachdem das Tool das Herunterladen der Updates abgeschlossen hat, kopieren Sie sie an den Dienstverbindungspunkt.
Import
Öffnen Sie auf dem Computer, auf dem der Dienstverbindungspunkt gehostet wird, eine Eingabeaufforderung als Administrator, und wechseln Sie zum Speicherort des Tools. Beispiel:
cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\
Führen Sie den folgenden Befehl aus, um die Updates zu importieren:
ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks
Schließen Sie nach Abschluss des Imports die Eingabeaufforderung. Es importiert nur Updates für die anwendbare Hierarchie.
Navigieren 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.