Import nebo export konfigurací instalace

Konfigurační soubory instalace můžete použít ke konfiguraci toho, co sada Visual Studio nainstaluje. Provedete to tak, že pomocí instalačního programu sady Visual Studio exportujete informace o úlohách, komponentách a rozšíření Marketplace do souboru .vsconfig . Jakmile máte soubor .vsconfig , můžete ho dále upřesnit a přidat nebo odebrat další položky. Struktura a syntaxe souboru .vsconfig je popsána v části formátu souboru vsconfig .

Konfigurační soubor můžete také importovat do nové nebo existující instalace sady Visual Studio, použít ho k vytvoření nebo úpravě rozložení nebo offline instalace, umístění do adresáře řešení nebo úložiště a aktivaci instalace chybějících komponent a jeho sdílení s ostatními.

Export konfigurace pomocí instalačního programu sady Visual Studio

Konfigurační soubor instalace můžete exportovat z dříve nainstalované instance sady Visual Studio.

Poznámka

Počínaje verzí 17.10 Preview sady Visual Studio 2022 můžete exportovat rozšíření Visual Studio Marketplace načtená v kontextu celé instance do souboru .vsconfig . Pokud chcete, aby funkce export mohla exportovat jiné typy rozšíření, jako jsou například rozšíření načtená ze sdílené síťové složky nebo načtené v kontextu uživatele, nás prosím dejte vědět.

Použití uživatelského rozhraní instalačního programu sady Visual Studio

  1. V nabídce Start otevřete instalační program sady Visual Studio.

  2. Na kartě produktu zvolte tlačítko Další a pak vyberte Exportovat konfiguraci .

    Snímek obrazovky s exportem konfigurace z karty produktu v instalačním programu sady Visual Studio

  3. Přejděte nebo zadejte umístění, kam chcete uložit soubor .vsconfig , a pak zvolte Zkontrolovat podrobnosti.

    Snímek obrazovky s polem Exportovat umístění v konfiguraci instalace

  4. Ověřte, že jsou vaše výběry přesné, a pak zvolte Exportovat.

Export konfiguračního souboru prostřednictvím kódu programu

Konfigurační soubor konkrétní instance sady Visual Studio můžete exportovat prostřednictvím kódu programu pomocí export příkazu. Další informace najdete v tématu Použití parametrů příkazového řádku k instalaci, aktualizaci a správě sady Visual Studio.

Import konfigurace pomocí instalačního programu sady Visual Studio

Konfigurační soubor instalace můžete importovat do dříve nainstalované instance sady Visual Studio nebo ho můžete použít k inicializaci nové instalace sady Visual Studio. Import konfiguračního souboru do sady Visual Studio nainstaluje všechno uvedené v konfiguračním souboru, který ještě není nainstalovaný.

Způsob použití souboru .vsconfig závisí na tom, jestli je již nainstalován Visual Studio:

  • Pokud Visual Studio ještě není nainstalované, použijte spouštěcí program edice (například vs_professional.exe) s parametrem --config.
  • Pokud je Visual Studio již nainstalován, použijte modify s --config (napříkladsetup.exe modify).

Použití uživatelského rozhraní instalačního programu sady Visual Studio

Až budete připraveni importovat konfigurační soubor instalace, postupujte podle těchto kroků.

  1. Otevřete instalační program sady Visual Studio a zavřete Visual Studio. Většina operací instalačního programu vyžaduje zavření samotného produktu Visual Studio.

  2. Na kartě Nainstalovaná nebo na kartě Dostupná vyberte Další>Konfigurace importu na kartě produktu Visual Studio.

  3. Vyhledejte soubor .vsconfig , který chcete importovat, a pak zvolte Zkontrolovat podrobnosti.

  4. Ověřte, že jsou vaše výběry přesné, a pak zvolte Upravit.

Programové použití konfiguračního souboru pro novou instalaci

Pokud chcete použít soubor .vsconfig během první instalace, stáhněte si správný bootstrapper, který odpovídá požadované verzi a edici (například vs_professional.exe). Pak otevřete příkazový řádek správce a spusťte bootstrapper s parametrem --config .

