Konfigurowanie domyślnych ustawień instalacji przy użyciu pliku odpowiedzi

Z tego artykułu dowiesz się, jak utworzyć plik odpowiedzi, który pomaga zautomatyzować instalację programu Visual Studio. Najczęściej używa się go podczas instalowania programu Visual Studio z układu .

Plik odpowiedzi programu Visual Studio jest plikiem JSON, którego zawartość zawiera dostosowania używane podczas początkowej instalacji programu Visual Studio na kliencie. Jego zawartość odzwierciedla argumenty wiersza polecenia i parametry . 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.
• Odnosić się do pliku konfiguracji instalacji *.vsconfig, na którym zespół się ustandaryzował.
• Określ , gdzie klient powinien otrzymywać aktualizacje od. Przykłady obejmują domyślne serwery hostowane przez firmę Microsoft w Internecie lub z lokalizacji układu sieciowego kontrolowanej przez administratora.
• Automatyczne usuwanie niewspieranych komponentów 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 wdraża Visual Studio, wywołując bootstrapper z układu, plik odpowiedzi znajdujący się w katalogu głównym tego układu jest używany automatycznie. Administratorzy 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, allowUnsignedExtensionsitp.), 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 tworzysz układ przy użyciu polecenia --layout, domyślny plik response.json zostanie utworzony w katalogu głównym folderu układu. Administratorzy powinni odpowiednio zmodyfikować i dostosować plik odpowiedzi przed zainstalowaniem na komputerze klienckim. Dzięki temu mogą kontrolować początkowe ustawienia konfiguracji klienta.

Ustawienia konfiguracji w pliku response.json są przywoływane tylko podczas wykonywania programu ładującego (na przykład vs_enterprise.exe). Inicjatory uruchamiania są zwykle używane do przeprowadzania początkowej instalacji na kliencie, ale czasami są używane do aktualizowania klienta. response.json nigdy nie jest używana podczas lokalnego uruchamiania instalatora na kliencie.

Jeśli administrator utworzył układ częściowy, domyślny plik response.json w układzie określa tylko obciążenia i języki, które zostały uwzględnione w układzie częściowym.

Gdy układ tworzony jest przez przekazanie pliku --config *.vsconfig, plik *.vsconfig zostaje skopiowany do katalogu układu jako layout.vsconfig, a ten plik konfiguracji jest przywoływany w pliku response.json. 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 , w którym klient szuka aktualizacji. Domyślną konfiguracją jest, aby klient przeglądał serwery hostowane przez firmę Microsoft w Internecie w celu uzyskania aktualizacji. Musisz zmienić wartość adresu channelUri i wskazać go na swój układ, jeśli klienci mają pobierać aktualizacje z Twojego układu. Przykłady tego, jak to zrobić, są szczegółowo opisane poniżej . Zawsze można zmienić lokalizację, w której klient szuka aktualizacji w przyszłości, wykonanie instalatora na kliencie i wywołanie polecenia modifySettings.

Jeśli instalacja klienta nie jest wykonywana przy użyciu trybu --quiet lub --passive, użytkownicy mogą zastąpić wartości domyślne określone w response.json, a następnie wybrać lub usunąć zaznaczenie dodatkowych obciążeń i składników do zainstalowania.

Ostrzeżenie

Podczas edytowania właściwości w response.json zdefiniowanych podczas tworzenia układu należy zachować ostrożność, ponieważ niektóre elementy są wymagane do instalacji.

Plik response.json główny w układzie powinien przypominać poniższy przykład, z tą różnicą, że identyfikator produktu odzwierciedla edycję w układzie.

{
  "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. Administratorzy mogą używać tego pliku jako punktu wyjścia dla niestandardowego pliku odpowiedzi. Po prostu usuń identyfikatory rzeczy, których nie chcesz instalować, i zapisz je w pliku response.json lub w swoim 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 układu dostosowanego

Poniższy przykład pliku response.json inicjalizuje instalację klienta Visual Studio Enterprise, aby wybrać kilka typowych zestawów funkcji i składników, wybrać języki interfejsu użytkownika angielski i francuski oraz skonfigurować lokalizację aktualizacji tak, aby wyszukiwała źródła w układzie hostowanym w sieci. Zapoznaj się z Skonfiguruj zasady wdrożeń korporacyjnych dla Visual Studio oraz Skonfiguruj swój układ, aby zawsze zawierał i dostarczał najnowszy instalator, aby uzyskać informacje na temat konfigurowania tego rozwiązania.

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise",

  "installPath": "C:\\VS2022",
  "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 plik response.json inicjuje instalację klienta programu Visual Studio Enterprise, który:

• 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 do wyszukiwania źródeł w układzie hostowanym w protokole http
• Umożliwia programistyczne ładowanie niepodpisanych rozszerzeń
• Usuwa składniki, które przeszły do stanu zakończenia wsparcia w czasie aktualizowania klienta. Zobacz listę niewspieranych składników 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 wystąpi problem z programem inicjującym Visual Studio, który zgłasza błąd podczas parowania z plikiem response.json, zapoznaj się ze stroną Rozwiązywanie problemów z błędami związanymi z siecią podczas instalowania lub używania 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:

• Użyj opcji obsługi czatu instalacji (tylko w języku angielskim) w przypadku problemów związanych z instalacją.
• Zgłoś problemy z produktem za pomocą narzędzia Zgłoś problem, które jest wyświetlane zarówno w Instalatorze 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ę administratora IT.
• Zasugeruj funkcję, śledź problemy z produktami i znajdź odpowiedzi w witrynie Visual Studio Developer Community.

Powiązana zawartość

• Przewodnik administratorów programu Visual Studio
• Tworzenie i obsługa instalacji sieciowej programu Visual Studio
• Wdrażanie Programu Visual Studio z układu na komputer kliencki
• 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