Tworzenie, konserwację i wdrażanie instalacji sieciowej programu Visual Studio

Dotyczy:takprogramu Visual Studio nie Visual Studio dla komputerów Mac nie Visual Studio Code

Czasami administrator przedsiębiorstwa chce utworzyć punkt instalacji sieci zawierający pliki programu Visual Studio, które można wdrożyć na stacjach roboczych klienta. Jest to ułatwienie scenariuszy, w których maszyny klienckie mogą mieć ograniczone uprawnienia lub ograniczony dostęp do Internetu lub gdy organizacja chce ustandaryzować określoną wersję zestawu narzędzi deweloperskich. Zaprojektowaliśmy program Visual Studio, aby administrator mógł tworzyć i obsługiwać układ sieciowy (pamięć podręczna plików), który może być przechowywany w wewnętrznym udziale sieciowym. Układ sieciowy zawiera wszystkie pliki programu Visual Studio niezbędne zarówno do wstępnej instalacji, jak i kolejnych aktualizacji produktów.

Na tej stronie internetowej znajduje się wiele informacji, które są pogrupowane w następujące sekcje:

Przed rozpoczęciem

Istnieje kilka ważnych rzeczy, które należy zaplanować i pamiętać o tym przed rozpoczęciem pracy.

  • Zarządzanie folderami: Jeśli w przedsiębiorstwie jest używanych wiele wersji programu Visual Studio (na przykład Visual Studio 2019 Professional i Visual Studio 2019 Enterprise), musisz utworzyć oddzielny punkt instalacji sieci dla każdej edycji. Ponadto ścieżka układu musi być mniejsza niż 80 znaków, chociaż niektóre organizacje pomyślnie używały linków symbolicznych do obejścia ograniczenia 80 znaków.
  • Planowanie Aktualizacje: przed rozpoczęciem instalacji klienta należy zdecydować, w jaki sposób komputery klienckie powinny otrzymywać aktualizacje produktów. Jest to konieczne, aby upewnić się, że konfiguracja lokalizacji aktualizacji klienta jest poprawnie ustawiona. Wybrane opcje obejmują pobieranie aktualizacji przez klientów z lokalizacji układu sieciowego lub z serwerów hostowanych przez firmę Microsoft w Internecie.

Ważne

Następujące ograniczenie istnieje z zarządzaniem układem, gdy używasz tylko funkcji programu Visual Studio 2019: po zainstalowaniu klienta z układu lokalizacja aktualizacji klienta jest zablokowana i niezmienialna. Oznacza to, że jeśli klienci będą otrzymywać aktualizacje z układu, zachowując ich funkcjonalność naprawy i odinstalowywania, należy umieścić wszystkie kolejne aktualizacje produktu w oryginalnym folderze układu zainstalowanym przez klientów. Innymi słowy, podstawowa funkcja programu Visual Studio 2019 nie obsługuje możliwości wykonania oryginalnej instalacji przez klienta z jednej lokalizacji układu, a następnie klient otrzymuje aktualizację produktu z innej lokalizacji układu.

To ograniczenie, w którym lokalizacja aktualizacji produktu jest stała, a aktualizacje produktu muszą znajdować się w tym samym folderze układu, co oryginalny układ instalacji nie istnieje w programie Visual Studio 2022. W programie Visual Studio 2022 można łatwo zmienić lokalizację źródłową klienta pod kątem aktualizacji. Umożliwiliśmy dołączanie i używanie najnowszego instalatora (Visual Studio 2022), który zarządza wszystkimi nowoczesnymi wersjami rodziny produktów Visual Studio, aby zarządzać układami programu Visual Studio 2019 i wyeliminować ograniczenie w wersji produktu 2019. W poniższej sekcji Skonfiguruj układ, aby zawsze uwzględniał i udostępniał najnowszy instalator , opisano sposób włączania tego układu.

  • Zarządzanie folderami: Jeśli w przedsiębiorstwie jest używanych wiele wersji programu Visual Studio (na przykład Visual Studio 2022 Professional i Visual Studio 2022 Enterprise), musisz utworzyć oddzielny punkt instalacji sieci dla każdej edycji. Ponadto ścieżka układu musi być mniejsza niż 80 znaków, chociaż niektóre organizacje pomyślnie używały linków symbolicznych do obejścia ograniczenia 80 znaków.
  • Planowanie Aktualizacje: zalecamy podjęcie decyzji, w jaki sposób maszyny klienckie powinny otrzymywać aktualizacje produktów przed rozpoczęciem instalacji klienta. Ma to na celu upewnienie się, że konfiguracja lokalizacji aktualizacji klienta jest poprawnie zainicjowana. Wybrane opcje obejmują pobieranie aktualizacji przez klientów z lokalizacji układu sieciowego lub z serwerów hostowanych przez firmę Microsoft w Internecie. Na szczęście można również skonfigurować lokalizację źródłową klienta pod kątem aktualizacji po wystąpieniu początkowej instalacji.

