Udostępnij za pośrednictwem

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

  • Artykuł

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 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 wdraża program Visual Studio przez wywołanie programu inicjatora z układu, plik odpowiedzi znaleziony w katalogu głównym układu jest automatycznie używany. 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, , --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 tworzysz układ przy użyciu --layout polecenia , domyślny response.json plik 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 response.json pliku są przywołyane tylko podczas wykonywania programu inicjują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. 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śla tylko obciążenia i języki uwzględnione w układzie częściowym.

Jeśli układ jest tworzony przez przekazanie --config *.vsconfig pliku, *.vsconfig plik zostanie skopiowany do katalogu layout jako layout.vsconfig i ten plik konfiguracji jest 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 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. Administratorzy 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

response.json Poniższy przykładowy plik inicjuje instalację klienta programu Visual Studio Enterprise, aby wybrać kilka typowych obciążeń i składników, wybrać języki angielski i francuski interfejs użytkownika oraz skonfigurować lokalizację aktualizacji do wyszukiwania źródeł w układzie hostowanym w sieci. W przypadku programu Visual Studio 2019 lokalizację aktualizacji (channelUri) można skonfigurować 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"
    ]
}

response.json Poniższy przykładowy plik inicjuje instalację klienta programu Visual Studio Enterprise, aby wybrać kilka typowych obciążeń i składników, wybrać języki angielski i francuski interfejs użytkownika oraz skonfigurować lokalizację aktualizacji do wyszukiwania źródeł w układzie hostowanym w sieci. 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.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 response.json plik inicjuje instalację klienta programu Visual Studio 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:

  • Użyj opcji obsługi (tylko w języku angielskim) czatu instalacji 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 społeczności deweloperów programu Visual Studio.

Powiązana zawartość