Changes for page Operative Cmdlets
Last modified by jklein on 2025/08/06 13:00
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Parent
-
... ... @@ -1,1 +1,1 @@ 1 -AESB.11 0.AESB Shell.Cmdlet-Dokumentation.WebHome1 +AESB.111.AESB Shell.Cmdlet-Dokumentation.WebHome - Content
-
... ... @@ -3,6 +3,10 @@ 3 3 (% class="wikigeneratedid" %) 4 4 Bei den operativen Cmdlets handelt es sich um Shell-Befehle, die für die Steuerung und das weiterführende Arbeiten in AESB verwendet werden können. 5 5 6 +{{aagon.infobox}} 7 +Falls bei der Ausführung eines Cmdlets mit ausschließlich optionalen Parametern keine Parameter angegeben werden, wird immer die Standardverbindung mit dem standardmäßigen Parameter-Set genutzt. 8 +{{/aagon.infobox}} 9 + 6 6 = Add-AESBAlias = 7 7 8 8 Mit diesem Cmdlet wird ein neuer Alias für eine SICS-Verbindung im Qualified Name Service (QNS) hinzugefügt. Wenn der Parameter //-ConnectionName// nicht angegeben wird, wird der Alias für die Standardverbindung hinzugefügt. ... ... @@ -254,7 +254,7 @@ 254 254 ConnectionName : MyConnection 255 255 {{/code}} 256 256 257 -Beispiel 2: Kodieren eines PSCustomObjects in eine Icql-Zeichenfolge und anschließendes dekodieren zurück in ein PSCustomObject. Die resultierenden Daten entsprechen den ursprünglichen Eingabewerten261 +Beispiel 2: Kodieren eines PSCustomObjects in eine Icql-Zeichenfolge und anschließendes Dekodieren zurück in ein PSCustomObject. Die resultierenden Daten entsprechen den ursprünglichen Eingabewerten 258 258 259 259 {{code language="powershell" layout="LINENUMBERS"}} 260 260 # Erstellen eines PSCustomObject mit Beispieldaten ... ... @@ -780,7 +780,6 @@ 780 780 781 781 Mit diesem Cmdlet wird ein Eintrag in das ActivityLog des AESB geschrieben. Wenn keine ID angegeben wird, wird ein neuer Log-Eintrag erstellt. Falls eine ID angegeben wird, wird der vorhandene Log-Eintrag mit dieser ID aktualisiert. 782 782 783 - 784 784 **Parameter** 785 785 786 786 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung ... ... @@ -807,3 +807,39 @@ 807 807 {{/code}} 808 808 809 809 = Write-AESBBusinessLog = 813 + 814 +Mit diesem Cmdlet wird eine Nachricht in das Business-Log des AESB geschrieben. Jeder Aufruf des Cmdlets erzeugt immer einen neuen Log-Eintrag. 815 + 816 +{{aagon.infobox}} 817 +Das BusinessLog dient zur Information über Prozessabläufe und -ergebnisse durch aussagekräftige Benachrichtigungen. Daher ist es nicht möglich, Objekte in der Nachricht des BusinessLogs auszugeben. 818 +{{/aagon.infobox}} 819 + 820 +**Parameter** 821 + 822 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 823 +|-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB. 824 +|-IsError|bool|✅|IsErr|Gibt an, ob die Nachricht als Fehler protokolliert wird. 825 +|-Message|string|❌|M|Die zu protokollierende Nachricht. 826 +|-ComponentId|string|✅|CId|Die ID des Komponenten. 827 +|-ComponentName|string|✅|ComName|Der Name des Komponenten. 828 +|-ComponentPart|string|✅|ComPart|Der Teil des Komponenten. 829 +|-HostId|string|✅|HId|Die ID des Hosts. 830 +|-HostName|string|✅|HN|Der Name des Hosts. 831 +|-Context|string|✅|CT|Der Kontext der Nachricht. 832 + 833 +=== **Beispiele** === 834 + 835 +Beispiel 1: Erstellen eines neuen Log-Eintrags im Business-Log mit der Nachricht "System started successfully". Der Log-Eintrag wird dem Komponenten-Namen "MyComponent" und dem Kontext "Initialization" zugeordnet. 836 + 837 +{{code language="powershell"}} 838 +Write-AESBBusinessLog -Message "System started successfully" -ComponentName "MyComponent" -Context "Initialization" 839 + 840 +{{/code}} 841 + 842 +Beispiel 2: Erstellen eines neuen Log-Eintrag im Business-Log, der als Fehler gekennzeichnet ist. Die Nachricht "Error connecting to database" wird dem Komponenten-ID "DBComponent" und dem Host-Namen "Server01" zugeordnet. 843 + 844 +{{code language="powershell"}} 845 +Write-AESBBusinessLog -IsError $true -Message "Error connecting to database" -ComponentId "DBComponent" -HostName "Server01" 846 +{{/code}} 847 + 848 +

