Konfigurowanie domyślnych ustawień instalacji przy użyciu pliku odpowiedzi
W tym artykule dowiesz się, jak utworzyć plik odpowiedzi, który pomaga zautomatyzować instalację programu Visual Studio. Jest on najczęściej używany podczas instalowania programu Visual Studio z układu.
Plik odpowiedzi programu Visual Studio to plik JSON , którego zawartość zawiera dostosowania używane podczas początkowej instalacji programu Visual Studio na kliencie. Jego zawartość odzwierciedla argumenty i parametry wiersza polecenia. Użyj pliku odpowiedzi dla następujących opcji konfiguracji:
- Skonfiguruj, które obciążenia, składniki lub języki powinny być domyślnie wybrane podczas początkowej instalacji.
- Odwołuje się do pliku konfiguracji instalacji
*.vsconfig
ustandaryzowanego przez zespół. - Określ , skąd klient ma otrzymywać aktualizacje. Przykłady obejmują domyślne serwery hostowane przez firmę Microsoft w Internecie lub z lokalizacji układu sieciowego kontrolowanej przez administratora.
- Automatyczne usuwanie składników poza obsługą podczas aktualizacji.
Tworzenie pliku odpowiedzi
Plik response.json
jest zwykle tworzony, gdy administrator tworzy układ i można go znaleźć w folderze głównym układu. Możesz jednak utworzyć własny plik odpowiedzi, korzystając z jednego z poniższych przykładów.
Określanie pliku odpowiedzi
Jeśli administrator wdroży program Visual Studio przez wywołanie programu inicjatora z układu, plik odpowiedzi znaleziony w katalogu głównym układu zostanie automatycznie użyty. Administracja istratory mogą również jawnie określić inny plik odpowiedzi przy użyciu parametru--in
, jak w poniższym przykładzie:
\\server\share\layoutdirectory\vs_enterprise.exe --in custom_response_file.json
Zawartość pliku odpowiedzi
Plik odpowiedzi hermetyzuje parametry wiersza polecenia używane przez Instalator programu Visual Studio i są zgodne z następującymi ogólnymi regułami:
- Jeśli parametr wiersza polecenia nie przyjmuje żadnych argumentów (na przykład
--quiet
, ,--passive
includeRecommended
,removeOos
useLatestInstaller
, , ,allowUnsignedExtensions
itp.), wartość w pliku odpowiedzi powinna mieć wartość true/false. - Jeśli parametr przyjmuje argument (na przykład
--installPath <dir>
,--config <*.vsconfig file>
), wartość w pliku odpowiedzi powinna być ciągiem. - Jeśli parametr przyjmuje argument i może pojawić się w wierszu polecenia więcej niż raz (na przykład
--add <id>
), wartość w pliku odpowiedzi powinna być tablicą ciągów.
Parametry określone w wierszu polecenia zastępują ustawienia zawarte w pliku odpowiedzi, z wyjątkiem sytuacji, gdy parametry przyjmują wiele danych wejściowych (na przykład --add
). Jeśli masz wiele danych wejściowych, dane wejściowe podane w wierszu polecenia są scalane z ustawieniami z pliku odpowiedzi.
Konfigurowanie pliku odpowiedzi używanego podczas instalowania z układu
Jeśli układ został utworzony przy użyciu --layout
polecenia , domyślny response.json
plik zostanie utworzony w folderze głównym folderu układu. oczekuje się, że Administracja istratory odpowiednio zmodyfikują i dostosują plik odpowiedzi przed zainstalowaniem na komputerze klienckim. Dzięki temu mogą kontrolować początkowe ustawienia konfiguracji klienta.
Ustawienia konfiguracji w response.json
pliku są przywołyane tylko podczas wykonywania programu inicjatora (np. vs_enterprise.exe). Inicjatory uruchamiania są zwykle używane do przeprowadzania początkowej instalacji na kliencie, ale czasami są używane do aktualizowania klienta. Element response.json
nigdy nie jest używany podczas lokalnego uruchamiania instalatora na kliencie.
Jeśli administrator utworzył układ częściowy, response.json
domyślny plik w układzie określi tylko obciążenia i języki uwzględnione w układzie częściowym.
Jeśli układ zostanie utworzony przez przekazanie --config *.vsconfig
pliku, *.vsconfig
plik zostanie skopiowany do katalogu układu, ponieważ layout.vsconfig
ten plik konfiguracji zostanie przywoływane w response.json
pliku. W ten sposób można użyć plików konfiguracji do inicjowania instalacji klientów pochodzących z układu.
Pamiętaj, aby zwrócić szczególną uwagę na ustawienie channelUri, które konfiguruje miejsce, w którym klient będzie szukać aktualizacji. Domyślną konfiguracją jest, aby klient przeglądał serwery hostowane przez firmę Microsoft w Internecie w celu uzyskania aktualizacji. Musisz zmienić wartość identyfikatora channelUri i wskazać go w układzie, jeśli klienci mają pobierać aktualizacje z układu. Przykłady tego, jak to zrobić, zostały szczegółowo opisane poniżej. Zawsze można zmienić miejsce, w którym klient szuka aktualizacji w przyszłości, wykonując instalator na kliencie i wywołując modifySettings
polecenie .
Jeśli instalacja klienta nie jest wykonywana w --quiet
trybie lub --passive
nie jest wykonywana, użytkownicy mogą zastąpić wartości domyślne określone w i response.json
i dalej wybierać lub usuwać zaznaczenie dodatkowych obciążeń i składników do zainstalowania.
Ostrzeżenie
Podczas edytowania właściwości zdefiniowanych response.json
podczas tworzenia układu należy zachować ostrożność, ponieważ niektóre elementy są wymagane do instalacji.
Plik podstawowy response.json
w układzie powinien wyglądać podobnie do poniższego przykładu, z tą różnicą, że identyfikator productID odzwierciedla edycję w układzie.
{
"installChannelUri": ".\\ChannelManifest.json",
"channelUri": "https://aka.ms/vs/16/release/channel",
"installCatalogUri": ".\\Catalog.json",
"channelId": "VisualStudio.16.Release",
"productId": "Microsoft.VisualStudio.Product.Enterprise"
}
{
"installChannelUri": ".\\ChannelManifest.json",
"channelUri": "https://aka.ms/vs/17/release/channel",
"installCatalogUri": ".\\Catalog.json",
"channelId": "VisualStudio.17.Release",
"productId": "Microsoft.VisualStudio.Product.Enterprise"
}
{
"installChannelUri": ".\\ChannelManifest.json",
"channelUri": "https://aka.ms/vs/17/release.ltsc.17.0/channel",
"installCatalogUri": ".\\Catalog.json",
"channelId": "VisualStudio.17.Release.LTSC.17.0",
"productId": "Microsoft.VisualStudio.Product.Enterprise"
}
Podczas tworzenia lub aktualizowania układu tworzony jest również plik response.template.json. Ten plik zawiera wszystkie identyfikatory obciążenia, składnika i języka, których można użyć. Ten plik jest dostarczany jako szablon dla wszystkich elementów, które można uwzględnić w instalacji niestandardowej. Administracja istratory mogą używać tego pliku jako punktu wyjścia dla niestandardowego pliku odpowiedzi. Po prostu usuń identyfikatory dla rzeczy, których nie chcesz instalować i zapisywać w response.json
pliku lub własnym pliku odpowiedzi. Nie dostosuj pliku response.template.json lub zmiany zostaną utracone za każdym razem, gdy układ zostanie zaktualizowany.
Przykładowa zawartość pliku odpowiedzi dostosowanego układu
Poniższy response.json
przykładowy plik zainicjuje instalację klienta programu Visual Studio 2019 Enterprise, aby wybrać kilka typowych obciążeń i składników, aby wybrać zarówno języki angielski, jak i francuski oraz skonfigurować lokalizację aktualizacji do wyszukiwania źródeł w układzie hostowanym w sieci. Należy pamiętać, że w przypadku programu Visual Studio 2019 lokalizacja aktualizacji (channelUri) może być skonfigurowana tylko podczas instalacji początkowej i nie można jej zmienić po fakcie , chyba że używasz funkcji w najnowszym instalatorze. Zapoznaj się z artykułem Konfigurowanie zasad dla wdrożeń programu Visual Studio w przedsiębiorstwie i Konfigurowanie układu, aby zawsze dołączać i udostępniać najnowsze instalatory, aby uzyskać informacje na temat konfigurowania tego rozwiązania .
{
"installChannelUri": ".\\ChannelManifest.json",
"channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
"installCatalogUri": ".\\Catalog.json",
"channelId": "VisualStudio.16.Release",
"productId": "Microsoft.VisualStudio.Product.Enterprise",
"installPath": "C:\\VS2019",
"quiet": false,
"passive": false,
"includeRecommended": true,
"norestart": false,
"useLatestInstaller": true,
"removeOos": true,
"addProductLang": [
"en-US",
"fr-FR"
],
"add": [
"Microsoft.VisualStudio.Workload.ManagedDesktop",
"Microsoft.VisualStudio.Workload.Data",
"Microsoft.VisualStudio.Workload.NativeDesktop",
"Microsoft.VisualStudio.Workload.NetWeb",
"Microsoft.VisualStudio.Workload.Office",
"Microsoft.VisualStudio.Workload.Universal",
"Component.GitHub.VisualStudio"
]
}
W poniższym przykładzie response.json
plik inicjuje instalację klienta programu Visual Studio 2022 Enterprise:
- Używa pliku konfiguracji *.vsconfig, który definiuje obciążenia, składniki i rozszerzenia do zainstalowania
- Wybiera zarówno języki angielski, jak i francuski interfejs użytkownika
- Konfiguruje lokalizację aktualizacji pod kątem wyszukiwania źródeł w układzie hostowanym przez protokół HTTP
- Umożliwia programowe ładowanie niepodpisanych rozszerzeń
- Usuwa składniki, które przeszły do stanu braku obsługi w momencie aktualizowania klienta. Zobacz listę składników poza obsługą tutaj.
{
"installChannelUri": ".\\ChannelManifest.json",
"channelUri": "http://MyCompanyIntranetSite/VS2022Enterprise/ChannelManifest.json",
"installCatalogUri": ".\\Catalog.json",
"channelId": "VisualStudio.17.Release",
"productId": "Microsoft.VisualStudio.Product.Enterprise",
"arch": "x64",
"config": ".\\Layout.vsconfig"
"installPath": "C:\\VS2022",
"quiet": false,
"passive": false,
"includeRecommended": true,
"norestart": false,
"useLatestInstaller": true,
"removeOos": true,
"allowUnsignedExtensions": true,
"addProductLang": [
"en-US",
"fr-FR"
]
}
Ostrzeżenie
Jeśli używasz intranetowych układów hostowanych w sieci Web, nie możesz ustawić wartości "noWeb": true w response.json i oczekiwać, że będzie działać. Spowoduje to wyłączenie protokołu HTTP i uniemożliwi klientowi dostęp do witryny internetowej.
Rozwiązywanie problemów
Jeśli napotkasz problem z programem Visual Studio, który zgłasza błąd podczas parowania go z plikiem response.json
, zobacz Rozwiązywanie problemów z błędami związanymi z siecią podczas instalowania lub używania strony programu Visual Studio , aby uzyskać więcej informacji.
Pomoc techniczna lub rozwiązywanie problemów
Czasami coś może pójść źle. Jeśli instalacja programu Visual Studio nie powiedzie się, zobacz Rozwiązywanie problemów z instalacją i uaktualnianiem programu Visual Studio, aby uzyskać szczegółowe wskazówki.
Oto kilka dodatkowych opcji pomocy technicznej:
- Oferujemy opcję obsługi czatu instalacyjnego (tylko w języku angielskim) w przypadku problemów związanych z instalacją.
- Zgłoś problemy z produktami za pośrednictwem 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.
- Zasugeruj funkcję, śledź problemy z produktami i znajdź odpowiedzi w społeczności deweloperów programu Visual Studio.
Powiązana zawartość
- Przewodnik Administracja istratorów programu Visual Studio
- Tworzenie i obsługa instalacji sieciowej programu Visual Studio
- Wdrażanie programu Visual Studio z układu na maszynie klienckiej
- Konfigurowanie zasad dla wdrożeń przedsiębiorstwa
- Identyfikatory obciążeń i składników programu Visual Studio
- Rozwiązywanie problemów z błędami związanymi z siecią podczas instalowania lub używania programu Visual Studio