Pobierz program rozruchowy programu Visual Studio, aby utworzyć układ sieci

Pobierz program rozruchowy dla żądanej wersji programu Visual Studio i skopiuj go do katalogu, który chcesz służyć jako lokalizacja źródłowa układu. Po utworzeniu układu można go użyć do zainstalowania programu Visual Studio na dowolnej maszynie klienckiej. Program uruchamiający to plik wykonywalny używany do tworzenia, aktualizowania i wykonywania innych operacji układu. Aby wykonać ten krok, musisz mieć połączenie internetowe.

Programy uruchamiane wymienione poniżej będą zawsze instalować najnowszą najbezpieczniejszą wersję programu Visual Studio 2019, bez względu na to, kiedy je uruchamiasz. Alternatywnie, jeśli chcesz utworzyć lub zaktualizować układ do określonej wersji programu Visual Studio 2019, przejdź do strony Wydania programu Visual Studio 2019 , która zawiera linki do stałych programów rozruchowych wersji dla każdej wersji obsługi i pobierz odpowiedni. Skopiuj go do katalogu, który chcesz służyć jako lokalizacja źródłowa układu.

Wersja Program inicjujący
Visual Studio 2019 Enterprise w wersji 16.11 vs_enterprise.exe
Visual Studio 2019 Professional w wersji 16.11 vs_professional.exe
Visual Studio 2019 Build Tools w wersji 16.11 vs_buildtools.exe

Inne obsługiwane programi rozruchowe obejmują vs_teamexplorer.exe, vs_testagent.exei vs_testcontroller.exe.

Programy uruchamiane wymienione poniżej będą zawsze instalować najnowszą najbezpieczniejszą wersję programu Visual Studio 2022 w bieżącym kanale, bez względu na to, kiedy je uruchamiasz. Alternatywnie, jeśli chcesz utworzyć lub zaktualizować układ do określonej wersji lub określonego kanału programu Visual Studio 2022, przejdź do strony Historia wersji programu Visual Studio 2022 , która zawiera linki do evergreen i fixed version bootstrappers dla każdej wersji obsługi w każdym kanale, a następnie pobierz odpowiedni. Skopiuj go do katalogu, który chcesz służyć jako lokalizacja źródłowa układu.

Wersja Program inicjujący
Visual Studio 2022 Enterprise vs_enterprise.exe
Visual Studio 2022 Professional vs_professional.exe
Visual Studio 2022 Build Tools vs_buildtools.exe

Porada

Jeśli wcześniej pobrano plik programu uruchamiającego i chcesz sprawdzić, jaka jest wersja, oto jak to zrobić. W systemie Windows otwórz Eksplorator plików, kliknij prawym przyciskiem myszy plik programu bootstrapper, wybierz polecenie Właściwości, wybierz kartę Szczegóły, a następnie wyświetl numer wersji produktu. Aby dopasować ten numer do wersji programu Visual Studio, zapoznaj się z tabelą w dolnej części strony Wydania programu Visual Studio 2019 .

Porada

Jeśli wcześniej pobrano plik programu uruchamiającego i chcesz sprawdzić, jaka wersja zostanie zainstalowana, poniżej przedstawiono sposób. W systemie Windows otwórz Eksplorator plików, kliknij prawym przyciskiem myszy plik bootstrapper, wybierz polecenie Właściwości, a następnie wybierz kartę Szczegóły. Pole Wersja produktu będzie opisywać kanał i wersję, którą zainstaluje program uruchamiający. Numer wersji powinien być zawsze odczytywany jako "najnowsza wersja obsługi określona", a kanał ma być bieżący, chyba że określono jawnie. Dlatego program rozruchowy z wersją Produktu LTSC 17.0 zainstaluje najnowszą wersję serwisową 17.0.x, która jest dostępna w kanale LTSC 17.0. Program uruchamiający z wersją produktu, która po prostu mówi, że program Visual Studio 2022 zainstaluje najnowszą wersję obsługi programu Visual Studio 2022 w bieżącym kanale.

Tworzenie układu sieciowego

Aby wykonać ten krok, musisz mieć połączenie internetowe.

Otwórz wiersz polecenia z uprawnieniami administratora, przejdź do katalogu pobranego do programu bootstrapper i użyj parametrów programu bootstrapper zgodnie z definicją w parametrach wiersza polecenia, aby zainstalować stronę programu Visual Studio w celu utworzenia i utrzymania układu sieciowego. Poniżej przedstawiono typowe przykłady tworzenia układów początkowych i przykładów parametrów wiersza polecenia dla strony instalacji programu Visual Studio .

Kompletny początkowy układ ustawień regionalnych pojedynczego języka wymaga około 35 GB miejsca na dysku dla Visual Studio Community i 45 GB dla Visual Studio Enterprise. Dodatkowe ustawienia regionalne języka wymagają około pół GB każdego z nich.

