Tworzenie i obsługa instalacji sieciowej programu Visual Studio

Czasami administrator przedsiębiorstwa chce utworzyć prywatną pamięć podręczną instalacji (znaną również jako "układ"), która zawiera pliki programu Visual Studio, które można wdrożyć na komputerach klienckich w organizacji.

Tworzenie układu jest przydatne w następujących sytuacjach:

• Użytkownik ma ograniczone uprawnienia
• Maszyny klienckie mają ograniczony dostęp do Internetu
• Organizacja chce standandaryzować określoną wersję zestawu narzędzi deweloperskich

Zaprojektowaliśmy program Visual Studio, aby administrator mógł tworzyć i obsługiwać układ oraz przechowywać go w wewnętrznym udziale sieciowym i opcjonalnie udostępnić go w intranecie organizacji. Układ służy jako lokalizacja źródłowa dla wszystkich plików programu Visual Studio wymaganych zarówno do początkowej instalacji klienta, jak i kolejnych aktualizacji.

Informacje na tej stronie są pogrupowane w trzy główne sekcje:

• Utwórz układ: opisuje sposób tworzenia układu z poprawną zawartością produktu, konfigurowania ustawień domyślnych, przechowywania go w sieciowym udziale plików i udostępniania go w intranecie.
• Zachowaj układ: informacje o tym, jak najlepiej zaktualizować wersję produktu układu lub zmodyfikować zawartość produktu układu, ustawienia kanału, wersję instalatora i rozmiar folderu.
• Pomoc i obsługa techniczna: gdzie poprosić o pomoc

Tworzenie układu

Przygotowywanie sieciowej lokalizacji przechowywania udziału plików

Najpierw należy określić miejsce przechowywania pobranych pakietów programu Visual Studio. Jeśli masz wiele wersji programu Visual Studio używanych w przedsiębiorstwie (na przykład Visual Studio 2022 Professional i Visual Studio 2022 Enterprise), musisz utworzyć oddzielny układ dla każdej edycji. Utworzenie oddzielnego układu dla każdej edycji może zużywać dużo miejsca na dysku, zwłaszcza jeśli uważasz, że aktualizacje układu również zużywają miejsce na dysku.

Ścieżka układu musi być mniejsza niż 80 znaków; niektóre organizacje pomyślnie używają linków symbolicznych do obejścia ograniczenia 80 znaków.

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

Pobierz odpowiedni program inicjujący dla żądanej wersji programu Visual Studio i skopiuj go do katalogu, który ma służyć jako repozytorium układu. Po utworzeniu układu można go użyć do zainstalowania programu Visual Studio na dowolnej maszynie klienckiej. Program inicjujący jest plikiem wykonywalnym używanym do tworzenia, aktualizowania i wykonywania innych operacji układu. Aby wykonać ten krok, musisz mieć uprawnienia do połączenia internetowego i administratora.

Następujące programy uruchamiane zawsze instalują 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, pobierz program inicjujący evergreen i fixed version bootstrapper dla wersji obsługi kanału, który chcesz uzyskać w historii wersji programu Visual Studio 2022. Skopiuj go do katalogu, który ma 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 Community	vs_community.exe
Visual Studio 2022 Build Tools	vs_buildtools.exe

Napiwek

Jeśli wcześniej pobrano plik programu inicjjącego i chcesz sprawdzić, jaka wersja zostanie zainstalowana, oto jak to zrobić. W systemie Windows otwórz Eksplorator plików, kliknij prawym przyciskiem myszy plik programu inicjjącego, wybierz polecenie Właściwości, a następnie wybierz kartę Szczegóły. W polu Wersja produktu opisano kanał i wersję, którą zainstaluje program inicjujący. Numer wersji powinien być zawsze odczytywany jako "najnowsza wersja obsługi określona" i przyjmuje się, że kanał ma być bieżący, chyba że określono jawnie. Dlatego program inicjujący z wersją Produktu LTSC 17.0 instaluje najnowszą wersję serwisową 17.0.x dostępną w kanale LTSC 17.0. Program inicjujący z wersją produktu z informacją, że program Visual Studio 2022 instaluje najnowszą wersję obsługi programu Visual Studio 2022 w bieżącym kanale.

Pobieranie pakietów programu Visual Studio

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

