Changes for page Operative Cmdlets

Last modified by jklein on 2025/08/06 13:00

From version 28.1
edited by jklein
on 2025/06/18 11:36
Change comment: There is no comment for this version
To version 18.4
edited by jklein
on 2024/12/16 14:36
Change comment: There is no comment for this version

Summary

Details

Page properties
Parent
... ... @@ -1,1 +1,1 @@
1 -AESB.111.AESB Shell.Cmdlet-Dokumentation.WebHome
1 +AESB.110.AESB Shell.Cmdlet-Dokumentation.WebHome
Content
... ... @@ -3,10 +3,6 @@
3 3  (% class="wikigeneratedid" %)
4 4  Bei den operativen Cmdlets handelt es sich um Shell-Befehle, die für die Steuerung und das weiterführende Arbeiten in AESB verwendet werden können.
5 5  
6 -{{aagon.infobox}}
7 -Falls bei der Ausführung eines Cmdlets mit ausschließlich optionalen Parametern keine Parameter angegeben werden, wird immer die Standardverbindung mit dem standardmäßigen Parameter-Set genutzt.
8 -{{/aagon.infobox}}
9 -
10 10  = Add-AESBAlias =
11 11  
12 12  Mit diesem Cmdlet wird ein neuer Alias für eine SICS-Verbindung im Qualified Name Service (QNS) hinzugefügt. Wenn der Parameter //-ConnectionName// nicht angegeben wird, wird der Alias für die Standardverbindung hinzugefügt.
... ... @@ -258,7 +258,7 @@
258 258  ConnectionName : MyConnection
259 259  {{/code}}
260 260  
261 -Beispiel 2: Kodieren eines PSCustomObjects in eine Icql-Zeichenfolge und anschließendes Dekodieren zurück in ein PSCustomObject. Die resultierenden Daten entsprechen den ursprünglichen Eingabewerten
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
262 262  
263 263  {{code language="powershell" layout="LINENUMBERS"}}
264 264  # Erstellen eines PSCustomObject mit Beispieldaten
... ... @@ -334,8 +334,6 @@
334 334  
335 335  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
336 336  |-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll.
337 -|-Sequence|string|✅| |Setzt die Sequence einer ICQL Message
338 -|-Action|string|✅| |Setzt die Action einer ICQL Message
339 339  
340 340  === **Beispiele** ===
341 341  
... ... @@ -356,9 +356,26 @@
356 356  $icqlString
357 357  {{/code}}
358 358  
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 +
359 359  = Get-AESBActivityLogItemById =
360 360  
361 -Gibt den Activity Log-Eintrag anhand einer ID zurück.
372 +Gibt den ActivityLog-Eintrag anhand einer ID zurück.
362 362  
363 363  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
364 364  |-Id|string|❌| |Die ID des Logeintrags
... ... @@ -397,11 +397,11 @@
397 397  
398 398  = Get-AESBVirtualRouters =
399 399  
400 -Gibt eine Liste aller Virtual Router zurück.
411 +Gibt eine Liste aller VirtualRouter zurück.
401 401  
402 402  === **Beispiele** ===
403 403  
404 -Beispiel 1: Abrufen einer Liste aller Virtual Router
415 +Beispiel 1: Abrufen einer Liste aller VirtualRouter
405 405  
406 406  {{code language="powershell"}}
407 407  Get-AESBVirtualRouters
... ... @@ -459,17 +459,17 @@
459 459  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
460 460  |-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.
461 461  |-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.
462 -|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, unter dem das Target läuft.
473 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, unter dem das Target läuft.
463 463  
464 464  === **Beispiele** ===
465 465  
466 -Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual Router "MyRouter"
477 +Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"
467 467  
468 468  {{code language="powershell"}}
469 469  Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
470 470  {{/code}}
471 471  
472 -Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual Router "MyRouter" und der Verbindung "MyConnection"
483 +Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"
473 473  
474 474  {{code language="powershell"}}
475 475  Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
... ... @@ -486,7 +486,7 @@
486 486  
487 487  === **Beispiele** ===
488 488  
489 -Beispiel 1: Abrufen der Liste aller Targets unter dem Virtual Router "MyRouter"
500 +Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
490 490  
491 491  {{code language="powershell"}}
492 492  Get-AESBTargets -VirtualRouter "MyRouter"
... ... @@ -493,7 +493,7 @@
493 493  
494 494  {{/code}}
495 495  
496 -Beispiel 2: Abrufen der Liste aller Targets für den Virtual Router "MyRouter" und die Verbindung "MyConnection"
507 +Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"
497 497  
498 498  {{code language="powershell"}}
499 499  Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
... ... @@ -512,7 +512,6 @@
512 512  |-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
513 513  |-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
514 514  
515 -=== Parameter-Sets ===
516 516  
517 517  Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
518 518  
... ... @@ -525,7 +525,7 @@
525 525  
526 526  === **Beispiele** ===
527 527  
528 -Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"
538 +Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"
529 529  
530 530  {{code language="powershell"}}
531 531  Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message"
... ... @@ -532,7 +532,7 @@
532 532  
533 533  {{/code}}
534 534  
535 -Beispiel 2: Senden der Nachricht "This is a test message" über den Virtual Router "MyRouter" mit dem Routing Key "MyRoutingKey"
545 +Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey"
536 536  
537 537  {{code language="powershell"}}
538 538  Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message"
... ... @@ -539,7 +539,7 @@
539 539  
540 540  {{/code}}
541 541  
542 -Beispiel 3: Konvertieren eines PSCustomObject in das ICQL-Format und senden der Nachricht an den Alias "MyAlias"
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".
543 543  
544 544  {{code language="powershell"}}
545 545  ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias"
... ... @@ -548,301 +548,629 @@
548 548  
549 549  = Publish-AESBMessageAndAwait =
550 550  
551 -Mit diesem Cmdlet können Sie eine Nachricht an ein bestimmtes Target oder einen Alias im AESB senden. Anschließend wird auf eine Bestätigung oder Antwort innerhalb des angegebenen Zeitlimits gewartet.
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.
552 552  
563 +
553 553  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
554 554  |-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
555 555  |-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
556 556  |-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
557 557  |-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
558 -|-RoutingKey|string|❌|RK|Der Routing Key, der für das Routing der Nachricht verwendet wird.
569 +|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
559 559  |-Timeout|string|✅|T|Die maximale Zeitdauer, die auf eine Bestätigung gewartet wird. Der Wert kann in Sekunden, Minuten oder Stunden angegeben werden, z.B. "5s", "5 sec", "5 seconds", "5m", "5 min", "5 minutes", "2h", "2 hours". Standardmäßig wird der Wert in Sekunden interpretiert.
560 -|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, über den die Nachricht veröffentlicht werden soll.
571 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
561 561  
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 +
562 562  === **Beispiele** ===
563 563  
564 -Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung
587 +Beispiel 1: Hinzufügen des Alias "MyAlias" r die Standardverbindung
565 565  
566 566  {{code language="powershell"}}
567 -Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
590 +Add-AESBAlias -Alias "MyAlias"
591 +{{/code}}
568 568  
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 +
569 569  {{/code}}
570 570  
571 -Beispiel 2: Senden der Nachricht "This is a test message" über den Virtual Router "MyRouter" mit dem Routing Key "MyRoutingKey" und wartet bis zu 1 Stunde auf eine Bestätigung.
600 += Add-AESBCallbackTarget =
572 572  
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 +
573 573  {{code language="powershell"}}
574 -Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
616 +Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
575 575  
576 576  {{/code}}
577 577  
578 -= Receive-AESBTargetMessages =
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
579 579  
580 -Mit diesem Cmdlet können Sie Nachrichten von einem Ziel im AESB empfangen.
622 +{{code language="powershell"}}
623 +Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
581 581  
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 +
582 582  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
583 -|-ConnectionName|//string//|✅|C|Der Name der Verbindung zum AESB.
584 -|-MessageCount|//int//|✅|MC|Die Anzahl der Nachrichten, die empfangen werden sollen.
585 -|-TargetName|//string//|❌|TName|Der Name des Ziels, von dem die Nachrichten empfangen werden.
586 -|-VirtualRouter|//string//|❌|VR|Der Name des Virtual Routers, der für das Ziel verwendet wird.
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.
587 587  
588 588  === **Beispiele** ===
589 589  
590 -Beispiel 1: Empfangen von Nachrichten vom Ziel mit dem Namen "MyTarget", das dem Virtual Router "MyRouter" zugeordnet ist
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
591 591  
592 592  {{code language="powershell"}}
593 -Receive-AESBTargetMessages -VirtualRouter "MyRouter" -TargetName "MyTarget"
642 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
594 594  
595 595  {{/code}}
596 596  
597 -Beispiel 2: Empfangen von bis zu 10 Nachrichten vom Ziel mit dem Namen "MyTarget", das dem Virtual Router "MyRouter" zugeordnet ist
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
598 598  
599 599  {{code language="powershell"}}
600 -Receive-AESBTargetMessages -VirtualRouter "MyRouter" -TargetName "MyTarget" -MessageCount 10
649 +Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
601 601  
602 602  {{/code}}
603 603  
604 -= Remove-AESBAlias =
653 += Add-AESBRoutingKey =
605 605  
606 -Mit diesem Cmdlet können Sie einen Alias aus dem AESB entfernen.
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.
607 607  
608 608  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
609 -|-Alias|string|❌|A|Der Name des zu entfernenden Alias.
610 -|-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB.
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.
611 611  
612 612  === **Beispiele** ===
613 613  
614 -Beispiel 1: Entfernen vom Alias "MyAlias" aus dem AESB
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
615 615  
616 616  {{code language="powershell"}}
617 -Remove-AESBAlias -Alias "MyAlias"
668 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
618 618  
619 619  {{/code}}
620 620  
621 -Beispiel 2: Entfernen vom Alias "MyAlias" aus dem AESB über die angegebene Verbindung
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
622 622  
623 623  {{code language="powershell"}}
624 -Remove-AESBAlias -ConnectionName "MyConnection" -Alias "MyAlias"
675 +Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"
625 625  
626 626  {{/code}}
627 627  
628 -= Remove-AESBRoutingFromAlias =
679 += Add-AESBRoutingToAlias =
629 629  
630 -Mit diesem Cmdlet nnen Sie ein Routing-Paar (bestehend aus Virtual Router und Routing Key) von einem Alias im QNS entfernen. Das Routing-Paar wird vollständig gelöscht.
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.
631 631  
632 632  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
633 -|-Alias|string|❌|A|Der Name des Alias, von dem das Routing-Paar entfernt werden soll.
634 -|-ConnectionName|string|✅|C|Der Name der Verbindung, die verwendet wird.
635 -|-RoutingKey|string|❌|RK|Der Routing Key, der aus dem Alias entfernt werden soll.
636 -|-VirtualRouter|string|❌|VR|Der Virtual Router, der zusammen mit dem Routing Key entfernt werden soll.
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.
637 637  
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 +
638 638  === **Beispiele** ===
639 639  
640 -Beispiel 1: Entfernen vom Routing-Paar miVirtual Router "MyRouter" und Routing Key "MyRoutingKey" vom Alias "MyAlias"
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
641 641  
642 642  {{code language="powershell"}}
643 -Remove-AESBRoutingFromAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
719 +Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"
644 644  
645 645  {{/code}}
646 646  
647 -Beispiel 2: Entfernen vom Routing-Paar miVirtual Router "MyRouter" und Routing Key "MyRoutingKey" vom Alias "MyAlias" unter Verwendung der Verbindung "MyConnection"
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
648 648  
649 649  {{code language="powershell"}}
650 -Remove-AESBRoutingFromAlias -Alias "MyAlias" -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
726 +Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
651 651  
652 652  {{/code}}
653 653  
654 -= Remove-AESBRoutingKey =
730 += Add-AESBVirtualRouter =
655 655  
656 -Mit diesem Cmdlet können Sie einen Routing Key von einem bestimmten Ziel in einem Virtual Router im AESB entfernen. Der Routing Key wird aus der Konfiguration entfernt, die mit dem angegebenen Ziel und Virtual Router verknüpft ist.
732 +Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
657 657  
658 658  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
659 -|-ConnectionName|string|✅|C|Der Name der Verbindung, die verwendet werden soll.
660 -|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, von dem der Routing Key entfernt werden soll.
661 -|-TargetName|string|❌|TName|Der Name des Ziels, von dem der Routing Key entfernt werden soll.
662 -|-RoutingKey|string|❌|RK|Der Routing Key, der entfernt werden soll.
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.
663 663  
664 664  === **Beispiele** ===
665 665  
666 -Beispiel 1: Entfernen vom Routing Key "MyRoutingKey" vom Ziel "MyTarget" im Virtual Router "MyRouter"
740 +Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung
667 667  
668 668  {{code language="powershell"}}
669 -Remove-AESBRoutingKey -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey"
743 +Add-AESBVirtualRouter -VirtualRouter "MyRouter"
670 670  
671 671  {{/code}}
672 672  
673 -Beispiel 2: Entfernen vom Routing Key "MyRoutingKey" vom Ziel "MyTarget" im Virtual Router "MyRouter" unter Verwendung der Verbindung "MyConnection"
747 +Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
674 674  
675 675  {{code language="powershell"}}
676 -Remove-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey"
750 +Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
677 677  
678 678  {{/code}}
679 679  
680 -= Remove-AESBTarget =
754 += ConvertFrom-AESBBase64 =
681 681  
682 -Mit diesem Cmdlet können Sie ein Ziel aus dem Virtual Router des AESB entfernen.
756 +Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
683 683  
684 684  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
685 -|-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB.
686 -|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, von dem das Ziel entfernt werden soll.
687 -|-TargetName|string|❌|TName|Der Name des Ziels, das entfernt werden soll.
759 +|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
688 688  
689 689  === **Beispiele** ===
690 690  
691 -Beispiel 1: Entfernen vom Ziel "MyTarget" vom Virtual Router "MyRouter"
763 +Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"
692 692  
693 693  {{code language="powershell"}}
694 -Remove-AESBTarget -VirtualRouter "MyRouter" -TargetName "MyTarget"
766 +ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
767 +
695 695  {{/code}}
696 696  
697 -Beispiel 2: Entfernen vom Ziel "MyTarget" vom Virtual Router "MyRouter" unter Verwendung der Verbindung "MyConnection"
770 +Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
698 698  
699 699  {{code language="powershell"}}
700 -Remove-AESBTarget -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
773 +$base64String = "U29tZSBiYXNlNjQgdGV4dA=="
774 +ConvertFrom-AESBBase64 -Input $base64String
701 701  {{/code}}
702 702  
703 -= Remove-AESBVirtualRouter =
777 += ConvertFrom-AESBBase64ToFile =
704 704  
705 -Mit diesem Cmdlet können Sie einen angegebenen Virtual Router entfernen.
779 +Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
706 706  
707 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|Gibt den Namen der Verbindung an.
709 -|VirtualRouter|string|❌|VR|Gibt den Namen des zu entfernenden Virtual Router an.
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.
710 710  
711 711  === **Beispiele** ===
712 712  
713 -Beispiel 1: Entfernen vom Virtual Router mit dem Namen "MyRouter"
788 +Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
714 714  
715 715  {{code language="powershell"}}
716 -Remove-AESBVirtualRouter -VirtualRouter "MyRouter"
791 +ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
717 717  
718 718  {{/code}}
719 719  
720 -Beispiel 2: Entfernen vom Virtual Router mit dem Namen "MyRouter" unter der Verbindung "MyConnection"
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
721 721  
722 722  {{code language="powershell"}}
723 -Remove-AESBVirtualRouter -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
798 +ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
724 724  {{/code}}
725 725  
726 -= Set-AESBBSelfAsAlias =
801 += ConvertFrom-AESBIcql =
727 727  
728 -Bei diesem Cmdlet wird ein existierender Alias verwendet, um einen neuen Alias hinzuzufügen. Durch Verwendung des bereits existierenden Alias, müssen so nicht der Routing Key und Virtual Router verwendet werden.
803 +Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
729 729  
730 -{{aagon.warnungsbox}}
731 -Die Parameter RemoveExistingAlias und AddToExistingAlias dürfen nicht gleichzeitig verwendet werden!
732 -{{/aagon.warnungsbox}}
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.
733 733  
734 -**Parameter**
808 +=== **Beispiele** ===
735 735  
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 +
736 736  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
737 -|-Alias|string|❌| |Gibt den Namen vom Alias an
738 -|-RemoveExistingAlias|bool|✅| |Der bestehende Alias wird ersetzt.
739 -|-AddToExistingAlias|bool|✅| |Der Virtual Router und Routing Key wird zu dem angegebenen Alias hinzugefügt
854 +|-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll.
740 740  
741 741  === **Beispiele** ===
742 742  
743 -Beispiel 1: Überschreiben vom existierenden Alias „AliasName“. Wenn z.B. der vorherige Alias mehrere Virtual Router und Routing Keys hatte, werden diese gescht
858 +Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
744 744  
745 745  {{code language="powershell"}}
746 -Set-AESBSelfAsAlias -Alias "AliasName" -RemoveExistingAlias $true
861 +ConvertTo-AESBBase64 -Input "Hello World!"
862 +ConvertFrom-AESBIcql -Icql $icqlString
863 +{{/code}}
747 747  
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
748 748  {{/code}}
749 749  
750 -Beispiel 2: Hinzufügen der Virtual Router und Routing Keys vom Alias „AliasName“ zum angegebenen Alias "SelfAliasTest".
873 += ConvertTo-AESBBase64FromFile =
751 751  
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 +
752 752  {{code language="powershell"}}
753 -Set-AESBSelfAsAlias -Alias "AliasName" -AddToExistingAlias "SelfAliasTest"
885 +ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
886 +
754 754  {{/code}}
755 755  
756 -= Show-AESBRoutingTable =
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
757 757  
758 -Dieses Cmdlet zeigt die Routing-Tabelle für den angegebenen Virtual Router an. Mit den Parametern ist es möglich, die angezeigten Daten weiter einzuschränken.
891 +{{code language="powershell"}}
892 +$filePath = "C:\path\to\anotherfile.txt"
893 +$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
894 +$base64String
895 +{{/code}}
759 759  
760 -**Parameter**
897 += ConvertTo-AESBIcql =
761 761  
899 +Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
900 +
762 762  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
763 -|-ConnectionName|string|✅|C|Der Name der Verbindung, die für das Abrufen der Routing-Tabelle verwendet wird.
764 -|-ExchangeType|ExchangeTypes|✅|ET|Der Typ des Exchanges, der angezeigt werden soll. Mögliche Werte sind DIRECT oder ROUTING.
765 -|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, für den die Routing-Tabelle angezeigt wird.
902 +|-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll.
766 766  
767 767  === **Beispiele** ===
768 768  
769 -Beispiel 1: Anzeigen der Routing-Tabelle für den Virtual Router „MyRouter
906 +Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
770 770  
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 +
771 771  {{code language="powershell"}}
772 -Show-AESBRoutingTable -VirtualRouter "MyRouter"
952 +Get-AESBActivityLogItemById -Id "ItemID"
773 773  
774 774  {{/code}}
775 775  
776 -Beispiel 2: Anzeigen der Routing-Tabelle für den Virtual Router „MyRouter“ an, wobei nur Einträge vom Typ „DIRECT“ angezeigt werden. Die Verbindung „MyConnection“ wird verwendet.
956 += Get-AESBAliasList =
777 777  
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 +
778 778  {{code language="powershell"}}
779 -Show-AESBRoutingTable -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -ExchangeType DIRECT
968 +Get-AESBAliasList
780 780  
781 781  {{/code}}
782 782  
783 -= Write-AESBActivityLog =
972 +Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
784 784  
785 -Mit diesem Cmdlet wird ein Eintrag in das ActivityLog des AESB geschrieben. Wenn keine ID angegeben wird, wird ein neuer Log-Eintrag erstellt. Falls eine ID angegeben wird, wird der vorhandene Log-Eintrag mit dieser ID aktualisiert.
974 +{{code language="powershell"}}
975 +Get-AESBAliasList -ConnectionName "MyConnection"
786 786  
787 -**Parameter**
977 +{{/code}}
788 788  
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 +
789 789  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
790 -|-ConnectionName|string|✅|C|Der Name der Verbindung, die für die Kommunikation verwendet wird.
791 -|-Id|string|✅|None|Die ID des Log-Eintrags, der aktualisiert werden soll. Wird ein neuer Eintrag erstellt, kann dieser Parameter weggelassen werden.
792 -|-Name|string|❌|N|Der Name des Log-Eintrags.
793 -|-Description|string|❌|D|Die Beschreibung des Log-Eintrags.
794 -|-Status|JobFeedbackResultCode|❌|ST|Der Status des Logs, z.B. "Warning", "Created", "Started", "Running", "Stopping", "Stopped", "Failed" oder "Finished".
795 -|-ComponentName|string|✅|ComName|Der Name der Komponente, die den Log-Eintrag erstellt hat.
997 +|-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder.
796 796  
797 797  === **Beispiele** ===
798 798  
799 -Beispiel 1: Erstellen eines neuen Log-Eintrags. Der Eintrag erhält den Namen "ProcessStart", die Beschreibung "Der Prozess wurde gestartet" und den Status "Started". Da keine ID angegeben ist, wird ein neuer Log-Eintrag erstellt.
1001 +Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"
800 800  
801 801  {{code language="powershell"}}
802 -Write-AESBActivityLog -Name "ProcessStart" -Description "Der Prozess wurde gestartet." -Status Started
1004 +Get-AESBAlias -Alias "AliasName"
1005 +
803 803  {{/code}}
804 804  
805 -Beispiel 2: Aktualisieren eines vorhandenen Log-Eintrags mit der ID "12345". Der Log-Eintrag wird auf den Namen "ProcessUpdate", die Beschreibung "Der Prozessstatus wurde aktualisiert" und den Status "Running" gesetzt. Die ID wird verwendet, um den spezifischen Eintrag zu finden und zu aktualisieren.
1008 += Get-AESBConnectionInfo =
806 806  
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 +
807 807  {{code language="powershell"}}
808 -Write-AESBActivityLog -Id "12345" -Name "ProcessUpdate" -Description "Der Prozessstatus wurde aktualisiert." -Status Running
1032 +Get-AESBAliasList -ConnectionName "MyConnection"
809 809  
810 810  {{/code}}
811 811  
812 -= Write-AESBBusinessLog =
1036 += Get-AESBTargetMessageCount =
813 813  
814 -Mit diesem Cmdlet wird eine Nachricht in das Business-Log des AESB geschrieben. Jeder Aufruf des Cmdlets erzeugt immer einen neuen Log-Eintrag.
1038 +Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.
815 815  
816 -{{aagon.infobox}}
817 -Das BusinessLog dient zur Information über Prozessabläufe und -ergebnisse durch aussagekräftige Benachrichtigungen. Daher ist es nicht möglich, Objekte in der Nachricht des BusinessLogs auszugeben.
818 -{{/aagon.infobox}}
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.
819 819  
820 -**Parameter**
1045 +=== **Beispiele** ===
821 821  
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 +
822 822  |=(% 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 +
1122 += Receive-AESBTargetMessages =
1123 +
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 +
1148 += Remove-AESBAlias =
1149 +
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.
823 823  |-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB.
824 -|-IsError|bool|✅|IsErr|Gibt an, ob die Nachricht als Fehler protokolliert wird.
825 -|-Message|string|❌|M|Die zu protokollierende Nachricht.
826 -|-ComponentId|string|✅|CId|Die ID des Komponenten.
827 -|-ComponentName|string|✅|ComName|Der Name des Komponenten.
828 -|-ComponentPart|string|✅|ComPart|Der Teil des Komponenten.
829 -|-HostId|string|✅|HId|Die ID des Hosts.
830 -|-HostName|string|✅|HN|Der Name des Hosts.
831 -|-Context|string|✅|CT|Der Kontext der Nachricht.
832 832  
833 833  === **Beispiele** ===
834 834  
835 -Beispiel 1: Erstellen eines neuen Log-Eintrags im Business-Log mit der Nachricht "System started successfully". Der Log-Eintrag wird dem Komponenten-Namen "MyComponent" und dem Kontext "Initialization" zugeordnet.
1158 +Beispiel 1: Entfernen vom Alias "MyAlias" aus dem AESB
836 836  
837 837  {{code language="powershell"}}
838 -Write-AESBBusinessLog -Message "System started successfully" -ComponentName "MyComponent" -Context "Initialization"
1161 +Remove-AESBAlias -Alias "MyAlias"
839 839  
840 840  {{/code}}
841 841  
842 -Beispiel 2: Erstellen eines neuen Log-Eintrag im Business-Log, der als Fehler gekennzeichnet ist. Die Nachricht "Error connecting to database" wird dem Komponenten-ID "DBComponent" und dem Host-Namen "Server01" zugeordnet.
1165 +Beispiel 2: Entfernen vom Alias "MyAlias" aus dem AESB über die angegebene Verbindung
843 843  
844 844  {{code language="powershell"}}
845 -Write-AESBBusinessLog -IsError $true -Message "Error connecting to database" -ComponentId "DBComponent" -HostName "Server01"
1168 +Remove-AESBAlias -ConnectionName "MyConnection" -Alias "MyAlias"
1169 +
846 846  {{/code}}
847 847  
848 -
1172 += Remove-AESBRoutingFromAlias =
1173 +
1174 += Remove-AESBRoutingKey =
1175 +
1176 += Remove-AESBTarget =
1177 +
1178 += Remove-AESBVirtualRouter =
1179 +
1180 += Set-AESBBSelfAsAlias =
1181 +
1182 += Show-AESBRoutingTable =
1183 +
1184 += Write-AESBActivityLog =
1185 +
1186 += Write-AESBBusinessLog =
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community