Changes for page Operative Cmdlets

Last modified by jklein on 2025/01/10 07:49

From version 15.1
edited by jklein
on 2024/12/04 15:21
Change comment: There is no comment for this version
To version 19.1
edited by jklein
on 2024/12/16 14:56
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -206,40 +206,2156 @@
206 206  
207 207  = ConvertFrom-AESBBase64ToFile =
208 208  
209 +Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
210 +
211 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
212 +|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
213 +|-OutputPath|string|❌|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen.
214 +|-Force|switch|✅|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert.
215 +
216 +=== **Beispiele** ===
217 +
218 +Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
219 +
220 +{{code language="powershell"}}
221 +ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
222 +
223 +{{/code}}
224 +
225 +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
226 +
227 +{{code language="powershell"}}
228 +ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
229 +{{/code}}
230 +
209 209  = ConvertFrom-AESBIcql =
210 210  
233 +Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
234 +
235 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
236 +|-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll.
237 +
238 +=== **Beispiele** ===
239 +
240 +Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
241 +
242 +{{code language="powershell"}}
243 +$icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>"
244 +ConvertFrom-AESBIcql -Icql $icqlString
245 +{{/code}}
246 +
247 +Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
248 +
249 +{{code language="none" layout="LINENUMBERS"}}
250 +TargetName : MyTarget
251 +TargetType : Queue
252 +RoutingKey : MyRoutingKey
253 +VirtualRouter : MyRouter
254 +ConnectionName : MyConnection
255 +{{/code}}
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 Eingabewerten
258 +
259 +{{code language="powershell" layout="LINENUMBERS"}}
260 +# Erstellen eines PSCustomObject mit Beispieldaten
261 +$exampleObject = [PSCustomObject]@{
262 + TargetName = "MyTarget"
263 + TargetType = "Queue"
264 + RoutingKey = "MyRoutingKey"
265 + VirtualRouter = "MyRouter"
266 + ConnectionName = "MyConnection"
267 +}
268 +
269 +# Konvertieren des Objekts in eine Icql-Zeichenfolge
270 +$x = ConvertTo-AESBIcql -InputObject $exampleObject
271 +
272 +# Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject
273 +$decodedObject = ConvertFrom-AESBIcql -Icql $x
274 +
275 +# Anzeigen des dekodierten Objekts
276 +$decodedObjectConvertFrom-AESBIcql -Icql $icqlString
277 +{{/code}}
278 +
211 211  = ConvertTo-AESBBase64 =
212 212  
281 +Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
282 +
283 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
284 +|-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll.
285 +
286 +=== **Beispiele** ===
287 +
288 +Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
289 +
290 +{{code language="powershell"}}
291 +ConvertTo-AESBBase64 -Input "Hello World!"
292 +ConvertFrom-AESBIcql -Icql $icqlString
293 +{{/code}}
294 +
295 +Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
296 +
297 +{{code language="powershell"}}
298 +$string = "Base64 encoding example"
299 +$base64String = ConvertTo-AESBBase64 -Input $string
300 +$base64StringConvertFrom-AESBIcql -Icql $icqlString
301 +{{/code}}
302 +
213 213  = ConvertTo-AESBBase64FromFile =
214 214  
305 +Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.
306 +
307 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
308 +|-InputPath|string|❌|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll.
309 +
310 +=== **Beispiele** ===
311 +
312 +Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge
313 +
314 +{{code language="powershell"}}
315 +ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
316 +
317 +{{/code}}
318 +
319 +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
320 +
321 +{{code language="powershell"}}
322 +$filePath = "C:\path\to\anotherfile.txt"
323 +$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
324 +$base64String
325 +{{/code}}
326 +
215 215  = ConvertTo-AESBIcql =
216 216  
329 +Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
330 +
331 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
332 +|-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll.
333 +
334 +=== **Beispiele** ===
335 +
336 +Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
337 +
338 +{{code language="powershell" layout="LINENUMBERS"}}
339 +# Erstellen eines PSCustomObject mit Beispieldaten
340 +$exampleObject = [PSCustomObject]@{
341 + TargetName = "MyTarget"
342 + TargetType = "Queue"
343 + RoutingKey = "MyRoutingKey"
344 + VirtualRouter = "MyRouter"
345 + ConnectionName = "MyConnection"
346 +}
347 +
348 +# Konvertieren des Objekts in eine Icql-Zeichenfolge
349 +$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
350 +$icqlString
351 +{{/code}}
352 +
353 +Beispiel 2: Konvertiert das PSCustomObject, das in der Variable $exampleObject gespeichert ist, in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge in der Variable $icqlString zurück.
354 +
355 +{{code language="powershell" layout="LINENUMBERS"}}
356 +# Erstellen eines PSCustomObject mit Beispieldaten
357 +$exampleObject = [PSCustomObject]@{
358 + TargetName = "MyTarget"
359 + TargetType = "Queue"
360 + RoutingKey = "MyRoutingKey"
361 + VirtualRouter = "MyRouter"
362 + ConnectionName = "MyConnection"
363 +}
364 +
365 +# Konvertieren des Objekts in eine Icql-Zeichenfolge
366 +$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
367 +$icqlString
368 +{{/code}}
369 +
217 217  = Get-AESBActivityLogItemById =
218 218  
372 +Gibt den ActivityLog-Eintrag anhand einer ID zurück.
373 +
374 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
375 +|-Id|string|❌| |Die ID des Logeintrags
376 +
377 +=== **Beispiele** ===
378 +
379 +Beispiel 1: Abruf eines Log-Eintrags anhand einer ID
380 +
381 +{{code language="powershell"}}
382 +Get-AESBActivityLogItemById -Id "ItemID"
383 +
384 +{{/code}}
385 +
219 219  = Get-AESBAliasList =
220 220  
388 +Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.
389 +
390 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
391 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll.
392 +
393 +=== **Beispiele** ===
394 +
395 +Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung
396 +
397 +{{code language="powershell"}}
398 +Get-AESBAliasList
399 +
400 +{{/code}}
401 +
402 +Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
403 +
404 +{{code language="powershell"}}
405 +Get-AESBAliasList -ConnectionName "MyConnection"
406 +
407 +{{/code}}
408 +
221 221  = Get-AESBVirtualRouters =
222 222  
411 +Gibt eine Liste aller VirtualRouter zurück.
412 +
413 +=== **Beispiele** ===
414 +
415 +Beispiel 1: Abrufen einer Liste aller VirtualRouter
416 +
417 +{{code language="powershell"}}
418 +Get-AESBVirtualRouters
419 +
420 +{{/code}}
421 +
223 223  = Get-AESBAlias =
224 224  
424 +Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.
425 +
426 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
427 +|-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder.
428 +
429 +=== **Beispiele** ===
430 +
431 +Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"
432 +
433 +{{code language="powershell"}}
434 +Get-AESBAlias -Alias "AliasName"
435 +
436 +{{/code}}
437 +
225 225  = Get-AESBConnectionInfo =
226 226  
440 +Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.
441 +
442 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
443 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen.
444 +
445 +=== **Beispiele** ===
446 +
447 +Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB
448 +
449 +{{code language="powershell" layout="LINENUMBERS"}}
450 +Get-AESBConnectionInfo
451 +
452 +#Beispiel-Output:
453 +
454 + EndPoint VirtualRouter RoutingKey
455 +-------- ------------- ----------
456 +wss://localhost:3950 SHELL SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668
457 +{{/code}}
458 +
459 +Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"
460 +
461 +{{code language="powershell"}}
462 +Get-AESBAliasList -ConnectionName "MyConnection"
463 +
464 +{{/code}}
465 +
227 227  = Get-AESBTargetMessageCount =
228 228  
468 +Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.
469 +
470 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
471 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.
472 +|-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.
473 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, unter dem das Target läuft.
474 +
475 +=== **Beispiele** ===
476 +
477 +Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"
478 +
479 +{{code language="powershell"}}
480 +Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
481 +{{/code}}
482 +
483 +Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"
484 +
485 +{{code language="powershell"}}
486 +Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
487 +
488 +{{/code}}
489 +
229 229  = Get-AESBTargets =
230 230  
492 +Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.
493 +
494 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
495 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll.
496 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll.
497 +
498 +=== **Beispiele** ===
499 +
500 +Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
501 +
502 +{{code language="powershell"}}
503 +Get-AESBTargets -VirtualRouter "MyRouter"
504 +
505 +{{/code}}
506 +
507 +Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"
508 +
509 +{{code language="powershell"}}
510 +Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
511 +
512 +{{/code}}
513 +
231 231  = Publish-AESBMessage =
232 232  
516 + Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.
517 +
518 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
519 +|-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
520 +|-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
521 +|-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
522 +|-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
523 +|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
524 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
525 +
526 +
527 +Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
528 +
529 +* (((
530 +RoutingParameterSet - Message, VirtualRouter, RoutingKey
531 +)))
532 +* (((
533 +AliasParameterSet - Message, Alias
534 +)))
535 +
536 +=== **Beispiele** ===
537 +
538 +Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"
539 +
540 +{{code language="powershell"}}
541 +Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message"
542 +
543 +{{/code}}
544 +
545 +Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey"
546 +
547 +{{code language="powershell"}}
548 +Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message"
549 +
550 +{{/code}}
551 +
552 +(% id="cke_bm_333933S" style="display:none" %) (%%)Beispiel 3: Konvertieren eines PowerShell-Objekts in das ICQL-Format und senden des Objekts an den Alias "MyAlias".
553 +
554 +{{code language="powershell"}}
555 +ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias"
556 +
557 +{{/code}}
558 +
233 233  = Publish-AESBMessageAndAwait =
234 234  
561 +Sendet eine Nachricht an ein bestimmtes Target oder einen Alias im AESB und wartet auf eine Bestätigung oder Antwort innerhalb des angegebenen Zeitlimits.
562 +
563 +
564 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
565 +|-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
566 +|-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
567 +|-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
568 +|-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
569 +|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
570 +|-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.
571 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
572 +
573 +(% class="wikigeneratedid" %)
574 +(% id="cke_bm_484750S" style="display:none" %) (%%)Arbeiten in AESB verwendet werden können.
575 +
576 += Add-AESBAlias =
577 +
578 +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.
579 +
580 +(% style="width:977px" %)
581 +|=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %)Optional|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung
582 +|-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.
583 +|-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.
584 +
585 +=== **Beispiele** ===
586 +
587 +Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung
588 +
589 +{{code language="powershell"}}
590 +Add-AESBAlias -Alias "MyAlias"
591 +{{/code}}
592 +
593 +Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection"
594 +
595 +{{code language="powershell"}}
596 +Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection"
597 +
598 +{{/code}}
599 +
600 += Add-AESBCallbackTarget =
601 +
602 +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.
603 +
604 +(% style="width:1073px" %)
605 +|=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Optional|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung
606 +|(% 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.
607 +|(% 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.
608 +|(% 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.
609 +|(% 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.
610 +
611 +=== (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** ===
612 +
613 +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
614 +
615 +{{code language="powershell"}}
616 +Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
617 +
618 +{{/code}}
619 +
620 +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
621 +
622 +{{code language="powershell"}}
623 +Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
624 +
625 +{{/code}}
626 +
627 += Add-AESBQueueTarget =
628 +
629 +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"]]
630 +
631 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
632 +|(% style="width:199px" %)-ConnectionName|(% style="width:160px" %)String|(% style="width:119px" %)✅|(% 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.
633 +|(% style="width:199px" %)-VirtualRouter|(% style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name des Virtual Routers, dem das Queue-Target zugeordnet wird.
634 +|(% style="width:199px" %)-TargetName|(% style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name des Queue-Targets, das hinzugefügt werden soll.
635 +|(% style="width:199px" %)-RoutingKey|(% style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Routing-Key, der verwendet wird, um Nachrichten an das Queue-Targets zu senden.
636 +
637 +=== **Beispiele** ===
638 +
639 +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
640 +
641 +{{code language="powershell"}}
642 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
643 +
644 +{{/code}}
645 +
646 +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
647 +
648 +{{code language="powershell"}}
649 +Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
650 +
651 +{{/code}}
652 +
653 += Add-AESBRoutingKey =
654 +
655 +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.
656 +
657 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
658 +|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll.
659 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, zu dem der Routing Key gehört.
660 +|-TargetName|string|❌|TName|Der Name des Targets, für das der Routing Key hinzugefügt wird.
661 +|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der hinzugefügt werden soll.
662 +
663 +=== **Beispiele** ===
664 +
665 +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
666 +
667 +{{code language="powershell"}}
668 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
669 +
670 +{{/code}}
671 +
672 +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
673 +
674 +{{code language="powershell"}}
675 +Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"
676 +
677 +{{/code}}
678 +
679 += Add-AESBRoutingToAlias =
680 +
681 +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.
682 +
683 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
684 +|-Alias|string|❌|A|Der Alias, zu dem das Routing-Paar im QNS hinzugefügt werden soll.
685 +|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Routing-Paar hinzugefügt werden soll.
686 +|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der zusammen mit dem Virtual Router hinzugefügt werden soll.
687 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, der zusammen mit dem Routing Key hinzugefügt werden soll.
688 +
689 +=== (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** ===
690 +
691 +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.
692 +
693 +{{code language="powershell"}}
694 +Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection"
695 +{{/code}}
696 +
697 +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.
698 +
699 +{{code language="powershell"}}
700 +Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
701 +{{/code}}
702 +
703 += Add-AESBTarget =
704 +
705 +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.
706 +
707 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
708 +|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll.
709 +|-RoutingKey|string|❌|RK|Der Routing Key, der dem Target zugewiesen wird.
710 +|-TargetName|string|❌|TName|Der Name des Targets, das hinzugefügt werden soll.
711 +|-TargetType|string|❌|TType|Der Typ des Targets, das hinzugefügt werden soll.
712 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird.
713 +
714 +=== **Beispiele** ===
715 +
716 +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
717 +
718 +{{code language="powershell"}}
719 +Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"
720 +
721 +{{/code}}
722 +
723 +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
724 +
725 +{{code language="powershell"}}
726 +Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
727 +
728 +{{/code}}
729 +
730 += Add-AESBVirtualRouter =
731 +
732 +Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
733 +
734 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
735 +|-ConnectionName|string|✅|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll.
736 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouter, der hinzugefügt werden soll.
737 +
738 +=== **Beispiele** ===
739 +
740 +Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung
741 +
742 +{{code language="powershell"}}
743 +Add-AESBVirtualRouter -VirtualRouter "MyRouter"
744 +
745 +{{/code}}
746 +
747 +Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
748 +
749 +{{code language="powershell"}}
750 +Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
751 +
752 +{{/code}}
753 +
754 += ConvertFrom-AESBBase64 =
755 +
756 +Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
757 +
758 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
759 +|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
760 +
761 +=== **Beispiele** ===
762 +
763 +Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"
764 +
765 +{{code language="powershell"}}
766 +ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
767 +
768 +{{/code}}
769 +
770 +Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
771 +
772 +{{code language="powershell"}}
773 +$base64String = "U29tZSBiYXNlNjQgdGV4dA=="
774 +ConvertFrom-AESBBase64 -Input $base64String
775 +{{/code}}
776 +
777 += ConvertFrom-AESBBase64ToFile =
778 +
779 +Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
780 +
781 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
782 +|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
783 +|-OutputPath|string|❌|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen.
784 +|-Force|switch|✅|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert.
785 +
786 +=== **Beispiele** ===
787 +
788 +Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
789 +
790 +{{code language="powershell"}}
791 +ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
792 +
793 +{{/code}}
794 +
795 +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
796 +
797 +{{code language="powershell"}}
798 +ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
799 +{{/code}}
800 +
801 += ConvertFrom-AESBIcql =
802 +
803 +Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
804 +
805 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
806 +|-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll.
807 +
808 +=== **Beispiele** ===
809 +
810 +Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
811 +
812 +{{code language="powershell"}}
813 +$icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>"
814 +ConvertFrom-AESBIcql -Icql $icqlString
815 +{{/code}}
816 +
817 +Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
818 +
819 +{{code language="none" layout="LINENUMBERS"}}
820 +TargetName : MyTarget
821 +TargetType : Queue
822 +RoutingKey : MyRoutingKey
823 +VirtualRouter : MyRouter
824 +ConnectionName : MyConnection
825 +{{/code}}
826 +
827 +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
828 +
829 +{{code language="powershell" layout="LINENUMBERS"}}
830 +# Erstellen eines PSCustomObject mit Beispieldaten
831 +$exampleObject = [PSCustomObject]@{
832 + TargetName = "MyTarget"
833 + TargetType = "Queue"
834 + RoutingKey = "MyRoutingKey"
835 + VirtualRouter = "MyRouter"
836 + ConnectionName = "MyConnection"
837 +}
838 +
839 +# Konvertieren des Objekts in eine Icql-Zeichenfolge
840 +$x = ConvertTo-AESBIcql -InputObject $exampleObject
841 +
842 +# Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject
843 +$decodedObject = ConvertFrom-AESBIcql -Icql $x
844 +
845 +# Anzeigen des dekodierten Objekts
846 +$decodedObjectConvertFrom-AESBIcql -Icql $icqlString
847 +{{/code}}
848 +
849 += ConvertTo-AESBBase64 =
850 +
851 +Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
852 +
853 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
854 +|-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll.
855 +
856 +=== **Beispiele** ===
857 +
858 +Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
859 +
860 +{{code language="powershell"}}
861 +ConvertTo-AESBBase64 -Input "Hello World!"
862 +ConvertFrom-AESBIcql -Icql $icqlString
863 +{{/code}}
864 +
865 +Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
866 +
867 +{{code language="powershell"}}
868 +$string = "Base64 encoding example"
869 +$base64String = ConvertTo-AESBBase64 -Input $string
870 +$base64StringConvertFrom-AESBIcql -Icql $icqlString
871 +{{/code}}
872 +
873 += ConvertTo-AESBBase64FromFile =
874 +
875 +Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.
876 +
877 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
878 +|-InputPath|string|❌|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll.
879 +
880 +=== **Beispiele** ===
881 +
882 +Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge
883 +
884 +{{code language="powershell"}}
885 +ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
886 +
887 +{{/code}}
888 +
889 +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
890 +
891 +{{code language="powershell"}}
892 +$filePath = "C:\path\to\anotherfile.txt"
893 +$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
894 +$base64String
895 +{{/code}}
896 +
897 += ConvertTo-AESBIcql =
898 +
899 +Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
900 +
901 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
902 +|-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll.
903 +
904 +=== **Beispiele** ===
905 +
906 +Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
907 +
908 +{{code language="powershell" layout="LINENUMBERS"}}
909 +# Erstellen eines PSCustomObject mit Beispieldaten
910 +$exampleObject = [PSCustomObject]@{
911 + TargetName = "MyTarget"
912 + TargetType = "Queue"
913 + RoutingKey = "MyRoutingKey"
914 + VirtualRouter = "MyRouter"
915 + ConnectionName = "MyConnection"
916 +}
917 +
918 +# Konvertieren des Objekts in eine Icql-Zeichenfolge
919 +$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
920 +$icqlString
921 +{{/code}}
922 +
923 +Beispiel 2: Konvertiert das PSCustomObject, das in der Variable $exampleObject gespeichert ist, in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge in der Variable $icqlString zurück.
924 +
925 +{{code language="powershell" layout="LINENUMBERS"}}
926 +# Erstellen eines PSCustomObject mit Beispieldaten
927 +$exampleObject = [PSCustomObject]@{
928 + TargetName = "MyTarget"
929 + TargetType = "Queue"
930 + RoutingKey = "MyRoutingKey"
931 + VirtualRouter = "MyRouter"
932 + ConnectionName = "MyConnection"
933 +}
934 +
935 +# Konvertieren des Objekts in eine Icql-Zeichenfolge
936 +$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
937 +$icqlString
938 +{{/code}}
939 +
940 += Get-AESBActivityLogItemById =
941 +
942 +Gibt den ActivityLog-Eintrag anhand einer ID zurück.
943 +
944 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
945 +|-Id|string|❌| |Die ID des Logeintrags
946 +
947 +=== **Beispiele** ===
948 +
949 +Beispiel 1: Abruf eines Log-Eintrags anhand einer ID
950 +
951 +{{code language="powershell"}}
952 +Get-AESBActivityLogItemById -Id "ItemID"
953 +
954 +{{/code}}
955 +
956 += Get-AESBAliasList =
957 +
958 +Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.
959 +
960 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
961 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll.
962 +
963 +=== **Beispiele** ===
964 +
965 +Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung
966 +
967 +{{code language="powershell"}}
968 +Get-AESBAliasList
969 +
970 +{{/code}}
971 +
972 +Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
973 +
974 +{{code language="powershell"}}
975 +Get-AESBAliasList -ConnectionName "MyConnection"
976 +
977 +{{/code}}
978 +
979 += Get-AESBVirtualRouters =
980 +
981 +Gibt eine Liste aller VirtualRouter zurück.
982 +
983 +=== **Beispiele** ===
984 +
985 +Beispiel 1: Abrufen einer Liste aller VirtualRouter
986 +
987 +{{code language="powershell"}}
988 +Get-AESBVirtualRouters
989 +
990 +{{/code}}
991 +
992 += Get-AESBAlias =
993 +
994 +Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.
995 +
996 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
997 +|-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder.
998 +
999 +=== **Beispiele** ===
1000 +
1001 +Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"
1002 +
1003 +{{code language="powershell"}}
1004 +Get-AESBAlias -Alias "AliasName"
1005 +
1006 +{{/code}}
1007 +
1008 += Get-AESBConnectionInfo =
1009 +
1010 +Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.
1011 +
1012 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1013 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen.
1014 +
1015 +=== **Beispiele** ===
1016 +
1017 +Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB
1018 +
1019 +{{code language="powershell" layout="LINENUMBERS"}}
1020 +Get-AESBConnectionInfo
1021 +
1022 +#Beispiel-Output:
1023 +
1024 + EndPoint VirtualRouter RoutingKey
1025 +-------- ------------- ----------
1026 +wss://localhost:3950 SHELL SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668
1027 +{{/code}}
1028 +
1029 +Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"
1030 +
1031 +{{code language="powershell"}}
1032 +Get-AESBAliasList -ConnectionName "MyConnection"
1033 +
1034 +{{/code}}
1035 +
1036 += Get-AESBTargetMessageCount =
1037 +
1038 +Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.
1039 +
1040 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1041 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.
1042 +|-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.
1043 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, unter dem das Target läuft.
1044 +
1045 +=== **Beispiele** ===
1046 +
1047 +Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"
1048 +
1049 +{{code language="powershell"}}
1050 +Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
1051 +{{/code}}
1052 +
1053 +Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"
1054 +
1055 +{{code language="powershell"}}
1056 +Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
1057 +
1058 +{{/code}}
1059 +
1060 += Get-AESBTargets =
1061 +
1062 +Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.
1063 +
1064 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1065 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll.
1066 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll.
1067 +
1068 +=== **Beispiele** ===
1069 +
1070 +Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
1071 +
1072 +{{code language="powershell"}}
1073 +Get-AESBTargets -VirtualRouter "MyRouter"
1074 +
1075 +{{/code}}
1076 +
1077 +Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"
1078 +
1079 +{{code language="powershell"}}
1080 +Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
1081 +
1082 +{{/code}}
1083 +
1084 += Publish-AESBMessage =
1085 +
1086 + Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.
1087 +
1088 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1089 +|-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
1090 +|-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
1091 +|-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
1092 +|-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
1093 +|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
1094 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
1095 +
1096 +
1097 +Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
1098 +
1099 +* (((
1100 +RoutingParameterSet - Message, VirtualRouter, RoutingKey
1101 +)))
1102 +* (((
1103 +AliasParameterSet - Message, Alias
1104 +)))
1105 +
1106 +=== **Beispiele** ===
1107 +
1108 +Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung
1109 +
1110 +{{code language="powershell"}}
1111 +Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
1112 +
1113 +{{/code}}
1114 +
1115 +Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey" und wartet bis zu 1 Stunde auf eine Bestätigung
1116 +
1117 +{{code language="powershell"}}
1118 +Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
1119 +
1120 +{{/code}}
1121 +
235 235  = Receive-AESBTargetMessages =
236 236  
1124 +Mit diesem Cmdlet werden Nachrichten von einem Ziel im AESB empfangen.
1125 +
1126 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1127 +|-ConnectionName|//string//|✅|C|Der Name der Verbindung zum AESB.
1128 +|-MessageCount|//int//|✅|MC|Die Anzahl der Nachrichten, die empfangen werden sollen.
1129 +|-TargetName|//string//|❌|TName|Der Name des Ziels, von dem die Nachrichten empfangen werden.
1130 +|-VirtualRouter|//string//|❌|VR|Der Name des VirtualRouters, der für das Ziel verwendet wird.
1131 +
1132 +=== **Beispiele** ===
1133 +
1134 +Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung
1135 +
1136 +{{code language="powershell"}}
1137 +Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
1138 +
1139 +{{/code}}
1140 +
1141 +Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey" und wartet bis zu 1 Stunde auf eine Bestätigung
1142 +
1143 +{{code language="powershell"}}
1144 +Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
1145 +
1146 +{{/code}}
1147 +
237 237  = Remove-AESBAlias =
238 238  
1150 +Mit diesem Cmdlet wird ein Alias aus dem AESB entfernt.
1151 +
1152 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1153 +|-Alias|string|❌|A|Der Name des zu entfernenden Alias.
1154 +|-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB.
1155 +
1156 +=== **Beispiele** ===
1157 +
1158 +Beispiel 1: Entfernen vom Alias "MyAlias" aus dem AESB
1159 +
1160 +{{code language="powershell"}}
1161 +Remove-AESBAlias -Alias "MyAlias"
1162 +
1163 +{{/code}}
1164 +
1165 +Beispiel 2: Entfernen vom Alias "MyAlias" aus dem AESB über die angegebene Verbindung
1166 +
1167 +{{code language="powershell"}}
1168 +Remove-AESBAlias -ConnectionName "MyConnection" -Alias "MyAlias"
1169 +
1170 +{{/code}}
1171 +
239 239  = Remove-AESBRoutingFromAlias =
240 240  
1174 +Mit diesem Cmdlet wird ein Routing-Paar (bestehend aus VirtualRouter und RoutingKey) von einem Alias im QNS entfernt. Das Routing-Paar wird dabei vollständig gelöscht.
1175 +
1176 +
1177 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1178 +|-Alias|string|❌|A|Der Name des Alias, von dem das Routing-Pärchen entfernt werden soll.
1179 +|-ConnectionName|string|✅|C|Der Name der Verbindung, die verwendet wird.
1180 +|-RoutingKey|string|❌|RK|Der RoutingKey, der aus dem Alias entfernt werden soll.
1181 +|-VirtualRouter|string|❌|VR|Der VirtualRouter, der zusammen mit dem RoutingKey entfernt werden soll.
1182 +
1183 +
1184 +(% class="wikigeneratedid" %)
1185 +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.
1186 +
1187 += Add-AESBAlias =
1188 +
1189 +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.
1190 +
1191 +(% style="width:977px" %)
1192 +|=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %)Optional|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung
1193 +|-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.
1194 +|-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.
1195 +
1196 +=== **Beispiele** ===
1197 +
1198 +Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung
1199 +
1200 +{{code language="powershell"}}
1201 +Add-AESBAlias -Alias "MyAlias"
1202 +{{/code}}
1203 +
1204 +Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection"
1205 +
1206 +{{code language="powershell"}}
1207 +Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection"
1208 +
1209 +{{/code}}
1210 +
1211 += Add-AESBCallbackTarget =
1212 +
1213 +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.
1214 +
1215 +(% style="width:1073px" %)
1216 +|=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Optional|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung
1217 +|(% 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.
1218 +|(% 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.
1219 +|(% 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.
1220 +|(% 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.
1221 +
1222 +=== (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** ===
1223 +
1224 +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
1225 +
1226 +{{code language="powershell"}}
1227 +Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
1228 +
1229 +{{/code}}
1230 +
1231 +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
1232 +
1233 +{{code language="powershell"}}
1234 +Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
1235 +
1236 +{{/code}}
1237 +
1238 += Add-AESBQueueTarget =
1239 +
1240 +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"]]
1241 +
1242 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1243 +|(% style="width:199px" %)-ConnectionName|(% style="width:160px" %)String|(% style="width:119px" %)✅|(% 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.
1244 +|(% style="width:199px" %)-VirtualRouter|(% style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name des Virtual Routers, dem das Queue-Target zugeordnet wird.
1245 +|(% style="width:199px" %)-TargetName|(% style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name des Queue-Targets, das hinzugefügt werden soll.
1246 +|(% style="width:199px" %)-RoutingKey|(% style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Routing-Key, der verwendet wird, um Nachrichten an das Queue-Targets zu senden.
1247 +
1248 +=== **Beispiele** ===
1249 +
1250 +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
1251 +
1252 +{{code language="powershell"}}
1253 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
1254 +
1255 +{{/code}}
1256 +
1257 +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
1258 +
1259 +{{code language="powershell"}}
1260 +Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
1261 +
1262 +{{/code}}
1263 +
1264 += Add-AESBRoutingKey =
1265 +
1266 +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.
1267 +
1268 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1269 +|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll.
1270 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, zu dem der Routing Key gehört.
1271 +|-TargetName|string|❌|TName|Der Name des Targets, für das der Routing Key hinzugefügt wird.
1272 +|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der hinzugefügt werden soll.
1273 +
1274 +=== **Beispiele** ===
1275 +
1276 +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
1277 +
1278 +{{code language="powershell"}}
1279 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
1280 +
1281 +{{/code}}
1282 +
1283 +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
1284 +
1285 +{{code language="powershell"}}
1286 +Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"
1287 +
1288 +{{/code}}
1289 +
1290 += Add-AESBRoutingToAlias =
1291 +
1292 +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.
1293 +
1294 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1295 +|-Alias|string|❌|A|Der Alias, zu dem das Routing-Paar im QNS hinzugefügt werden soll.
1296 +|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Routing-Paar hinzugefügt werden soll.
1297 +|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der zusammen mit dem Virtual Router hinzugefügt werden soll.
1298 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, der zusammen mit dem Routing Key hinzugefügt werden soll.
1299 +
1300 +=== (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** ===
1301 +
1302 +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.
1303 +
1304 +{{code language="powershell"}}
1305 +Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection"
1306 +{{/code}}
1307 +
1308 +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.
1309 +
1310 +{{code language="powershell"}}
1311 +Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
1312 +{{/code}}
1313 +
1314 += Add-AESBTarget =
1315 +
1316 +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.
1317 +
1318 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1319 +|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll.
1320 +|-RoutingKey|string|❌|RK|Der Routing Key, der dem Target zugewiesen wird.
1321 +|-TargetName|string|❌|TName|Der Name des Targets, das hinzugefügt werden soll.
1322 +|-TargetType|string|❌|TType|Der Typ des Targets, das hinzugefügt werden soll.
1323 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird.
1324 +
1325 +=== **Beispiele** ===
1326 +
1327 +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
1328 +
1329 +{{code language="powershell"}}
1330 +Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"
1331 +
1332 +{{/code}}
1333 +
1334 +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
1335 +
1336 +{{code language="powershell"}}
1337 +Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
1338 +
1339 +{{/code}}
1340 +
1341 += Add-AESBVirtualRouter =
1342 +
1343 +Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
1344 +
1345 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1346 +|-ConnectionName|string|✅|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll.
1347 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouter, der hinzugefügt werden soll.
1348 +
1349 +=== **Beispiele** ===
1350 +
1351 +Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung
1352 +
1353 +{{code language="powershell"}}
1354 +Add-AESBVirtualRouter -VirtualRouter "MyRouter"
1355 +
1356 +{{/code}}
1357 +
1358 +Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
1359 +
1360 +{{code language="powershell"}}
1361 +Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
1362 +
1363 +{{/code}}
1364 +
1365 += ConvertFrom-AESBBase64 =
1366 +
1367 +Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
1368 +
1369 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1370 +|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
1371 +
1372 +=== **Beispiele** ===
1373 +
1374 +Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"
1375 +
1376 +{{code language="powershell"}}
1377 +ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
1378 +
1379 +{{/code}}
1380 +
1381 +Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
1382 +
1383 +{{code language="powershell"}}
1384 +$base64String = "U29tZSBiYXNlNjQgdGV4dA=="
1385 +ConvertFrom-AESBBase64 -Input $base64String
1386 +{{/code}}
1387 +
1388 += ConvertFrom-AESBBase64ToFile =
1389 +
1390 +Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
1391 +
1392 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1393 +|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
1394 +|-OutputPath|string|❌|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen.
1395 +|-Force|switch|✅|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert.
1396 +
1397 +=== **Beispiele** ===
1398 +
1399 +Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
1400 +
1401 +{{code language="powershell"}}
1402 +ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
1403 +
1404 +{{/code}}
1405 +
1406 +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
1407 +
1408 +{{code language="powershell"}}
1409 +ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
1410 +{{/code}}
1411 +
1412 += ConvertFrom-AESBIcql =
1413 +
1414 +Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
1415 +
1416 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1417 +|-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll.
1418 +
1419 +=== **Beispiele** ===
1420 +
1421 +Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
1422 +
1423 +{{code language="powershell"}}
1424 +$icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>"
1425 +ConvertFrom-AESBIcql -Icql $icqlString
1426 +{{/code}}
1427 +
1428 +Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
1429 +
1430 +{{code language="none" layout="LINENUMBERS"}}
1431 +TargetName : MyTarget
1432 +TargetType : Queue
1433 +RoutingKey : MyRoutingKey
1434 +VirtualRouter : MyRouter
1435 +ConnectionName : MyConnection
1436 +{{/code}}
1437 +
1438 +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
1439 +
1440 +{{code language="powershell" layout="LINENUMBERS"}}
1441 +# Erstellen eines PSCustomObject mit Beispieldaten
1442 +$exampleObject = [PSCustomObject]@{
1443 + TargetName = "MyTarget"
1444 + TargetType = "Queue"
1445 + RoutingKey = "MyRoutingKey"
1446 + VirtualRouter = "MyRouter"
1447 + ConnectionName = "MyConnection"
1448 +}
1449 +
1450 +# Konvertieren des Objekts in eine Icql-Zeichenfolge
1451 +$x = ConvertTo-AESBIcql -InputObject $exampleObject
1452 +
1453 +# Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject
1454 +$decodedObject = ConvertFrom-AESBIcql -Icql $x
1455 +
1456 +# Anzeigen des dekodierten Objekts
1457 +$decodedObjectConvertFrom-AESBIcql -Icql $icqlString
1458 +{{/code}}
1459 +
1460 += ConvertTo-AESBBase64 =
1461 +
1462 +Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
1463 +
1464 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1465 +|-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll.
1466 +
1467 +=== **Beispiele** ===
1468 +
1469 +Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
1470 +
1471 +{{code language="powershell"}}
1472 +ConvertTo-AESBBase64 -Input "Hello World!"
1473 +ConvertFrom-AESBIcql -Icql $icqlString
1474 +{{/code}}
1475 +
1476 +Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
1477 +
1478 +{{code language="powershell"}}
1479 +$string = "Base64 encoding example"
1480 +$base64String = ConvertTo-AESBBase64 -Input $string
1481 +$base64StringConvertFrom-AESBIcql -Icql $icqlString
1482 +{{/code}}
1483 +
1484 += ConvertTo-AESBBase64FromFile =
1485 +
1486 +Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.
1487 +
1488 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1489 +|-InputPath|string|❌|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll.
1490 +
1491 +=== **Beispiele** ===
1492 +
1493 +Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge
1494 +
1495 +{{code language="powershell"}}
1496 +ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
1497 +
1498 +{{/code}}
1499 +
1500 +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
1501 +
1502 +{{code language="powershell"}}
1503 +$filePath = "C:\path\to\anotherfile.txt"
1504 +$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
1505 +$base64String
1506 +{{/code}}
1507 +
1508 += ConvertTo-AESBIcql =
1509 +
1510 +Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
1511 +
1512 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1513 +|-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll.
1514 +
1515 +=== **Beispiele** ===
1516 +
1517 +Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
1518 +
1519 +{{code language="powershell" layout="LINENUMBERS"}}
1520 +# Erstellen eines PSCustomObject mit Beispieldaten
1521 +$exampleObject = [PSCustomObject]@{
1522 + TargetName = "MyTarget"
1523 + TargetType = "Queue"
1524 + RoutingKey = "MyRoutingKey"
1525 + VirtualRouter = "MyRouter"
1526 + ConnectionName = "MyConnection"
1527 +}
1528 +
1529 +# Konvertieren des Objekts in eine Icql-Zeichenfolge
1530 +$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
1531 +$icqlString
1532 +{{/code}}
1533 +
1534 +Beispiel 2: Konvertiert das PSCustomObject, das in der Variable $exampleObject gespeichert ist, in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge in der Variable $icqlString zurück.
1535 +
1536 +{{code language="powershell" layout="LINENUMBERS"}}
1537 +# Erstellen eines PSCustomObject mit Beispieldaten
1538 +$exampleObject = [PSCustomObject]@{
1539 + TargetName = "MyTarget"
1540 + TargetType = "Queue"
1541 + RoutingKey = "MyRoutingKey"
1542 + VirtualRouter = "MyRouter"
1543 + ConnectionName = "MyConnection"
1544 +}
1545 +
1546 +# Konvertieren des Objekts in eine Icql-Zeichenfolge
1547 +$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
1548 +$icqlString
1549 +{{/code}}
1550 +
1551 += Get-AESBActivityLogItemById =
1552 +
1553 +Gibt den ActivityLog-Eintrag anhand einer ID zurück.
1554 +
1555 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1556 +|-Id|string|❌| |Die ID des Logeintrags
1557 +
1558 +=== **Beispiele** ===
1559 +
1560 +Beispiel 1: Abruf eines Log-Eintrags anhand einer ID
1561 +
1562 +{{code language="powershell"}}
1563 +Get-AESBActivityLogItemById -Id "ItemID"
1564 +
1565 +{{/code}}
1566 +
1567 += Get-AESBAliasList =
1568 +
1569 +Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.
1570 +
1571 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1572 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll.
1573 +
1574 +=== **Beispiele** ===
1575 +
1576 +Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung
1577 +
1578 +{{code language="powershell"}}
1579 +Get-AESBAliasList
1580 +
1581 +{{/code}}
1582 +
1583 +Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
1584 +
1585 +{{code language="powershell"}}
1586 +Get-AESBAliasList -ConnectionName "MyConnection"
1587 +
1588 +{{/code}}
1589 +
1590 += Get-AESBVirtualRouters =
1591 +
1592 +Gibt eine Liste aller VirtualRouter zurück.
1593 +
1594 +=== **Beispiele** ===
1595 +
1596 +Beispiel 1: Abrufen einer Liste aller VirtualRouter
1597 +
1598 +{{code language="powershell"}}
1599 +Get-AESBVirtualRouters
1600 +
1601 +{{/code}}
1602 +
1603 += Get-AESBAlias =
1604 +
1605 +Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.
1606 +
1607 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1608 +|-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder.
1609 +
1610 +=== **Beispiele** ===
1611 +
1612 +Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"
1613 +
1614 +{{code language="powershell"}}
1615 +Get-AESBAlias -Alias "AliasName"
1616 +
1617 +{{/code}}
1618 +
1619 += Get-AESBConnectionInfo =
1620 +
1621 +Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.
1622 +
1623 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1624 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen.
1625 +
1626 +=== **Beispiele** ===
1627 +
1628 +Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB
1629 +
1630 +{{code language="powershell" layout="LINENUMBERS"}}
1631 +Get-AESBConnectionInfo
1632 +
1633 +#Beispiel-Output:
1634 +
1635 + EndPoint VirtualRouter RoutingKey
1636 +-------- ------------- ----------
1637 +wss://localhost:3950 SHELL SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668
1638 +{{/code}}
1639 +
1640 +Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"
1641 +
1642 +{{code language="powershell"}}
1643 +Get-AESBAliasList -ConnectionName "MyConnection"
1644 +
1645 +{{/code}}
1646 +
1647 += Get-AESBTargetMessageCount =
1648 +
1649 +Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.
1650 +
1651 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1652 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.
1653 +|-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.
1654 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, unter dem das Target läuft.
1655 +
1656 +=== **Beispiele** ===
1657 +
1658 +Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"
1659 +
1660 +{{code language="powershell"}}
1661 +Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
1662 +{{/code}}
1663 +
1664 +Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"
1665 +
1666 +{{code language="powershell"}}
1667 +Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
1668 +
1669 +{{/code}}
1670 +
1671 += Get-AESBTargets =
1672 +
1673 +Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.
1674 +
1675 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1676 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll.
1677 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll.
1678 +
1679 +=== **Beispiele** ===
1680 +
1681 +Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
1682 +
1683 +{{code language="powershell"}}
1684 +Get-AESBTargets -VirtualRouter "MyRouter"
1685 +
1686 +{{/code}}
1687 +
1688 +Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"
1689 +
1690 +{{code language="powershell"}}
1691 +Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
1692 +
1693 +{{/code}}
1694 +
1695 += Publish-AESBMessage =
1696 +
1697 + Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.
1698 +
1699 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1700 +|-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
1701 +|-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
1702 +|-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
1703 +|-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
1704 +|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
1705 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
1706 +
1707 +
1708 +Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
1709 +
1710 +* (((
1711 +RoutingParameterSet - Message, VirtualRouter, RoutingKey
1712 +)))
1713 +* (((
1714 +AliasParameterSet - Message, Alias
1715 +)))
1716 +
1717 +=== **Beispiele** ===
1718 +
1719 +Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"
1720 +
1721 +{{code language="powershell"}}
1722 +Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message"
1723 +
1724 +{{/code}}
1725 +
1726 +Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey"
1727 +
1728 +{{code language="powershell"}}
1729 +Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message"
1730 +
1731 +{{/code}}
1732 +
1733 +(% id="cke_bm_333933S" style="display:none" %) (%%)Beispiel 3: Konvertieren eines PowerShell-Objekts in das ICQL-Format und senden des Objekts an den Alias "MyAlias".
1734 +
1735 +{{code language="powershell"}}
1736 +ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias"
1737 +
1738 +{{/code}}
1739 +
1740 += Publish-AESBMessageAndAwait =
1741 +
1742 +Sendet eine Nachricht an ein bestimmtes Target oder einen Alias im AESB und wartet auf eine Bestätigung oder Antwort innerhalb des angegebenen Zeitlimits.
1743 +
1744 +
1745 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1746 +|-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
1747 +|-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
1748 +|-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
1749 +|-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
1750 +|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
1751 +|-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.
1752 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
1753 +
1754 +(% class="wikigeneratedid" %)
1755 +(% id="cke_bm_484750S" style="display:none" %) (%%)Arbeiten in AESB verwendet werden können.
1756 +
1757 += Add-AESBAlias =
1758 +
1759 +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.
1760 +
1761 +(% style="width:977px" %)
1762 +|=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %)Optional|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung
1763 +|-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.
1764 +|-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.
1765 +
1766 +=== **Beispiele** ===
1767 +
1768 +Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung
1769 +
1770 +{{code language="powershell"}}
1771 +Add-AESBAlias -Alias "MyAlias"
1772 +{{/code}}
1773 +
1774 +Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection"
1775 +
1776 +{{code language="powershell"}}
1777 +Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection"
1778 +
1779 +{{/code}}
1780 +
1781 += Add-AESBCallbackTarget =
1782 +
1783 +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.
1784 +
1785 +(% style="width:1073px" %)
1786 +|=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Optional|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung
1787 +|(% 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.
1788 +|(% 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.
1789 +|(% 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.
1790 +|(% 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.
1791 +
1792 +=== (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** ===
1793 +
1794 +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
1795 +
1796 +{{code language="powershell"}}
1797 +Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
1798 +
1799 +{{/code}}
1800 +
1801 +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
1802 +
1803 +{{code language="powershell"}}
1804 +Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
1805 +
1806 +{{/code}}
1807 +
1808 += Add-AESBQueueTarget =
1809 +
1810 +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"]]
1811 +
1812 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1813 +|(% style="width:199px" %)-ConnectionName|(% style="width:160px" %)String|(% style="width:119px" %)✅|(% 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.
1814 +|(% style="width:199px" %)-VirtualRouter|(% style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name des Virtual Routers, dem das Queue-Target zugeordnet wird.
1815 +|(% style="width:199px" %)-TargetName|(% style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name des Queue-Targets, das hinzugefügt werden soll.
1816 +|(% style="width:199px" %)-RoutingKey|(% style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Routing-Key, der verwendet wird, um Nachrichten an das Queue-Targets zu senden.
1817 +
1818 +=== **Beispiele** ===
1819 +
1820 +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
1821 +
1822 +{{code language="powershell"}}
1823 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
1824 +
1825 +{{/code}}
1826 +
1827 +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
1828 +
1829 +{{code language="powershell"}}
1830 +Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
1831 +
1832 +{{/code}}
1833 +
1834 += Add-AESBRoutingKey =
1835 +
1836 +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.
1837 +
1838 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1839 +|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll.
1840 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, zu dem der Routing Key gehört.
1841 +|-TargetName|string|❌|TName|Der Name des Targets, für das der Routing Key hinzugefügt wird.
1842 +|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der hinzugefügt werden soll.
1843 +
1844 +=== **Beispiele** ===
1845 +
1846 +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
1847 +
1848 +{{code language="powershell"}}
1849 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
1850 +
1851 +{{/code}}
1852 +
1853 +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
1854 +
1855 +{{code language="powershell"}}
1856 +Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"
1857 +
1858 +{{/code}}
1859 +
1860 += Add-AESBRoutingToAlias =
1861 +
1862 +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.
1863 +
1864 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1865 +|-Alias|string|❌|A|Der Alias, zu dem das Routing-Paar im QNS hinzugefügt werden soll.
1866 +|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Routing-Paar hinzugefügt werden soll.
1867 +|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der zusammen mit dem Virtual Router hinzugefügt werden soll.
1868 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, der zusammen mit dem Routing Key hinzugefügt werden soll.
1869 +
1870 +=== (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** ===
1871 +
1872 +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.
1873 +
1874 +{{code language="powershell"}}
1875 +Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection"
1876 +{{/code}}
1877 +
1878 +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.
1879 +
1880 +{{code language="powershell"}}
1881 +Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
1882 +{{/code}}
1883 +
1884 += Add-AESBTarget =
1885 +
1886 +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.
1887 +
1888 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1889 +|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll.
1890 +|-RoutingKey|string|❌|RK|Der Routing Key, der dem Target zugewiesen wird.
1891 +|-TargetName|string|❌|TName|Der Name des Targets, das hinzugefügt werden soll.
1892 +|-TargetType|string|❌|TType|Der Typ des Targets, das hinzugefügt werden soll.
1893 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird.
1894 +
1895 +=== **Beispiele** ===
1896 +
1897 +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
1898 +
1899 +{{code language="powershell"}}
1900 +Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"
1901 +
1902 +{{/code}}
1903 +
1904 +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
1905 +
1906 +{{code language="powershell"}}
1907 +Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
1908 +
1909 +{{/code}}
1910 +
1911 += Add-AESBVirtualRouter =
1912 +
1913 +Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
1914 +
1915 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1916 +|-ConnectionName|string|✅|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll.
1917 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouter, der hinzugefügt werden soll.
1918 +
1919 +=== **Beispiele** ===
1920 +
1921 +Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung
1922 +
1923 +{{code language="powershell"}}
1924 +Add-AESBVirtualRouter -VirtualRouter "MyRouter"
1925 +
1926 +{{/code}}
1927 +
1928 +Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
1929 +
1930 +{{code language="powershell"}}
1931 +Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
1932 +
1933 +{{/code}}
1934 +
1935 += ConvertFrom-AESBBase64 =
1936 +
1937 +Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
1938 +
1939 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1940 +|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
1941 +
1942 +=== **Beispiele** ===
1943 +
1944 +Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"
1945 +
1946 +{{code language="powershell"}}
1947 +ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
1948 +
1949 +{{/code}}
1950 +
1951 +Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
1952 +
1953 +{{code language="powershell"}}
1954 +$base64String = "U29tZSBiYXNlNjQgdGV4dA=="
1955 +ConvertFrom-AESBBase64 -Input $base64String
1956 +{{/code}}
1957 +
1958 += ConvertFrom-AESBBase64ToFile =
1959 +
1960 +Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
1961 +
1962 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1963 +|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
1964 +|-OutputPath|string|❌|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen.
1965 +|-Force|switch|✅|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert.
1966 +
1967 +=== **Beispiele** ===
1968 +
1969 +Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
1970 +
1971 +{{code language="powershell"}}
1972 +ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
1973 +
1974 +{{/code}}
1975 +
1976 +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
1977 +
1978 +{{code language="powershell"}}
1979 +ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
1980 +{{/code}}
1981 +
1982 += ConvertFrom-AESBIcql =
1983 +
1984 +Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
1985 +
1986 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1987 +|-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll.
1988 +
1989 +=== **Beispiele** ===
1990 +
1991 +Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
1992 +
1993 +{{code language="powershell"}}
1994 +$icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>"
1995 +ConvertFrom-AESBIcql -Icql $icqlString
1996 +{{/code}}
1997 +
1998 +Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
1999 +
2000 +{{code language="none" layout="LINENUMBERS"}}
2001 +TargetName : MyTarget
2002 +TargetType : Queue
2003 +RoutingKey : MyRoutingKey
2004 +VirtualRouter : MyRouter
2005 +ConnectionName : MyConnection
2006 +{{/code}}
2007 +
2008 +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
2009 +
2010 +{{code language="powershell" layout="LINENUMBERS"}}
2011 +# Erstellen eines PSCustomObject mit Beispieldaten
2012 +$exampleObject = [PSCustomObject]@{
2013 + TargetName = "MyTarget"
2014 + TargetType = "Queue"
2015 + RoutingKey = "MyRoutingKey"
2016 + VirtualRouter = "MyRouter"
2017 + ConnectionName = "MyConnection"
2018 +}
2019 +
2020 +# Konvertieren des Objekts in eine Icql-Zeichenfolge
2021 +$x = ConvertTo-AESBIcql -InputObject $exampleObject
2022 +
2023 +# Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject
2024 +$decodedObject = ConvertFrom-AESBIcql -Icql $x
2025 +
2026 +# Anzeigen des dekodierten Objekts
2027 +$decodedObjectConvertFrom-AESBIcql -Icql $icqlString
2028 +{{/code}}
2029 +
2030 += ConvertTo-AESBBase64 =
2031 +
2032 +Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
2033 +
2034 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2035 +|-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll.
2036 +
2037 +=== **Beispiele** ===
2038 +
2039 +Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
2040 +
2041 +{{code language="powershell"}}
2042 +ConvertTo-AESBBase64 -Input "Hello World!"
2043 +ConvertFrom-AESBIcql -Icql $icqlString
2044 +{{/code}}
2045 +
2046 +Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
2047 +
2048 +{{code language="powershell"}}
2049 +$string = "Base64 encoding example"
2050 +$base64String = ConvertTo-AESBBase64 -Input $string
2051 +$base64StringConvertFrom-AESBIcql -Icql $icqlString
2052 +{{/code}}
2053 +
2054 += ConvertTo-AESBBase64FromFile =
2055 +
2056 +Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.
2057 +
2058 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2059 +|-InputPath|string|❌|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll.
2060 +
2061 +=== **Beispiele** ===
2062 +
2063 +Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge
2064 +
2065 +{{code language="powershell"}}
2066 +ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
2067 +
2068 +{{/code}}
2069 +
2070 +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
2071 +
2072 +{{code language="powershell"}}
2073 +$filePath = "C:\path\to\anotherfile.txt"
2074 +$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
2075 +$base64String
2076 +{{/code}}
2077 +
2078 += ConvertTo-AESBIcql =
2079 +
2080 +Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
2081 +
2082 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2083 +|-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll.
2084 +
2085 +=== **Beispiele** ===
2086 +
2087 +Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
2088 +
2089 +{{code language="powershell" layout="LINENUMBERS"}}
2090 +# Erstellen eines PSCustomObject mit Beispieldaten
2091 +$exampleObject = [PSCustomObject]@{
2092 + TargetName = "MyTarget"
2093 + TargetType = "Queue"
2094 + RoutingKey = "MyRoutingKey"
2095 + VirtualRouter = "MyRouter"
2096 + ConnectionName = "MyConnection"
2097 +}
2098 +
2099 +# Konvertieren des Objekts in eine Icql-Zeichenfolge
2100 +$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
2101 +$icqlString
2102 +{{/code}}
2103 +
2104 +Beispiel 2: Konvertiert das PSCustomObject, das in der Variable $exampleObject gespeichert ist, in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge in der Variable $icqlString zurück.
2105 +
2106 +{{code language="powershell" layout="LINENUMBERS"}}
2107 +# Erstellen eines PSCustomObject mit Beispieldaten
2108 +$exampleObject = [PSCustomObject]@{
2109 + TargetName = "MyTarget"
2110 + TargetType = "Queue"
2111 + RoutingKey = "MyRoutingKey"
2112 + VirtualRouter = "MyRouter"
2113 + ConnectionName = "MyConnection"
2114 +}
2115 +
2116 +# Konvertieren des Objekts in eine Icql-Zeichenfolge
2117 +$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
2118 +$icqlString
2119 +{{/code}}
2120 +
2121 += Get-AESBActivityLogItemById =
2122 +
2123 +Gibt den ActivityLog-Eintrag anhand einer ID zurück.
2124 +
2125 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2126 +|-Id|string|❌| |Die ID des Logeintrags
2127 +
2128 +=== **Beispiele** ===
2129 +
2130 +Beispiel 1: Abruf eines Log-Eintrags anhand einer ID
2131 +
2132 +{{code language="powershell"}}
2133 +Get-AESBActivityLogItemById -Id "ItemID"
2134 +
2135 +{{/code}}
2136 +
2137 += Get-AESBAliasList =
2138 +
2139 +Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.
2140 +
2141 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2142 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll.
2143 +
2144 +=== **Beispiele** ===
2145 +
2146 +Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung
2147 +
2148 +{{code language="powershell"}}
2149 +Get-AESBAliasList
2150 +
2151 +{{/code}}
2152 +
2153 +Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
2154 +
2155 +{{code language="powershell"}}
2156 +Get-AESBAliasList -ConnectionName "MyConnection"
2157 +
2158 +{{/code}}
2159 +
2160 += Get-AESBVirtualRouters =
2161 +
2162 +Gibt eine Liste aller VirtualRouter zurück.
2163 +
2164 +=== **Beispiele** ===
2165 +
2166 +Beispiel 1: Abrufen einer Liste aller VirtualRouter
2167 +
2168 +{{code language="powershell"}}
2169 +Get-AESBVirtualRouters
2170 +
2171 +{{/code}}
2172 +
2173 += Get-AESBAlias =
2174 +
2175 +Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.
2176 +
2177 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2178 +|-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder.
2179 +
2180 +=== **Beispiele** ===
2181 +
2182 +Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"
2183 +
2184 +{{code language="powershell"}}
2185 +Get-AESBAlias -Alias "AliasName"
2186 +
2187 +{{/code}}
2188 +
2189 += Get-AESBConnectionInfo =
2190 +
2191 +Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.
2192 +
2193 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2194 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen.
2195 +
2196 +=== **Beispiele** ===
2197 +
2198 +Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB
2199 +
2200 +{{code language="powershell" layout="LINENUMBERS"}}
2201 +Get-AESBConnectionInfo
2202 +
2203 +#Beispiel-Output:
2204 +
2205 + EndPoint VirtualRouter RoutingKey
2206 +-------- ------------- ----------
2207 +wss://localhost:3950 SHELL SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668
2208 +{{/code}}
2209 +
2210 +Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"
2211 +
2212 +{{code language="powershell"}}
2213 +Get-AESBAliasList -ConnectionName "MyConnection"
2214 +
2215 +{{/code}}
2216 +
2217 += Get-AESBTargetMessageCount =
2218 +
2219 +Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.
2220 +
2221 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2222 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.
2223 +|-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.
2224 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, unter dem das Target läuft.
2225 +
2226 +=== **Beispiele** ===
2227 +
2228 +Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"
2229 +
2230 +{{code language="powershell"}}
2231 +Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
2232 +{{/code}}
2233 +
2234 +Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"
2235 +
2236 +{{code language="powershell"}}
2237 +Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
2238 +
2239 +{{/code}}
2240 +
2241 += Get-AESBTargets =
2242 +
2243 +Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.
2244 +
2245 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2246 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll.
2247 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll.
2248 +
2249 +=== **Beispiele** ===
2250 +
2251 +Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
2252 +
2253 +{{code language="powershell"}}
2254 +Get-AESBTargets -VirtualRouter "MyRouter"
2255 +
2256 +{{/code}}
2257 +
2258 +Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"
2259 +
2260 +{{code language="powershell"}}
2261 +Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
2262 +
2263 +{{/code}}
2264 +
2265 += Publish-AESBMessage =
2266 +
2267 + Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.
2268 +
2269 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2270 +|-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
2271 +|-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
2272 +|-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
2273 +|-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
2274 +|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
2275 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
2276 +
2277 +Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
2278 +
2279 +* (((
2280 +RoutingParameterSet - Message, VirtualRouter, RoutingKey
2281 +)))
2282 +* (((
2283 +AliasParameterSet - Message, Alias
2284 +)))
2285 +
2286 +=== **Beispiele** ===
2287 +
2288 +Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"
2289 +
2290 +{{code language="powershell"}}
2291 +Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
2292 +
2293 +{{/code}}
2294 +
2295 +Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey"
2296 +
2297 +{{code language="powershell"}}
2298 +Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
2299 +
2300 +{{/code}}
2301 +
2302 += Receive-AESBTargetMessages =
2303 +
2304 +Mit diesem Cmdlet werden Nachrichten von einem Ziel im AESB empfangen.
2305 +
2306 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2307 +|-ConnectionName|//string//|✅|C|Der Name der Verbindung zum AESB.
2308 +|-MessageCount|//int//|✅|MC|Die Anzahl der Nachrichten, die empfangen werden sollen.
2309 +|-TargetName|//string//|❌|TName|Der Name des Ziels, von dem die Nachrichten empfangen werden.
2310 +|-VirtualRouter|//string//|❌|VR|Der Name des Virtual Routers, der für das Ziel verwendet wird.
2311 +
2312 +=== **Beispiele** ===
2313 +
2314 +Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung
2315 +
2316 +{{code language="powershell"}}
2317 +Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
2318 +
2319 +{{/code}}
2320 +
2321 +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
2322 +
2323 +{{code language="powershell"}}
2324 +Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
2325 +
2326 +{{/code}}
2327 +
2328 += Remove-AESBAlias =
2329 +
2330 +Mit diesem Cmdlet wird ein Alias aus dem AESB entfernt.
2331 +
2332 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2333 +|-Alias|string|❌|A|Der Name des zu entfernenden Alias.
2334 +|-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB.
2335 +
2336 +=== **Beispiele** ===
2337 +
2338 +Beispiel 1: Entfernen vom Routing-Paar mit Virtual Router "MyRouter" und Routing Key "MyRoutingKey" vom Alias "MyAlias".
2339 +
2340 +{{code language="powershell"}}
2341 +Remove-AESBRoutingFromAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
2342 +
2343 +{{/code}}
2344 +
2345 +Beispiel 2: Entfernen vom Routing-Paar mit VirtualRouter "MyRouter" und RoutingKey "MyRoutingKey" vom Alias "MyAlias" unter Verwendung der Verbindung "MyConnection".
2346 +
2347 +{{code language="powershell"}}
2348 +Remove-AESBRoutingFromAlias -Alias "MyAlias" -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
2349 +{{/code}}
2350 +
241 241  = Remove-AESBRoutingKey =
242 242  
2353 +Entfernt einen Routing Key von einem bestimmten Ziel in einem VirtualRouter im AESB. Der RoutingKey wird aus der Konfiguration entfernt, die mit dem angegebenen Ziel und VirtualRouter verknüpft ist.
2354 +
2355 +
2356 +
2357 +
2358 +
243 243  = Remove-AESBTarget =
244 244  
245 245  = Remove-AESBVirtualRouter =
© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community