Otwórz wiersz polecenia z podwyższonym poziomem uprawnień, przejdź do katalogu, w którym pobrano program inicjator, i użyj parametrów programu inicjatora zgodnie z definicją w parametrach wiersza polecenia, aby zainstalować stronę programu Visual Studio w celu utworzenia i utrzymania układu sieciowego. W poniższych przykładach przedstawiono typowe sposoby tworzenia układów początkowych. Więcej przykładów można znaleźć na stronie przykładów parametrów wiersza polecenia dla strony instalacji programu Visual Studio.

Pełny początkowy układ ustawień regionalnych pojedynczego języka wymaga około 40 GB miejsca na dysku dla programu Visual Studio Community i około 50 GB dla programu Visual Studio Enterprise. Dodatkowe ustawienia regionalne języka wymagają około pół GB każdy.

Zalecane jest utworzenie początkowego układu programu Visual Studio ze wszystkimi obciążeniami i odpowiednimi językami oraz zapisanie pakietów w katalogu układów na serwerze sieciowym. W ten sposób każda instalacja klienta ma dostęp do całej oferty produktu Visual Studio i możliwości instalowania dowolnego podzestawu. Aby utworzyć pełny układ programu Visual Studio, uruchom następujące polecenie z katalogu, na którym planujesz hostować układ sieciowy:

vs_enterprise.exe --layout c:\VSLayout

Upewnij się, że układ jest oparty na prawidłowym kanale

Ważne jest, aby upewnić się, że układ sieciowy jest oparty na prawidłowym kanale, ponieważ jest to jedno z kryteriów aktualizowania przez administratora, jeśli są wdrażane w całej organizacji, służą do identyfikowania, które wystąpienia klientów powinny być aktualizowane. 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, wszystkie aktualizacje zabezpieczeń udostępnione w kanale LTSC 17.0 są dostępne dla klientów, którzy zainstalować lub zaktualizować z tego układu.

Wymienione wcześniej bootstrappers są oparte na bieżącym kanale. Aby utworzyć układ na podstawie jednego z kanałów LTSC, uzyskaj odpowiedni program inicjujące 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

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. Układ częściowy jest przydatny, jeśli wiesz, że zamierzasz wdrożyć tylko podzbiór obciążeń na klienckich stacjach roboczych. 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, pobierane są wszystkie obciążenia i składniki.
• --includeRecommended aby uwzględnić wszystkie zalecane składniki dla określonych identyfikatorów obciążeń.
• --includeOptional aby uwzględnić wszystkie opcjonalne składniki dla określonych identyfikatorów obciążeń.
• --config aby *.vsconfig użyć pliku w celu określenia obciążeń, składników lub rozszerzeń, które powinny być uwzględnione w układzie lub do których się odwołuje. Upewnij się, że określono pełną ścieżkę pliku konfiguracji.
• --lang aby określić ustawienia regionalne języka.

Poniżej przedstawiono kilka przykładów tworzenia niestandardowego układu sieciowego.

• Aby utworzyć układ z wymaganymi składnikami dla wszystkich obciążeń tylko w jednym języku, uruchom polecenie:

  vs_enterprise.exe --layout C:\VSLayout --lang en-US
  

• Aby utworzyć układ z wymaganymi składnikami dla wszystkich obciążeń w wielu językach, 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 wymaganymi i zalecanymi składnikami dla tego obciążenia we wszystkich językach, uruchom polecenie:

  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 w trzech językach, 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
  

Inicjowanie zawartości układu za pomocą pliku konfiguracji

Parametru --config można użyć do przekazania pliku*.vsconfig. Upewnij się, że określono pełną ścieżkę pliku konfiguracji. *.vsconfig Użycie pliku podczas tworzenia układu dostosowuje i ogranicza zawartość układu sieciowego do tego, co jest określone w pliku konfiguracji. Plik konfiguracji jest kopiowany do katalogu układu i zmieniany layout.vsconfigna .

Wszystkie rozszerzenia określone w *.vsconfig pliku nie są kopiowane bezpośrednio do układu. Zamiast tego plik układu response.json zawiera odwołanie do nowo utworzonego layout.vsconfig pliku, definiując lokalizację instalacji rozszerzeń klienta. Jeśli instalujesz rozszerzenia, które nie są podpisane cyfrowo, pamiętaj, aby edytować element response.json , aby dodać "allowUnsignedExtensions": trueelement . Zobacz response.json przykłady zawartości.

vs_enterprise.exe --layout "C:\VSLayout" --config "C:\myconfig.vsconfig" 

Kopiowanie układu do udziału sieciowego