Zalecaną metodą jest utworzenie początkowego układu Visual Studio Enterprise ze wszystkimi językami i wszystkimi obciążeniami w katalogu układu na serwerze sieciowym. W ten sposób klienci będą mieli dostęp do całej oferty produktów. Aby utworzyć pełny układ programu Visual Studio, uruchom następujące polecenie na maszynie, na której planujesz hostować układ sieciowy:

vs_enterprise.exe --layout c:\VSLayout

Upewnij się, że układ ma poprawny kanał

Ważne jest, aby upewnić się, że układ sieciowy jest oparty na poprawnym kanale, ponieważ jest to jedno z kryteriów, które administrator aktualizuje, jeśli są wdrażane w całej organizacji, użyj polecenia w celu zidentyfikowania, które wystąpienia klientów powinny zostać zaktualizowane. Jeśli na przykład układ jest oparty na kanale VisualStudio.17.Release.LTSC.17.0 i jeśli klienci są skonfigurowani do odbierania aktualizacji z serwerów hostowanych przez firmę Microsoft, wszelkie aktualizacje zabezpieczeń udostępniane w kanale LTSC 17.0 będą dostępne dla klientów, którzy zostali zainstalowani lub zaktualizowani z tego układu.

Wymienione powyżej bootstrappers są oparte na kanale Current. Aby utworzyć układ oparty na jednym z kanałów LTSC, po prostu uzyskaj program rozruchowy poprawnego kanału na stronie Historia wydania programu Visual Studio 2022 , skopiuj go do folderu układu i użyj go do utworzenia lub zaktualizowania układu.

Konfigurowanie zawartości układu sieciowego

Istnieje kilka opcji, których można użyć do dostosowania zawartości układu sieciowego. Można utworzyć układ częściowy, który zawiera tylko określony zestaw ustawień regionalnych języka, obciążeń, składników i ich zalecanych lub opcjonalnych zależności. Może to być przydatne, jeśli wiesz, że zamierzasz wdrożyć tylko podzbiór obciążeń na stacjach roboczych klienckich. Typowe parametry wiersza polecenia do dostosowywania układu obejmują:

  • --add aby określić identyfikatory obciążeń lub składników.
    Jeśli --add jest używany, pobierane są tylko te obciążenia i składniki określone za pomocą --add polecenia. Jeśli --add nie jest używany, wszystkie obciążenia i składniki zostaną pobrane.
  • --includeRecommended w celu uwzględnienia wszystkich zalecanych składników dla określonych identyfikatorów obciążeń.
  • --includeOptional w celu uwzględnienia wszystkich opcjonalnych składników dla określonych identyfikatorów obciążeń.
  • --lang aby określić ustawienia regionalne języka.

Poniżej przedstawiono kilka przykładów tworzenia niestandardowego układu częściowego.

  • Aby utworzyć układ ze wszystkimi obciążeniami i składnikami tylko dla jednego języka, uruchom polecenie:

    vs_enterprise.exe --layout C:\VSLayout --lang en-US
    
  • Aby utworzyć układ ze wszystkimi obciążeniami i składnikami dla wielu języków, uruchom polecenie:

    vs_enterprise.exe --layout C:\VSLayout --lang en-US de-DE ja-JP
    
  • Aby utworzyć układ z jednym obciążeniem i wszystkimi zalecanymi składnikami dla tego obciążenia, uruchom polecenie dla wszystkich języków:

    vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --includeRecommended
    
  • Aby utworzyć układ z dwoma obciążeniami i jednym opcjonalnym składnikiem dla trzech języków, uruchom polecenie:

    vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Component.Git --lang en-US de-DE ja-JP
    
  • Aby utworzyć układ z dwoma obciążeniami i wszystkimi zalecanymi i opcjonalnymi składnikami, uruchom polecenie:

    vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --includeOptional
    

Upewnij się, że układ korzysta z najnowszego instalatora

Zalecamy, aby zawsze używać najnowszego instalatora programu Visual Studio w układzie i dystrybuować go do klientów. Dzięki temu będziesz mieć dostęp do nowych funkcji i funkcji udostępnianych w kolejnych wersjach produktu. Na przykład w przypadku dystrybucji Instalatora programu Visual Studio 2022 w układach programu Visual Studio 2019 klienci programu Visual Studio 2019 na podstawie tego układu będą mieli możliwość zmiany lokalizacji źródłowej aktualizacji. Scenariusz, w którym ta funkcja byłaby przydatna, to jeśli chcesz zainstalować z jednego układu, ale aktualizacje pochodzą z innego układu. Dalsze szczegóły, w tym sposób wyłączania korzystania z najnowszego instalatora, opisano poniżej

Ważne

Ta możliwość korzystania z najnowszego instalatora jest dostępna tylko dla programu Visual Studio 2019 bootstrappers, które zostały utworzone po pierwotnie dostarczonym programie Visual Studio 2022. Dlatego vs_enterprise.exe w poniższym przykładzie musi być wersją dostarczoną po 10 listopada 2021 r.

  • Aby utworzyć układ całego produktu, który używa najnowszego i największego dostępnego instalatora, uruchom polecenie
    vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
    

