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,8 +330,6 @@ 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 335 335 336 336 === **Beispiele** === 337 337 ... ... @@ -352,9 +352,26 @@ 352 352 $icqlString 353 353 {{/code}} 354 354 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 + 355 355 = Get-AESBActivityLogItemById = 356 356 357 -Gibt den Activity 372 +Gibt den ActivityLog-Eintrag anhand einer ID zurück. 358 358 359 359 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 360 360 |-Id|string|❌| |Die ID des Logeintrags ... ... @@ -393,11 +393,11 @@ 393 393 394 394 = Get-AESBVirtualRouters = 395 395 396 -Gibt eine Liste aller Virtual 411 +Gibt eine Liste aller VirtualRouter zurück. 397 397 398 398 === **Beispiele** === 399 399 400 -Beispiel 1: Abrufen einer Liste aller Virtual 415 +Beispiel 1: Abrufen einer Liste aller VirtualRouter 401 401 402 402 {{code language="powershell"}} 403 403 Get-AESBVirtualRouters ... ... @@ -455,17 +455,17 @@ 455 455 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 456 456 |-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll. 457 457 |-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll. 458 -|-VirtualRouter|string|❌|VR|Der Name des Virtual 473 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, unter dem das Target läuft. 459 459 460 460 === **Beispiele** === 461 461 462 -Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual 477 +Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" 463 463 464 464 {{code language="powershell"}} 465 465 Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget" 466 466 {{/code}} 467 467 468 -Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual 483 +Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection" 469 469 470 470 {{code language="powershell"}} 471 471 Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" ... ... @@ -482,7 +482,7 @@ 482 482 483 483 === **Beispiele** === 484 484 485 -Beispiel 1: Abrufen der Liste aller Targets unter dem Virtual 500 +Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter" 486 486 487 487 {{code language="powershell"}} 488 488 Get-AESBTargets -VirtualRouter "MyRouter" ... ... @@ -489,7 +489,7 @@ 489 489 490 490 {{/code}} 491 491 492 -Beispiel 2: Abrufen der Liste aller Targets für den Virtual 507 +Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection" 493 493 494 494 {{code language="powershell"}} 495 495 Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter" ... ... @@ -508,7 +508,6 @@ 508 508 |-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird. 509 509 |-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll. 510 510 511 -=== Parameter-Sets === 512 512 513 513 Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können: 514 514 ... ... @@ -521,7 +521,7 @@ 521 521 522 522 === **Beispiele** === 523 523 524 -Beispiel 1: Senden der 538 +Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" 525 525 526 526 {{code language="powershell"}} 527 527 Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message" ... ... @@ -528,7 +528,7 @@ 528 528 529 529 {{/code}} 530 530 531 -Beispiel 2: Senden der 545 +Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey" 532 532 533 533 {{code language="powershell"}} 534 534 Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" ... ... @@ -535,7 +535,7 @@ 535 535 536 536 {{/code}} 537 537 538 -Beispiel 3: Konvertieren eines P SCustomObject in das ICQL-Format und senden derNachricht 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". 539 539 540 540 {{code language="powershell"}} 541 541 ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias" ... ... @@ -544,297 +544,629 @@ 544 544 545 545 = Publish-AESBMessageAndAwait = 546 546 547 - Mit diesem Cmdletkönnen Sie eine Nachricht an ein bestimmtes Target oder einen Alias im AESBsenden.Anschließendwirdauf eine Bestätigung oder Antwort innerhalb des angegebenen Zeitlimitsgewartet.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. 548 548 563 + 549 549 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 550 550 |-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll. 551 551 |-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll. 552 552 |-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre. 553 553 |-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll. 554 -|-RoutingKey|string|❌|RK|Der Routing 569 +|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird. 555 555 |-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. 556 -|-VirtualRouter|string|❌|VR|Der Name des Virtual 571 +|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll. 557 557 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 + 558 558 === **Beispiele** === 559 559 560 -Beispiel 1: Senden der Nachricht "Thisis a test message" an denAlias "MyAlias"und wartetbiszu 5 Minutenufeine Bestätigung587 +Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung 561 561 562 562 {{code language="powershell"}} 563 -Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m" 590 +Add-AESBAlias -Alias "MyAlias" 591 +{{/code}} 564 564 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 + 565 565 {{/code}} 566 566 567 - Beispiel2: Sendender Nachricht "This isatest message" überden Virtual Router "MyRouter" mit dem RoutingKey "MyRoutingKey"und wartet bis zu 1 Stunde auf eine Bestätigung.600 += Add-AESBCallbackTarget = 568 568 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 + 569 569 {{code language="powershell"}} 570 - Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This isatest message" -Timeout "1h"616 +Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1" 571 571 572 572 {{/code}} 573 573 574 - =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 575 575 576 -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" 577 577 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 + 578 578 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 579 -|-ConnectionName| //string//|✅|C|Der Name der Verbindung zumAESB.580 -| -MessageCount|//int//|✅|MC|DieAnzahlder Nachrichten, die empfangenwerdensollen.581 -|-TargetName| //string//|❌|TName|Der Name desZiels,vondem die Nachrichtenmpfangenwerden.582 -| -VirtualRouter|//string//|❌|VR|DerNameesVirtual Routers, derfür das Zielverwendet 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. 583 583 584 584 === **Beispiele** === 585 585 586 -Beispiel 1: EmpfangenvonNachrichtenvomZielmitdemNamen"MyTarget",dasdem Virtual Router "MyRouter" zugeordnetist639 +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 587 587 588 588 {{code language="powershell"}} 589 - Receive-AESBTargetMessages-VirtualRouter "MyRouter" -TargetName "MyTarget"642 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1" 590 590 591 591 {{/code}} 592 592 593 -Beispiel 2: Empfangenvon biszu10 Nachrichtenvom ZielmitdemNamen"MyTarget",dasdem Virtual Router "MyRouter" zugeordnetist646 +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 594 594 595 595 {{code language="powershell"}} 596 - Receive-AESBTargetMessages-VirtualRouter "MyRouter" -TargetName "MyTarget" -MessageCount 10649 +Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1" 597 597 598 598 {{/code}} 599 599 600 -= Remove-AESBAlias=653 += Add-AESBRoutingKey = 601 601 602 - Mit diesemCmdletkönnenSie einenAliasausdemAESB 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. 603 603 604 604 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 605 -|-Alias|string|❌|A|Der Name des zu entfernenden Alias. 606 -|-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. 607 607 608 608 === **Beispiele** === 609 609 610 -Beispiel 1: EntfernenvomAlias "MyAlias"ausdemAESB665 +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 611 611 612 612 {{code language="powershell"}} 613 - Remove-AESBAlias-Alias"MyAlias"668 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1" 614 614 615 615 {{/code}} 616 616 617 -Beispiel 2: Entfernenvom Alias "MyAlias"ausdemAESB überVerbindung672 +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 618 618 619 619 {{code language="powershell"}} 620 - Remove-AESBAlias-ConnectionName "MyConnection" -Alias"MyAlias"675 +Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" 621 621 622 622 {{/code}} 623 623 624 -= Remove-AESBRoutingFromAlias =679 += Add-AESBRoutingToAlias = 625 625 626 - Mit diesemCmdletkönnen Sie ein Routing-Paar(bestehendaus)voneinementfernen. Das Routing-Paarwirdvollstä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. 627 627 628 628 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 629 -|-Alias|string|❌|A|Der Name desAlias,vondem das Routing-Paarentfernt werden soll.630 -|-ConnectionName|string|✅|C|Der Name der Verbindung, die verwendet wird.631 -|-RoutingKey|string|❌|RK|Der Routing Key, der aus demAliasentfernt werden soll.632 -|-VirtualRouter|string|❌|VR|Der Virtual Router, der zusammen mit dem 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. 633 633 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 + 634 634 === **Beispiele** === 635 635 636 -Beispiel 1: Entfernenvom Routing-PaarmitVirtual RouterRoutingKey"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 637 637 638 638 {{code language="powershell"}} 639 - Remove-AESBRoutingFromAlias-Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"719 +Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey" 640 640 641 641 {{/code}} 642 642 643 -Beispiel 2: Entfernenvom Routing-PaarmitVirtual RouterRoutingKey"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 644 644 645 645 {{code language="powershell"}} 646 - Remove-AESBRoutingFromAlias-Alias"MyAlias" -ConnectionName "MyConnection" -VirtualRouter"MyRouter" -RoutingKey"MyRoutingKey"726 +Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection" 647 647 648 648 {{/code}} 649 649 650 -= Remove-AESBRoutingKey=730 += Add-AESBVirtualRouter = 651 651 652 - Mit diesemCmdletkönnen SieeinenRoutingKey von einembestimmtenZiel ineinemVirtual Router im AESB entfernen. DerRouting Key wirdausderKonfigurationentfernt, die mit dem angegebenenZiel undVirtualRouterverknüpft ist.732 +Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren. 653 653 654 654 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 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. 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. 659 659 660 660 === **Beispiele** === 661 661 662 -Beispiel 1: Entfernenvom Routing Key "MyRoutingKey"vom Ziel "MyTarget" imVirtual Router "MyRouter"740 +Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung 663 663 664 664 {{code language="powershell"}} 665 - Remove-AESBRoutingKey -VirtualRouter"MyRouter"-TargetName "MyTarget" -RoutingKey"MyRoutingKey"743 +Add-AESBVirtualRouter -VirtualRouter "MyRouter" 666 666 667 667 {{/code}} 668 668 669 -Beispiel 2: Entfernenvom Routing Key "MyRoutingKey"vom Ziel "MyTarget" imVirtual Router "MyRouter"unterVerwendungder Verbindung "MyConnection"747 +Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection" 670 670 671 671 {{code language="powershell"}} 672 - Remove-AESBRoutingKey-ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey"750 +Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection" 673 673 674 674 {{/code}} 675 675 676 -= Remove-AESBTarget=754 += ConvertFrom-AESBBase64 = 677 677 678 - Mit diesemCmdletkönnenSie einZielausdemVirtualRouter des AESBentfernen.756 +Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren. 679 679 680 680 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 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. 759 +|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll. 684 684 685 685 === **Beispiele** === 686 686 687 -Beispiel 1: EntfernenvomZiel"MyTarget"vom VirtualRouter"MyRouter"763 +Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!" 688 688 689 689 {{code language="powershell"}} 690 -Remove-AESBTarget -VirtualRouter "MyRouter" -TargetName "MyTarget" 766 +ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh" 767 + 691 691 {{/code}} 692 692 693 -Beispiel 2: EntfernenvomZiel"MyTarget"vomVirtualRouter"MyRouter" unterVerwendungderVerbindung "MyConnection"770 +Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text" 694 694 695 695 {{code language="powershell"}} 696 -Remove-AESBTarget -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" 773 +$base64String = "U29tZSBiYXNlNjQgdGV4dA==" 774 +ConvertFrom-AESBBase64 -Input $base64String 697 697 {{/code}} 698 698 699 -= Remove-AESBVirtualRouter=777 += ConvertFrom-AESBBase64ToFile = 700 700 701 - Mit diesemCmdletkönnenSieeinenangegebenenVirtualRouter entfernen.779 +Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern. 702 702 703 703 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 704 -|ConnectionName|string|✅|C|Gibt den Namen der Verbindung an. 705 -|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. 706 706 707 707 === **Beispiele** === 708 708 709 -Beispiel 1: Entfernen vomVirtualRoutermitdemNamen"MyRouter"788 +Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad 710 710 711 711 {{code language="powershell"}} 712 - Remove-AESBVirtualRouter-VirtualRouter"MyRouter"791 +ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt" 713 713 714 714 {{/code}} 715 715 716 -Beispiel 2: Entfernen vomVirtualRoutermitdemNamen"MyRouter"unterderVerbindung"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 717 717 718 718 {{code language="powershell"}} 719 - Remove-AESBVirtualRouter-ConnectionName"MyConnection" -VirtualRouter"MyRouter"798 +ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force 720 720 {{/code}} 721 721 722 -= Set-AESBBSelfAsAlias=801 += ConvertFrom-AESBIcql = 723 723 724 - BeidiesemCmdlet wirdein existierender Aliasverwendet, um einenneuenAliashinzuzufügen.DurchVerwendungdes bereitsexistierenden Alias, müssen so nichtder RoutingKey undVirtual Routerverwendet werden.803 +Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren. 725 725 726 -{{aagon.warnungsbox}} 727 -Die Parameter RemoveExistingAlias und AddToExistingAlias dürfen nicht gleichzeitig verwendet werden! 728 -{{/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. 729 729 730 -** Parameter**808 +=== **Beispiele** === 731 731 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 + 732 732 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 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 854 +|-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll. 736 736 737 737 === **Beispiele** === 738 738 739 -Beispiel 1: ÜberschreibenvomexistierendenAlias „AliasName“.Wenn z.B. der vorherige AliasmehrereVirtual Router undRouting Keyshatte, werden diesegelöscht858 +Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version 740 740 741 741 {{code language="powershell"}} 742 -Set-AESBSelfAsAlias -Alias "AliasName" -RemoveExistingAlias $true 861 +ConvertTo-AESBBase64 -Input "Hello World!" 862 +ConvertFrom-AESBIcql -Icql $icqlString 863 +{{/code}} 743 743 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 744 744 {{/code}} 745 745 746 - Beispiel2: Hinzufügen derVirtual Router und Routing Keys vomAlias„AliasName“ zumangegebenen Alias "SelfAliasTest".873 += ConvertTo-AESBBase64FromFile = 747 747 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 + 748 748 {{code language="powershell"}} 749 -Set-AESBSelfAsAlias -Alias "AliasName" -AddToExistingAlias "SelfAliasTest" 885 +ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt" 886 + 750 750 {{/code}} 751 751 752 - =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 753 753 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. 891 +{{code language="powershell"}} 892 +$filePath = "C:\path\to\anotherfile.txt" 893 +$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath 894 +$base64String 895 +{{/code}} 755 755 756 - **Parameter**897 += ConvertTo-AESBIcql = 757 757 899 +Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird. 900 + 758 758 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 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. 902 +|-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll. 762 762 763 763 === **Beispiele** === 764 764 765 -Beispiel 1: Anzeigen derRouting-TabellefürdenVirtualRouter„MyRouter“906 +Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück. 766 766 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 + 767 767 {{code language="powershell"}} 768 - Show-AESBRoutingTable -VirtualRouter"MyRouter"952 +Get-AESBActivityLogItemById -Id "ItemID" 769 769 770 770 {{/code}} 771 771 772 - Beispiel2: Anzeigen der Routing-Tabelle für den Virtual Router „MyRouter“ an, wobeinur Einträgevom Typ „DIRECT“ angezeigt werden. Die Verbindung „MyConnection“ wird verwendet.956 += Get-AESBAliasList = 773 773 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 + 774 774 {{code language="powershell"}} 775 - Show-AESBRoutingTable -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -ExchangeType DIRECT968 +Get-AESBAliasList 776 776 777 777 {{/code}} 778 778 779 - =Write-AESBActivityLog=972 +Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection" 780 780 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. 974 +{{code language="powershell"}} 975 +Get-AESBAliasList -ConnectionName "MyConnection" 782 782 783 - **Parameter**977 +{{/code}} 784 784 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 + 785 785 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 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. 997 +|-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder. 792 792 793 793 === **Beispiele** === 794 794 795 -Beispiel 1: Erstellen eines neuenLog-Eintrags. DerEintrag erhält den Namen "ProcessStart", dieBeschreibung"Der Prozess wurdegestartet" undden Status "Started". Da keine ID angegebenist,wirdinneuer Log-Eintragerstellt.1001 +Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName" 796 796 797 797 {{code language="powershell"}} 798 -Write-AESBActivityLog -Name "ProcessStart" -Description "Der Prozess wurde gestartet." -Status Started 1004 +Get-AESBAlias -Alias "AliasName" 1005 + 799 799 {{/code}} 800 800 801 - Beispiel2: Aktualisieren eines vorhandenen Log-Eintrags mit der ID "12345". Der Log-Eintrag wird auf denNamen "ProcessUpdate", die Beschreibung "Der Prozessstatus wurde aktualisiert" und den Status "Running" gesetzt. DieID wird verwendet, um den spezifischenEintrag zu finden und zu aktualisieren.1008 += Get-AESBConnectionInfo = 802 802 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 + 803 803 {{code language="powershell"}} 804 - Write-AESBActivityLog -Id "12345" -Name "ProcessUpdate"-Description"Der Prozessstatus wurdeaktualisiert."-Status Running1032 +Get-AESBAliasList -ConnectionName "MyConnection" 805 805 806 806 {{/code}} 807 807 808 -= Write-AESBBusinessLog =1036 += Get-AESBTargetMessageCount = 809 809 810 - Mit diesemCmdlet wirdindas Business-Logdes AESB geschrieben.JederAufruf desCmdlets erzeugt immereinen neuenLog-Eintrag1038 +Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden. 811 811 812 -**Parameter** 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. 813 813 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 + 814 814 |=(% 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. 815 815 |-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. 824 824 825 825 === **Beispiele** === 826 826 827 -Beispiel 1: E rstelleninesneuen Log-Eintrags imBusiness-Logmit der Nachricht"System started successfully". Der Log-Eintrag wird dem Komponenten-Namen"MyComponent"unddemKontext "Initialization" zugeordnet.1158 +Beispiel 1: Entfernen vom Alias "MyAlias" aus dem AESB 828 828 829 829 {{code language="powershell"}} 830 - Write-AESBBusinessLog-Message "Systemstarted successfully"-ComponentName "MyComponent" -Context "Initialization"1161 +Remove-AESBAlias -Alias "MyAlias" 831 831 832 832 {{/code}} 833 833 834 -Beispiel 2: E rstelleninesneuen Log-Eintrag imBusiness-Log, deralsFehler gekennzeichnetist.DieNachricht "Errorconnecting to database" wirddemKomponenten-ID "DBComponent" und demHost-Namen "Server01" zugeordnet.1165 +Beispiel 2: Entfernen vom Alias "MyAlias" aus dem AESB über die angegebene Verbindung 835 835 836 836 {{code language="powershell"}} 837 -Write-AESBBusinessLog -IsError $true -Message "Error connecting to database" -ComponentId "DBComponent" -HostName "Server01" 1168 +Remove-AESBAlias -ConnectionName "MyConnection" -Alias "MyAlias" 1169 + 838 838 {{/code}} 839 839 840 - 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 =