Konfigurieren der Standardeinstellungen für die Installation mithilfe einer Antwortdatei

In diesem Artikel erfahren Sie, wie Sie eine Antwortdatei erstellen, mit der Sie Ihre Visual Studio-Installation automatisieren können. Die Verwendung ist üblich, wenn Sie Visual Studio über ein Layout installieren.

Die Visual Studio-Antwortdatei ist eine JSON- Datei, deren Inhalt Anpassungen enthält, die während der Erstinstallation von Visual Studio auf dem Client verwendet werden. Der Inhalt spiegelt die Befehlszeilenargumente und Parameterwider. Verwenden Sie die Antwortdatei für die folgenden Konfigurationsoptionen:

• Konfigurieren, welche Workloads, Komponenten oder Sprachen während der Erstinstallation standardmäßig ausgewählt werden sollen.
• Verweisen Sie auf die Installationskonfigurationsdatei *.vsconfig, auf die sich Ihr Team festgelegt hat.
• Geben Sie an, wo der Client Updates vonerhalten soll. Beispiele hierfür sind die standardmäßig von Microsoft gehosteten Server im Internet oder von einem vom Administrator gesteuerten Netzwerk-Layout-Standort.
• Automatische Entfernung von nicht unterstützten Komponenten während Updates.

Erstellen der Antwortdatei

Die response.json Datei wird normalerweise erstellt, wenn ein Administrator ein Layout erstellt und im Stammordner des Layouts zu finden ist. Sie können jedoch eine eigene Antwortdatei mit einem der folgenden Beispiele erstellen.

Angeben der Antwortdatei

Wenn Administrierende Visual Studio durch Aufrufen des Bootstrapladeprogramms über ein Layout bereitstellen, wird automatisch die Antwortdatei im Stammverzeichnis des Layouts verwendet. Administratoren können auch eine andere Antwortdatei explizit angeben, indem Sie den parameter --in verwenden, wie im folgenden Beispiel gezeigt:

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

Inhalt der Antwortdatei

Die Antwortdatei kapselt Befehlszeilenparameter, die vom Visual Studio Installer verwendet werden, und es folgt den folgenden allgemeinen Regeln:

• Wenn ein Befehlszeilenparameter keine Argumente akzeptiert (z. B. --quiet, --passive, includeRecommended, removeOos, useLatestInstaller, allowUnsignedExtensionsusw.), sollte der Wert in der Antwortdatei "true/false" sein.
• Wenn der Parameter ein Argument verwendet (z. B. --installPath <dir>, --config <*.vsconfig file>), sollte der Wert in der Antwortdatei eine Zeichenfolge sein.
• Wenn der Parameter ein Argument verwendet und in der Befehlszeile mehrmals angezeigt werden kann (z. B. --add <id>), sollte der Wert in der Antwortdatei ein Array von Zeichenfolgen sein.

Parameter, die in der Befehlszeile angegeben sind, überschreiben die Einstellungen, die in der Antwortdatei enthalten sind, außer wenn Parameter mehrere Eingaben verwenden (z. B. --add). Wenn Sie über mehrere Eingaben verfügen, werden die in der Befehlszeile bereitgestellten Eingaben mit Einstellungen aus der Antwortdatei zusammengeführt.

Konfigurieren der Antwortdatei, die bei der Installation über ein Layout verwendet wird

Wenn Sie ein Layout mithilfe des Befehls --layout erstellen, wird im Stammverzeichnis des Layoutordners eine Standarddatei response.json erstellt. Administrierende müssen die Antwortdatei vor der Installation auf einem Clientcomputer entsprechend ändern und anpassen. Auf diese Weise können sie die anfänglichen Konfigurationseinstellungen des Clients steuern.

Auf die Konfigurationseinstellungen in der datei response.json wird nur verwiesen, wenn ein Bootstrapper- ausgeführt wird (z. B. vs_enterprise.exe). Bootstrapper werden in der Regel verwendet, um die Erstinstallation auf dem Client durchzuführen, aber manchmal werden sie auch zum Aktualisieren eines Clients verwendet. Die response.json wird nie verwendet, wenn Sie das Installationsprogramm lokal auf dem Client starten.

Wenn der Administrator ein Partielles Layout erstellt hat, gibt die Standarddatei response.json im Layout nur die Arbeitslasten und Sprachen an, die im Teillayout enthalten waren.

Wenn das Layout durch Übergeben einer --config *.vsconfig Datei erstellt wird, wird die *.vsconfig Datei als layout.vsconfig in das Layoutverzeichnis kopiert, und auf diese Konfigurationsdatei wird in der response.json Datei verwiesen. Auf diese Weise können Sie Konfigurationsdateien verwenden, um Clientinstallationen zu initialisieren, die aus einem Layout stammen.

Achten Sie unbedingt auf die channelUri-Einstellung, die konfiguriert, wo der Client nach Updates sucht. Die Standardkonfiguration ist, dass der Client auf von Microsoft gehosteten Servern im Internet nach Updates sucht. Sie müssen den Wert von channelUri ändern und auf Ihr Layout verweisen, wenn Clients ihre Aktualisierungen aus Ihrem Layout erhalten sollen. Beispiele für die Vorgehensweise finden Sie später in diesem Artikel. Sie können jederzeit ändern, wo ein Client in Zukunft nach Updates sucht, indem Sie das Installationsprogramm auf dem Client ausführen und den modifySettings Befehlaufrufen.

