Changes for page Operative Cmdlets
Last modified by jklein on 2025/01/10 07:49
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -330,6 +330,8 @@ 330 330 331 331 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 332 332 |-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll. 333 +|-Sequence|string|✅| |Setzt die Sequence einer ICQL Message 334 +|-Action|string|✅| |Setzt die Action einer ICQL Message 333 333 334 334 === **Beispiele** === 335 335 ... ... @@ -350,26 +350,9 @@ 350 350 $icqlString 351 351 {{/code}} 352 352 353 -Beispiel 2: Konvertiert das PSCustomObject, das in der Variable $exampleObject gespeichert ist, in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge in der Variable $icqlString zurück. 354 - 355 -{{code language="powershell" layout="LINENUMBERS"}} 356 -# Erstellen eines PSCustomObject mit Beispieldaten 357 -$exampleObject = [PSCustomObject]@{ 358 - TargetName = "MyTarget" 359 - TargetType = "Queue" 360 - RoutingKey = "MyRoutingKey" 361 - VirtualRouter = "MyRouter" 362 - ConnectionName = "MyConnection" 363 -} 364 - 365 -# Konvertieren des Objekts in eine Icql-Zeichenfolge 366 -$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject 367 -$icqlString 368 -{{/code}} 369 - 370 370 = Get-AESBActivityLogItemById = 371 371 372 -Gibt den ActivityLog-Eintrag anhand einer ID zurück. 357 +Gibt den Activity Log-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 VirtualRouter zurück. 396 +Gibt eine Liste aller Virtual Router zurück. 412 412 413 413 === **Beispiele** === 414 414 415 -Beispiel 1: Abrufen einer Liste aller VirtualRouter 400 +Beispiel 1: Abrufen einer Liste aller Virtual Router 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 VirtualRouters, unter dem das Target läuft. 458 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, 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 VirtualRouter "MyRouter" 462 +Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual Router "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 VirtualRouter "MyRouter" und der Verbindung "MyConnection" 468 +Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual Router "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 VirtualRouter "MyRouter" 485 +Beispiel 1: Abrufen der Liste aller Targets unter dem Virtual Router "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 VirtualRouter "MyRouter" und die Verbindung "MyConnection" 492 +Beispiel 2: Abrufen der Liste aller Targets für den Virtual Router "MyRouter" und die Verbindung "MyConnection" 508 508 509 509 {{code language="powershell"}} 510 510 Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter" ... ... @@ -523,6 +523,7 @@ 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 511 +=== Parameter-Sets === 526 526 527 527 Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können: 528 528 ... ... @@ -535,7 +535,7 @@ 535 535 536 536 === **Beispiele** === 537 537 538 -Beispiel 1: Senden der 524 +Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" 539 539 540 540 {{code language="powershell"}} 541 541 Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message" ... ... @@ -542,7 +542,7 @@ 542 542 543 543 {{/code}} 544 544 545 -Beispiel 2: Senden der 531 +Beispiel 2: Senden der Nachricht "This is a test message" über den Virtual Router "MyRouter" mit dem Routing Key "MyRoutingKey" 546 546 547 547 {{code language="powershell"}} 548 548 Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" ... ... @@ -549,7 +549,7 @@ 549 549 550 550 {{/code}} 551 551 552 - (% id="cke_bm_333933S" style="display:none" %) (%%)Beispiel 3: Konvertieren eines PowerShell-Objektsin das ICQL-Format und senden desObjektsan den Alias "MyAlias".538 +Beispiel 3: Konvertieren eines PSCustomObject in das ICQL-Format und senden der Nachricht an den Alias "MyAlias" 553 553 554 554 {{code language="powershell"}} 555 555 ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias" ... ... @@ -558,629 +558,297 @@ 558 558 559 559 = Publish-AESBMessageAndAwait = 560 560 561 - Sendet eine Nachricht an ein bestimmtes Target oder einen Alias im AESBund wartetauf eine Bestätigung oder Antwort innerhalb des angegebenen Zeitlimits.547 +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. 562 562 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 RoutingKey, der für das Routing der Nachricht verwendet wird. 554 +|-RoutingKey|string|❌|RK|Der Routing Key, 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 VirtualRouters, über den die Nachricht veröffentlicht werden soll. 556 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, ü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 - 585 585 === **Beispiele** === 586 586 587 -Beispiel 1: Hinzufügen des Alias "MyAlias"fürdieStandardverbindung560 +Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung 588 588 589 589 {{code language="powershell"}} 590 -Add-AESBAlias -Alias "MyAlias" 591 -{{/code}} 563 +Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m" 592 592 593 -Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection" 594 - 595 -{{code language="powershell"}} 596 -Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection" 597 - 598 598 {{/code}} 599 599 600 - =Add-AESBCallbackTarget=567 +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. 601 601 602 -Mtit diesem Cmdlet wird ein neues Callback-Target zur SICS-Verbindung hinzugefügt. Das Callback-Target wird für den Empfang von Nachrichten verwendet und erfordert eine Routing-Key-Konfiguration sowie einen Virtual Router. 603 - 604 -(% style="width:1073px" %) 605 -|=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Optional|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung 606 -|(% style="width:166px" %)-ConnectionName|(% style="width:127px" %)String|(% style="width:90px" %)✅|(% style="width:74px" %)Keine|(% style="width:614px" %)Der Name der SICS-Verbindung, zu der das Callback-Target hinzugefügt wird. Wenn dieser Parameter nicht angegeben ist, wird das Callback-Target zur Standardverbindung hinzugefügt. 607 -|(% style="width:166px" %)-VirtualRouter|(% style="width:127px" %)String|(% style="width:90px" %)❌|(% style="width:74px" %)Keine|(% style="width:614px" %)Der Name des Virtual Routers, dem das Callback-Target zugeordnet werden soll. 608 -|(% style="width:166px" %)-TargetName|(% style="width:127px" %)String|(% style="width:90px" %)❌|(% style="width:74px" %)Keine|(% style="width:614px" %)Der Name des Callback-Targets, das hinzugefügt werden soll. 609 -|(% style="width:166px" %)-RoutingKey|(% style="width:127px" %)String|(% style="width:90px" %)❌|(% style="width:74px" %)Keine|(% style="width:614px" %)Der Routing-Key, der verwendet wird, um Nachrichten an das Callback-Target zu routen. 610 - 611 -=== (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** === 612 - 613 -Beispiel 1: Hinzufügen eines Callback-Targets "CallbackTarget1" zur Standardverbindung. Dabei wird das Callback-Target über den Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet 614 - 615 615 {{code language="powershell"}} 616 - Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey"Key1"570 +Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h" 617 617 618 618 {{/code}} 619 619 620 - Beispiel2: Hinzufügeneines Callback-Targets "CallbackTarget1" zur SICS-Verbindung "MyConnection". Dabei wird dasCallback-Targetüber den Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet574 += Receive-AESBTargetMessages = 621 621 622 -{{code language="powershell"}} 623 -Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1" 576 +Mit diesem Cmdlet können Sie Nachrichten von einem Ziel im AESB empfangen. 624 624 625 -{{/code}} 626 - 627 -= Add-AESBQueueTarget = 628 - 629 -Dieses Cmdlet fügt ein neues Target zu einer SICS-Verbindung hinzu. Innerhalb dieses Targets ist eine Queue enthalten, in der Nachrichten weiterverarbeitet werden, die an das Target gesendet werden. Daher handelt es sich bei diesem Cmdlet um eine spezifische Form eines [[AESB-Targets.>>doc:||anchor="HAdd-AESBTarget"]] 630 - 631 631 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 632 -| (% style="width:199px" %)-ConnectionName|(%style="width:160px" %)String|(% style="width:119px" %)✅|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name derSICS-Verbindung,zuder das Queue-Target hinzugefügt wird. Wenn dieser Parameternicht angegeben ist, wird das Queue-Target zurStandardverbindung 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, demdas Queue-Targetzugeordnetwird.634 -| (% style="width:199px" %)-TargetName|(%style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name desQueue-Targets, dashinzugefügtwerdensoll.635 -| (% style="width:199px" %)-RoutingKey|(%style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px"%)Keine|(%style="width:827px"%)DerRouting-Key, der verwendet wird, um Nachrichten an das Queue-Targets zu senden.579 +|-ConnectionName|//string//|✅|C|Der Name der Verbindung zum AESB. 580 +|-MessageCount|//int//|✅|MC|Die Anzahl der Nachrichten, die empfangen werden sollen. 581 +|-TargetName|//string//|❌|TName|Der Name des Ziels, von dem die Nachrichten empfangen werden. 582 +|-VirtualRouter|//string//|❌|VR|Der Name des Virtual Routers, der für das Ziel verwendet wird. 636 636 637 637 === **Beispiele** === 638 638 639 -Beispiel 1: Hinzufügeneines Queue-Targets "QueueTarget1" zur Standardverbindung.DabeiwirddasQueue-Targetüberden Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet586 +Beispiel 1: Empfangen von Nachrichten vom Ziel mit dem Namen "MyTarget", das dem Virtual Router "MyRouter" zugeordnet ist 640 640 641 641 {{code language="powershell"}} 642 - Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1"-RoutingKey "Key1"589 +Receive-AESBTargetMessages -VirtualRouter "MyRouter" -TargetName "MyTarget" 643 643 644 644 {{/code}} 645 645 646 -Beispiel 2: HinzufügeneinesQueue-Targets"QueueTarget1"zurSICS-Verbindung "MyConnection".DabeiwirddasQueue-Targetüberden Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet593 +Beispiel 2: Empfangen von bis zu 10 Nachrichten vom Ziel mit dem Namen "MyTarget", das dem Virtual Router "MyRouter" zugeordnet ist 647 647 648 648 {{code language="powershell"}} 649 - Add-AESBQueueTarget-ConnectionName"MyConnection"-VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey"Key1"596 +Receive-AESBTargetMessages -VirtualRouter "MyRouter" -TargetName "MyTarget" -MessageCount 10 650 650 651 651 {{/code}} 652 652 653 -= Add-AESBRoutingKey=600 += Remove-AESBAlias = 654 654 655 - DiesesCmdletwird verwendet,um Routing-Informationenfürein[[AESB-Target>>doc:||anchor="HAdd-AESBTarget"]]zukonfigurieren. Dabei wirdinRoutingKey zueinem Targetineinem VirtualRouter hinzugefügt.602 +Mit diesem Cmdlet können Sie einen Alias aus dem AESB entfernen. 656 656 657 657 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 658 -|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll. 659 -|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, zu dem der Routing Key gehört. 660 -|-TargetName|string|❌|TName|Der Name des Targets, für das der Routing Key hinzugefügt wird. 661 -|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der hinzugefügt werden soll. 605 +|-Alias|string|❌|A|Der Name des zu entfernenden Alias. 606 +|-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB. 662 662 663 663 === **Beispiele** === 664 664 665 -Beispiel 1: Hinzufügen des Routing Keys "Key1"für dieStandardverbindung. Dabei wird angegeben,dass der RoutingKey für dasTarget"MyTarget".hinzugefügtwirdund zumVirtual Router "Router1" gehört610 +Beispiel 1: Entfernen vom Alias "MyAlias" aus dem AESB 666 666 667 667 {{code language="powershell"}} 668 - Add-AESBQueueTarget-VirtualRouter"Router1" -TargetName"QueueTarget1" -RoutingKey "Key1"613 +Remove-AESBAlias -Alias "MyAlias" 669 669 670 670 {{/code}} 671 671 672 -Beispiel 2: HinzufügendesRoutingKeys "AnotherKey"fürdie SICS-Verbindung"MyConnection". Dabeiwirdangegeben, dass derRouting Key fürdas Target "AnotherTarget". hinzugefügt wirdd zum Virtual Router "AnotherRouter"gehört617 +Beispiel 2: Entfernen vom Alias "MyAlias" aus dem AESB über die angegebene Verbindung 673 673 674 674 {{code language="powershell"}} 675 - Add-AESBRoutingKey-ConnectionName "MyConnection" -VirtualRouter"AnotherRouter" -TargetName"AnotherTarget" -RoutingKey "AnotherKey"620 +Remove-AESBAlias -ConnectionName "MyConnection" -Alias "MyAlias" 676 676 677 677 {{/code}} 678 678 679 -= Add-AESBRoutingToAlias =624 += Remove-AESBRoutingFromAlias = 680 680 681 - DiesesCmdletwird verwendet, um Routing-Informationenfür den AESB zu konfigurieren,indem ein Routing-Paarmit einem Alias verknüpft wird. Das Routing-PaarbestehtauseinemVirtual Router undeinemRouting Key,diezueinemhinzugefügt werden.626 +Mit diesem Cmdlet können Sie ein Routing-Paar (bestehend aus Virtual Router und Routing Key) von einem Alias im QNS entfernen. Das Routing-Paar wird vollständig gelöscht. 682 682 683 683 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 684 -|-Alias|string|❌|A|Der zudem das Routing-Paarim QNS hinzugefügt werden soll.685 -|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung,fürdiedas Routing-Paarhinzugefügt werden soll.686 -|-RoutingKey|string|❌|RK|Der Name desRouting Keys, derzusammenmitdemVirtualRouterhinzugefügt werden soll.687 -|-VirtualRouter|string|❌|VR|Der Name desVirtual Router, der zusammen mit demhinzugefügt werden soll.629 +|-Alias|string|❌|A|Der Name des Alias, von dem das Routing-Paar entfernt werden soll. 630 +|-ConnectionName|string|✅|C|Der Name der Verbindung, die verwendet wird. 631 +|-RoutingKey|string|❌|RK|Der Routing Key, der aus dem Alias entfernt werden soll. 632 +|-VirtualRouter|string|❌|VR|Der Virtual Router, der zusammen mit dem Routing Key entfernt werden soll. 688 688 689 -=== (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** === 690 - 691 -Beispiel 1: Hinzufügen des Routing-Paars zum Alias "MyAlias" für die Standardverbindung. Dabei werden der Routing Key "MyKey" und der Virtual Router "MyRouter" als Routing-Paar verknüpft. 692 - 693 -{{code language="powershell"}} 694 -Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection" 695 -{{/code}} 696 - 697 -Beispiel 2: Hinzufügen des Routing-Paars zum Alias "AnotherAlias" für die SICS-Verbindung "MyConnection". Dabei werden der Routing Key "AnotherKey" und der Virtual Router "AnotherRouter" als Routing-Paar verknüpft. 698 - 699 -{{code language="powershell"}} 700 -Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection" 701 -{{/code}} 702 - 703 -= Add-AESBTarget = 704 - 705 -Dieses Cmdlet wird verwendet, um ein neues Target für eine SICS-Verbindung in einem Virtual Router hinzuzufügen. Dabei wird ein Target Type und Target Name mit einem Routing Key verknüpft. 706 - 707 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 708 -|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll. 709 -|-RoutingKey|string|❌|RK|Der Routing Key, der dem Target zugewiesen wird. 710 -|-TargetName|string|❌|TName|Der Name des Targets, das hinzugefügt werden soll. 711 -|-TargetType|string|❌|TType|Der Typ des Targets, das hinzugefügt werden soll. 712 -|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird. 713 - 714 714 === **Beispiele** === 715 715 716 -Beispiel 1: HinzufügeninesQueue-Targets "MyTarget" für die Standardverbindung. Das Targetwird demhinzugefügt undihm wird derRouting Keyzugewiesen636 +Beispiel 1: Entfernen vom Routing-Paar mit Virtual Router "MyRouter" und Routing Key "MyRoutingKey" vom Alias "MyAlias" 717 717 718 718 {{code language="powershell"}} 719 - Add-AESBTarget -VirtualRouter "MyRouter" -TargetType"Queue" -TargetName "MyTarget" -RoutingKeyMyKey"639 +Remove-AESBRoutingFromAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" 720 720 721 721 {{/code}} 722 722 723 -Beispiel 2: Hinzufügen eines Queue-Targets "MyTarget"für dieSICS-Verbindung"MyConnection". Das Targetwird demhinzugefügt undihm wird derRouting Keyzugewiesen643 +Beispiel 2: Entfernen vom Routing-Paar mit Virtual Router "MyRouter" und Routing Key "MyRoutingKey" vom Alias "MyAlias" unter Verwendung der Verbindung "MyConnection" 724 724 725 725 {{code language="powershell"}} 726 - Add-AESBTarget -VirtualRouter "AnotherRouter"-TargetType"Queue" -TargetName "AnotherTarget" -RoutingKey"AnotherKey" -ConnectionName "MyConnection"646 +Remove-AESBRoutingFromAlias -Alias "MyAlias" -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" 727 727 728 728 {{/code}} 729 729 730 -= Add-AESBVirtualRouter=650 += Remove-AESBRoutingKey = 731 731 732 - DiesesCmdletwirdverwendet,umeinen neuenhalbder angegebenenSICS-Verbindungzukonfigurieren.652 +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. 733 733 734 734 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 735 -|-ConnectionName|string|✅|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll. 736 -|-VirtualRouter|string|❌|VR|Der Name des VirtualRouter, der hinzugefügt werden soll. 655 +|-ConnectionName|string|✅|C|Der Name der Verbindung, die verwendet werden soll. 656 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, von dem der Routing Key entfernt werden soll. 657 +|-TargetName|string|❌|TName|Der Name des Ziels, von dem der Routing Key entfernt werden soll. 658 +|-RoutingKey|string|❌|RK|Der Routing Key, der entfernt werden soll. 737 737 738 738 === **Beispiele** === 739 739 740 -Beispiel 1: Hinzufügen einesVirtual Routers"MyRouter"in der Standardverbindung662 +Beispiel 1: Entfernen vom Routing Key "MyRoutingKey" vom Ziel "MyTarget" im Virtual Router "MyRouter" 741 741 742 742 {{code language="powershell"}} 743 - Add-AESBVirtualRouter -VirtualRouter"MyRouter"665 +Remove-AESBRoutingKey -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey" 744 744 745 745 {{/code}} 746 746 747 -Beispiel 2: Hinzufügen einesVirtual Routers"AnotherRouter"in derSICS-Verbindung "MyConnection"669 +Beispiel 2: Entfernen vom Routing Key "MyRoutingKey" vom Ziel "MyTarget" im Virtual Router "MyRouter" unter Verwendung der Verbindung "MyConnection" 748 748 749 749 {{code language="powershell"}} 750 - Add-AESBVirtualRouter-VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"672 +Remove-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey" 751 751 752 752 {{/code}} 753 753 754 -= ConvertFrom-AESBBase64=676 += Remove-AESBTarget = 755 755 756 - DiesesCmdletwird verwendet,um eineBase64-kodierteZeichenfolgezurückin ihreunkodierteFormzudekodieren.678 +Mit diesem Cmdlet können Sie ein Ziel aus dem Virtual Router des AESB entfernen. 757 757 758 758 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 759 -|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll. 681 +|-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB. 682 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, von dem das Ziel entfernt werden soll. 683 +|-TargetName|string|❌|TName|Der Name des Ziels, das entfernt werden soll. 760 760 761 761 === **Beispiele** === 762 762 763 -Beispiel 1: DekodiereninerBase64-kodiertenZeichenfolge. Zurückgegebenwird derursprünglicheText "HelloWorld!"687 +Beispiel 1: Entfernen vom Ziel "MyTarget" vom Virtual Router "MyRouter" 764 764 765 765 {{code language="powershell"}} 766 -ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh" 767 - 690 +Remove-AESBTarget -VirtualRouter "MyRouter" -TargetName "MyTarget" 768 768 {{/code}} 769 769 770 -Beispiel 2: DekodiereninerBase64-Zeichenfolgeaus der Variable$base64string. Zurückgegebenwird derursprünglicheText"Somebase64text"693 +Beispiel 2: Entfernen vom Ziel "MyTarget" vom Virtual Router "MyRouter" unter Verwendung der Verbindung "MyConnection" 771 771 772 772 {{code language="powershell"}} 773 -$base64String = "U29tZSBiYXNlNjQgdGV4dA==" 774 -ConvertFrom-AESBBase64 -Input $base64String 696 +Remove-AESBTarget -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" 775 775 {{/code}} 776 776 777 -= ConvertFrom-AESBBase64ToFile =699 += Remove-AESBVirtualRouter = 778 778 779 - DiesesCmdletwird verwendet,umeineBase64-kodierteZeichenfolgezudekodierenund ineiner Datei zu speichern.701 +Mit diesem Cmdlet können Sie einen angegebenen Virtual Router entfernen. 780 780 781 781 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 782 -|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll. 783 -|-OutputPath|string|❌|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen. 784 -|-Force|switch|✅|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert. 704 +|ConnectionName|string|✅|C|Gibt den Namen der Verbindung an. 705 +|VirtualRouter|string|❌|VR|Gibt den Namen des zu entfernenden Virtual Router an. 785 785 786 786 === **Beispiele** === 787 787 788 -Beispiel 1: DekodiereninerBase64-ZeichenfolgeundSpeichernvomursprünglichen Text"HelloWorld!"inderDatei"output.txt" im angegebenen Pfad709 +Beispiel 1: Entfernen vom Virtual Router mit dem Namen "MyRouter" 789 789 790 790 {{code language="powershell"}} 791 - ConvertFrom-AESBBase64ToFile -Input"SGVsbG8gV29ybGQh"-OutputPath"C:\path\to\output.txt"712 +Remove-AESBVirtualRouter -VirtualRouter "MyRouter" 792 792 793 793 {{/code}} 794 794 795 -Beispiel 2: DekodiereninerBase64-ZeichenfolgeundSpeichernvomursprünglichen Text"Some base64text"inderDatei"output.txt"im angegebenenPfad. Da dieDatei bereits vorhandenist, wird sieüberschrieben716 +Beispiel 2: Entfernen vom Virtual Router mit dem Namen "MyRouter" unter der Verbindung "MyConnection" 796 796 797 797 {{code language="powershell"}} 798 - ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath"C:\path\to\output.txt" -Force719 +Remove-AESBVirtualRouter -ConnectionName "MyConnection" -VirtualRouter "MyRouter" 799 799 {{/code}} 800 800 801 -= ConvertFrom-AESBIcql =722 += Set-AESBBSelfAsAlias = 802 802 803 - DiesesCmdlet wird verwendet, um eineAESBIcql-Zeichenfolgezurückin einPowerShell-Objektzudekodieren.724 +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. 804 804 805 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 806 -|-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll. 726 +{{aagon.warnungsbox}} 727 +Die Parameter RemoveExistingAlias und AddToExistingAlias dürfen nicht gleichzeitig verwendet werden! 728 +{{/aagon.warnungsbox}} 807 807 808 - ===**Beispiele**===730 +**Parameter** 809 809 810 -Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString 811 - 812 -{{code language="powershell"}} 813 -$icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>" 814 -ConvertFrom-AESBIcql -Icql $icqlString 815 -{{/code}} 816 - 817 -Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben: 818 - 819 -{{code language="none" layout="LINENUMBERS"}} 820 -TargetName : MyTarget 821 -TargetType : Queue 822 -RoutingKey : MyRoutingKey 823 -VirtualRouter : MyRouter 824 -ConnectionName : MyConnection 825 -{{/code}} 826 - 827 -Beispiel 2: Kodieren eines PSCustomObjects in eine Icql-Zeichenfolge und anschließendes dekodieren zurück in ein PSCustomObject. Die resultierenden Daten entsprechen den ursprünglichen Eingabewerten 828 - 829 -{{code language="powershell" layout="LINENUMBERS"}} 830 -# Erstellen eines PSCustomObject mit Beispieldaten 831 -$exampleObject = [PSCustomObject]@{ 832 - TargetName = "MyTarget" 833 - TargetType = "Queue" 834 - RoutingKey = "MyRoutingKey" 835 - VirtualRouter = "MyRouter" 836 - ConnectionName = "MyConnection" 837 -} 838 - 839 -# Konvertieren des Objekts in eine Icql-Zeichenfolge 840 -$x = ConvertTo-AESBIcql -InputObject $exampleObject 841 - 842 -# Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject 843 -$decodedObject = ConvertFrom-AESBIcql -Icql $x 844 - 845 -# Anzeigen des dekodierten Objekts 846 -$decodedObjectConvertFrom-AESBIcql -Icql $icqlString 847 -{{/code}} 848 - 849 -= ConvertTo-AESBBase64 = 850 - 851 -Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren. 852 - 853 853 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 854 -|-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll. 733 +|-Alias|string|❌| |Gibt den Namen vom Alias an 734 +|-RemoveExistingAlias|bool|✅| |Der bestehende Alias wird ersetzt. 735 +|-AddToExistingAlias|bool|✅| |Der Virtual Router und Routing Key wird zu dem angegebenen Alias hinzugefügt 855 855 856 856 === **Beispiele** === 857 857 858 -Beispiel 1: KodierenderZeichenfolge////"HelloWorld!"// //in Base64.ZurückgegebenwirddieBase64-kodierteVersion739 +Beispiel 1: Überschreiben vom existierenden Alias „AliasName“. Wenn z.B. der vorherige Alias mehrere Virtual Router und Routing Keys hatte, werden diese gelöscht 859 859 860 860 {{code language="powershell"}} 861 -ConvertTo-AESBBase64 -Input "Hello World!" 862 -ConvertFrom-AESBIcql -Icql $icqlString 863 -{{/code}} 742 +Set-AESBSelfAsAlias -Alias "AliasName" -RemoveExistingAlias $true 864 864 865 -Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String 866 - 867 -{{code language="powershell"}} 868 -$string = "Base64 encoding example" 869 -$base64String = ConvertTo-AESBBase64 -Input $string 870 -$base64StringConvertFrom-AESBIcql -Icql $icqlString 871 871 {{/code}} 872 872 873 - =ConvertTo-AESBBase64FromFile=746 +Beispiel 2: Hinzufügen der Virtual Router und Routing Keys vom Alias „AliasName“ zum angegebenen Alias "SelfAliasTest". 874 874 875 -Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren. 876 - 877 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 878 -|-InputPath|string|❌|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll. 879 - 880 -=== **Beispiele** === 881 - 882 -Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge 883 - 884 884 {{code language="powershell"}} 885 -ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt" 886 - 749 +Set-AESBSelfAsAlias -Alias "AliasName" -AddToExistingAlias "SelfAliasTest" 887 887 {{/code}} 888 888 889 - Beispiel2: Kodieren des Inhalts der Datei, deren Pfad in der Variable $filePath gespeichert ist, in Base64. Zurückgegebenwird die Base64-kodierte Zeichenfolge in der Variable$base64String752 += Show-AESBRoutingTable = 890 890 891 -{{code language="powershell"}} 892 -$filePath = "C:\path\to\anotherfile.txt" 893 -$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath 894 -$base64String 895 -{{/code}} 754 +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. 896 896 897 - = ConvertTo-AESBIcql =756 +**Parameter** 898 898 899 -Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird. 900 - 901 901 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 902 -|-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll. 759 +|-ConnectionName|string|✅|C|Der Name der Verbindung, die für das Abrufen der Routing-Tabelle verwendet wird. 760 +|-ExchangeType|ExchangeTypes|✅|ET|Der Typ des Exchanges, der angezeigt werden soll. Mögliche Werte sind DIRECT oder ROUTING. 761 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, für den die Routing-Tabelle angezeigt wird. 903 903 904 904 === **Beispiele** === 905 905 906 -Beispiel 1: Konvertiertdas PSCustomObjectineine AESB Icql-Zeichenfolgeundgibtdie resultierendeIcql-Zeichenfolge zurück.765 +Beispiel 1: Anzeigen der Routing-Tabelle für den Virtual Router „MyRouter“ 907 907 908 -{{code language="powershell" layout="LINENUMBERS"}} 909 -# Erstellen eines PSCustomObject mit Beispieldaten 910 -$exampleObject = [PSCustomObject]@{ 911 - TargetName = "MyTarget" 912 - TargetType = "Queue" 913 - RoutingKey = "MyRoutingKey" 914 - VirtualRouter = "MyRouter" 915 - ConnectionName = "MyConnection" 916 -} 917 - 918 -# Konvertieren des Objekts in eine Icql-Zeichenfolge 919 -$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject 920 -$icqlString 921 -{{/code}} 922 - 923 -Beispiel 2: Konvertiert das PSCustomObject, das in der Variable $exampleObject gespeichert ist, in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge in der Variable $icqlString zurück. 924 - 925 -{{code language="powershell" layout="LINENUMBERS"}} 926 -# Erstellen eines PSCustomObject mit Beispieldaten 927 -$exampleObject = [PSCustomObject]@{ 928 - TargetName = "MyTarget" 929 - TargetType = "Queue" 930 - RoutingKey = "MyRoutingKey" 931 - VirtualRouter = "MyRouter" 932 - ConnectionName = "MyConnection" 933 -} 934 - 935 -# Konvertieren des Objekts in eine Icql-Zeichenfolge 936 -$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject 937 -$icqlString 938 -{{/code}} 939 - 940 -= Get-AESBActivityLogItemById = 941 - 942 -Gibt den ActivityLog-Eintrag anhand einer ID zurück. 943 - 944 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 945 -|-Id|string|❌| |Die ID des Logeintrags 946 - 947 -=== **Beispiele** === 948 - 949 -Beispiel 1: Abruf eines Log-Eintrags anhand einer ID 950 - 951 951 {{code language="powershell"}} 952 - Get-AESBActivityLogItemById-Id"ItemID"768 +Show-AESBRoutingTable -VirtualRouter "MyRouter" 953 953 954 954 {{/code}} 955 955 956 - =Get-AESBAliasList=772 +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. 957 957 958 -Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten. 959 - 960 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 961 -|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll. 962 - 963 -=== **Beispiele** === 964 - 965 -Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung 966 - 967 967 {{code language="powershell"}} 968 - Get-AESBAliasList775 +Show-AESBRoutingTable -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -ExchangeType DIRECT 969 969 970 970 {{/code}} 971 971 972 - Beispiel2: Abrufen einer ListeallerAliase im AESBfür die angegebene Verbindung "MyConnection"779 += Write-AESBActivityLog = 973 973 974 -{{code language="powershell"}} 975 -Get-AESBAliasList -ConnectionName "MyConnection" 781 +Mit diesem Cmdlet wird ein Eintrag in das ActivityLog des AESB geschrieben. Wenn keine ID angegeben wird, wird ein neuer Log-Eintrag erstellt. Falls eine ID angegeben wird, wird der vorhandene Log-Eintrag mit dieser ID aktualisiert. 976 976 977 - {{/code}}783 +**Parameter** 978 978 979 -= Get-AESBVirtualRouters = 980 - 981 -Gibt eine Liste aller VirtualRouter zurück. 982 - 983 -=== **Beispiele** === 984 - 985 -Beispiel 1: Abrufen einer Liste aller VirtualRouter 986 - 987 -{{code language="powershell"}} 988 -Get-AESBVirtualRouters 989 - 990 -{{/code}} 991 - 992 -= Get-AESBAlias = 993 - 994 -Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder. 995 - 996 996 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 997 -|-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder. 786 +|-ConnectionName|string|✅|C|Der Name der Verbindung, die für die Kommunikation verwendet wird. 787 +|-Id|string|✅|None|Die ID des Log-Eintrags, der aktualisiert werden soll. Wird ein neuer Eintrag erstellt, kann dieser Parameter weggelassen werden. 788 +|-Name|string|❌|N|Der Name des Log-Eintrags. 789 +|-Description|string|❌|D|Die Beschreibung des Log-Eintrags. 790 +|-Status|JobFeedbackResultCode|❌|ST|Der Status des Logs, z.B. "Warning", "Created", "Started", "Running", "Stopping", "Stopped", "Failed" oder "Finished". 791 +|-ComponentName|string|✅|ComName|Der Name der Komponente, die den Log-Eintrag erstellt hat. 998 998 999 999 === **Beispiele** === 1000 1000 1001 -Beispiel 1: AbrufenderInformationen zurVerbindungmit demAlias"AliasName"795 +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. 1002 1002 1003 1003 {{code language="powershell"}} 1004 -Get-AESBAlias -Alias "AliasName" 1005 - 798 +Write-AESBActivityLog -Name "ProcessStart" -Description "Der Prozess wurde gestartet." -Status Started 1006 1006 {{/code}} 1007 1007 1008 - = Get-AESBConnectionInfo=801 +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. 1009 1009 1010 -Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten. 1011 - 1012 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 1013 -|-ConnectionName|string|✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen. 1014 - 1015 -=== **Beispiele** === 1016 - 1017 -Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB 1018 - 1019 -{{code language="powershell" layout="LINENUMBERS"}} 1020 -Get-AESBConnectionInfo 1021 - 1022 -#Beispiel-Output: 1023 - 1024 - EndPoint VirtualRouter RoutingKey 1025 --------- ------------- ---------- 1026 -wss://localhost:3950 SHELL SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668 1027 -{{/code}} 1028 - 1029 -Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection" 1030 - 1031 1031 {{code language="powershell"}} 1032 - Get-AESBAliasList -ConnectionName "MyConnection"804 +Write-AESBActivityLog -Id "12345" -Name "ProcessUpdate" -Description "Der Prozessstatus wurde aktualisiert." -Status Running 1033 1033 1034 1034 {{/code}} 1035 1035 1036 -= Get-AESBTargetMessageCount=808 += Write-AESBBusinessLog = 1037 1037 1038 - DiesesCmdlet wirdverwendet, um die Anzahl derNachrichtenzu ermitteln,die sichderzeit imangegebenenTarget befinden.810 +Mit diesem Cmdlet wird eine Nachricht in das Business-Log des AESB geschrieben. Jeder Aufruf des Cmdlets erzeugt immer einen neuen Log-Eintrag 1039 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. 812 +**Parameter** 1044 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 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 1154 |-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB. 816 +|-IsError|bool|✅|IsErr|Gibt an, ob die Nachricht als Fehler protokolliert wird. 817 +|-Message|string|❌|M|Die zu protokollierende Nachricht. 818 +|-ComponentId|string|✅|CId|Die ID des Komponenten. 819 +|-ComponentName|string|✅|ComName|Der Name des Komponenten. 820 +|-ComponentPart|string|✅|ComPart|Der Teil des Komponenten. 821 +|-HostId|string|✅|HId|Die ID des Hosts. 822 +|-HostName|string|✅|HN|Der Name des Hosts. 823 +|-Context|string|✅|CT|Der Kontext der Nachricht. 1155 1155 1156 1156 === **Beispiele** === 1157 1157 1158 -Beispiel 1: E ntfernenvomAlias "MyAlias" ausdemAESB827 +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. 1159 1159 1160 1160 {{code language="powershell"}} 1161 - Remove-AESBAlias -Alias "MyAlias"830 +Write-AESBBusinessLog -Message "System started successfully" -ComponentName "MyComponent" -Context "Initialization" 1162 1162 1163 1163 {{/code}} 1164 1164 1165 -Beispiel 2: E ntfernenvom Alias"MyAlias"aus demAESBüberdie angegebeneVerbindung834 +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. 1166 1166 1167 1167 {{code language="powershell"}} 1168 -Remove-AESBAlias -ConnectionName "MyConnection" -Alias "MyAlias" 1169 - 837 +Write-AESBBusinessLog -IsError $true -Message "Error connecting to database" -ComponentId "DBComponent" -HostName "Server01" 1170 1170 {{/code}} 1171 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 - 1186 -= Write-AESBBusinessLog = 840 +