Installieren des .NET-Upgrade-Assistenten

  • Artikel

Der .NET-Upgrade-Assistent kann als Visual Studio-Erweiterung oder als .NET-Befehlszeilentool installiert werden. Bei der Installation als Visual Studio-Erweiterung können geladene Projekte über das Kontextmenü aktualisiert werden. Die .NET-Befehlszeilen-Toolversion bietet eine interaktive Oberfläche, die schrittweise durchlaufen werden kann. Weitere Informationen zum Installieren des Tools finden Sie unter Übersicht über den .NET-Upgrade-Assistenten.

Voraussetzungen

Installieren der Visual Studio-Erweiterung

Der .NET-Upgrade-Assistent kann als Visual Studio-Erweiterung installiert werden, mit der Sie ein Upgrade eines geöffneten Projekts durchführen können. Führen Sie die folgenden Schritte aus, um den .NET-Upgrade-Assistenten in Visual Studio zu installieren. Alternativ dazu können Sie die Erweiterung auch aus dem Visual Studio Marketplace herunterladen und installieren.

  1. Wenn Visual Studio geöffnet ist, wählen Sie das Menüelement Erweiterungen>Erweiterungen verwalten, wodurch das Fenster Erweiterungen verwalten geöffnet wird.

  2. Geben Sie Upgrade in das Sucheingabefeld des Fensters Erweiterungen verwalten ein.

  3. Wählen Sie das Element .NET-Upgrade-Assistent und dann Herunterladen aus.

    The manage extensions window in Visual Studio, showing the .NET Upgrade Assistant.

  4. Nachdem die Erweiterung heruntergeladen wurde, schließen Sie Visual Studio. Dadurch wird die Installation der Erweiterung gestartet:

    A prompt to install the .NET Upgrade Assistant extension.

  5. Wählen Sie Ändern aus, und folgen Sie den Anweisungen zum Installieren der Erweiterung.

Installieren des globalen .NET-Tools

Der .NET-Upgrade-Assistent ist auch als globales .NET-Tool verfügbar. Sie können das Tool mit dem folgenden Befehl installieren:

dotnet tool install -g upgrade-assistant

Da der .NET-Upgrade-Assistent als .NET-Tool installiert ist, kann er auf ähnliche Weise ganz einfach aktualisiert werden, indem Sie Folgendes ausführen:

dotnet tool update -g upgrade-assistant

Wichtig

Die Installation dieses Tools schlägt möglicherweise fehl, wenn Sie zusätzliche NuGet-Feedquellen konfiguriert haben. Verwenden Sie den --ignore-failed-sources-Parameter, um diese Fehler als Warnungen statt als Fehler zu behandeln:

dotnet tool install -g --ignore-failed-sources upgrade-assistant

Wenn Sie ein Upgrade für Projekte mit WCF-Komponenten durchführen, verwenden Sie die ältere Version des CLI-Tools. Weitere Informationen finden Sie unter Installieren (Legacyversion).