Kopiowanie układu do udziału sieciowego

Należy hostować układ w udziale sieciowym, aby można było go uruchomić z maszyn klienckich. Jeśli układ został utworzony na komputerze lokalnym, należy skopiować go do lokalizacji sieciowej. W poniższym przykładzie użyto metody xcopy. Możesz również użyć polecenia robocopy, jeśli chcesz. Przykład:

xcopy /e c:\VSLayout \\server\share\layoutdirectory

Ważne

Aby zapobiec błędowi, upewnij się, że pełna ścieżka układu w udziale sieciowym jest mniejsza niż 80 znaków. Lub niektóre organizacje pomyślnie użyły linków symbolicznych , aby obejść ograniczenie 80 znaków.

Aktualizowanie lub modyfikowanie układu

Można zaktualizować układ sieciowy programu Visual Studio przy użyciu najnowszych aktualizacji produktu, aby można było go użyć zarówno jako punktu instalacji, jak i źródła aktualizacji dla stacji roboczych klienckich, aby otrzymywać najnowszą wersję programu Visual Studio. Najlepszym rozwiązaniem jest okresowe aktualizowanie układu, szczególnie jeśli zamierzasz, aby klienci otrzymywali aktualizacje z układu. W tej sekcji opisano najbardziej typowe lub przydatne operacje konserwacji układu.

Jeśli hostujesz układ w udziale plików, możesz zaktualizować prywatną kopię układu (na przykład c:\VSLayout), a następnie po pobraniu całej zaktualizowanej zawartości skopiuj ją do udziału plików (na przykład \\server\products\VS). Jeśli tego nie zrobisz, istnieje większe prawdopodobieństwo, że wszyscy użytkownicy, którzy uruchamiają instalatora podczas aktualizowania układu, mogą uzyskać niezgodność zawartości z układu, ponieważ nie została jeszcze całkowicie zaktualizowana.

Aktualizowanie układu do najnowszej wersji produktu

Firma Microsoft często publikuje zaktualizowane wersje produktu, aby rozwiązać problemy z funkcjonalnością lub zabezpieczeniami. Zalecamy, aby układ był aktualizowany przy użyciu najnowszej wersji produktu, aby nowi klienci zawsze otrzymywali najnowsze dobro. Ważne jest również, aby układ był aktualizowany, jeśli klienci są skonfigurowani do odbierania aktualizacji z układu.

Podczas tworzenia układu początkowego określone opcje, takie jak obciążenia i języki do uwzględnienia w układzie, są zapisywane w pliku konfiguracji układu. Później, gdy chcesz zaktualizować ten układ do nowszej wersji produktu, nie musisz ponownie określać opcji używanych podczas tworzenia początkowego układu. Polecenia aktualizacji układu automatycznie używają zapisanych ustawień układu.

Załóżmy, że ten układ częściowy został już utworzony przy użyciu jednego z evergreen bootstrappers w powyższej tabeli.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --lang en-US

Aktualizowanie tego układu do najnowszej wersji produktu oferowanego przez firmę Microsoft i hostowanego na serwerach firmy Microsoft jest łatwe. Wystarczy użyć tego samego evergreen bootstrapper i ponownie uruchomić --layout polecenie, aby pobrać najnowsze pakiety do układu.

vs_enterprise.exe --layout c:\VSLayout

Układ można również zaktualizować do nowszej wersji w sposób nienadzorowany. Operacja układu uruchamia proces instalacji w nowym oknie konsoli. Okno zostało otwarte, aby użytkownicy mogli zobaczyć wynik końcowy i podsumowanie wszelkich błędów, które mogły wystąpić. Jeśli wykonujesz operację układu w sposób nienadzorowany (na przykład masz skrypt, który jest regularnie uruchamiany w celu zaktualizowania układu do najnowszej wersji), użyj parametru --passive , a proces automatycznie zamknie okno.

vs_enterprise.exe --layout c:\VSLayout --passive

Aktualizowanie układu do określonej wersji produktu

Czasami warto zaktualizować układ do określonej wersji produktu. Na przykład układ może być zgodny z najnowszą bezpieczną wersją planu bazowego obsługi, która została ustandaryzowana w organizacji. Oto jak to zrobić:

Możesz przejść do strony Wydania programu Visual Studio 2019 i pobrać określony program rozruchowy stałej wersji, skopiować go do układu i użyć go do zaktualizowania układu do tej dokładnej wersji określonej w programie bootstrapper. Należy użyć dokładnie tej samej składni, co powyżej.

Możesz przejść do strony Historia wydania programu Visual Studio 2022 i pobrać określony program rozruchowy stałej wersji, skopiować go do układu i użyć go do zaktualizowania układu do tej dokładnej wersji określonej w programie bootstrapper. Należy użyć dokładnie tej samej składni, co powyżej.

