Korzystanie z narzędzia połączenia z usługą dla programu Configuration Manager
Dotyczy: programu Configuration Manager (bieżąca gałąź)
Użyj narzędzia połączenia z usługą , gdy punkt połączenia usługi jest w trybie offline. Można go również użyć, gdy serwery systemu lokacji programu Configuration Manager nie są połączone z Internetem. To narzędzie może ułatwić aktualizowanie witryny przy użyciu najnowszych aktualizacji programu Configuration Manager.
Po uruchomieniu narzędzia nawiązuje ono połączenie z usługą w chmurze programu Configuration Manager, przekazuje informacje o użyciu hierarchii i pobiera aktualizacje. Przekazywanie danych użycia jest niezbędne do umożliwienia usłudze w chmurze dostarczania odpowiednich aktualizacji dla środowiska.
Wymagania wstępne
Lokacja ma punkt połączenia z usługą i konfigurujesz ją dla połączenia offline na żądanie.
Uruchom narzędzie w wierszu polecenia jako administrator. Nie ma interfejsu użytkownika.
Narzędzie jest uruchamiane z punktu połączenia z usługą i komputera, który może łączyć się z Internetem. Każdy z tych komputerów musi mieć x64-bitowy system operacyjny i mieć następujące składniki:
Pliki redystrybucyjne Visual C++ x86 i x64. Domyślnie program Configuration Manager instaluje wersję x64 na komputerze hostującym punkt połączenia z usługą. To narzędzie wymaga pakietu redystrybucyjnego Microsoft Visual C++ 2015-2019 (14.28.29914.0) lub nowszego na komputerze, z który jest uruchomiony. Aby pobrać ten składnik, zobacz Artykuł Microsoft Visual C++ Redistributable latest supported downloads (Microsoft Visual C++ Redistributable — najnowsze obsługiwane pliki do pobrania).
Uwaga
W przypadku uaktualniania z wersji programu Configuration Manager spoza obsługi przed 2107 r. narzędzie wymaga pakietu redystrybucyjnego Visual C++ 2013 (12.0.40660.0), który jest dostępny z tego samego linku.
To narzędzie wymaga platformy .NET w wersji 4.6.2 i zalecana jest wersja 4.8. Aby uzyskać więcej informacji, zobacz Wymagania wstępne dotyczące lokacji i systemu lokacji.
Począwszy od wersji 2309, to narzędzie wymaga instalacji sterownika ODBC 18 dla programu SQL Server (x64). Aby pobrać ten składnik, zobacz Pobieranie sterownika ODBC dla programu SQL Server.
Konto używane do uruchamiania narzędzia wymaga następujących uprawnień:
Administrator lokalny na komputerze hostującym punkt połączenia z usługą
Uprawnienia do odczytu bazy danych lokacji
Potrzebna jest metoda transferu plików między komputerem z dostępem do Internetu i punktem połączenia z usługą. Na przykład dysk USB z wystarczającą ilością wolnego miejsca do przechowywania plików i aktualizacji.
Omówienie
Przygotowanie: uruchom narzędzie w punkcie połączenia z usługą. Umieszcza dane użycia w pliku .cab w określonej lokalizacji. Skopiuj plik danych na komputer przy użyciu połączenia internetowego.
Połącz: uruchom narzędzie na komputerze z połączeniem internetowym. Przekazuje dane użycia, a następnie pobiera aktualizacje programu Configuration Manager. Skopiuj pobrane aktualizacje do punktu połączenia z usługą.
Możesz przekazać wiele plików danych jednocześnie, z których każdy pochodzi z innej hierarchii. Można również określić serwer proxy i użytkownika dla serwera proxy.
Importuj: uruchom narzędzie w punkcie połączenia z usługą. Importuje aktualizacje i dodaje je do witryny. Następnie możesz wyświetlić i zainstalować te aktualizacje w konsoli programu Configuration Manager.
Przekazywanie wielu plików danych
Umieść wszystkie wyeksportowane pliki danych z oddzielnych hierarchii w tym samym folderze. Nadaj każdemu plikowi unikatową nazwę. W razie potrzeby można ręcznie zmienić ich nazwę.
Po uruchomieniu narzędzia do przekazywania danych do firmy Microsoft należy określić folder zawierający pliki danych.
Po uruchomieniu narzędzia do importowania danych narzędzie importuje tylko dane dla tej hierarchii.
Określanie serwera proxy
Jeśli komputer z połączeniem internetowym wymaga serwera proxy, narzędzie obsługuje podstawową konfigurację serwera proxy. Użyj opcjonalnych parametrów -proxyserveruri i -proxyusername. Aby uzyskać więcej informacji, zobacz Parametry wiersza polecenia.
Określanie typu aktualizacji do pobrania
Narzędzie obsługuje opcje kontrolowania pobieranych plików. Domyślnie narzędzie pobiera tylko najnowszą dostępną aktualizację, która ma zastosowanie do wersji witryny. Nie pobiera poprawek.
Aby zmodyfikować to zachowanie, użyj jednego z następujących parametrów, aby zmienić pliki, które pobiera:
-downloadall: Pobierz wszystkie aktualizacje, w tym aktualizacje i poprawki, niezależnie od wersji witryny.
-downloadhotfix: Pobierz wszystkie poprawki niezależnie od wersji witryny.
-downloadsiteversion: pobiera aktualizacje i poprawki w nowszej wersji niż wersja witryny.
Ważna
Ze względu na znany problem w programie Configuration Manager w wersji 2002 domyślne zachowanie nie działa zgodnie z oczekiwaniami. Zaktualizuj do wersji 2006 lub użyj parametru -downloadsiteversion , aby pobrać niezbędne aktualizacje dla wersji 2002.
Aby uzyskać więcej informacji, zobacz Parametry wiersza polecenia.
Porada
Narzędzie określa wersję witryny na podstawie pliku danych. Aby zweryfikować wersję, poszukaj w pliku .cab pliku tekstowego o nazwie z wersją witryny.
Korzystanie z narzędzia
Narzędzie połączenia z usługą znajduje się w nośniku instalacyjnym programu Configuration Manager w następującej ścieżce: SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe
. Zawsze używaj narzędzia połączenia z usługą zgodnego z używaną wersją programu Configuration Manager. Wszystkie te pliki muszą znajdować się w tym samym folderze, aby narzędzie połączenia z usługą działało.
Skopiuj folder ServiceConnectionTool z całą jego zawartością na komputer z połączeniem internetowym.
W tej procedurze przykłady wiersza polecenia używają następujących nazw plików i lokalizacji folderów. Nie musisz używać tych ścieżek i nazw plików. Możesz użyć alternatyw zgodnych ze środowiskiem i preferencjami.
Ścieżka do plików źródłowych nośników instalacyjnych programu Configuration Manager w punkcie połączenia z usługą:
C:\Source
Ścieżka do dysku USB, w którym są przechowywane dane do transferu między komputerami:
D:\USB\
Nazwa pliku danych eksportowane z witryny:
UsageData.cab
Nazwa pustego folderu, w którym narzędzie przechowuje pobrane aktualizacje programu Configuration Manager:
UpdatePacks
Przygotowanie
Na komputerze hostującym punkt połączenia z usługą otwórz wiersz polecenia jako administrator i zmień katalog na lokalizację narzędzia. Przykład:
cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\
Uruchom następujące polecenie, aby przygotować plik danych:
ServiceConnectionTool.exe -prepare -usagedatadest D:\USB\UsageData.cab
Uwaga
Jeśli jednocześnie przekażesz pliki danych z więcej niż jednej hierarchii, nadaj każdemu plikowi danych unikatową nazwę. W razie potrzeby można później zmienić nazwę plików.
Dane w pliku są oparte na poziomie danych diagnostycznych i danych użycia skonfigurowanych dla lokacji. Aby uzyskać więcej informacji, zobacz Omówienie danych diagnostycznych i danych użycia. Za pomocą narzędzia możesz wyeksportować dane do pliku CSV w celu wyświetlenia zawartości. Aby uzyskać więcej informacji, zobacz -export.
Po zakończeniu eksportowania danych użycia narzędzia skopiuj plik danych na komputer z dostępem do Internetu.
Nawiązywanie połączeń
Na komputerze z dostępem do Internetu otwórz wiersz polecenia jako administrator i zmień katalog na lokalizację narzędzia. Ta lokalizacja jest kopią całego folderu ServiceConnectionTool . Przykład:
cd D:\USB\ServiceConnectionTool\
Uruchom następujące polecenie, aby przekazać plik danych i pobrać aktualizacje programu Configuration Manager:
ServiceConnectionTool.exe -connect -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks
Aby uzyskać więcej przykładów, zobacz Parametry wiersza polecenia.
Uwaga
Po uruchomieniu tego wiersza polecenia może zostać wyświetlony następujący błąd:
Nieobsługiwany wyjątek: System.UnauthorizedAccessException: odmowa dostępu do ścieżki "C:\Users\jqpublic\AppData\Local\Temp\extractmanifestcab\95F8A562.sql".
Ten błąd można bezpiecznie zignorować. Zamknij okno błędu, aby kontynuować.
Po zakończeniu pobierania aktualizacji przez narzędzie skopiuj je do punktu połączenia z usługą.
Importowanie
Na komputerze hostującym punkt połączenia z usługą otwórz wiersz polecenia jako administrator i zmień katalog na lokalizację narzędzia. Przykład:
cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\
Uruchom następujące polecenie, aby zaimportować aktualizacje:
ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks
Po zakończeniu importowania zamknij wiersz polecenia. Importuje tylko aktualizacje dla odpowiedniej hierarchii.
W konsoli programu Configuration Manager przejdź do obszaru roboczego Administracja i wybierz węzeł Aktualizacje i obsługa . Zaimportowane aktualizacje są teraz dostępne do zainstalowania. Aby uzyskać więcej informacji, zobacz Instalowanie aktualizacji w konsoli.
Pliki dziennika
ServiceConnectionTool.log: za każdym razem, gdy uruchamiasz narzędzie połączenia z usługą, zapisuje ono w tym pliku dziennika. Ścieżka pliku dziennika jest zawsze tą samą lokalizacją co narzędzie. Ten plik dziennika zawiera proste szczegóły dotyczące użycia narzędzia na podstawie używanych parametrów. Za każdym razem, gdy uruchamiasz narzędzie, narzędzie zastępuje dowolny istniejący plik dziennika.
ConfigMgrSetup.log: W fazie Nawiązywanie połączenia narzędzie zapisuje w tym pliku dziennika w katalogu głównym dysku systemowego. Ten plik dziennika zawiera bardziej szczegółowe informacje. Na przykład jakie pliki pobiera narzędzie i czy sprawdzanie wartości skrótu zakończyło się pomyślnie.
Parametry wiersza polecenia
W tej sekcji wymieniono w kolejności alfabetycznej wszystkie dostępne parametry narzędzia do połączenia z usługą.
-połączyć
Użyj w fazie Nawiązywanie połączenia na komputerze z dostępem do Internetu. Nawiązuje połączenie z usługą w chmurze programu Configuration Manager, aby przekazać plik danych i pobrać aktualizacje.
Wymaga to następujących parametrów:
- -usagedatasrc: lokalizacja pliku danych do przekazania
- -updatepackdest: ścieżka dla pobranych aktualizacji
Można również użyć następujących parametrów opcjonalnych:
- -proxyserveruri: nazwa FQDN serwera proxy
- -proxyusername: nazwa użytkownika serwera proxy
- -downloadall: Pobierz wszystko, w tym aktualizacje i poprawki, niezależnie od wersji witryny.
- -downloadhotfix: Pobierz wszystkie poprawki, niezależnie od wersji witryny.
- -downloadsiteversion: Pobierz aktualizacje i poprawki, które mają nowszą wersję niż wersja witryny.
Przykład nawiązywania połączenia bez serwera proxy
ServiceConnectionTool.exe -connect -usagedatasrc D:\USB\ -updatepackdest D:\USB\UpdatePacks
Przykład nawiązywania połączenia z serwerem proxy
ServiceConnectionTool.exe -connect -usagedatasrc D:\USB\Usagedata.cab -updatepackdest D:\USB\UpdatePacks -proxyserveruri itproxy.contoso.com -proxyusername jqpublic
Przykład połączenia w celu pobrania tylko odpowiednich aktualizacji wersji witryny
ServiceConnectionTool.exe -connect -downloadsiteversion -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks
-dest
Wymagany parametr z parametrem -export , aby określić ścieżkę i nazwę pliku CSV do wyeksportowania. Aby uzyskać więcej informacji, zobacz -export.
-downloadall
Opcjonalny parametr z parametrem -connect umożliwiającym pobranie wszystkich elementów, w tym aktualizacji i poprawek niezależnie od wersji witryny. Aby uzyskać więcej informacji, zobacz -connect.
-downloadhotfix
Opcjonalny parametr z parametrem -connect umożliwiającym pobranie tylko wszystkich poprawek niezależnie od wersji witryny. Aby uzyskać więcej informacji, zobacz -connect.
-downloadsiteversion
Opcjonalny parametr z parametrem -connect umożliwiający pobieranie tylko aktualizacji i poprawek, które mają nowszą wersję niż wersja witryny. Aby uzyskać więcej informacji, zobacz -connect.
-eksport
Użyj podczas fazy przygotowywania , aby wyeksportować dane użycia do pliku CSV. Uruchom go jako administrator w punkcie połączenia z usługą. Ta akcja umożliwia przejrzenie zawartości danych użycia przed przekazaniem do firmy Microsoft. Wymaga parametru -dest , aby określić lokalizację pliku CSV.
Przykład eksportu
-export -dest D:\USB\usagedata.csv
-import
Użyj w fazie importowania w punkcie połączenia z usługą, aby zaimportować aktualizacje do lokacji. Wymaga parametru -updatepacksrc , aby określić lokalizację pobranych aktualizacji.
Przykład importowania
ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks
-przygotować
Użyj w fazie Przygotowania w punkcie połączenia z usługą, aby wyeksportować dane użycia z lokacji. Wymaga parametru -usagedatadest , aby określić lokalizację wyeksportowanego pliku danych.
Przykład przygotowania
ServiceConnectionTool.exe -prepare -usagedatadest D:\USB\UsageData.cab
-proxyserveruri
Opcjonalny parametr z parametrem -connect w celu określenia nazwy FQDN serwera proxy. Aby uzyskać więcej informacji, zobacz -connect.
-proxyusername
Opcjonalny parametr z parametrem -connect w celu określenia nazwy użytkownika do uwierzytelniania na serwerze proxy. Aby uzyskać więcej informacji, zobacz -connect.
-updatepackdest
Wymagany parametr z parametrem -connect w celu określenia ścieżki dla pobranych aktualizacji. Aby uzyskać więcej informacji, zobacz -connect.
-updatepacksrc
Wymagany parametr z parametrem -import w celu określenia ścieżki pobranych aktualizacji. Aby uzyskać więcej informacji, zobacz -import.
-usagedatadest
Wymagany parametr z parametrem -prepare w celu określenia ścieżki i nazwy pliku wyeksportowanego pliku danych. Aby uzyskać więcej informacji, zobacz -prepare.