Należy hostować układ w udziale sieciowym, aby można było uzyskać do niego dostęp z komputerów klienckich. Jeśli układ został utworzony na komputerze lokalnym, musisz skopiować go do lokalizacji pliku sieciowego. 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

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

Plik o nazwie response.json jest tworzony w folderze głównym układu. Ten dostosowywalny plik dostarcza początkowe ustawienia domyślne do skonfigurowania na kliencie, gdy klient początkowo jest instalowany z układu. Typowe opcje konfiguracji obejmują możliwość konfigurowania:

• Które obciążenia, składniki lub języki powinny być instalowane domyślnie na kliencie
• Jeśli zalecane składniki powinny być również zainstalowane
• Jeśli klient powinien przestrzegać pliku instalacyjnego *.vsconfig
• Gdzie klient powinien otrzymywać aktualizacje od
• Jeśli składniki poza obsługą powinny zostać usunięte podczas aktualizacji
• Jeśli rozszerzenia niepodpisane mogą być ładowane cicho i programowo

Więcej informacji można znaleźć na stronie Automatyzowanie instalacji programu Visual Studio przy użyciu pliku odpowiedzi.

Udostępnianie układu za pośrednictwem witryny intranetowej

Począwszy od czerwca 2023 r., możesz udostępnić układy w wewnętrznej witrynie intranetowej, która umożliwia korzystanie z buforowania plików serwera internetowego i możliwości wydajności georeplikacji. Aby użyć tej nowej funkcji, musisz użyć najnowszych programów inicjujących programu Visual Studio i najnowszych Instalator programu Visual Studio. Administratorzy IT muszą wykonać następujące czynności, aby skorzystać z tej funkcji hostingu w sieci Web intranet:

1. Najpierw utwórz i zachowaj układ sieciowy oraz upewnij się, że bity są obecne i regularnie aktualizowane w udziale sieciowym. Pamiętaj również, aby skonfigurować wartość channelUri w response.json układu, jeśli klienci mają pobierać aktualizacje z lokalizacji układu intranetowego.

2. Następnie administrator będzie musiał przygotować wewnętrzną witrynę internetową i powiązać źródło witryny internetowej z lokalizacją pliku sieciowego układu. Muszą również upewnić się, że serwer internetowy uwzględnia następujące typy MIME:

   Formatem	Typ MIME
   .Kabiny	application/vnd.ms-cab-compressed
   .Exe	application/octet-stream
   .Json	application/json
   .Msi	application/octet-stream
   .Msu	application/octet-stream
   .Nupkg	application/octet-stream
   .Opc	application/octet-stream
   .ps1	application/postscript
   .Vsix	application/octet-stream
   .Xml	text/xml
   .Zip	application/x-zip-compressed

3. Na koniec, aby wdrożyć ten układ na kliencie, uruchom skrypt programu PowerShell na kliencie, aby przeprowadzić instalację początkową. Po pomyślnym zainstalowaniu programu Visual Studio na kliencie z układu hostowanego w sieci Web aktualizacje klienta dla układów hostowanych w sieci Web można zaktualizować za pomocą standardowych metod.

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

Uwaga

Od czerwca 2023 r. najnowszy instalator jest domyślnie dostarczany z każdą aktualizacją do wszystkich obsługiwanych wersji programu Visual Studio 2017, Visual Studio 2019 i Visual Studio 2022. Jeśli używasz jednej z tych wersji produktu, nie musisz wykonywać żadnych czynności jawnie, aby uzyskać najnowszą wersję instalatora z najnowszymi funkcjami i poprawkami błędów.

Jeśli używasz wersji programu Visual Studio dostarczonej przed czerwcem 2023 r., zalecamy, aby zawsze używać najnowszych Instalator programu Visual Studio w układzie i dystrybuować je do klientów. Na przykład w przypadku dystrybucji instalatora programu Visual Studio 2022 w układzie programu Visual Studio 2019 klienci programu Visual Studio 2019 na podstawie tego układu mają możliwość zmiany lokalizacji źródłowej aktualizacji lub łatwego usuwania składników poza obsługą. Dalsze szczegóły opisano w poniższej sekcji.

Możliwość zapewnienia programowego korzystania z najnowszego instalatora jest dostępna tylko dla programów inicjujących programu Visual Studio 2019 utworzonych po pierwotnie dostarczonym programie Visual Studio 2022. Dlatego vs_enterprise.exe w poniższym przykładzie musi być wersją dostarczaną 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