Wenn die Clientinstallation nicht mithilfe des --quiet- oder --passive-Modus erfolgt, können Benutzende die in response.json angegebenen Standardwerte überschreiben und zusätzliche zu installierende Workloads und Komponenten auswählen bzw. deren Auswahl aufheben.

Warnung

Seien Sie beim Bearbeiten von Eigenschaften in der response.json sehr vorsichtig, die beim Erstellen des Layouts definiert wurden, da einige der Elemente für die Installation erforderlich sind.

Die Basisdatei response.json in einem Layout sollte dem folgenden Beispiel ähneln, außer dass die productID die Edition in Ihrem Layout widerspiegeln würde.

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

Wenn Sie ein Layout erstellen oder aktualisieren, wird auch eine response.template.json Datei erstellt. Diese Datei enthält alle Workload-, Komponenten- und Sprach-IDs, die verwendet werden können. Diese Datei wird als Vorlage für alle Elemente bereitgestellt, die in einer benutzerdefinierten Installation enthalten sein können. Administratoren können diese Datei als Ausgangspunkt für eine benutzerdefinierte Antwortdatei verwenden. Entfernen Sie einfach die IDs für die Dinge, die Sie nicht installieren möchten, und speichern Sie sie in der response.json Datei oder Ihrer eigenen Antwortdatei. Passen Sie die response.template.json Datei nicht an, oder Ihre Änderungen gehen verloren, wenn das Layout aktualisiert wird.

Beispiel für angepassten Layoutantwortdateiinhalt

Im folgenden response.json-Dateibeispiel wird eine Visual Studio Enterprise-Clientinstallation initialisiert, um mehrere allgemeine Workloads und Komponenten auszuwählen, sowohl die UI-Sprachen Englisch und Französisch auszuwählen, und den Update-Standort so zu konfigurieren, dass er nach Quellen in einem im Netzwerk gehosteten Layout sucht. Weitere Informationen zur Konfiguration finden Sie unter Konfigurieren von Richtlinien für Unternehmensbereitstellungen von Visual Studio und Konfigurieren des Layouts zum Einbeziehen und Bereitstellen des neuesten Installationsprogramms.

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

Im folgenden Beispiel initialisiert die response.json Datei eine Visual Studio Enterprise-Clientinstallation, die:

• Verwendet eine Konfigurationsdatei *.vsconfig, die definiert, welche Workloads, Komponenten und Erweiterungen installiert werden sollen
• Wählt sowohl die Benutzeroberflächensprachen Englisch als auch Französisch aus.
• Konfiguration des Updatespeicherorts für die Suche nach Quellen in einem in HTTP gehosteten Layout
• Zulassen des programmgesteuerten Ladens von nicht signierten Erweiterungen
• Entfernt Komponenten, die zum Zeitpunkt der Aktualisierung des Client-in einen Out-of-Support-Zustand umgestellt wurden. Die Liste der nicht mehr unterstützten Komponenten finden Sie 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"
    ]

}

Warnung

Wenn Sie im Web gehostete Intranetlayouts verwenden, können Sie nicht „noWeb: true“ in der Datei „response.json“ festlegen und erwarten, dass dies funktioniert. Dadurch wird das HTTP-Protokoll deaktiviert und verhindert, dass der Client auf die Website zugreift.

Fehlerbehebung

Wenn Sie auf ein Problem mit dem Visual Studio-Bootstrapper stoßen, das einen Fehler auslöst, wenn Sie ihn mit einer response.json-Datei koppeln, siehe Fehlerbehebung bei netzwerkbezogenen Fehlern bei der Installation oder Verwendung von Visual Studio für weitere Informationen.

Support oder Problembehandlung

Manchmal kann es zu einem Fehler kommen. Wenn Ihre Visual Studio-Installation fehlschlägt, lesen Sie Problembehandlung bei Installations- und Aktualisierungsproblemen von Visual Studio für schrittweise Anleitungen.

Hier sind einige weitere Supportoptionen:

• Verwenden Sie die Supportoption Installationschat (nur Englisch) für Probleme bei der Installation.
• Melden Sie produktprobleme an uns, indem Sie das Tool "Problem melden" verwenden, das sowohl im Visual Studio Installer als auch in der Visual Studio IDE angezeigt wird. Wenn Sie ein IT-Administrator sind und Visual Studio nicht installiert haben, können Sie IT-Administratorfeedbackübermitteln.
• Schlagen Sie ein Feature vor, verfolgen Sie Produktprobleme, und finden Sie Antworten in der Visual Studio Developer Community.

Verwandte Inhalte

• Visual Studio-Administratorhandbuch
• Erstellen und Verwalten einer Netzwerkinstallation von Visual Studio
• Bereitstellen von Visual Studio über ein Layout auf einem Clientcomputer
• Konfigurieren von Richtlinien für Unternehmensbereitstellungen
• Visual Studio-Arbeitsauslastung und Komponenten-IDs
• Beheben von Netzwerkfehlern bei der Installation oder Verwendung von Visual Studio