Możesz użyć aktualizacji administratora , aby zaktualizować układ do określonej wersji. Aby uzyskać aktualizację administratora, przejdź do katalogu usługi Microsoft Update, wyszukaj aktualizację, do której chcesz zaktualizować układ. Pobierz update.exe na komputer hostujący układ, otwórz wiersz polecenia na tym komputerze i uruchom polecenie w następujący sposób:

visualstudioupdate-17.0.0to17.0.1.exe layout --layoutPath c:\VSLayout

Należy pamiętać, że aktualizacje administratora nie zainicjują oryginalnej instalacji układu; zaktualizują tylko istniejący układ lub wystąpienie klienta.

Modyfikowanie kanału układu sieciowego

Czasami w miarę przechodzenia kanałów poza pomoc techniczną należy upewnić się, że układ sieci będzie nadal oparty na obsługiwanym kanale, aby klienci mogli nadal otrzymywać powiadomienia o aktualizacjach zabezpieczeń. Jeśli układ jest oparty na kanale VisualStudio.17.Release.LTSC.17.0, po zakończeniu obsługi kanału LTSC 17.0 nie udostępnimy żadnych dodatkowych aktualizacji zabezpieczeń, a układ i klienci staną się niezabezpieczone.

Aby zmienić kanał oparty na układzie, po prostu uzyskaj program startowy żądanego kanału ze strony Historia wydania programu Visual Studio 2022 , skopiuj go do folderu układu i wykonaj normalną aktualizację. Klienci powinni wówczas być odpowiednio powiadomieni o aktualizacji, aby mogli również zachować bezpieczeństwo.

Modyfikowanie zawartości układu

Istnieje możliwość zmodyfikowania tego układu i dodania lub usunięcia dodatkowych obciążeń lub składników lub języków. W poniższym przykładzie dodamy obciążenie platformy Azure i zlokalizowany język do utworzonego powyżej układu. Po wprowadzeniu modyfikacji w tym układzie zostaną uwzględnione zarówno obciążenia pulpitu zarządzanego, jak i platformy Azure, a także zasoby angielskie i niemieckie. Ponadto układ jest aktualizowany do najnowszej dostępnej wersji.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --lang de-DE

Jeśli chcesz zmodyfikować istniejący układ częściowy tak, aby stał się pełnym układem, użyj opcji --all, jak pokazano w poniższym przykładzie.

vs_enterprise.exe --layout c:\VSLayout --all

Poniżej przedstawiono sposób dodawania dodatkowego obciążenia i zlokalizowanego języka bez aktualizowania wersji. (To polecenie dodaje obciążenie ASP.NET i Tworzenie aplikacji internetowych). Teraz w tym układzie znajdują się obciążenia Managed Desktop, Azure i ASP.NET & Web Development. Zasoby językowe dla języków angielskich, niemieckich i francuskich są również uwzględniane dla wszystkich tych obciążeń. Układ nie jest jednak aktualizowany do najnowszej dostępnej wersji po uruchomieniu tego polecenia. Pozostaje w istniejącej wersji.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.NetWeb --lang fr-FR --keepLayoutVersion

Ważne

Operacja aktualizacji nie pobiera ani nie instaluje dodatkowych składników opcjonalnych w układzie lub na kliencie. Jeśli musisz dodać lub zmienić opcjonalne składniki, najpierw usuń stare składniki opcjonalne z layout.json pliku konfiguracji i dołącz nowe składniki potrzebne w sekcji "dodaj" w layout.jsonprogramie . Następnie po uruchomieniu --layout polecenia w celu zaktualizowania układu zostaną pobrane nowo dodane składniki do układu.

Aby uzyskać te nowe składniki zainstalowane na komputerze klienckim, upewnij się, że wykonasz te trzy kroki. Najpierw sprawdź, czy układ zawiera nowe składniki zgodnie z powyższym opisem. Następnie zaktualizuj klienta do najnowszych bitów w układzie. Na koniec ponownie na kliencie uruchom operację modyfikowania, która zainstaluje nowe składniki (dodane do układu) na komputerze klienckim.

Konfigurowanie układu tak, aby zawsze uwzględniał i udostępniał najnowszy instalator

Układ można skonfigurować tak, aby zawsze uwzględniał i dostarczał najnowszego instalatora klientom, nawet jeśli instalator jest uważany za część nowszej wersji programu Visual Studio. W związku z tym po zaktualizowaniu klienta z tego układu klient uzyska najnowszą wersję instalatora, która jest dołączona i dostarczona przez ten układ. Korzyść polega na tym, że gdy najnowszy instalator znajduje się na kliencie, instalacje klienta będą mogły korzystać z poprawek błędów i nowych funkcji, które będziemy nadal dodawać do instalatora.

Porada

