Installation einer Erweiterung bei BC OnPremises Systemen

Um eine .app-Datei in Microsoft Dynamics 365 Business Central (Version 14, On-Premises) über die PowerShell zu installieren, folgen Sie diesen Schritten:

(Tipp: Benennen Sie vorab die .app Datei um und kürzen den Namen z.B. in "sst.app" - dann müssen Sie später in der Shell nur den kurzen Namen eingeben)

1. PowerShell starten

• Öffnen Sie die Business Central Administration Shell oder eine normale PowerShell-Sitzung (als Administrator).

2. Verbindung zum BC-Service herstellen

Stellen Sie sicher, dass der Dienst läuft, und führen Sie folgendes aus:

$serviceUrl = "http://<ServerName>:<Port>/NAV"  

#Beispiel: http://localhost:7048/NAV $credential = Get-Credential  # Eingabe der Zugangsdaten

3. Bereitstellung der Erweiterung vorbereiten

Wechseln Sie in das Verzeichnis, in dem die .app-Datei liegt. Beispiel:

cd "C:\Pfad\zur\Datei"

4. Erweiterung veröffentlichen

Führen Sie den folgenden Befehl aus, um die Erweiterung hochzuladen und im System zu veröffentlichen:

Publish-NAVApp -Path "C:\Pfad\zur\Datei\<ExtensionName>.app" -ServerInstance "<InstanceName>"

Ersetzen Sie <InstanceName> durch den Namen Ihrer Business Central Instanz (z. B. BC140).

5. Erweiterung installieren

Installieren Sie die veröffentlichte Erweiterung mit folgendem Befehl:

Install-NAVApp -Name "<ExtensionName>" -ServerInstance "<InstanceName>"

6. Erweiterung für einen bestimmten Mandanten (Company) installieren

Falls die Erweiterung nur für einen spezifischen Mandanten aktiviert werden soll:

Install-NAVApp -Name "<ExtensionName>" -ServerInstance "<InstanceName>" -CompanyName "<MandantName>"

7. Überprüfung

Nach der Installation können Sie überprüfen, ob die Erweiterung aktiv ist:

Get-NAVAppInfo -ServerInstance "<InstanceName>"

Fehlerbehebung

1. Fehler beim Hochladen der .app-Datei:

   • Überprüfen Sie, ob die Datei kompatibel mit Version 14 ist.
   • Stellen Sie sicher, dass der Pfad korrekt ist.

2. Lizenzprobleme:

   • Vergewissern Sie sich, dass die Lizenz die Erweiterung unterstützt.

3. Dienst-Neustart: Falls Änderungen nicht greifen, starten Sie den Dienst neu:

   Restart-Service -Name "<ServiceName>"