Obsługa układu

Najlepszym rozwiązaniem jest okresowe aktualizowanie układu programu Visual Studio do najnowszej bezpiecznej wersji produktu. Dzięki temu układ może być używany zarówno jako punkt instalacji, jak i źródło aktualizacji dla instalacji klienta. W poniższej sekcji opisano najbardziej typowe lub przydatne operacje konserwacji układu.

Jeśli hostujesz układ w sieciowym udziale plików, możesz pobrać zaktualizowany układ do prywatnego udziału lokalnego (na przykład c:\VSLayoutUpdate), a następnie po pobraniu całej zaktualizowanej zawartości skopiuj go do sieciowego udziału plików układu (na przykład \server\products\VS). Jeśli tego nie zrobisz, użytkownicy, którzy uruchamiają konfigurację 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. Zdecydowanie zalecamy aktualizowanie układu przy użyciu najnowszej wersji produktu, aby klienci zawsze mieli dostęp do najnowszej najbezpieczniejszej wersji produktu. Jest to szczególnie ważne, jeśli klienci nie mają dostępu do Internetu i mogą otrzymywać aktualizacje produktów tylko z układu. Program Visual Studio zazwyczaj publikuje aktualizacje zabezpieczeń w drugi wtorek miesiąca, znany jako "patch Tuesday", więc dobrą strategią byłoby zaktualizowanie wszystkich układów we wtorek po południu.

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 layout.jsonkonfiguracji układu . Później po zaktualizowaniu tego układu do nowszej wersji produktu nie trzeba ponownie określać składników produktu, które mają być w układzie. Aktualizacja układu po prostu aktualizuje istniejące składniki w układzie do najnowszej wersji.

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ć istniejącego evergreen bootstrapper w układzie i uruchomić --layout polecenie w wierszu polecenia z podwyższonym poziomem uprawnień, aby pobrać najnowsze pakiety do układu w następujący sposób:

vs_enterprise.exe --layout c:\VSLayout

Możesz również zaktualizować układ do zaktualizowanej wersji w sposób nienadzorowany. Operacja układu uruchamia proces instalacji w nowym oknie konsoli. Okno zostało otwarte, aby administratorzy mogli zobaczyć końcowy wynik aktualizacji układu i podsumowanie wszelkich błędów, które mogły wystąpić. Jeśli chcesz wykonać operację aktualizacji 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 --passive parametru , a proces automatycznie zamknie okno.

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

Aktualizowanie układu do określonej wersji produktu

Czasami możesz 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, w której została ustandaryzowana twoja organizacja. Oto jak to zrobić:

Możesz przejść do strony Historia wydania programu Visual Studio 2022 i pobrać konkretny program uruchamiający stałą wersję, skopiować go do układu i użyć go do zaktualizowania układu do tej dokładnej wersji określonej w programie inicjujący. Należy użyć dokładnie takiej samej składni, jak powyżej.

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

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

Należy pamiętać, że aktualizacja administratora nie zainicjuje tworzenia nowego układu; zaktualizuje on tylko istniejący układ. Aby utworzyć układ początkowy, należy użyć programu inicjjącego.

Zapewnianie, że układ sieci jest oparty na obsługiwanej wersji

Czasami w miarę przechodzenia kanałów poza obsługę należy upewnić się, że układ sieciowy 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 w wersji 17.0 w lipcu 2023 r. nie wydamy do niego żadnych kolejnych aktualizacji zabezpieczeń, a układ i klienci staną się niepewni. Daty pomocy technicznej dla różnych kanałów programu Visual Studio 2022 można znaleźć tutaj.

Aby zmienić kanał oparty na układzie, uzyskaj program inicjujący żą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 odpowiednio otrzymywać powiadomienia o aktualizacji, aby mogli również zachować bezpieczeństwo.

Modyfikowanie zawartości układu

Istnieje możliwość zmodyfikowania układu częściowego i dodania dodatkowych obciążeń, składników lub języków. Nie można niezawodnie usuwać składników z układu.

W poniższym przykładzie dodamy obciążenie platformy Azure i zlokalizowany język do układu, który został wcześniej utworzony przy użyciu tylko obciążenia pulpitu zarządzanego i języka angielskiego. Po wprowadzeniu modyfikacji w tym układzie zostaną uwzględnione zarówno obciążenia pulpitu zarządzanego, jak i platformy Azure, a zarówno angielski, jak i niemiecki. Oprócz dodawania składników --layout polecenie spowoduje również zaktualizowanie układu do wersji określonej przez program uruchamiającego. Tak więc, jeśli używasz evergreen bootstrapper, wynikowy układ będzie miał nowy składnik, nowy język i cała zawartość układu zostaną zaktualizowane do najnowszej wersji na kanale programu inicjatora.

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. Ponownie to polecenie spowoduje zaktualizowanie zawartości układu do wersji określonej przez program inicjujący.

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

