Changes for page Operative Cmdlets

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

From version 23.1
edited by jklein
on 2024/12/18 10:33
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
Content
... ... @@ -369,7 +369,7 @@
369 369  
370 370  = Get-AESBActivityLogItemById =
371 371  
372 -Gibt den Activity Log-Eintrag anhand einer ID zurück.
372 +Gibt den ActivityLog-Eintrag anhand einer ID zurück.
373 373  
374 374  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
375 375  |-Id|string|❌| |Die ID des Logeintrags
... ... @@ -408,11 +408,11 @@
408 408  
409 409  = Get-AESBVirtualRouters =
410 410  
411 -Gibt eine Liste aller Virtual Router zurück.
411 +Gibt eine Liste aller VirtualRouter zurück.
412 412  
413 413  === **Beispiele** ===
414 414  
415 -Beispiel 1: Abrufen einer Liste aller Virtual Router
415 +Beispiel 1: Abrufen einer Liste aller VirtualRouter
416 416  
417 417  {{code language="powershell"}}
418 418  Get-AESBVirtualRouters
... ... @@ -470,17 +470,17 @@
470 470  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
471 471  |-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.
472 472  |-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.
473 -|-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.
474 474  
475 475  === **Beispiele** ===
476 476  
477 -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"
478 478  
479 479  {{code language="powershell"}}
480 480  Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
481 481  {{/code}}
482 482  
483 -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"
484 484  
485 485  {{code language="powershell"}}
486 486  Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
... ... @@ -497,7 +497,7 @@
497 497  
498 498  === **Beispiele** ===
499 499  
500 -Beispiel 1: Abrufen der Liste aller Targets unter dem Virtual Router "MyRouter"
500 +Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
501 501  
502 502  {{code language="powershell"}}
503 503  Get-AESBTargets -VirtualRouter "MyRouter"
... ... @@ -504,7 +504,7 @@
504 504  
505 505  {{/code}}
506 506  
507 -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"
508 508  
509 509  {{code language="powershell"}}
510 510  Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
... ... @@ -523,7 +523,6 @@
523 523  |-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
524 524  |-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
525 525  
526 -=== Parameter-Sets ===
527 527  
528 528  Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
529 529  
... ... @@ -536,7 +536,7 @@
536 536  
537 537  === **Beispiele** ===
538 538  
539 -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"
540 540  
541 541  {{code language="powershell"}}
542 542  Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message"
... ... @@ -543,7 +543,7 @@
543 543  
544 544  {{/code}}
545 545  
546 -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"
547 547  
548 548  {{code language="powershell"}}
549 549  Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message"
... ... @@ -550,7 +550,7 @@
550 550  
551 551  {{/code}}
552 552  
553 -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".
554 554  
555 555  {{code language="powershell"}}
556 556  ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias"
... ... @@ -559,266 +559,629 @@
559 559  
560 560  = Publish-AESBMessageAndAwait =
561 561  
562 -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.
563 563  
563 +
564 564  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
565 565  |-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
566 566  |-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
567 567  |-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
568 568  |-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
569 -|-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.
570 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 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.
572 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 +
573 573  === **Beispiele** ===
574 574  
575 -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
576 576  
577 577  {{code language="powershell"}}
578 -Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
590 +Add-AESBAlias -Alias "MyAlias"
591 +{{/code}}
579 579  
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 +
580 580  {{/code}}
581 581  
582 -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 =
583 583  
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 +
584 584  {{code language="powershell"}}
585 -Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
616 +Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
586 586  
587 587  {{/code}}
588 588  
589 -= 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
590 590  
591 -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"
592 592  
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 +
593 593  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
594 -|-ConnectionName|//string//|✅|C|Der Name der Verbindung zum AESB.
595 -|-MessageCount|//int//|✅|MC|Die Anzahl der Nachrichten, die empfangen werden sollen.
596 -|-TargetName|//string//|❌|TName|Der Name des Ziels, von dem die Nachrichten empfangen werden.
597 -|-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.
598 598  
599 599  === **Beispiele** ===
600 600  
601 -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
602 602  
603 603  {{code language="powershell"}}
604 -Receive-AESBTargetMessages -VirtualRouter "MyRouter" -TargetName "MyTarget"
642 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
605 605  
606 606  {{/code}}
607 607  
608 -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
609 609  
610 610  {{code language="powershell"}}
611 -Receive-AESBTargetMessages -VirtualRouter "MyRouter" -TargetName "MyTarget" -MessageCount 10
649 +Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
612 612  
613 613  {{/code}}
614 614  
615 -= Remove-AESBAlias =
653 += Add-AESBRoutingKey =
616 616  
617 -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.
618 618  
619 619  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
620 -|-Alias|string|❌|A|Der Name des zu entfernenden Alias.
621 -|-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.
622 622  
623 623  === **Beispiele** ===
624 624  
625 -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
626 626  
627 627  {{code language="powershell"}}
628 -Remove-AESBAlias -Alias "MyAlias"
668 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
629 629  
630 630  {{/code}}
631 631  
632 -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
633 633  
634 634  {{code language="powershell"}}
635 -Remove-AESBAlias -ConnectionName "MyConnection" -Alias "MyAlias"
675 +Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"
636 636  
637 637  {{/code}}
638 638  
639 -= Remove-AESBRoutingFromAlias =
679 += Add-AESBRoutingToAlias =
640 640  
641 -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.
642 642  
643 643  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
644 -|-Alias|string|❌|A|Der Name des Alias, von dem das Routing-Paar entfernt werden soll.
645 -|-ConnectionName|string|✅|C|Der Name der Verbindung, die verwendet wird.
646 -|-RoutingKey|string|❌|RK|Der Routing Key, der aus dem Alias entfernt werden soll.
647 -|-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.
648 648  
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 +
649 649  === **Beispiele** ===
650 650  
651 -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
652 652  
653 653  {{code language="powershell"}}
654 -Remove-AESBRoutingFromAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
719 +Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"
655 655  
656 656  {{/code}}
657 657  
658 -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
659 659  
660 660  {{code language="powershell"}}
661 -Remove-AESBRoutingFromAlias -Alias "MyAlias" -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
726 +Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
662 662  
663 663  {{/code}}
664 664  
665 -= Remove-AESBRoutingKey =
730 += Add-AESBVirtualRouter =
666 666  
667 -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.
668 668  
669 669  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
670 -|-ConnectionName|string|✅|C|Der Name der Verbindung, die verwendet werden soll.
671 -|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, von dem der Routing Key entfernt werden soll.
672 -|-TargetName|string|❌|TName|Der Name des Ziels, von dem der Routing Key entfernt werden soll.
673 -|-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.
674 674  
675 675  === **Beispiele** ===
676 676  
677 -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
678 678  
679 679  {{code language="powershell"}}
680 -Remove-AESBRoutingKey -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey"
743 +Add-AESBVirtualRouter -VirtualRouter "MyRouter"
681 681  
682 682  {{/code}}
683 683  
684 -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"
685 685  
686 686  {{code language="powershell"}}
687 -Remove-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey"
750 +Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
688 688  
689 689  {{/code}}
690 690  
691 -= Remove-AESBTarget =
754 += ConvertFrom-AESBBase64 =
692 692  
693 -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.
694 694  
695 695  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
696 -|-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB.
697 -|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, von dem das Ziel entfernt werden soll.
698 -|-TargetName|string|❌|TName|Der Name des Ziels, das entfernt werden soll.
759 +|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
699 699  
700 700  === **Beispiele** ===
701 701  
702 -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!"
703 703  
704 704  {{code language="powershell"}}
705 -Remove-AESBTarget -VirtualRouter "MyRouter" -TargetName "MyTarget"
766 +ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
767 +
706 706  {{/code}}
707 707  
708 -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"
709 709  
710 710  {{code language="powershell"}}
711 -Remove-AESBTarget -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
773 +$base64String = "U29tZSBiYXNlNjQgdGV4dA=="
774 +ConvertFrom-AESBBase64 -Input $base64String
712 712  {{/code}}
713 713  
714 -= Remove-AESBVirtualRouter =
777 += ConvertFrom-AESBBase64ToFile =
715 715  
716 -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.
717 717  
718 718  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
719 -|ConnectionName|string|✅|C|Gibt den Namen der Verbindung an.
720 -|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.
721 721  
722 722  === **Beispiele** ===
723 723  
724 -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
725 725  
726 726  {{code language="powershell"}}
727 -Remove-AESBVirtualRouter -VirtualRouter "MyRouter"
791 +ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
728 728  
729 729  {{/code}}
730 730  
731 -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
732 732  
733 733  {{code language="powershell"}}
734 -Remove-AESBVirtualRouter -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
798 +ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
735 735  {{/code}}
736 736  
737 -= Set-AESBBSelfAsAlias =
801 += ConvertFrom-AESBIcql =
738 738  
739 -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.
740 740  
741 -{{aagon.warnungsbox}}
742 -Die Parameter RemoveExistingAlias und AddToExistingAlias dürfen nicht gleichzeitig verwendet werden!
743 -{{/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.
744 744  
745 -**Parameter**
808 +=== **Beispiele** ===
746 746  
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 +
747 747  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
748 -|-Alias|string|❌| |Gibt den Namen vom Alias an
749 -|-RemoveExistingAlias|bool|✅| |Der bestehende Alias wird ersetzt.
750 -|-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.
751 751  
752 752  === **Beispiele** ===
753 753  
754 -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
755 755  
756 756  {{code language="powershell"}}
757 -Set-AESBSelfAsAlias -Alias "AliasName" -RemoveExistingAlias $true
861 +ConvertTo-AESBBase64 -Input "Hello World!"
862 +ConvertFrom-AESBIcql -Icql $icqlString
863 +{{/code}}
758 758  
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
759 759  {{/code}}
760 760  
761 -Beispiel 2: Hinzufügen der Virtual Router und Routing Keys vom Alias „AliasName“ zum angegebenen Alias "SelfAliasTest".
873 += ConvertTo-AESBBase64FromFile =
762 762  
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 +
763 763  {{code language="powershell"}}
764 -Set-AESBSelfAsAlias -Alias "AliasName" -AddToExistingAlias "SelfAliasTest"
885 +ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
886 +
765 765  {{/code}}
766 766  
767 -= 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
768 768  
769 -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}}
770 770  
771 -**Parameter**
897 += ConvertTo-AESBIcql =
772 772  
899 +Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
900 +
773 773  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
774 -|-ConnectionName|string|✅|C|Der Name der Verbindung, die für das Abrufen der Routing-Tabelle verwendet wird.
775 -|-ExchangeType|ExchangeTypes|✅|ET|Der Typ des Exchanges, der angezeigt werden soll. Mögliche Werte sind DIRECT oder ROUTING.
776 -|-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.
777 777  
778 778  === **Beispiele** ===
779 779  
780 -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.
781 781  
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 +
782 782  {{code language="powershell"}}
783 -Show-AESBRoutingTable -VirtualRouter "MyRouter"
952 +Get-AESBActivityLogItemById -Id "ItemID"
784 784  
785 785  {{/code}}
786 786  
787 -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 =
788 788  
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 +
789 789  {{code language="powershell"}}
790 -Show-AESBRoutingTable -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -ExchangeType DIRECT
968 +Get-AESBAliasList
791 791  
792 792  {{/code}}
793 793  
794 -= Write-AESBActivityLog =
972 +Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
795 795  
796 -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"
797 797  
977 +{{/code}}
798 798  
799 -**Parameter**
979 += Get-AESBVirtualRouters =
800 800  
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 +
801 801  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
802 -|-ConnectionName|string|✅|C|Der Name der Verbindung, die für die Kommunikation verwendet wird.
803 -|-Id|string|✅|None|Die ID des Log-Eintrags, der aktualisiert werden soll. Wird ein neuer Eintrag erstellt, kann dieser Parameter weggelassen werden.
804 -|-Name|string|❌|N|Der Name des Log-Eintrags.
805 -|-Description|string|❌|D|Die Beschreibung des Log-Eintrags.
806 -|-Status|JobFeedbackResultCode|❌|ST|Der Status des Logs, z.B. "Warning", "Created", "Started", "Running", "Stopping", "Stopped", "Failed" oder "Finished".
807 -|-ComponentName|string|✅|ComName|Der Name der Komponente, die den Log-Eintrag erstellt hat.
997 +|-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder.
808 808  
809 809  === **Beispiele** ===
810 810  
811 -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"
812 812  
813 813  {{code language="powershell"}}
814 -Write-AESBActivityLog -Name "ProcessStart" -Description "Der Prozess wurde gestartet." -Status Started
1004 +Get-AESBAlias -Alias "AliasName"
1005 +
815 815  {{/code}}
816 816  
817 -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 =
818 818  
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 +
819 819  {{code language="powershell"}}
820 -Write-AESBActivityLog -Id "12345" -Name "ProcessUpdate" -Description "Der Prozessstatus wurde aktualisiert." -Status Running
1032 +Get-AESBAliasList -ConnectionName "MyConnection"
821 821  
822 822  {{/code}}
823 823  
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 +
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.
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 +
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 +
824 824  = Write-AESBBusinessLog =
© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community