Jeśli chcesz zmienić lokalizację, w której instalacja programu Visual Studio 2019 klienta szuka aktualizacji, musisz uzyskać najnowszy instalator programu Visual Studio 2022 na komputerze klienckim. Jednym ze sposobów jest dołączenie instalatora programu Visual Studio 2022 do układów programu Visual Studio 2019 przy użyciu parametrów opisanych poniżej. Możliwość korzystania z najnowszego instalatora jest dostępna tylko dla programu Visual Studio 2019 bootstrappers, które zostały utworzone po pierwotnie dostarczonym programie Visual Studio 2022. Dlatego vs_enterprise.exe w poniższym przykładzie musi być wersją dostarczoną po 10 listopada 2021 r.

Istnieją dwa sposoby włączenia układu i udostępnienia najnowszego instalatora:

  • Parametr można przekazać --useLatestInstaller do programu uruchamiającego podczas tworzenia lub aktualizowania układu. Spowoduje to ustawienie ustawione w pliku layout.json, które można znaleźć w katalogu głównym układu. Oto przykład aktualizowania układu i konfigurowania go pod kątem używania najnowszego i największego dostępnego instalatora.

    vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
    
  • Możesz edytować plik layout.json bezpośrednio, aby dodać to ustawienie.

    {
       "installChannelUri": ".\\ChannelManifest.json",
       "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
       "installCatalogUri": ".\\Catalog.json",
       "channelId": "VisualStudio.16.Release",
       "productId": "Microsoft.VisualStudio.Product.Enterprise",
    
       "useLatestInstaller": true
       "removeOos": true
    
    }
    

Nie ma możliwości programowego usunięcia tego ustawienia w pliku layout.json, więc jeśli chcesz, aby układ przestał korzystać z najnowszego instalatora udostępnionego przez firmę Microsoft, a zamiast tego użyj wersji instalatora odpowiadającej programowi rozruchowemu (który jest przeważnie starszy niż najnowszy instalator), po prostu edytuj plik layout.json i usuń "UseLatestInstaller": true to ustawienie.

Należy pamiętać, że to "UseLatestInstaller": true ustawienie można znaleźć również w pliku response.json układu, ale jest tam ignorowane. Plik response.json służy do ustawiania domyślnych opcji konfiguracji na kliencie podczas instalowania lub aktualizowania klienta z układu. To konkretne "useLatestInstaller": true ustawienie służy do zapewnienia, że zawartość układu zawiera najnowszego instalatora, dzięki czemu komputery klienckie mogą następnie uzyskać najnowszy instalator z układu.

Skonfiguruj układ, aby usunąć składniki poza obsługą na maszynie klienckiej.

Niektóre przedsiębiorstwa będą chciały skorzystać z funkcji wprowadzonej w programie Visual Studio 2022 w wersji 17.4, która usuwa składniki, które przeszły do stanu pomocy technicznej. Jest to stosunkowo łatwe do skonfigurowania, jeśli zarządzasz układem i jeśli klienci otrzymują aktualizacje administratora. Najpierw należy skonfigurować układ tak, aby miał najnowszą wersję instalatora zgodnie z powyższym opisem. Po drugie, musisz dodać wiersz "removeOos": true do pliku response.json, jak pokazano powyżej. Jeśli układ ma te dwa szczegóły poprawnie ustawione, kolejne aktualizacje administratora będą uwzględniać to ustawienie i usunie składniki poza obsługą z maszyn klienckich.

Weryfikowanie układu

Służy --verify do przeprowadzania weryfikacji w układzie sieciowym, który sprawdza, czy brakuje plików pakietów, czy są one nieprawidłowe. Po zakończeniu weryfikacji wyświetla listę brakujących i nieprawidłowych plików.

Weryfikacja działa tylko w przypadku najnowszej wersji określonej wersji pomocniczej programu Visual Studio. Po wydaniu nowej wersji weryfikacja nie będzie działać w przypadku układów zawierających poprzednie wersje.

vs_enterprise.exe --layout <layoutDir> --verify

Uwaga

Niektóre ważne pliki metadanych wymagane przez --verify tę opcję muszą znajdować się w folderze układu. Jeśli brakuje tych plików metadanych, polecenie "--verify" nie może zostać uruchomione, a instalator wyświetla błąd. Jeśli wystąpi ten błąd, spróbuj ponownie zaktualizować układ lub ponownie utworzyć nowy układ sieciowy w innym folderze.

