Wiki source code of Operative Cmdlets

Last modified by jklein on 2025/08/06 13:00
Show last authors
1 {{aagon.floatingbox/}}
2
3 (% class="wikigeneratedid" %)
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
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
10 = Add-AESBAlias =
11
12 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.
13
14 (% style="width:977px" %)
15 |=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %)Erforderlich|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung
16 |-Alias|(% style="width:101px" %)String|(% style="width:94px" %)✅|(% style="width:87px" %)Keine|(% style="width:505px" %)Der Name des Alias, der dem Qualified Name Service (QNS) hinzugefügt werden soll.
17 |-ConnectionName|(% style="width:101px" %)String|(% style="width:94px" %)❌|(% style="width:87px" %)Keine|(% style="width:505px" %)Der Name der SICS-Verbindung, für die der Alias hinzugefügt wird. Wenn dieser Parameter nicht angegeben ist, wird der Alias für die Standardverbindung hinzugefügt.
18
19 === **Beispiele** ===
20
21 Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung
22
23 {{code language="powershell"}}
24 Add-AESBAlias -Alias "MyAlias"
25 {{/code}}
26
27 Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection"
28
29 {{code language="powershell"}}
30 Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection"
31
32 {{/code}}
33
34 = Add-AESBCallbackTarget =
35
36 Mtit diesem Cmdlet wird ein neues Callback-Target zur SICS-Verbindung hinzugefügt. Das Callback-Target wird für den Empfang von Nachrichten verwendet und erfordert eine Routing-Key-Konfiguration sowie einen Virtual Router.
37
38 (% style="width:1073px" %)
39 |=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Erforderlich|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung
40 |(% style="width:166px" %)-ConnectionName|(% style="width:127px" %)String|(% style="width:90px" %)❌|(% style="width:74px" %)Keine|(% style="width:614px" %)Der Name der SICS-Verbindung, zu der das Callback-Target hinzugefügt wird. Wenn dieser Parameter nicht angegeben ist, wird das Callback-Target zur Standardverbindung hinzugefügt.
41 |(% style="width:166px" %)-VirtualRouter|(% style="width:127px" %)String|(% style="width:90px" %)✅|(% style="width:74px" %)Keine|(% style="width:614px" %)Der Name des Virtual Routers, dem das Callback-Target zugeordnet werden soll.
42 |(% style="width:166px" %)-TargetName|(% style="width:127px" %)String|(% style="width:90px" %)✅|(% style="width:74px" %)Keine|(% style="width:614px" %)Der Name des Callback-Targets, das hinzugefügt werden soll.
43 |(% style="width:166px" %)-RoutingKey|(% style="width:127px" %)String|(% style="width:90px" %)✅|(% style="width:74px" %)Keine|(% style="width:614px" %)Der Routing-Key, der verwendet wird, um Nachrichten an das Callback-Target zu routen.
44
45 === (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** ===
46
47 Beispiel 1: Hinzufügen eines Callback-Targets "CallbackTarget1" zur Standardverbindung. Dabei wird das Callback-Target über den Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet
48
49 {{code language="powershell"}}
50 Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
51
52 {{/code}}
53
54 Beispiel 2: Hinzufügen eines Callback-Targets "CallbackTarget1" zur SICS-Verbindung "MyConnection". Dabei wird das Callback-Target über den Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet
55
56 {{code language="powershell"}}
57 Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
58
59 {{/code}}
60
61 = Add-AESBQueueTarget =
62
63 Dieses Cmdlet fügt ein neues Target zu einer SICS-Verbindung hinzu. Innerhalb dieses Targets ist eine Queue enthalten, in der Nachrichten weiterverarbeitet werden, die an das Target gesendet werden. Daher handelt es sich bei diesem Cmdlet um eine spezifische Form eines [[AESB-Targets.>>doc:||anchor="HAdd-AESBTarget"]]
64
65 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 90px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
66 |(% style="width:199px" %)-ConnectionName|(% style="width:160px" %)String|(% style="width:90px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name der SICS-Verbindung, zu der das Queue-Target hinzugefügt wird. Wenn dieser Parameter nicht angegeben ist, wird das Queue-Target zur Standardverbindung hinzugefügt.
67 |(% style="width:199px" %)-VirtualRouter|(% style="width:160px" %)String|(% style="width:90px" %)✅|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name des Virtual Routers, dem das Queue-Target zugeordnet wird.
68 |(% style="width:199px" %)-TargetName|(% style="width:160px" %)String|(% style="width:90px" %)✅|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name des Queue-Targets, das hinzugefügt werden soll.
69 |(% style="width:199px" %)-RoutingKey|(% style="width:160px" %)String|(% style="width:90px" %)✅|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Routing-Key, der verwendet wird, um Nachrichten an das Queue-Targets zu senden.
70
71 === **Beispiele** ===
72
73 Beispiel 1: Hinzufügen eines Queue-Targets "QueueTarget1" zur Standardverbindung. Dabei wird das Queue-Target über den Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet
74
75 {{code language="powershell"}}
76 Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
77
78 {{/code}}
79
80 Beispiel 2: Hinzufügen eines Queue-Targets "QueueTarget1" zur SICS-Verbindung "MyConnection". Dabei wird das Queue-Target über den Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet
81
82 {{code language="powershell"}}
83 Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
84
85 {{/code}}
86
87 = Add-AESBRoutingKey =
88
89 Dieses Cmdlet wird verwendet, um Routing-Informationen für ein [[AESB-Target>>doc:||anchor="HAdd-AESBTarget"]] zu konfigurieren. Dabei wird ein RoutingKey zu einem Target in einem VirtualRouter hinzugefügt.
90
91 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 90px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
92 |-ConnectionName|string|(% style="width:90px" %)❌|C|Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll.
93 |-VirtualRouter|string|(% style="width:90px" %)✅|VR|Der Name des Virtual Router, zu dem der Routing Key gehört.
94 |-TargetName|string|(% style="width:90px" %)✅|TName|Der Name des Targets, für das der Routing Key hinzugefügt wird.
95 |-RoutingKey|string|(% style="width:90px" %)✅|RK|Der Name des Routing Keys, der hinzugefügt werden soll.
96
97 === **Beispiele** ===
98
99 Beispiel 1: Hinzufügen des Routing Keys "Key1"  für die Standardverbindung. Dabei wird angegeben, dass der Routing Key für das Target "MyTarget". hinzugefügt wird und zum Virtual Router "Router1" gehört
100
101 {{code language="powershell"}}
102 Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
103
104 {{/code}}
105
106 Beispiel 2: Hinzufügen des Routing Keys "AnotherKey"  für die SICS-Verbindung "MyConnection". Dabei wird angegeben, dass der Routing Key für das Target "AnotherTarget". hinzugefügt wird und zum Virtual Router "AnotherRouter" gehört
107
108 {{code language="powershell"}}
109 Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"
110
111 {{/code}}
112
113 = Add-AESBRoutingToAlias =
114
115 Dieses Cmdlet wird verwendet, um Routing-Informationen für den AESB zu konfigurieren, indem ein Routing-Paar mit einem Alias verknüpft wird. Das Routing-Paar besteht aus einem Virtual Router und einem Routing Key, die zu einem Alias im QNS hinzugefügt werden.
116
117 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
118 |-Alias|string|✅|A|Der Alias, zu dem das Routing-Paar im QNS hinzugefügt werden soll.
119 |-ConnectionName|string|❌|C|Der Name der SICS-Verbindung, für die das Routing-Paar hinzugefügt werden soll.
120 |-RoutingKey|string|✅|RK|Der Name des Routing Keys, der zusammen mit dem Virtual Router hinzugefügt werden soll.
121 |-VirtualRouter|string|✅|VR|Der Name des Virtual Router, der zusammen mit dem Routing Key hinzugefügt werden soll.
122
123 === (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** ===
124
125 Beispiel 1: Hinzufügen des Routing-Paars zum Alias "MyAlias" für die Standardverbindung. Dabei werden der Routing Key "MyKey" und der Virtual Router "MyRouter" als Routing-Paar verknüpft.
126
127 {{code language="powershell"}}
128 Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection"
129 {{/code}}
130
131 Beispiel 2: Hinzufügen des Routing-Paars zum Alias "AnotherAlias" für die SICS-Verbindung "MyConnection". Dabei werden der Routing Key "AnotherKey" und der Virtual Router "AnotherRouter" als Routing-Paar verknüpft.
132
133 {{code language="powershell"}}
134 Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
135 {{/code}}
136
137 = Add-AESBTarget =
138
139 Dieses Cmdlet wird verwendet, um ein neues Target für eine SICS-Verbindung in einem Virtual Router hinzuzufügen. Dabei wird ein Target Type und Target Name mit einem Routing Key verknüpft.
140
141 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 90px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
142 |-ConnectionName|string|(% style="width:90px" %)❌|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll.
143 |-RoutingKey|string|(% style="width:90px" %)✅|RK|Der Routing Key, der dem Target zugewiesen wird.
144 |-TargetName|string|(% style="width:90px" %)✅|TName|Der Name des Targets, das hinzugefügt werden soll.
145 |-TargetType|string|(% style="width:90px" %)✅|TType|Der Typ des Targets, das hinzugefügt werden soll.
146 |-VirtualRouter|string|✅|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird.
147
148 === **Beispiele** ===
149
150 Beispiel 1: Hinzufügen eines Queue-Targets "MyTarget" für die Standardverbindung. Das Target wird dem Virtual Router "MyRouter" hinzugefügt und ihm wird der Routing Key "MyKey" zugewiesen
151
152 {{code language="powershell"}}
153 Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"
154
155 {{/code}}
156
157 Beispiel 2: Hinzufügen eines Queue-Targets "MyTarget" für die SICS-Verbindung "MyConnection". Das Target wird dem Virtual Router "MyRouter" hinzugefügt und ihm wird der Routing Key "MyKey" zugewiesen
158
159 {{code language="powershell"}}
160 Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
161
162 {{/code}}
163
164 = Add-AESBVirtualRouter =
165
166 Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
167
168 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 90px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
169 |-ConnectionName|string|(% style="width:90px" %)❌|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll.
170 |-VirtualRouter|string|(% style="width:90px" %)✅|VR|Der Name des VirtualRouter, der hinzugefügt werden soll.
171
172 === **Beispiele** ===
173
174 Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung
175
176 {{code language="powershell"}}
177 Add-AESBVirtualRouter -VirtualRouter "MyRouter"
178
179 {{/code}}
180
181 Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
182
183 {{code language="powershell"}}
184 Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
185
186 {{/code}}
187
188 = ConvertFrom-AESBBase64 =
189
190 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
191
192 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
193 |-Input|string|✅|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
194
195 === **Beispiele** ===
196
197 Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"
198
199 {{code language="powershell"}}
200 ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
201
202 {{/code}}
203
204 Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
205
206 {{code language="powershell"}}
207 $base64String = "U29tZSBiYXNlNjQgdGV4dA=="
208 ConvertFrom-AESBBase64 -Input $base64String
209 {{/code}}
210
211 = ConvertFrom-AESBBase64ToFile =
212
213 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
214
215 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
216 |-Input|string|✅|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
217 |-OutputPath|string|✅|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen.
218 |-Force|switch|❌|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert.
219
220 === **Beispiele** ===
221
222 Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
223
224 {{code language="powershell"}}
225 ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
226
227 {{/code}}
228
229 Beispiel 2: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Some base64 text" in der Datei "output.txt" im angegebenen Pfad. Da die Datei bereits vorhanden ist, wird sie überschrieben
230
231 {{code language="powershell"}}
232 ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
233 {{/code}}
234
235 = ConvertFrom-AESBIcql =
236
237 Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
238
239 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
240 |-Icql|string|✅|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll.
241
242 === **Beispiele** ===
243
244 Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
245
246 {{code language="powershell"}}
247 $icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>"
248 ConvertFrom-AESBIcql -Icql $icqlString
249 {{/code}}
250
251 Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
252
253 {{code language="none" layout="LINENUMBERS"}}
254 TargetName : MyTarget
255 TargetType : Queue
256 RoutingKey : MyRoutingKey
257 VirtualRouter : MyRouter
258 ConnectionName : MyConnection
259 {{/code}}
260
261 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
262
263 {{code language="powershell" layout="LINENUMBERS"}}
264 # Erstellen eines PSCustomObject mit Beispieldaten
265 $exampleObject = [PSCustomObject]@{
266 TargetName = "MyTarget"
267 TargetType = "Queue"
268 RoutingKey = "MyRoutingKey"
269 VirtualRouter = "MyRouter"
270 ConnectionName = "MyConnection"
271 }
272
273 # Konvertieren des Objekts in eine Icql-Zeichenfolge
274 $x = ConvertTo-AESBIcql -InputObject $exampleObject
275
276 # Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject
277 $decodedObject = ConvertFrom-AESBIcql -Icql $x
278
279 # Anzeigen des dekodierten Objekts
280 $decodedObjectConvertFrom-AESBIcql -Icql $icqlString
281 {{/code}}
282
283 = ConvertTo-AESBBase64 =
284
285 Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
286
287 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
288 |-Input|string|✅|In|Die Zeichenfolge, die in Base64 kodiert werden soll.
289
290 === **Beispiele** ===
291
292 Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
293
294 {{code language="powershell"}}
295 ConvertTo-AESBBase64 -Input "Hello World!"
296 ConvertFrom-AESBIcql -Icql $icqlString
297 {{/code}}
298
299 Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
300
301 {{code language="powershell"}}
302 $string = "Base64 encoding example"
303 $base64String = ConvertTo-AESBBase64 -Input $string
304 $base64StringConvertFrom-AESBIcql -Icql $icqlString
305 {{/code}}
306
307 = ConvertTo-AESBBase64FromFile =
308
309 Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.
310
311 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
312 |-InputPath|string|✅|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll.
313
314 === **Beispiele** ===
315
316 Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge
317
318 {{code language="powershell"}}
319 ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
320
321 {{/code}}
322
323 Beispiel 2: Kodieren des Inhalts der Datei, deren Pfad in der Variable $filePath gespeichert ist, in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
324
325 {{code language="powershell"}}
326 $filePath = "C:\path\to\anotherfile.txt"
327 $base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
328 $base64String
329 {{/code}}
330
331 = ConvertTo-AESBIcql =
332
333 Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
334
335 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
336 |-InputObject|psobject|✅|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll.
337 |-Sequence|string|❌| |Setzt die Sequence einer ICQL Message
338 |-Action|string|❌| |Setzt die Action einer ICQL Message
339
340 === **Beispiele** ===
341
342 Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
343
344 {{code language="powershell" layout="LINENUMBERS"}}
345 # Erstellen eines PSCustomObject mit Beispieldaten
346 $exampleObject = [PSCustomObject]@{
347 TargetName = "MyTarget"
348 TargetType = "Queue"
349 RoutingKey = "MyRoutingKey"
350 VirtualRouter = "MyRouter"
351 ConnectionName = "MyConnection"
352 }
353
354 # Konvertieren des Objekts in eine Icql-Zeichenfolge
355 $icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
356 $icqlString
357 {{/code}}
358
359 = Get-AESBActivityLogItemById =
360
361 Gibt den Activity Log-Eintrag anhand einer ID zurück.
362
363 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
364 |-Id|string|✅| |Die ID des Logeintrags
365
366 === **Beispiele** ===
367
368 Beispiel 1: Abruf eines Log-Eintrags anhand einer ID
369
370 {{code language="powershell"}}
371 Get-AESBActivityLogItemById -Id "ItemID"
372
373 {{/code}}
374
375 = Get-AESBAliasList =
376
377 Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.
378
379 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
380 |-ConnectionName|string|❌|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll.
381
382 === **Beispiele** ===
383
384 Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung
385
386 {{code language="powershell"}}
387 Get-AESBAliasList
388
389 {{/code}}
390
391 Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
392
393 {{code language="powershell"}}
394 Get-AESBAliasList -ConnectionName "MyConnection"
395
396 {{/code}}
397
398 = Get-AESBVirtualRouters =
399
400 Gibt eine Liste aller Virtual Router zurück.
401
402 === **Beispiele** ===
403
404 Beispiel 1: Abrufen einer Liste aller Virtual Router
405
406 {{code language="powershell"}}
407 Get-AESBVirtualRouters
408
409 {{/code}}
410
411 = Get-AESBAlias =
412
413 Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.
414
415 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
416 |-Alias|string|✅| |Gibt die Informationen zum angegebenen Alias wieder.
417
418 === **Beispiele** ===
419
420 Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"
421
422 {{code language="powershell"}}
423 Get-AESBAlias -Alias "AliasName"
424
425 {{/code}}
426
427 = Get-AESBConnectionInfo =
428
429 Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.
430
431 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
432 |-ConnectionName|string|❌|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen.
433
434 === **Beispiele** ===
435
436 Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB
437
438 {{code language="powershell" layout="LINENUMBERS"}}
439 Get-AESBConnectionInfo
440
441 #Beispiel-Output:
442
443 EndPoint VirtualRouter RoutingKey
444 -------- ------------- ----------
445 wss://localhost:3950 SHELL SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668
446 {{/code}}
447
448 Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"
449
450 {{code language="powershell"}}
451 Get-AESBAliasList -ConnectionName "MyConnection"
452
453 {{/code}}
454
455 = Get-AESBTargetMessageCount =
456
457 Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.
458
459 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
460 |-ConnectionName|string|❌|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.
461 |-TargetName|string|✅|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.
462 |-VirtualRouter|string|✅|VR|Der Name des Virtual Routers, unter dem das Target läuft.
463
464 === **Beispiele** ===
465
466 Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual Router "MyRouter"
467
468 {{code language="powershell"}}
469 Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
470 {{/code}}
471
472 Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual Router "MyRouter" und der Verbindung "MyConnection"
473
474 {{code language="powershell"}}
475 Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
476
477 {{/code}}
478
479 = Get-AESBTargets =
480
481 Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.
482
483 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
484 |-ConnectionName|string|❌|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll.
485 |-VirtualRouter|string|✅|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll.
486
487 === **Beispiele** ===
488
489 Beispiel 1: Abrufen der Liste aller Targets unter dem Virtual Router "MyRouter"
490
491 {{code language="powershell"}}
492 Get-AESBTargets -VirtualRouter "MyRouter"
493
494 {{/code}}
495
496 Beispiel 2: Abrufen der Liste aller Targets für den Virtual Router "MyRouter" und die Verbindung "MyConnection"
497
498 {{code language="powershell"}}
499 Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
500
501 {{/code}}
502
503 = Publish-AESBMessage =
504
505 Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.
506
507 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
508 |-Alias|string|✅|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
509 |-ConnectionName|string|❌|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
510 |-Force|switch|❌|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
511 |-Message|Object|✅|M|Die Nachricht, die veröffentlicht werden soll.
512 |-RoutingKey|string|✅|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
513 |-VirtualRouter|string|✅|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
514
515 === Parameter-Sets ===
516
517 Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
518
519 * (((
520 RoutingParameterSet - Message, VirtualRouter, RoutingKey
521 )))
522 * (((
523 AliasParameterSet - Message, Alias
524 )))
525
526 === **Beispiele** ===
527
528 Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"
529
530 {{code language="powershell"}}
531 Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message"
532
533 {{/code}}
534
535 Beispiel 2: Senden der Nachricht "This is a test message" über den Virtual Router "MyRouter" mit dem Routing Key "MyRoutingKey"
536
537 {{code language="powershell"}}
538 Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message"
539
540 {{/code}}
541
542 Beispiel 3: Konvertieren eines PSCustomObject in das ICQL-Format und senden der Nachricht an den Alias "MyAlias"
543
544 {{code language="powershell"}}
545 ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias"
546
547 {{/code}}
548
549 = Publish-AESBMessageAndAwait =
550
551 Mit diesem Cmdlet können Sie eine Nachricht an ein bestimmtes Target oder einen Alias im AESB senden. Anschließend wird auf eine Bestätigung oder Antwort innerhalb des angegebenen Zeitlimits gewartet.
552
553 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
554 |-Alias|string|✅|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
555 |-ConnectionName|string|❌|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
556 |-Force|switch|❌|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
557 |-Message|Object|✅|M|Die Nachricht, die veröffentlicht werden soll.
558 |-RoutingKey|string|✅|RK|Der Routing Key, der für das Routing der Nachricht verwendet wird.
559 |-Timeout|string|❌|T|Die maximale Zeitdauer, die auf eine Bestätigung gewartet wird. Der Wert kann in Sekunden, Minuten oder Stunden angegeben werden, z.B. "5s", "5 sec", "5 seconds", "5m", "5 min", "5 minutes", "2h", "2 hours". Standardmäßig wird der Wert in Sekunden interpretiert.
560 |-VirtualRouter|string|✅|VR|Der Name des Virtual Routers, über den die Nachricht veröffentlicht werden soll.
561
562 === **Beispiele** ===
563
564 Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung
565
566 {{code language="powershell"}}
567 Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
568
569 {{/code}}
570
571 Beispiel 2: Senden der Nachricht "This is a test message" über den Virtual Router "MyRouter" mit dem Routing Key "MyRoutingKey" und wartet bis zu 1 Stunde auf eine Bestätigung.
572
573 {{code language="powershell"}}
574 Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
575
576 {{/code}}
577
578 = Receive-AESBTargetMessages =
579
580 Mit diesem Cmdlet können Sie Nachrichten von einem Ziel im AESB empfangen.
581
582 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
583 |-ConnectionName|//string//|❌|C|Der Name der Verbindung zum AESB.
584 |-MessageCount|//int//|❌|MC|Die Anzahl der Nachrichten, die empfangen werden sollen.
585 |-TargetName|//string//|✅|TName|Der Name des Ziels, von dem die Nachrichten empfangen werden.
586 |-VirtualRouter|//string//|✅|VR|Der Name des Virtual Routers, der für das Ziel verwendet wird.
587
588 === **Beispiele** ===
589
590 Beispiel 1: Empfangen von Nachrichten vom Ziel mit dem Namen "MyTarget", das dem Virtual Router "MyRouter" zugeordnet ist
591
592 {{code language="powershell"}}
593 Receive-AESBTargetMessages -VirtualRouter "MyRouter" -TargetName "MyTarget"
594
595 {{/code}}
596
597 Beispiel 2: Empfangen von bis zu 10 Nachrichten vom Ziel mit dem Namen "MyTarget", das dem Virtual Router "MyRouter" zugeordnet ist
598
599 {{code language="powershell"}}
600 Receive-AESBTargetMessages -VirtualRouter "MyRouter" -TargetName "MyTarget" -MessageCount 10
601
602 {{/code}}
603
604 = Remove-AESBAlias =
605
606 Mit diesem Cmdlet können Sie einen Alias aus dem AESB entfernen.
607
608 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
609 |-Alias|string|✅|A|Der Name des zu entfernenden Alias.
610 |-ConnectionName|string|❌|C|Der Name der Verbindung zum AESB.
611
612 === **Beispiele** ===
613
614 Beispiel 1: Entfernen vom Alias "MyAlias" aus dem AESB
615
616 {{code language="powershell"}}
617 Remove-AESBAlias -Alias "MyAlias"
618
619 {{/code}}
620
621 Beispiel 2: Entfernen vom Alias "MyAlias" aus dem AESB über die angegebene Verbindung
622
623 {{code language="powershell"}}
624 Remove-AESBAlias -ConnectionName "MyConnection" -Alias "MyAlias"
625
626 {{/code}}
627
628 = Remove-AESBRoutingFromAlias =
629
630 Mit diesem Cmdlet können Sie ein Routing-Paar (bestehend aus Virtual Router und Routing Key) von einem Alias im QNS entfernen. Das Routing-Paar wird vollständig gelöscht.
631
632 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
633 |-Alias|string|✅|A|Der Name des Alias, von dem das Routing-Paar entfernt werden soll.
634 |-ConnectionName|string|❌|C|Der Name der Verbindung, die verwendet wird.
635 |-RoutingKey|string|✅|RK|Der Routing Key, der aus dem Alias entfernt werden soll.
636 |-VirtualRouter|string|✅|VR|Der Virtual Router, der zusammen mit dem Routing Key entfernt werden soll.
637
638 === **Beispiele** ===
639
640 Beispiel 1: Entfernen vom Routing-Paar mit Virtual Router "MyRouter" und Routing Key "MyRoutingKey" vom Alias "MyAlias"
641
642 {{code language="powershell"}}
643 Remove-AESBRoutingFromAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
644
645 {{/code}}
646
647 Beispiel 2: Entfernen vom Routing-Paar mit Virtual Router "MyRouter" und Routing Key "MyRoutingKey" vom Alias "MyAlias" unter Verwendung der Verbindung "MyConnection"
648
649 {{code language="powershell"}}
650 Remove-AESBRoutingFromAlias -Alias "MyAlias" -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
651
652 {{/code}}
653
654 = Remove-AESBRoutingKey =
655
656 Mit diesem Cmdlet können Sie einen Routing Key von einem bestimmten Ziel in einem Virtual Router im AESB entfernen. Der Routing Key wird aus der Konfiguration entfernt, die mit dem angegebenen Ziel und Virtual Router verknüpft ist.
657
658 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
659 |-ConnectionName|string|❌|C|Der Name der Verbindung, die verwendet werden soll.
660 |-VirtualRouter|string|✅|VR|Der Name des Virtual Routers, von dem der Routing Key entfernt werden soll.
661 |-TargetName|string|✅|TName|Der Name des Ziels, von dem der Routing Key entfernt werden soll.
662 |-RoutingKey|string|✅|RK|Der Routing Key, der entfernt werden soll.
663
664 === **Beispiele** ===
665
666 Beispiel 1: Entfernen vom Routing Key "MyRoutingKey" vom Ziel "MyTarget" im Virtual Router "MyRouter"
667
668 {{code language="powershell"}}
669 Remove-AESBRoutingKey -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey"
670
671 {{/code}}
672
673 Beispiel 2: Entfernen vom Routing Key "MyRoutingKey" vom Ziel "MyTarget" im Virtual Router "MyRouter" unter Verwendung der Verbindung "MyConnection"
674
675 {{code language="powershell"}}
676 Remove-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey"
677
678 {{/code}}
679
680 = Remove-AESBTarget =
681
682 Mit diesem Cmdlet können Sie ein Ziel aus dem Virtual Router des AESB entfernen.
683
684 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
685 |-ConnectionName|string|❌|C|Der Name der Verbindung zum AESB.
686 |-VirtualRouter|string|✅|VR|Der Name des Virtual Routers, von dem das Ziel entfernt werden soll.
687 |-TargetName|string|✅|TName|Der Name des Ziels, das entfernt werden soll.
688
689 === **Beispiele** ===
690
691 Beispiel 1: Entfernen vom Ziel "MyTarget" vom Virtual Router "MyRouter"
692
693 {{code language="powershell"}}
694 Remove-AESBTarget -VirtualRouter "MyRouter" -TargetName "MyTarget"
695 {{/code}}
696
697 Beispiel 2: Entfernen vom Ziel "MyTarget" vom Virtual Router "MyRouter" unter Verwendung der Verbindung "MyConnection"
698
699 {{code language="powershell"}}
700 Remove-AESBTarget -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
701 {{/code}}
702
703 = Remove-AESBVirtualRouter =
704
705 Mit diesem Cmdlet können Sie einen angegebenen Virtual Router entfernen.
706
707 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
708 |ConnectionName|string|❌|C|Gibt den Namen der Verbindung an.
709 |VirtualRouter|string|✅|VR|Gibt den Namen des zu entfernenden Virtual Router an.
710
711 === **Beispiele** ===
712
713 Beispiel 1: Entfernen vom Virtual Router mit dem Namen "MyRouter"
714
715 {{code language="powershell"}}
716 Remove-AESBVirtualRouter -VirtualRouter "MyRouter"
717
718 {{/code}}
719
720 Beispiel 2: Entfernen vom Virtual Router mit dem Namen "MyRouter" unter der Verbindung "MyConnection"
721
722 {{code language="powershell"}}
723 Remove-AESBVirtualRouter -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
724 {{/code}}
725
726 = Set-AESBBSelfAsAlias =
727
728 Bei diesem Cmdlet wird ein existierender Alias verwendet, um einen neuen Alias hinzuzufügen. Durch Verwendung des bereits existierenden Alias, müssen so nicht der Routing Key und Virtual Router verwendet werden.
729
730 {{aagon.warnungsbox}}
731 Die Parameter RemoveExistingAlias und AddToExistingAlias dürfen nicht gleichzeitig verwendet werden!
732 {{/aagon.warnungsbox}}
733
734 **Parameter**
735
736 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
737 |-Alias|string|✅| |Gibt den Namen vom Alias an
738 |-RemoveExistingAlias|bool|❌| |Der bestehende Alias wird ersetzt.
739 |-AddToExistingAlias|bool|❌| |Der Virtual Router und Routing Key wird zu dem angegebenen Alias hinzugefügt
740
741 === **Beispiele** ===
742
743 Beispiel 1: Überschreiben vom existierenden Alias „AliasName“. Wenn z.B. der vorherige Alias mehrere Virtual Router und Routing Keys hatte, werden diese gelöscht
744
745 {{code language="powershell"}}
746 Set-AESBSelfAsAlias -Alias "AliasName" -RemoveExistingAlias $true
747
748 {{/code}}
749
750 Beispiel 2: Hinzufügen der Virtual Router und Routing Keys vom Alias „AliasName“ zum angegebenen Alias "SelfAliasTest".
751
752 {{code language="powershell"}}
753 Set-AESBSelfAsAlias -Alias "AliasName" -AddToExistingAlias "SelfAliasTest"
754 {{/code}}
755
756 = Show-AESBRoutingTable =
757
758 Dieses Cmdlet zeigt die Routing-Tabelle für den angegebenen Virtual Router an. Mit den Parametern ist es möglich, die angezeigten Daten weiter einzuschränken.
759
760 **Parameter**
761
762 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
763 |-ConnectionName|string|❌|C|Der Name der Verbindung, die für das Abrufen der Routing-Tabelle verwendet wird.
764 |-ExchangeType|ExchangeTypes|❌|ET|Der Typ des Exchanges, der angezeigt werden soll. Mögliche Werte sind DIRECT oder ROUTING.
765 |-VirtualRouter|string|✅|VR|Der Name des Virtual Routers, für den die Routing-Tabelle angezeigt wird.
766
767 === **Beispiele** ===
768
769 Beispiel 1: Anzeigen der Routing-Tabelle für den Virtual Router „MyRouter“
770
771 {{code language="powershell"}}
772 Show-AESBRoutingTable -VirtualRouter "MyRouter"
773
774 {{/code}}
775
776 Beispiel 2: Anzeigen der Routing-Tabelle für den Virtual Router „MyRouter“ an, wobei nur Einträge vom Typ „DIRECT“ angezeigt werden. Die Verbindung „MyConnection“ wird verwendet.
777
778 {{code language="powershell"}}
779 Show-AESBRoutingTable -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -ExchangeType DIRECT
780
781 {{/code}}
782
783 = Write-AESBActivityLog =
784
785 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.
786
787 **Parameter**
788
789 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
790 |-ConnectionName|string|❌|C|Der Name der Verbindung, die für die Kommunikation verwendet wird.
791 |-Id|string|❌|None|Die ID des Log-Eintrags, der aktualisiert werden soll. Wird ein neuer Eintrag erstellt, kann dieser Parameter weggelassen werden.
792 |-Name|string|✅|N|Der Name des Log-Eintrags.
793 |-Description|string|✅|D|Die Beschreibung des Log-Eintrags.
794 |-Status|JobFeedbackResultCode|✅|ST|Der Status des Logs, z.B. "Warning", "Created", "Started", "Running", "Stopping", "Stopped", "Failed" oder "Finished".
795 |-ComponentName|string|❌|ComName|Der Name der Komponente, die den Log-Eintrag erstellt hat.
796
797 === **Beispiele** ===
798
799 Beispiel 1: Erstellen eines neuen Log-Eintrags. Der Eintrag erhält den Namen "ProcessStart", die Beschreibung "Der Prozess wurde gestartet" und den Status "Started". Da keine ID angegeben ist, wird ein neuer Log-Eintrag erstellt.
800
801 {{code language="powershell"}}
802 Write-AESBActivityLog -Name "ProcessStart" -Description "Der Prozess wurde gestartet." -Status Started
803 {{/code}}
804
805 Beispiel 2: Aktualisieren eines vorhandenen Log-Eintrags mit der ID "12345". Der Log-Eintrag wird auf den Namen "ProcessUpdate", die Beschreibung "Der Prozessstatus wurde aktualisiert" und den Status "Running" gesetzt. Die ID wird verwendet, um den spezifischen Eintrag zu finden und zu aktualisieren.
806
807 {{code language="powershell"}}
808 Write-AESBActivityLog -Id "12345" -Name "ProcessUpdate" -Description "Der Prozessstatus wurde aktualisiert." -Status Running
809
810 {{/code}}
811
812 = 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;" %)Erforderlich|=(% 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
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community