Składniki można dodać do układu, przekazując *.vsconfig plik zawierający dodatkowe składniki, które mają być w układzie. W takim przypadku nowa *.vsconfig zawartość zastąpi istniejącą layout.vsconfig zawartość. Aby uzyskać więcej informacji, zapoznaj się z poprzednią sekcją Używanie pliku konfiguracji do inicjowania zawartości układu.

vs_enterprise.exe --layout C:\VSLayout --config "C:\myupdatedconfig.vsconfig"

Na koniec możesz bezpośrednio edytować layout.json plik konfiguracji w folderze layout i zaktualizować sekcję "add" tego pliku, aby uwzględnić dodatkowe składniki, które mają zostać uwzględnione w układzie. Następnie należy zaktualizować układ zgodnie --layout z wcześniejszym opisem, aby pobrać najnowsze składniki.

Uwaga

Najprostszym sposobem zainstalowania nowo dodanych składników układu na maszynie klienckiej jest uruchomienie programu inicjjącego w układzie z komputera klienckiego. Sekcja response.json "add" pliku w układzie określa, które składniki są domyślnie wybrane w interfejsie użytkownika instalatora klienta. Jeśli układ został zmodyfikowany przy użyciu jednej z powyższych metod, możesz ręcznie sprawdzić dwukrotnie i ewentualnie dostosować sekcję "add" w response.json pliku, aby bardziej odpowiednio dopasować zawartość w sekcji "add" nowo zmodyfikowanego layout.json pliku.

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 braku 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, jak opisano poniżej. Po drugie należy dodać wiersz "removeOos": true do response.json pliku. Jeśli układ ma te dwa szczegóły prawidłowo ustawione, kolejne aktualizacje administratora będą uwzględniać to ustawienie i usunie składniki poza wsparciem z maszyn klienckich.

Weryfikowanie układu

Użyj --verify polecenia , aby przeprowadzić weryfikację w układzie sieciowym, który sprawdza, czy brakuje plików pakietów, czy są one nieprawidłowe. Na końcu 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 opcję muszą znajdować się w folderze układu. Jeśli brakuje tych plików metadanych, nie można uruchomić polecenia "--verify", a instalator wyświetla błąd. Jeśli wystąpi ten błąd, spróbuj ponownie zaktualizować układ lub ponownie utwórz nowy układ sieciowy w innym folderze.

Należy pamiętać, że firma Microsoft okresowo dostarcza aktualizacje do programu Visual Studio, więc jeśli używasz programu inicjującego evergreen, nowszy układ może nie zawierać tej samej wersji co układ początkowy. Jeśli jednak używasz stałych modułów rozruchowych linków, zawsze uzyskasz zestaw plików deterministycznych.

Naprawianie układu

Użyj --fix polecenia , aby przeprowadzić taką samą weryfikację, jak --verify i spróbuj rozwiązać zidentyfikowane problemy. Proces --fix wymaga połączenia z Internetem, dlatego przed wywołaniem --fixupewnij 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ć niektóre przestarzałe pakiety, które nie są już potrzebne przez najnowszą instalację programu Visual Studio. Możesz użyć --clean opcji , aby usunąć przestarzałe pakiety z folderu układu sieciowego.

W tym celu będziesz potrzebować ścieżek plików do manifestów wykazu zawierających te przestarzałe pakiety. Manifesty wykazu można znaleźć w folderze "Archiwum" w pamięci podręcznej układu sieciowego. Są one zapisywane podczas aktualizowania układu. W folderze "Archiwum" znajduje się 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 najbardziej interesujące pliki 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żna to zrobić tak samo, jak w przypadku innych folderów "GUID". Po podjęciu decyzji o katalogach, 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ęcia.

Konfigurowanie układu w taki sposób, aby zawsze uwzględniał i udostępniał najnowszy instalator

Uwaga

