Standaardinstellingen voor installatie configureren met behulp van een antwoordbestand

In dit artikel leert u hoe u een antwoordbestand maakt waarmee u de installatie van Visual Studio kunt automatiseren. Het meest voorkomende gebruik is wanneer u Visual Studio installeert vanuit een indeling.

Het Visual Studio-antwoordbestand is een JSON--bestand waarvan de inhoud aanpassingen bevat die tijdens de eerste installatie van Visual Studio op de client zijn gebruikt. De inhoud weerspiegelt de opdrachtregelargumenten en parameters. Gebruik het antwoordbestand voor de volgende configuratieopties:

• Configureren welke workloads, onderdelen of talen standaard moeten worden geselecteerd tijdens de eerste installatie.
• Verwijs naar een -installatieconfiguratie *.vsconfig bestand die uw team heeft gestandaardiseerd.
• Geef op waar de client updates vanmoet ontvangen. Voorbeelden hiervan zijn de standaard door Microsoft gehoste servers op internet of vanaf een door de beheerder beheerde netwerkindelingslocatie.
• Automatisch verwijderen van niet-ondersteunde onderdelen tijdens updates.

Het antwoordbestand maken

Het response.json-bestand wordt meestal gemaakt wanneer een beheerder een indeling maakt en zich in de hoofdmap van de indeling bevindt. U kunt echter uw eigen antwoordbestand maken met behulp van een van de volgende voorbeelden.

Het antwoordbestand opgeven

Als een beheerder visual Studio implementeert door de bootstrapper aan te roepen vanuit een indeling, wordt het antwoordbestand dat in de hoofdmap van de indeling wordt gevonden, automatisch gebruikt. Beheerders kunnen er ook voor kiezen om expliciet een ander antwoordbestand op te geven met behulp van de parameter --in, zoals in het volgende voorbeeld:

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

Inhoud van antwoordbestand

Het antwoordbestand bevat opdrachtregelparameters die worden gebruikt door het Visual Studio-installatieprogramma en volgt deze algemene regels:

• Als een opdrachtregelparameter geen argumenten gebruikt (bijvoorbeeld --quiet, --passive, includeRecommended, removeOos, useLatestInstaller, allowUnsignedExtensions, enzovoort), moet de waarde in het antwoordbestand waar/onwaar zijn.
• Als de parameter een argument gebruikt (bijvoorbeeld --installPath <dir>, --config <*.vsconfig file>), moet de waarde in het antwoordbestand een tekenreeks zijn.
• Als de parameter een argument gebruikt en meerdere keren op de opdrachtregel kan worden weergegeven (bijvoorbeeld --add <id>), moet de waarde in het antwoordbestand een matrix met tekenreeksen zijn.

Parameters die zijn opgegeven op de opdrachtregel overschrijven de instellingen die zijn opgenomen in het antwoordbestand, behalve wanneer parameters meerdere invoer gebruiken (bijvoorbeeld --add). Wanneer u meerdere invoergegevens hebt, worden de invoer die op de opdrachtregel is opgegeven, samengevoegd met instellingen uit het antwoordbestand.

Het antwoordbestand configureren dat wordt gebruikt bij de installatie vanuit een indeling

Als u een indeling maakt met behulp van de opdracht --layout, wordt er een standaardbestand response.json gemaakt in de hoofdmap van de indelingsmap. Beheerders moeten het antwoordbestand naar verwachting op de juiste wijze wijzigen en aanpassen voordat installeren op een clientcomputer. Op die manier kunnen ze de initiële configuratie-instellingen van de client beheren.

Er wordt alleen naar de configuratie-instellingen in het response.json-bestand verwezen bij het uitvoeren van een bootstrapper- (bijvoorbeeld vs_enterprise.exe). Bootstrappers worden meestal gebruikt om de eerste installatie op de client uit te voeren, maar soms worden ze ook gebruikt om een client bij te werken. De response.json wordt nooit gebruikt wanneer u het installatieprogramma lokaal op de client start.

Als de beheerder een gedeeltelijke indeling heeft gemaakt, geeft het standaardbestand response.json in de indeling alleen de werkbelastingen en talen op die zijn opgenomen in de gedeeltelijke indeling.

Als de indeling wordt gemaakt door een --config *.vsconfig bestand door te geven, wordt het *.vsconfig bestand naar de indelingsmap gekopieerd als layout.vsconfig en wordt naar dit configuratiebestand verwezen in het response.json bestand. Op deze manier kunt u configuratiebestanden gebruiken om clientinstallaties te initialiseren die afkomstig zijn van een indeling.

Zorg ervoor dat u speciale aandacht besteedt aan de channelUri-instelling, die configureert waar de client zoekt naar updates. De standaardconfiguratie is voor de client om te kijken naar gehoste Microsoft-servers op internet voor updates. U moet de waarde van channelUri wijzigen en deze naar uw indeling laten wijzen als u wilt dat clients hun updates van uw indeling ontvangen. Voorbeelden voor hoe u dit doet, zijn hieronder beschreven. U kunt altijd wijzigen waar een client in de toekomst naar updates zoekt door het installatieprogramma op de client uit te voeren en de modifySettings opdrachtaan te roepen.