Należy pamiętać, że firma Microsoft okresowo dostarcza aktualizacje do programu Visual Studio, więc nowszy układ może nie zawierać tej samej wersji co układ początkowy, chyba że używasz programu [fixed link bootstrappers](#download-the-visual-studio-bootstrapper-to create-the-network-layout).

Naprawianie układu

Użyj --fix polecenia , aby wykonać tę samą weryfikację, a --verify także spróbować rozwiązać zidentyfikowane problemy. Proces --fix wymaga połączenia internetowego, dlatego przed wywołaniem --fixpolecenia upewnij się, że maszyna jest połączona z Internetem.

vs_enterprise.exe --layout <layoutDir> --fix

Usuwanie starszych wersji z układu

Po wykonaniu aktualizacji układu do pamięci podręcznej sieci folder layout może zawierać przestarzałe pakiety, które nie są już potrzebne przez najnowszą instalację programu Visual Studio. Możesz użyć --clean opcji usuwania przestarzałych pakietów z folderu układu sieciowego.

W tym celu musisz mieć ścieżki plików do manifestów wykazu, które zawierają te przestarzałe pakiety. Manifesty wykazu można znaleźć w folderze "Archiwum" w pamięci podręcznej układu sieciowego. Są one zapisywane tam podczas aktualizowania układu. W folderze "Archive" istnieje co najmniej jeden "identyfikator GUID" o nazwie foldery, z których każdy zawiera przestarzały manifest wykazu. Liczba folderów "GUID" powinna być taka sama jak liczba aktualizacji wprowadzonych w układach.

Kilka plików jest zapisywanych w każdym folderze "GUID". Dwa pliki najbardziej interesujące to plik "catalog.json" i plik "version.txt". Plik "catalog.json" jest przestarzałym manifestem wykazu, który należy przekazać do --clean opcji. Drugi plik version.txt zawiera wersję tego przestarzałego manifestu wykazu. Na podstawie numeru wersji możesz zdecydować, czy chcesz usunąć przestarzałe pakiety z tego manifestu wykazu. Możesz to zrobić tak samo, jak w przypadku innych folderów "GUID". Po podjęciu decyzji dotyczącej katalogów, które chcesz wyczyścić, uruchom --clean polecenie, podając ścieżki plików do tych katalogów.

Oto przykład użycia opcji --clean:

c:\VSLayout\vs_enterprise.exe --layout c:\VSLayout --clean c:\VSLayout\Archive\1cd70189-fc55-4583-8ad8-a2711e928325\Catalog.json --clean c:\VSLayout\Archive\d420889f-6aad-4ba4-99e4-ed7833795a10\Catalog.json

Po wykonaniu tego polecenia Instalator analizuje folder układu sieciowego, aby znaleźć listę plików, które zostaną usunięte. Następnie będzie można przejrzeć pliki, które zostaną usunięte i potwierdzić usunięcie.

Instalowanie programu Visual Studio na komputerze klienckim z instalacji sieciowej

Administratorzy mogą wdrażać program Visual Studio na stacjach roboczych klienta w ramach skryptu instalacji. Użytkownicy, którzy mają uprawnienia administratora, mogą uruchamiać konfigurację bezpośrednio z udziału, aby zainstalować program Visual Studio na swojej maszynie.

  • Użytkownicy mogą ręcznie zainstalować produkt z układu sieciowego, uruchamiając następujące polecenie:

    \\server\products\VS\vs_enterprise.exe
    
  • Administratorzy mogą zainstalować w trybie nienadzorowanym, uruchamiając następujące polecenie:

    \\server\products\VS\vs_enterprise.exe --quiet --wait --norestart
    

Uwaga

Poczekaj kilka minut Upewnij się, że --wait zarówno instalator, jak i produkt mają być zakończone. Podczas instalowania lub aktualizowania klienta z układu instalator jest zawsze pierwszą rzeczą do zainstalowania lub zaktualizowania, a następnie sam produkt Programu Visual Studio zostanie zainstalowany lub zaktualizowany. Oba te procesy muszą zostać zakończone, aby można było uznać za pomyślną aktualizację.

Podczas wykonywania instalacji lub aktualizacji w ramach nienadzorowanego zautomatyzowanego pliku wsadowego opcja jest przydatna, aby upewnić się, --wait że vs_enterprise.exe proces czeka na ukończenie instalacji przed zwróceniem kodu zakończenia. Jest to przydatne, jeśli administrator przedsiębiorstwa chce wykonać dalsze akcje na ukończonej instalacji, takie jak zastosowanie klucza produktu do pomyślnej instalacji. Użycie opcji --wait uniemożliwia przedwczesne rozpoczęcie kolejnych operacji. Jeśli nie używasz --waitmetody , vs_enterprise.exe proces może zakończyć się przed ukończeniem obu części instalacji, a w związku z tym zwróci niedokładny kod zakończenia, który nie reprezentuje stanu operacji instalacji.

Instalowanie na kliencie, który nie ma dostępu do Internetu

Po zainstalowaniu z układu zawartość zainstalowana domyślnie zostanie pobrana z układu. Jeśli jednak wybierzesz składnik, który nie znajduje się w układzie, a klient został skonfigurowany do wyszukiwania serwerów hostowanych przez firmę Microsoft pod kątem aktualizacji, instalator podejmie próbę uzyskania pakietów programu Visual Studio z Internetu. Jeśli chcesz uniemożliwić instalatorowi programu Visual Studio pobranie jakiejkolwiek zawartości z sieci Web, której brakuje w układzie, użyj --noWeb opcji . Jeśli --noWeb jest używany, a układ nie ma żadnej zawartości wybranej do zainstalowania, konfiguracja zakończy się niepowodzeniem.

Ważne

Opcja --noWeb nie zatrzymuje instalatora programu Visual Studio na komputerze klienckim połączonym z Internetem z sprawdzania dostępności aktualizacji, jeśli klient został skonfigurowany do sprawdzania serwerów hostowanych przez firmę Microsoft pod kątem aktualizacji. --noWeb Zamiast tego po prostu uniemożliwia klientowi pobieranie pakietów produktów. Aby uzyskać więcej informacji, zobacz Aktualizowanie klienta programu Visual Studio zainstalowanego na stronie układu sieciowego .

Jeśli zostanie wyświetlony komunikat o błędzie z komunikatem "Nie można odnaleźć produktu zgodnego z poniższymi parametrami", upewnij się, że używasz przełącznika --noweb .

Konfigurowanie domyślnych ustawień instalacji początkowej klienta dla tego układu

Plik response.json można zmodyfikować w folderze układu, aby ustawić wartości domyślne, gdy produkt jest początkowo zainstalowany na komputerze klienckim. Typowe opcje konfiguracji obejmują:

  • Możliwość skonfigurowania, które obciążenia, składniki lub języki powinny być domyślnie wybierane podczas początkowej instalacji.
  • Możliwość określenia lokalizacji, z której klient powinien otrzymywać aktualizacje. Przykłady obejmują domyślne serwery hostowane przez firmę Microsoft w Internecie lub z lokalizacji układu sieciowego kontrolowanego przez administratora.

Aby uzyskać więcej informacji na temat dostosowywania i konfigurowania domyślnych ustawień klienta dla układu, zobacz Automatyzowanie instalacji programu Visual Studio przy użyciu pliku odpowiedzi.

Konfigurowanie zasad dotyczących zachowania wdrażania w przedsiębiorstwie

Można również kontrolować inne zachowanie wdrażania przedsiębiorstwa, takie jak instalacja, aktualizacja i pobieranie, zachowanie aktualizacji administratora, sposób wyświetlania układów w oknie dialogowym Ustawienia aktualizacji i zachowanie powiadomień.

Aby uzyskać dodatkowe informacje , zobacz Konfigurowanie zasad dla wdrożeń przedsiębiorstwa programu Visual Studio .

Kody błędów

Jeśli użyto parametru --wait , w zależności od wyniku operacji %ERRORLEVEL% zmienna środowiskowa jest ustawiona na jedną z następujących wartości:

Wartość Wynik
0 Operacja zakończona pomyślnie
740 Wymagane podniesienie uprawnień
1001 Proces instalatora programu Visual Studio jest uruchomiony
1003 Program Visual Studio jest używany
1602 Operacja została anulowana
1618 Inna instalacja uruchomiona
1641 Operacja została ukończona pomyślnie, a zainicjowano ponowny rozruch
3010 Operacja została ukończona pomyślnie, ale instalacja wymaga ponownego uruchomienia, zanim będzie można go użyć
5003 Nie można pobrać instalatora programu Bootstrapper
5004 Operacja została anulowana
5005 Błąd analizowania wiersza polecenia programu Bootstrapper
5007 Operacja została zablokowana — komputer nie spełnia wymagań
8001 Niepowodzenie sprawdzania maszyny arm
8002 Niepowodzenie wstępnego pobierania w tle
8003 Brak pomocy technicznej — niepowodzenie z możliwością wyboru
8004 Błąd katalogu docelowego
8005 Weryfikowanie niepowodzenia ładunków źródłowych
8006 Uruchomione procesy programu Visual Studio
-1073720687 Błąd łączności
-1073741510 Program Microsoft Instalator programu Visual Studio został zakończony (przez użytkownika lub proces zewnętrzny)
Inne
(na przykład:
-1, 1, 1603)
Wystąpił warunek niepowodzenia — sprawdź dzienniki, aby uzyskać więcej informacji

Uzyskiwanie pomocy technicznej dla układu sieciowego

Jeśli wystąpi problem z układem sieci, chcemy o tym wiedzieć. Najlepszym sposobem, aby nam powiedzieć, jest użycie narzędzia Zgłoś problem, które pojawia się zarówno w Instalator programu Visual Studio, jak i w środowisku IDE programu Visual Studio. Jeśli jesteś administratorem IT i nie masz zainstalowanego programu Visual Studio, możesz przesłać opinię it Administracja tutaj. Jeśli używasz tego narzędzia, bardzo przydatne byłoby wysłanie dzienników przez narzędzie VS Collect , które może pomóc nam zdiagnozować i rozwiązać problem.

Oferujemy również opcję obsługi czatu instalacyjnego (tylko w języku angielskim) w przypadku problemów związanych z instalacją.

Mamy również dostępne inne opcje pomocy technicznej. Zobacz nasze Developer Community programu Visual Studio.

Zobacz też