Wiki-Quellcode von Verbindungen einrichten
Zuletzt geändert von jklein am 2025/06/16 13:31
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{aagon.floatingbox/}} | ||
| 2 | |||
| 3 | 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. | ||
| 4 | |||
| 5 | {{aagon.infobox}} | ||
| 6 | Sollte die AESB Shell bei Ihnen noch nicht vorhanden sein, dann müssen Sie diese erst __[[über den AESB Installer installieren>>doc:AESB.110.AESB installieren, konfigurieren und aktualisieren.AESB Core-Komponenten installieren.WebHome]]__. | ||
| 7 | {{/aagon.infobox}} | ||
| 8 | |||
| 9 | = Verbindung hinzufügen = | ||
| 10 | |||
| 11 | Zum Hinzufügen einer SICS-Verbindung in der AESB Shell, müssen Sie das Cmdlet //{{code language="PowerShell"}}Add-AESBConnection{{/code}}// ausführen. In diesem Befehl können Sie Verbindungsdetails wie Zieladresse, Authentifizierungsinformationen und spezifische Konfigurationsparameter angeben. | ||
| 12 | |||
| 13 | {{aagon.infobox}} | ||
| 14 | Die erste hinzugefügte SICS-Verbindung wird immer als Standardverbindung festgelegt. | ||
| 15 | {{/aagon.infobox}} | ||
| 16 | |||
| 17 | Der Aufruf vom Cmdlet //{{code language="PowerShell"}}Add-AESBConnection{{/code}} //zum Hinzufügen einer SICS-Verbindung zum localhost würde beispielsweise folgendermaßen ablaufen: | ||
| 18 | |||
| 19 | 1. Das Cmdlets //{{code language="PowerShell"}}Add-AESBConnection{{/code}} //ausführen | ||
| 20 | 1. Die benötigten Parameter einzeln angeben | ||
| 21 | 1. Rückmeldung erhalten, dass die SICS-Verbindung hinzugefügt wurde | ||
| 22 | |||
| 23 | {{code language="PowerShell"}} | ||
| 24 | PS > Add-AESBConnection | ||
| 25 | |||
| 26 | cmdlet Add-AESBConnection at command pipeline position 1 | ||
| 27 | Supply values for the following parameters: | ||
| 28 | ConnectionName: LocalConnection | ||
| 29 | Server: localhost | ||
| 30 | Port: 3950 | ||
| 31 | Username: Operator | ||
| 32 | Password: ******** | ||
| 33 | Connection has been added. | ||
| 34 | {{/code}} | ||
| 35 | |||
| 36 | (% class="wikigeneratedid" %) | ||
| 37 | Detaillierte Informationen zu diesem Cmdlet finden Sie in der [[Cmdlet-Dokumentation>>doc:AESB.110.AESB Shell.Cmdlet-Dokumentation.Basis-Cmdlets.WebHome||anchor="HAdd-AESBConnection"]]. | ||
| 38 | |||
| 39 | = Verbindung aufbauen = | ||
| 40 | |||
| 41 | 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 //{{code language="PowerShell"}}Open-AESBConnection{{/code}} //aufgerufen: | ||
| 42 | |||
| 43 | {{code language="PowerShell"}} | ||
| 44 | PS > Open-AESBConnection | ||
| 45 | Connection established. | ||
| 46 | {{/code}} | ||
| 47 | |||
| 48 | (% class="wikigeneratedid" %) | ||
| 49 | 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: | ||
| 50 | |||
| 51 | {{code language="PowerShell"}} | ||
| 52 | PS > Open-AESBConnection -ConnectionName "MyConnection" | ||
| 53 | Connection established. | ||
| 54 | {{/code}} | ||
| 55 | |||
| 56 | (% class="wikigeneratedid" %) | ||
| 57 | Detaillierte Informationen zu diesem Cmdlet finden Sie in der [[Cmdlet-Dokumentation>>doc:AESB.110.AESB Shell.Cmdlet-Dokumentation.Basis-Cmdlets.WebHome||anchor="HOpen-AESBConnection"]]. | ||
| 58 | |||
| 59 | = Cmdlets für ACMP Public API importieren = | ||
| 60 | |||
| 61 | Für die weitere Arbeit mit der AESB Shell sollten Sie nun alle Cmdlets für die ACMP Public API importieren. Hierzu ist es notwendig, dass ACMP und AESB korrekt miteinander verbunden sind, da die Cmdlets aus der Public API des verbundenen ACMP Servers generiert werden. | ||
| 62 | |||
| 63 | Die Cmdlets werden über die angegebene SICS-Verbindung von dem SICS-Server heruntergeladen, mit dem die Verbindung besteht. | ||
| 64 | |||
| 65 | {{code language="PowerShell"}} | ||
| 66 | PS > Import-AESBPublicApiCommands | ||
| 67 | It's possible that the SICS needs to generate the Public-API Cmdlets, therefor this command could take a while. | ||
| 68 | Public API Commands were imported successfully(ACMPPapi-a1748aae-a7be-4649-8336-18c3eb2fc793) | ||
| 69 | {{/code}} | ||
| 70 | |||
| 71 | Mit einer neuen Version der Public API können neue Cmdlets hinzukommen oder es können neue Versionen bereits vorhandener Cmdlets hinzukommen. Deshalb können sich sowohl die Anzahl als auch die Versionen der Cmdlets in Abhängigkeit vom verbundenen ACMP Server unterscheiden. Eine vollständige Liste der Cmdlets kann mithilfe von //{{code language="PowerShell"}}Get-Command -ListImported -Module *ACMP*{{/code}}// aufgerufen werden. Weitere Informationen zum Aufbau und zur Verwendung von Cmdlets der ACMP Public API in PowerShell-Skripten finden Sie im Abschnitt [[Verwenden der ACMP Public API>>doc:AESB.111.Workspaces.Powershell.Verwenden der ACMP Public API.WebHome]]. | ||
| 72 | |||
| 73 | = Verbindungen verwalten = | ||
| 74 | |||
| 75 | 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. | ||
| 76 | |||
| 77 | |=(% style="width: 354px;" %)Cmdlet|=(% style="width: 976px;" %)Funktion | ||
| 78 | |(% style="width:354px" %)[[{{{Get-AESBConnections}}}>>doc:AESB.110.AESB Shell.Cmdlet-Dokumentation.Basis-Cmdlets.WebHome||anchor="HGet-AESBConnections"]]|(% style="width:976px" %)(% style="width:1129px" %)Bestehende Verbindungen anzeigen | ||
| 79 | |(% style="width:354px" %)[[{{{Edit-AESBConnection}}}>>doc:AESB.110.AESB Shell.Cmdlet-Dokumentation.Basis-Cmdlets.WebHome||anchor="HEdit-AESBConnection"]]|(% style="width:976px" %)(% style="width:1129px" %)Eine bestehende Verbindung bearbeiten | ||
| 80 | |(% style="width:354px" %)[[{{{Remove-AESBConnection}}}>>doc:AESB.110.AESB Shell.Cmdlet-Dokumentation.Basis-Cmdlets.WebHome||anchor="HRemove-AESBConnection"]]|(% style="width:976px" %)(% style="width:1129px" %)Eine bestehende Verbindung löschen | ||
| 81 | |(% style="width:354px" %)[[{{{Set-AESBDefaultConnection}}}>>doc:AESB.110.AESB Shell.Cmdlet-Dokumentation.Basis-Cmdlets.WebHome||anchor="HSet-AESBDefaultConnection"]]|(% style="width:976px" %)(% style="width:1129px" %)Eine Verbindung als Standard-Verbindung festlegen | ||
| 82 | |(% style="width:354px" %)[[{{{Close-AESBConnection}}}>>doc:AESB.110.AESB Shell.Cmdlet-Dokumentation.Basis-Cmdlets.WebHome||anchor="HClose-AESBConnection"]]|(% style="width:976px" %)(% style="width:1129px" %)Eine bestehende Verbindung schließen | ||
| 83 | |(% style="width:354px" %)[[{{{Open-AESBConnection}}}>>doc:AESB.110.AESB Shell.Cmdlet-Dokumentation.Basis-Cmdlets.WebHome||anchor="HOpen-AESBConnection"]]|(% style="width:976px" %)(% style="width:1129px" %)Eine geschlossene Verbindung öffnen | ||
| 84 | |||
| 85 | Detaillierte Informationen zu diesen und weiteren Cmdlets finden Sie in der [[Cmdlet-Dokumentation>>doc:AESB.110.AESB Shell.Cmdlet-Dokumentation.Basis-Cmdlets.WebHome]]. | ||
| 86 | |||
| 87 | {{aagon.infobox}} | ||
| 88 | Beim korrekten Schließen einer PowerShell-Session über das Command **//Exit //**werden alle Verbindungen korrekt geschlossen. | ||
| 89 | {{/aagon.infobox}} |