Freigeben über

Behandeln von Problemen mit der Bicep-Installation

  • Artikel

In diesem Artikel wird beschrieben, wie Sie potenzielle Fehler in einer Bicep-Installation beheben können.

Visual Studio Code-Fehler

Wenn Sie die folgende Fehlermeldung in Visual Studio Code erhalten:

The Bicep server crashed 5 times in the last 3 minutes. The server will not be restarted.

Öffnen Sie in VS Code die Ansicht Ausgabe im Bereich am unteren Bildschirmrand, und wählen Sie dann Bicep aus:

Visual Studio Code-Ausgabebereich

Wenn die folgende Ausgabe im Bereich angezeigt wird, überprüfen Sie, ob Sie die Einstellung dotnetAcquisitionExtension.existingDotnetPath zu VS Code hinzugefügt haben. Wenn diese Einstellung vorhanden ist, entfernen Sie sie, und starten Sie VS Code neu. Informationen zum Konfigurieren der Visual Studio Code-Einstellungen finden Sie unter Benutzer- und Workspace-Einstellungen.

It was not possible to find any compatible framework version.

Melden andernfalls ein Problem im Bicep-Repository und schließen Sie die Ausgabenachrichten ein.

Mehrere Versionen der Bicep CLI installiert

Wenn Sie die Bicep CLI manuell an mehreren Speicherorten installieren, kann es zu unerwartetem Verhalten kommen, z. B. dass die Bicep CLI nicht aktualisiert wird, wenn Sie den Befehl upgrade ausführen. Oder Sie stellen fest, dass die Ausführung von az bicep version eine Version, die von bicep --version aber eine andere Version zurückgibt.

Um dieses Problem zu lösen, können Sie entweder alle Speicherorte aktualisieren oder einen Speicherorten auswählen, den Sie beibehalten möchten, und die anderen Speicherorte löschen.

Öffnen Sie zunächst die Eingabeaufforderung (nicht PowerShell), und führen Sie where bicep aus. Dieser Befehl gibt die Speicherorte Ihrer Bicep-Installationen zurück. Wenn Sie die Instanz der Bicep CLI verwenden, die von der Azure CLI verwaltet wird, wird diese Installation nicht angezeigt, da sie PATH nicht hinzugefügt wurde. Wenn where bicep nur einen Speicherort zurückgibt, kann es sein, dass der auftretende Versionskonflikt zwischen der manuellen Installation und der Azure CLI-Installation besteht.

Um alle Installationsspeicherorte beizubehalten, verwenden Sie die Methode, die Sie zuvor für die manuelle Installation der Bicep CLI für alle Speicherorte verwendet haben, die Sie beibehalten möchten. Wenn Sie Azure CLI verwenden, führen Sie az bicep upgrade aus, um diese Version zu aktualisieren.

Um nur einen Installationsspeicherort beizubehalten, gehen Sie wie folgt vor:

  1. Löschen Sie die Dateien der Installationen, die Sie nicht beibehalten möchten.
  2. Entfernen Sie diese Speicherorte aus der Umgebungsvariablen PATH.

Wenn Sie sowohl eine manuelle Installation als auch die von der Azure CLI verwaltete Instanz haben, können Sie Ihre Nutzung in einer Instanz kombinieren.

  1. Löschen Sie den manuellen Installationsspeicherort.
  2. Fügen Sie den Speicherort der von der Azure CLI installierten Bicep CLI zur Variablen PATH hinzu. Unter Windows lautet der von der Azure CLI verwaltete Speicherort %USERPROFILE%\.Azure\bin.

Nachdem Sie die Azure CLI-Instanz zu PATH hinzugefügt haben, können Sie diese Version entweder mit az bicep oder bicep verwenden.

Nächste Schritte

Weitere Informationen zur Verwendung von Visual Studio Code und der BICEP-Erweiterung finden Sie unter Schnellstart: Erstellen von BICEP-Dateien mit Visual Studio Code.