Od czerwca 2023 r. najnowszy instalator jest domyślnie wysyłany wraz z każdą aktualizacją obsługiwanych wersji programu Visual Studio 2017, Visual Studio 2019 i Visual Studio 2022. W związku z tym nie trzeba nic jawnie robić, aby uzyskać najnowszą wersję instalatora z najnowszymi funkcjami i poprawkami błędów w układzie i na klientach.

Jeśli jednak używasz układu utworzonego przed czerwcem 2023 r., możesz również jawnie skonfigurować układ tak, aby zawsze dołączał i dostarczał najnowsze instalator klientom, nawet jeśli instalator jest uważany za część nowszej wersji programu Visual Studio. W związku z tym, gdy klient zostanie zaktualizowany z tego układu, klient uzyska najnowszy instalator dołączony i dostarczony przez ten układ. Zaletą jest to, że gdy na kliencie znajduje się najnowszy instalator, instalacje klienta będą mogły korzystać z poprawek błędów i nowych funkcji, które będziemy nadal dodawać do instalatora.

Istnieje kilka sposobów włączenia układu i udostępnienia najnowszego instalatora:

• Możesz użyć wersji programu Visual Studio utworzonej w czerwcu 2023 r. lub nowszej.

• Parametr można przekazać --useLatestInstaller do programu inicjjącego podczas tworzenia lub aktualizowania układu. Spowoduje to ustawienie ustawione w layout.json pliku, 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 bezpośrednio, layout.json 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 layout.json pliku, 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 inicjującemu (który jest najprawdopodobniej starszy niż najnowszy instalator), zmodyfikuj layout.json plik i usuń "UseLatestInstaller": true ustawienie.

Należy pamiętać, że to "UseLatestInstaller": true ustawienie również może znajdować się w pliku układu response.json , ale jest ono ignorowane na potrzeby zapewnienia, że układ zawsze ma najnowszy instalator. 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 w layout.json pliku służy do zapewnienia, że zawartość układu zawiera najnowszy instalator, dzięki czemu maszyny klienckie mogą następnie uzyskać najnowszy instalator z układu.

Kody błędów

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

Wartość	Wynik
0	Operacja została ukończona pomyślnie
740	Wymagane podniesienie uprawnień
1001	Proces instalatora programu Visual Studio jest uruchomiony
1003	Program Visual Studio jest w użyciu
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 inicjatora
5004	Operacja została anulowana
5005	Błąd analizy wiersza polecenia programu inicjatora
5007	Operacja została zablokowana — komputer nie spełnia wymagań
8001	Niepowodzenie sprawdzania maszyny arm
8002	Niepowodzenie wstępnego pobierania w tle
8003	Awaria braku obsługi do wyboru
8004	Błąd katalogu docelowego
8005	Weryfikowanie błędu ładunków źródłowych
8006	Uruchomione procesy programu Visual Studio
8010	System operacyjny nie jest obsługiwany. Zapoznaj się z wymaganiami systemowym
-1073720687	Połączenie ivity failure (Niepowodzenie Połączenie ivity)
-1073741510	Usługa Microsoft Instalator programu Visual Studio została zakończona (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 obsługi układu sieciowego

Jeśli wystąpi problem z układem sieci, chcemy o tym wiedzieć. Najlepszym sposobem na powiedzenie nam jest użycie narzędzia Zgłoś problem, które jest wyświetlane zarówno w Instalator programu Visual Studio, jak i w środowisku IDE programu Visual Studio. Jeśli jesteś Administracja istratorem IT i nie masz zainstalowanego programu Visual Studio, możesz przesłać tutaj opinię Administracja IT. Jeśli używasz tego narzędzia, bardzo pomocne byłoby wysłanie dzienników za pomocą narzędzia Visual Studio 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ą.

Dostępne są też inne opcje pomocy technicznej. Zobacz naszą społeczność deweloperów programu Visual Studio.

Powiązana zawartość

• Przewodnik administratora programu Visual Studio
• Wdrażanie programu Visual Studio z układu na maszynie klienckiej
• Aktualizowanie instalacji sieciowej programu Visual Studio
• Rozwiązywanie problemów z błędami związanymi z siecią podczas instalowania lub używania programu Visual Studio
• Konfigurowanie zasad dla wdrożeń w przedsiębiorstwie programu Visual Studio
• Cykl życia i obsługa produktu Visual Studio
• Korzystanie z parametrów wiersza polecenia do zainstalowania programu Visual Studio
• Identyfikatory obciążeń i składników programu Visual Studio
• Instalowanie certyfikatów wymaganych do instalacji programu Visual Studio w trybie offline