Basis-Cmdlets

Version 7.1 by jklein on 2024/11/28 15:17

Bei den Basic-Cmdlets handelt es sich um Shell-Befehle, die primär für das Verbindungsmanagement und das grundsätzliche Arbeiten mit Messages relevant sind.

Add-AESBConnection

Dieses Cmdlet fügt eine neue SICS-Verbindung hinzu. Alle hinzugefügten Verbindungen werden in einem Verzeichnis gesammelt und sind systemweit verfügbar. Daher sind sie in allen AESB Shell-Sessions auf demselben PC verwendbar. Die erste Verbindung, die zu diesem Verzeichnis hinzugefügt wird, wird als Standardverbindung festgelegt. Falls keine Parameter beim Hinzufügen der Verbindung angegeben werden, werden die Werte für diese Parameter interaktiv angefordert und können einzeln eingetragen werden.

Parameter DatentypOptionalAliasBeschreibung
-ConnectionNameStringKeineDer Name der Verbindung.
-ServerStringKeineDie IP-Adresse oder der DNS-Name des Zielservers.
-PortIntKeineDer Port, über den die Verbindung hergestellt wird. Der Standardwert ist 3950. Es können Werte im Bereich 1 bis 65535 angegeben werden.
-UsernameStringKeineDer Benutzername für die Authentifizierung.
-PasswordSecureStringKeineDas Passwort für die Verbindung.
-DescriptionStringKeineEine Beschreibung oder Notiz zur Verbindung.

Beispiele

Beispiel 1: Hinzufügen einer Verbindung mit Standardport 3950

Add-AESBConnection -ConnectionName "MyConnection" -Server "server.example.com" -Port 3950 -Username "user" -Password (ConvertTo-SecureString "password" -AsPlainText -Force)

Beispiel 2: Hinzufügen einer Verbindung zu einem Server über den Port 8080 mit benutzerdefiniertem Port und Beschreibung

Add-AESBConnection -ConnectionName "MyConnection" -Server "192.168.1.1" -Port 8080 -Username "user" -Password (ConvertTo-SecureString "password" -AsPlainText -Force) -Description "Test connection"

Beispiel 3: Hinzufügen einer Verbindung mit Nutzung der interaktiven Eingabe

Add-AESBConnection

Close-AESBConnection

Dieses Cmdlet schließt eine offene SICS-Verbindung. Wenn der -ConnectionName-Parameter angegeben wird, wird entsprechend die spezifische Verbindung geschlossen. Anderenfalls wird die Standardverbindung geschlossen. Da der einzige Parameter des Cmdlets optional ist, erfolgt keine interaktive Nachfrage, falls kein Parameter angegeben wird und keine Standardverbindung vorhanden ist.

Parameter DatentypOptionalAliasBeschreibung
-ConnectionNameStringKeineDer Name der Verbindung, die geschlossen werden soll. Wenn nicht angegeben, wird die Standardverbindung geschlossen.

Beispiele

Beispiel 1: Schließen der spezifischen Verbindung "MyConnection"

Close-AESBConnection -ConnectionName "MyConnection"

Beispiel 2: Schließen der Standardverbindung, da kein -ConnectionName-Parameter angegeben ist.

Close-AESBConnection

Close-AESBConnections

Dieses Cmdlet schließt alle offenen SICS-Verbindungen im Connection-Verzeichnis.

Close-AESBConnections

Edit-AESBConnection

Mit diesem Cmdlet können Sie eine bestehende SICS-Verbindung bearbeiten. Es ermöglicht das Aktualisieren von Verbindungseigenschaften wie Serveradresse, Port, Benutzername, Passwort und Beschreibung.

Parameter DatentypOptionalAliasBeschreibung
-ConnectionNameStringKeineDer Name der Verbindung, die bearbeitet werden soll.
-DescriptionStringKeineEine neue Beschreibung oder Notiz zur Verbindung.
-PasswordSecureStringKeineDas neue Passwort für die Verbindung.
-PortIntKeineDer neue Port, über den die Verbindung hergestellt wird.Wertebereich ist 1 bis 65535.
-ServerStringKeineDie neue IP-Adresse oder der DNS-Name des Zielservers.
-UsernameStringKeineDer neue Benutzername für die Authentifizierung.

Beispiele

Beispiel 1: Vollständiges Bearbeiten der bestehenden SICS-Verbindung "MyConnection" mit der Möglichkeit zur Änderung allen Parameter

Edit-AESBConnection -ConnectionName "MyConnection" -Server "newserver.example.com" -Port 3960 -Username "newuser" -Password (ConvertTo-SecureString "newpassword" -AsPlainText -Force) -Description "Updated connection"

Beispiel 2: Explizite Änderung der Serveradresse und des Ports der SICS-Verbindung "MyConnection"

Edit-AESBConnection -ConnectionName "MyConnection" -Server "another.server.com" -Port 8080

Get-AESBConnection

Get-AESBConnections

Get-AESBMessageCount

Import-AESBPublicApiCommands

New-AESBShell

Open-AESBConnection

Receive-AESBMessage

Receive-AESBMessages

Remove-AESBConnection

Set-AESBDefaultConnection

Show-AESBInfrastructure

© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community