Konfigurace výchozího nastavení instalace pomocí souboru odpovědi

V tomto článku se dozvíte, jak vytvořit soubor odpovědi, který vám pomůže automatizovat instalaci sady Visual Studio. Nejčastěji se používá při instalaci sady Visual Studio z rozložení.

Soubor odpovědí sady Visual Studio je soubor JSON , jehož obsah obsahuje vlastní nastavení použitá při počáteční instalaci sady Visual Studio do klienta. Jeho obsah zrcadlí argumenty a parametry příkazového řádku. Soubor odpovědi použijte pro následující možnosti konfigurace:

• Při počáteční instalaci nakonfigurujte, které úlohy, komponenty nebo jazyky mají být ve výchozím nastavení vybrány.
• Odkazujte na konfigurační *.vsconfig soubor instalace, na který váš tým standardizoval.
• Určete , odkud má klient přijímat aktualizace. Mezi příklady patří výchozí servery hostované Microsoftem na internetu nebo z umístění rozložení sítě řízeného správcem.
• Automatické odebrání komponent mimo podporu během aktualizací.

Vytvoření souboru odpovědi

Soubor response.json se obvykle vytvoří, když správce vytvoří rozložení a najdete ho v kořenové složce rozložení. Pomocí jednoho z následujících příkladů ale můžete vytvořit vlastní soubor odpovědí.

Zadání souboru odpovědi

Pokud správce nasadí Sadu Visual Studio vyvoláním bootstrapperu z rozložení, soubor odpovědi nalezený v kořenovém adresáři rozložení se automaticky použije. Správci se také můžou rozhodnout explicitně zadat jiný soubor odpovědi pomocí parametru --in , jak je znázorněno v následujícím příkladu:

\\server\share\layoutdirectory\vs_enterprise.exe --in custom_response_file.json

Obsah souboru odpovědi

Soubor odpovědi zapouzdřuje parametry příkazového řádku používané Instalační program pro Visual Studio a řídí se těmito obecnými pravidly:

• Pokud parametr příkazového řádku nepřijímá žádné argumenty (například --quiet, --passive, includeRecommended, removeOos, useLatestInstaller, , allowUnsignedExtensionsatd.), hodnota v souboru odpovědi by měla být true/false.
• Pokud parametr přebírá argument (například --installPath <dir>, --config <*.vsconfig file>), hodnota v souboru odpovědi by měla být řetězec.
• Pokud parametr přebírá argument a může se zobrazit na příkazovém řádku více než jednou (například --add <id>), hodnota v souboru odpovědi by měla být pole řetězců.

Parametry zadané na příkazovém řádku přepíší nastavení, která jsou součástí souboru odpovědi, s výjimkou toho, že parametry přebírají více vstupů (například --add). Pokud máte více vstupů, vstupy zadané na příkazovém řádku se sloučí s nastavením ze souboru odpovědi.

Konfigurace souboru odpovědi použitého při instalaci z rozložení

Pokud pomocí příkazu vytvoříte rozložení --layout , vytvoří se výchozí response.json soubor v kořenové složce rozložení. Před instalací na klientský počítač se očekává, že správci upraví a přizpůsobí soubor odpovědí. Tímto způsobem můžou řídit počáteční nastavení konfigurace klienta.

Nastavení konfigurace v response.json souboru se odkazuje pouze při spuštění bootstrapperu (například vs_enterprise.exe). Bootstrappery se obvykle používají k provedení počáteční instalace klienta, ale někdy se používají také k aktualizaci klienta. Nikdy response.json se nepoužívá při místním spuštění instalačního programu v klientovi.

Pokud správce vytvořil částečné rozložení, pak výchozí response.json soubor v rozložení určuje pouze úlohy a jazyky, které byly součástí částečného rozložení.

Pokud se rozložení vytvoří předáním --config *.vsconfig souboru, *.vsconfig zkopíruje se soubor do adresáře rozložení, protože layout.vsconfig na response.json tento konfigurační soubor se odkazuje v souboru. Tímto způsobem můžete pomocí konfiguračních souborů inicializovat instalace klientů, které pocházejí z rozložení.

Nezapomeňte věnovat zvláštní pozornost nastavení channelUri, které konfiguruje , kde klient hledá aktualizace. Výchozí konfigurace je, aby klient hledal aktualizace na serverech hostovaných Microsoftem na internetu. Pokud chcete, aby klienti získali aktualizace z vašeho rozložení, musíte změnit hodnotu channelUri a nasměrovat ji na vaše rozložení. Příklady, jak to udělat, jsou podrobně popsány níže. Vždy můžete změnit, kde klient hledá aktualizace v budoucnu spuštěním instalačního programu na klientovi a vyvoláním modifySettings příkazu.