vs_professional.exe --config "C:\myconfig.vsconfig" --passive --wait

Pokud chcete umístění instalace nastavit explicitně, zahrňte --installPath.

vs_professional.exe --installPath "C:\Program Files\Microsoft Visual Studio\18\Professional" --config "C:\myconfig.vsconfig" --passive --wait

vs_professional.exe --installPath "C:\Program Files\Microsoft Visual Studio\2022\Professional" --config "C:\myconfig.vsconfig" --passive --wait

Important

Při první instalaci použijte bootstrapper pro danou edici (vs_professional.exe, vs_enterprise.exe a tak dále), nikoli setup.exe modify.

Pokud váš soubor .vsconfig obsahuje rozšíření a pracujete v režimu --passive nebo --quiet, zahrňte --allowUnsignedExtensions.

Programové použití konfiguračního souboru k přidání komponent do existující instalace

Parametr --config můžete použít s parametrem modify k přidání komponent do stávající instalace. Následující příklad používá instalační program na klientském počítači k modify existující instalaci.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\Program Files\Microsoft Visual Studio\18\Professional" --config "C:\myconfig.vsconfig" --passive --allowUnsignedExtensions

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\Program Files\Microsoft Visual Studio\2022\Professional" --config "C:\myconfig.vsconfig" --passive --allowUnsignedExtensions

Poznámka

Pokud chcete přidat komponenty do existující instalace pomocí souboru .vsconfig , musíte použít modify a neupdate. Příkaz update pouze aktualizuje existující nainstalované komponenty na nejnovější verzi. Další informace o různých operacích instalačního programu najdete v dokumentaci Instalace sady Visual Studio z příkazového řádku.

Inicializace obsahu rozložení pomocí konfiguračního souboru

Pomocí správného bootstrapperu, který odpovídá požadované verzi a edici sady Visual Studio, otevřete příkazový řádek správce a spuštěním následujícího příkazu použijte parametr --config ke konfiguraci obsahu rozložení. Další informace o použití souborů .vsconfig k inicializaci a instalaci z rozložení naleznete v tématu Použití konfiguračního souboru k inicializaci obsahu rozložení.

vs_enterprise.exe --layout "c:\localVSlayout" --config "c:\myconfig.vsconfig" --lang en-US

Použití konfiguračního souboru k automatické instalaci chybějících komponent

Pokud soubor .vsconfig uložíte do kořenového adresáře řešení a pak otevřete řešení, Visual Studio automaticky rozpozná chybějící komponenty a vyzve vás k jejich instalaci.

Poznámka

Pokud váš soubor .vsconfig obsahuje rozšíření, v současné době pouze rozšíření hostovaná v Visual Studio Marketplace aktivují automatické zjišťování a instalaci. Pokud chcete, aby tato logika zahrnovala rozšíření nainstalovaná z umístění mimo Marketplace, uveďte podrobnosti o vašem scénáři.

Snímek obrazovky Průzkumníka řešení s návrhem dalších komponent

Snímek obrazovky Průzkumníka řešení s návrhem dalších komponent

Vytvořili jsme také nástroj s otevřeným zdrojovým kódem, který rekurzivně vyhledá konfigurační soubory instalace sady Visual Studio .vsconfig a sloučí je dohromady. Další informace o tomto nástroji najdete v tématu VSConfigFinder na GitHubu.

Formát souboru vsconfig

Soubor .vsconfig je formát souboru JSON, který obsahuje oddíl komponent a volitelně oddíl rozšíření. Část komponenty obsahuje úlohy a komponenty a vypadá takto:

{
  "version": "1.0", 
  "components": [ 
    "Microsoft.VisualStudio.Component.CoreEditor", 
    "Microsoft.VisualStudio.Workload.CoreEditor", 
    "Microsoft.VisualStudio.Component.NuGet" 
    ] 
}

Rozšíření

