Verbindungen einrichten

Zuletzt geändert von Jannis Klein am 2025/02/12 14:18

Bevor Sie mit der eigentlichen Arbeit in der AESB Shell beginnen können, müssen Sie zunächst die notwendigen SICS-Verbindungen zu Ihren spezifischen Endpunkten hinzufügen. 

Hinweis  Hinweis: 

Sollte die AESB Shell bei Ihnen noch nicht vorhanden sein, dann müssen Sie diese erst über den AESB Installer installieren

Verbindung hinzufügen

Zum Hinzufügen einer SICS-Verbindung in der AESB Shell, müssen Sie das Cmdlet Add-AESBConnection ausführen. In diesem Befehl können Sie Verbindungsdetails wie Zieladresse, Authentifizierungsinformationen und spezifische Konfigurationsparameter angeben. 

Hinweis  Hinweis: 

Die erste hinzugefügte SICS-Verbindung wird immer als Standardverbindung festgelegt.

Der Aufruf vom Cmdlet Add-AESBConnection zum Hinzufügen einer SICS-Verbindung zum localhost würde beispielsweise folgendermaßen ablaufen: 

  1. Das Cmdlets Add-AESBConnection ausführen
  2. Die benötigten Parameter einzeln angeben
  3. Rückmeldung erhalten, dass die SICS-Verbindung hinzugefügt wurde
PS > Add-AESBConnection

cmdlet Add-AESBConnection at command pipeline position 1
Supply values for the following parameters:
ConnectionName: LocalConnection
Server: localhost
Port: 3950
Username: Operator
Password: ********
Connection has been added. 

Detaillierte Informationen zu diesem Cmdlet finden Sie in der Cmdlet-Dokumentation.

Verbindung aufbauen

Bevor Sie eine hinzugefügte SICS-Verbindung aktiv nutzen können, muss diese erst geöffnet werden. Zum Öffnen einer SICS-Verbindung wird grundsätzlich das Cmdlet Open-AESBConnection aufgerufen:

PS > Open-AESBConnection
Connection established.

Ohne die Angabe weiterer Parameter, wird mit diesem Befehl immer die Standard-Verbindung geöffnet. Wenn Sie bereits mehrere SICS-Verbindungen hinzugefügt haben und eine spezifische SICS-Verbindung öffnen möchten, müssen Sie zusätzlich den Verbindungsnamen als Parameter angeben:

PS > Open-AESBConnection -ConnectionName "MyConnection"
Connection established.

Detaillierte Informationen zu diesem Cmdlet finden Sie in der Cmdlet-Dokumentation.

Cmdlets für ACMP Public Api importieren

Für die weitere Arbeit mit der AESB Shell sollten Sie nun alle Cmdlets für die ACMP Public Api importieren. Die Cmdlets werden über die angegebene SICS-Verbindung von dem SICS-Server heruntergeladen, mit dem die Verbindung besteht. 

PS > Import-AESBPublicApiCommands
It's possible that the SICS needs to generate the Public-API Cmdlets, therefor this command could take a while.
Public API Commands were imported successfully(ACMPPapi-a1748aae-a7be-4649-8336-18c3eb2fc793)

Verbindungen verwalten

Die Verwaltung von Verbindungen in der AESB Shell ermöglicht es Ihnen, aktive Verbindungen zu überwachen und anzupassen. Mithilfe von verschiedenen Cmdlets können Verbindungen angezeigt, bearbeitet oder gelöscht werden. Darüber hinaus können Sie beispielsweise eine Standard-Verbindung festlegen oder bestehende Verbindungen für eine bessere Übersicht schließen und später erneut öffnen.

CmdletFunktion
Get-AESBConnectionsBestehende Verbindungen anzeigen
Edit-AESBConnectionEine bestehende Verbindung bearbeiten
Remove-AESBConnectionEine bestehende Verbindung löschen
Set-AESBDefaultConnectionEine Verbindung als Standard-Verbindung festlegen
Close-AESBConnectionEine bestehende Verbindung schließen
Open-AESBConnectionEine geschlossene Verbindung öffnen

Detaillierte Informationen zu diesen und weiteren Cmdlets finden Sie in der Cmdlet-Dokumentation.

Hinweis  Hinweis: 

Beim korrekten Schließen einer PowerShell-Session über das Command Exit werden alle Verbindungen korrekt geschlossen.

© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community