Pokud se instalace klienta neprovede pomocí --quiet nebo --passive režimu, můžou uživatelé přepsat výchozí hodnoty zadané v response.json nástroji a dále vybrat nebo zrušit výběr dalších úloh a součástí, které chcete nainstalovat.

Upozorňující

Při úpravách vlastností definovaného response.json při vytváření rozložení buďte velmi opatrní, protože některé položky jsou vyžadovány pro instalaci.

Základní response.json soubor v rozložení by měl vypadat podobně jako v následujícím příkladu, s tím rozdílem, že id produktu by odráželo edici ve vašem rozložení.

{
  "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"
}

Při vytváření nebo aktualizaci rozložení se vytvoří také soubor response.template.json. Tento soubor obsahuje všechna ID úloh, komponent a jazyků, které je možné použít. Tento soubor je k dispozici jako šablona pro to, co všechno může být součástí vlastní instalace. Správci můžou tento soubor použít jako výchozí bod pro vlastní soubor odpovědí. Stačí odebrat ID věcí, které nechcete nainstalovat, a uložit je do response.json souboru nebo do vlastního souboru odpovědi. Při každé aktualizaci rozložení nepřizpůsobte soubor response.template.json nebo dojde ke ztrátě změn.

Příklad přizpůsobeného obsahu souboru odpovědi rozložení

Následující response.json příklad souboru inicializuje instalaci klienta sady Visual Studio Enterprise tak, aby vybral několik běžných úloh a komponent, aby vybral jazyky anglického i francouzského uživatelského rozhraní a aby umístění aktualizace nakonfigurované tak, aby hledalo zdroje v rozložení hostované v síti. Informace o konfiguraci tohoto postupu najdete v tématu Konfigurace zásad pro podniková nasazení sady Visual Studio a konfigurace rozložení tak, aby vždy obsahovala a poskytla nejnovější instalační program .

{
  "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"
    ]
}

V následujícím příkladu response.json soubor inicializuje instalaci klienta Visual Studio Enterprise, který:

• Používá konfigurační soubor *.vsconfig, který definuje, jaké úlohy, komponenty a rozšíření se mají nainstalovat.
• Vybere jazyky uživatelského rozhraní pro angličtinu i francouzštinu.
• Nakonfiguruje umístění aktualizace tak, aby hledalo zdroje v rozložení hostovaného protokolem HTTP.
• Umožňuje programové načítání nepodepsaných rozšíření.
• Odebere komponenty převedené do stavu mimo podporu v době aktualizace klienta. Seznam komponent mimo podporu najdete tady.

{
  "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"
    ]

}

Upozorňující

Pokud používáte rozložení hostovaná na intranetu, nemůžete v response.json nastavit "noWeb": true a očekáváte, že bude fungovat. Tím zakážete protokol HTTP a zabráníte klientovi v přístupu k webu.

Řešení problému

Pokud narazíte na problém se zaváděcím nástrojem sady Visual Studio, který vyvolá chybu při párování se souborem response.json , další informace najdete v tématu Řešení chyb souvisejících se sítí při instalaci nebo použití stránky sady Visual Studio .

Podpora nebo řešení potíží

Někdy se věci můžou pokazit. Pokud se instalace sady Visual Studio nezdaří, pokyny najdete v tématu Řešení potíží s instalací a upgradem sady Visual Studio.

Tady je několik dalších možností podpory:

• V případě problémů souvisejících s instalací použijte možnost podpory prostřednictvím instalačního chatu (pouze v angličtině).
• Nahlašte nám problémy s produktem pomocí nástroje Nahlásit problém, který se zobrazí v instalačním programu sady Visual Studio i v integrovaném vývojovém prostředí sady Visual Studio. Pokud jste správce IT a nemáte nainstalovanou sadu Visual Studio, můžete odeslat zpětnou vazbu správce IT.
• Navrhněte funkci, sledujte problémy s produktem a najděte odpovědi v komunitě vývojářů sady Visual Studio.

Související obsah

• Příručka pro správce sady Visual Studio
• Vytvoření a údržba síťové instalace sady Visual Studio
• Nasazení sady Visual Studio z rozložení na klientský počítač
• Konfigurace zásad pro podniková nasazení
• ID úloh a komponent sady Visual Studio
• Řešení chyb souvisejících se sítí při instalaci nebo používání sady Visual Studio