Import nebo export konfigurací instalace

Konfigurační soubory instalace můžete použít ke konfiguraci toho, co sada Visual Studio nainstaluje. Uděláte 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 níže. 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

Od sady Visual Studio 2022 verze 17.10 Preview teď můžete exportovat rozšíření Visual Studio Marketplace, které byly načteny 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. Otevřete instalační program sady Visual Studio.

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

   

3. Vyhledejte nebo zadejte umístění, kam chcete soubor .vsconfig uložit, a pak vyberte Zkontrolovat podrobnosti.

   

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 programově exportovat pomocí příkazu export, jak je popsáno v dokumentaci Instalace sady Visual Studio z příkazového řádku.

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ý.

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 potom 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 k přidání komponent do existující instalace

Pomocí parametru --config můžete inicializovat nebo upravit existující instalaci a přidat součásti. 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\2022\Professional" --config "C:\myconfig.vsconfig" --passive --allowUnsignedExtensions

Poznámka

Pokud chcete přidat komponenty do existující instalace pomocí konfiguračního souboru (*.vsconfig), budete muset modify nainstalovaný produkt a ne update. 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 zde.

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áš *.vsconfig soubor obsahuje rozšíření, v současné době se automatické zjišťování a instalace spustí pouze u rozšíření hostovaných 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.

Můžete také vygenerovat soubor *.vsconfig přímo z průzkumníka řešení .

1. Klikněte pravým tlačítkem na soubor řešení.

2. Vyberte Přidat instalační konfigurační soubor>.

3. Potvrďte umístění, kam chcete soubor .vsconfig uložit, a pak zvolte Zkontrolovat podrobnosti.

4. Ujistěte se, že máte požadované úlohy a komponenty, a pak zvolte Export.

Také jsme vytvořili open source nástroj, který rekurzivně vyhledá konfigurační soubory instalace sady Visual Studio označené jako *.vsconfig a všechny je sloučí dohromady. Další informace o nástroji VSConfigFinder najdete zde.

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.9můžete určit rozšíření v souboru *.vsconfig a pomocí instalačního programu sady Visual Studio je nainstalovat na úrovni celého počítače, což je zpřístupňuje pro všechny uživatele. Počínaje sadou Visual Studio 2022 verze 17.10 Preview můžete pomocí instalačního programu sady Visual Studio export rozšíření Visual Studio Marketplace do souboru *.vsconfig, který byl načten v kontextu 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.

1. 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. Mějte na paměti, že všechna rozšíření, která dříve nainstaloval Správce rozšíření sady Visual Studio, měla možnost být nainstalovaná (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.
2. 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 balíčku *.vsix 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 tom vědět prostřednictvím nového návrhu komunity vývojářů.
3. Jenom rozšíření hostovaná na Visual Studio Marketplace spustí automatické zjišťování a instalaci chybějících rozšíření, pokud je soubor *.vsconfig v adresáři řešení. Pokud chcete, aby tato logika zahrnovala rozšíření nainstalovaná z umístění mimo Marketplace, uveďte podrobnosti o vašem scénáři.
4. Pokud programově používáte soubor *.vsconfig k přidání přípon, budete také muset použít nový parametr --allowUnsignedExtensions, aby bylo možné načíst nepodepsaná rozšíření v kontextu --passive nebo --quiet. 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 najdete zde.

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

• konfigurace sady Visual Studio ve vaší organizaci s blogovým příspěvkem .vsconfig z dubna 2019
• Vytvoření síťové instalace sady Visual Studio
• Aktualizace síťové instalace sady Visual Studio
• Řízení aktualizací nasazení sady Visual Studio
• Konfigurace zásad pro podniková nasazení