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

  • Artykuł

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:

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, , --passiveincludeRecommended, removeOosuseLatestInstaller, , , 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 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:

{
  "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ść