Als de clientinstallatie niet op - of-wijze wordt uitgevoerd met behulp van de --quiet- of --passive-modus, kunnen gebruikers de standaardwaarden die in de response.json zijn opgegeven overschrijven en extra werkbelastingen en componenten selecteren of de selectie daarvan opheffen om te installeren.

Waarschuwing

Wees zeer voorzichtig bij het bewerken van eigenschappen die in response.json zijn gedefinieerd bij het maken van de indeling, aangezien sommige van de items nodig zijn voor installatie.

Het basisbestand response.json in een indeling moet er ongeveer uitzien als in het volgende voorbeeld, behalve dat de product-id de editie in uw indeling zou weerspiegelen.

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

Wanneer u een indeling maakt of bijwerkt, wordt er ook een response.template.json-bestand gemaakt. Dit bestand bevat alle workload-, onderdeel- en taal-id's die kunnen worden gebruikt. Dit bestand wordt geleverd als sjabloon voor wat allemaal kan worden opgenomen in een aangepaste installatie. Beheerders kunnen dit bestand gebruiken als uitgangspunt voor een aangepast antwoordbestand. Verwijder gewoon de id's voor de dingen die u niet wilt installeren en sla deze op in het response.json-bestand of uw eigen antwoordbestand. Pas het response.template.json bestand niet aan of uw wijzigingen gaan verloren wanneer de indeling wordt bijgewerkt.

Voorbeeldinhoud van aangepast lay-outantwoordbestand.

In het volgende response.json bestand wordt een Visual Studio Enterprise-clientinstallatie geïnitialiseerd om verschillende algemene werkbelastingen en onderdelen te selecteren, zowel de Engelse als de Franse gebruikersinterfacetalen te selecteren en de updatelocatie te configureren om te zoeken naar bronnen in een door het netwerk gehoste indeling. Raadpleeg de Beleidsregels voor het configureren van bedrijfsimplementaties van Visual Studio en de Indeling configureren om altijd de meest recente installer op te nemen en om informatie te bieden over het configureren hiervan.

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

In het volgende voorbeeld initialiseert het bestand response.json een Visual Studio Enterprise-clientinstallatie die:

• Maakt gebruik van een configuratiebestand *.vsconfig waarmee wordt gedefinieerd welke workloads, onderdelen en extensies moeten worden geïnstalleerd
• Selecteert zowel de Engelse als de Franse ui-talen
• Hiermee configureert u de -updatelocatie om te zoeken naar bronnen in een door HTTP gehoste indeling
• Staat programmatisch laden van niet-ondertekende uitbreidingen toe
• Verwijdert onderdelen die op het moment van bijwerken van de clientzijn overgezet naar een status die niet meer ondersteund wordt. Zie de lijst met niet-ondersteunde onderdelen hier.

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

}

Waarschuwing

Als u intranetwebhostindelingen gebruikt, kunt u 'noWeb': true niet instellen in de response.json en verwachten dat het werkt. Hierdoor wordt het HTTP-protocol uitgeschakeld en wordt voorkomen dat de client toegang heeft tot de website.

Probleemoplossing

Als u een probleem ondervindt met de Visual Studio bootstrapper die een fout genereert wanneer u deze koppelt aan een response.json-bestand, raadpleegt u Problemen met netwerkgerelateerde fouten oplossen wanneer u Visual Studio-pagina installeert of gebruikt voor meer informatie.

Ondersteuning of probleemoplossing

Soms kan het fout gaan. Als de installatie van Visual Studio mislukt, raadpleegt u Problemen met de installatie en upgrade van Visual Studio oplossen voor stapsgewijze instructies.

Hier volgen nog enkele ondersteuningsopties:

• Gebruik de installatiechat (enkel in het Engels) voor installatieproblemen.
• Meld productproblemen aan ons met behulp van het hulpprogramma Een probleem melden dat wordt weergegeven in het visual studio-installatieprogramma en in de Visual Studio IDE. Als u een IT-beheerder bent en Visual Studio niet hebt geïnstalleerd, kunt u feedback verzenden IT-beheerder.
• Een functie voorstellen, productproblemen bijhouden en antwoorden vinden in de Visual Studio Developer Community.

Verwante inhoud

• Beheerdershandleiding voor Visual Studio
• Een netwerkinstallatie van Visual Studio maken en onderhouden
• Visual Studio vanuit een indeling implementeren op een clientcomputer
• Beleidsregels configureren voor bedrijfsimplementaties
• Visual Studio-workload- en onderdeel-id's
• Netwerkgerelateerde fouten oplossen bij het installeren of gebruiken van Visual Studio