Počínaje sadou Visual Studio 2022 verze 17.9 můžete zadat rozšíření v souboru .vsconfig a pomocí instalačního programu sady Visual Studio je načíst na celém počítači a zpřístupnit je všem uživatelům. Počínaje sadou Visual Studio 2022 verze 17.10 Preview, můžete pomocí instalačního programu Visual Studio přidat rozšíření z Visual Studio Marketplace do souboru export, které byly načteny v rámci celé instance, jak je popsáno dříve.

Existuje několik známých výhrad ohledně podporovaných přípon v konfiguračním souboru.

  • Vzhledem k tomu, že rozšíření načtená prostřednictvím konfiguračního souboru jsou nainstalovaná v celé instanci, musíte mít oprávnění správce nebo mít udělenou kontrolu nad instalačním programem prostřednictvím zásad AllowStandardUserControl, aby je bylo možné nainstalovat. Všechna rozšíření nainstalovaná správcem rozšíření sady Visual Studio měla možnost instalace (a obvykle byla) nainstalovaná pro jednotlivé uživatele, ne pro celou instanci a uživatel nemusel mít oprávnění správce k instalaci.
  • Instalační program sady Visual Studio v současné době podporuje pouze import určitých typů rozšíření, například těch obsažených v *.vsix balíčku nebo těch, které nejsou příliš složité. Pokud máte příponu, která se nenačítá přes konfigurační soubor správně, dejte nám o ní vědět prostřednictvím nového návrhu komunity vývojářů.
  • Pokud je soubor .vsconfig v adresáři řešení, aktivují automatické zjišťování a instalaci jenom rozšíření hostovaná na Visual Studio Marketplace. Pokud chcete, aby tato logika zahrnovala rozšíření nainstalovaná z umístění mimo Marketplace, uveďte podrobnosti o vašem scénáři.
  • Pokud programově používáte soubor .vsconfig k přidání rozšíření, musíte také použít --allowUnsignedExtensions parametr, který umožní načtení nepodepsaných rozšíření v --passive nebo v --quiet kontextu. Pokud instalujete z rozložení, můžete do souboru "allowUnsignedExtensions" : true přidat syntaxi response.json, abyste dosáhli podobného efektu.

Všechna rozšíření pro celou instanci se automaticky aktualizují přibližně jednou denně prostřednictvím naplánované úlohy. Další informace naleznete v tématu Automatické aktualizace rozšíření.

Formát souboru .vsconfig , který obsahuje přípony, by měl vypadat takto.

{
  "version": "1.0", 
  "components": [ 
    // Whatever components you want to install come here, in quotes, separated by commas.
    // You can use the installer to select the components you want to install and then export them,
    // Or you can specify the ones you want according to the [component-id's](https://learn.microsoft.com/en-us/visualstudio/install/workload-and-component-ids).
    // This array should not be null! If you don't want to install any component, just leave the array empty.
  ],
  "extensions": [
    // The extensions you want to install are specified in this section, in quotes, separated by commas.
    // Extensions are optional in .vsconfig, so if you don't want any, you can delete the entire extensions section.
    // The extensions must be in a *.vsix package
    // Make sure that the extensions you specify are designed to work with that version of Visual Studio.
    // examples below
    "https://marketplace.visualstudio.com/items?itemName=MadsKristensen.ImageOptimizer64bit",   //unsigned extension
    "https://marketplace.visualstudio.com/items?itemName=vsext.RegexMatchVisualizer",  //signed extension
    "c:\\mylocaldrive\\someextension.vsix",
    "\\\\server\\share\\myextension.vsix",
    "https://myweb/anotherextension.vsix"
  ]
}

Podpora nebo řešení potíží

Někdy se věci můžou pokazit. Pokud instalace sady Visual Studio selže, přečtěte si Řešení potíží s instalací a upgradem sady Visual Studio podrobné pokyny.

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

  • Pro řešení problémů souvisejících s instalací použijte možnost podpory 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 vývojářské komunitě sady Visual Studio.

Související obsah

  • Last updated on