Changes for page Operative Cmdlets

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

From 18.4 to 19.1

From version 19.1

edited by jklein
on 2024/12/16 14:56

Change comment: There is no comment for this version

To version 26.1

edited by jklein
on 2025/01/10 07:49

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -254,7 +254,7 @@
  ConnectionName : MyConnection
  {{/code}}
--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
++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
  {{code language="powershell" layout="LINENUMBERS"}}
  # Erstellen eines PSCustomObject mit Beispieldaten
@@ -330,6 +330,8 @@
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
  |-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll.
++|-Sequence|string|✅| |Setzt die Sequence einer ICQL Message
++|-Action|string|✅| |Setzt die Action einer ICQL Message
  === **Beispiele** ===
@@ -350,26 +350,9 @@
  $icqlString
  {{/code}}
--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.
--
--{{code language="powershell" layout="LINENUMBERS"}}
--# Erstellen eines PSCustomObject mit Beispieldaten
--$exampleObject = [PSCustomObject]@{
--    TargetName    = "MyTarget"
--    TargetType    = "Queue"
--    RoutingKey    = "MyRoutingKey"
--    VirtualRouter = "MyRouter"
--    ConnectionName = "MyConnection"
--}
--
--# Konvertieren des Objekts in eine Icql-Zeichenfolge
--$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
--$icqlString
--{{/code}}
--
  = Get-AESBActivityLogItemById =
--Gibt den ActivityLog-Eintrag anhand einer ID zurück.
++Gibt den Activity Log-Eintrag anhand einer ID zurück.
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
  |-Id|string|❌| |Die ID des Logeintrags
@@ -408,11 +408,11 @@
  = Get-AESBVirtualRouters =
--Gibt eine Liste aller VirtualRouter zurück.
++Gibt eine Liste aller Virtual Router zurück.
  === **Beispiele** ===
--Beispiel 1: Abrufen einer Liste aller VirtualRouter
++Beispiel 1: Abrufen einer Liste aller Virtual Router
  {{code language="powershell"}}
  Get-AESBVirtualRouters
@@ -470,17 +470,17 @@
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
  |-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.
  |-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, unter dem das Target läuft.
++|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, unter dem das Target läuft.
  === **Beispiele** ===
--Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"
++Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual Router "MyRouter"
  {{code language="powershell"}}
  Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
  {{/code}}
--Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"
++Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual Router "MyRouter" und der Verbindung "MyConnection"
  {{code language="powershell"}}
  Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
@@ -497,7 +497,7 @@
  === **Beispiele** ===
--Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
++Beispiel 1: Abrufen der Liste aller Targets unter dem Virtual Router "MyRouter"
  {{code language="powershell"}}
  Get-AESBTargets -VirtualRouter "MyRouter"
@@ -504,7 +504,7 @@
  {{/code}}
--Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"
++Beispiel 2: Abrufen der Liste aller Targets für den Virtual Router "MyRouter" und die Verbindung "MyConnection"
  {{code language="powershell"}}
  Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
@@ -523,6 +523,7 @@
  |-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
  |-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
++=== Parameter-Sets ===
  Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
@@ -535,7 +535,7 @@
  === **Beispiele** ===
--Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"
++Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"
  {{code language="powershell"}}
  Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message"
@@ -542,7 +542,7 @@
  {{/code}}
--Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey"
++Beispiel 2: Senden der Nachricht "This is a test message" über den Virtual Router "MyRouter" mit dem Routing Key "MyRoutingKey"
  {{code language="powershell"}}
  Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message"
@@ -549,7 +549,7 @@
  {{/code}}
--(% 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".
++Beispiel 3: Konvertieren eines PSCustomObject in das ICQL-Format und senden der Nachricht an den Alias "MyAlias"
  {{code language="powershell"}}
  ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias"
@@ -558,561 +558,27 @@
  = Publish-AESBMessageAndAwait =
--Sendet eine Nachricht an ein bestimmtes Target oder einen Alias im AESB und wartet auf eine Bestätigung oder Antwort innerhalb des angegebenen Zeitlimits.
++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.
--
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
  |-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
  |-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
  |-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
  |-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
--|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
++|-RoutingKey|string|❌|RK|Der Routing Key, der für das Routing der Nachricht verwendet wird.
  |-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.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
++|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, über den die Nachricht veröffentlicht werden soll.
--(% class="wikigeneratedid" %)
--(% id="cke_bm_484750S" style="display:none" %) (%%)Arbeiten in AESB verwendet werden können.
--
--= Add-AESBAlias =
--
--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.
--
--(% style="width:977px" %)
--|=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %)Optional|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung
--|-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.
--|-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.
--
  === **Beispiele** ===
--Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung
++Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung
  {{code language="powershell"}}
--Add-AESBAlias -Alias "MyAlias"
--{{/code}}
--
--Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection"
--
--{{/code}}
--
--= Add-AESBCallbackTarget =
--
--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.
--
--(% style="width:1073px" %)
--|=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Optional|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung
--|(% 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.
--|(% 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.
--|(% 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.
--|(% 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.
--
--=== (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** ===
--
--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
--
--{{code language="powershell"}}
--Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
--
--{{/code}}
--
--= Add-AESBQueueTarget =
--
--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"]]
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|(% 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.
--|(% 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.
--|(% 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.
--|(% 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.
--
--=== **Beispiele** ===
--
--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
--
--{{code language="powershell"}}
--Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
--
--{{/code}}
--
--= Add-AESBRoutingKey =
--
--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.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, zu dem der Routing Key gehört.
--|-TargetName|string|❌|TName|Der Name des Targets, für das der Routing Key hinzugefügt wird.
--|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der hinzugefügt werden soll.
--
--=== **Beispiele** ===
--
--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
--
--{{code language="powershell"}}
--Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"
--
--{{/code}}
--
--= Add-AESBRoutingToAlias =
--
--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.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Alias|string|❌|A|Der Alias, zu dem das Routing-Paar im QNS hinzugefügt werden soll.
--|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Routing-Paar hinzugefügt werden soll.
--|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der zusammen mit dem Virtual Router hinzugefügt werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, der zusammen mit dem Routing Key hinzugefügt werden soll.
--
--=== (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** ===
--
--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.
--
--{{code language="powershell"}}
--Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection"
--{{/code}}
--
--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.
--
--{{code language="powershell"}}
--Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
--{{/code}}
--
--= Add-AESBTarget =
--
--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.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll.
--|-RoutingKey|string|❌|RK|Der Routing Key, der dem Target zugewiesen wird.
--|-TargetName|string|❌|TName|Der Name des Targets, das hinzugefügt werden soll.
--|-TargetType|string|❌|TType|Der Typ des Targets, das hinzugefügt werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird.
--
--=== **Beispiele** ===
--
--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
--
--{{code language="powershell"}}
--Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
--
--{{/code}}
--
--= Add-AESBVirtualRouter =
--
--Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouter, der hinzugefügt werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung
--
--{{code language="powershell"}}
--Add-AESBVirtualRouter -VirtualRouter "MyRouter"
--
--{{/code}}
--
--Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
--
--{{/code}}
--
--= ConvertFrom-AESBBase64 =
--
--Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"
--
--{{code language="powershell"}}
--ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
--
--{{/code}}
--
--Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
--
--{{code language="powershell"}}
--$base64String = "U29tZSBiYXNlNjQgdGV4dA=="
--ConvertFrom-AESBBase64 -Input $base64String
--{{/code}}
--
--= ConvertFrom-AESBBase64ToFile =
--
--Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
--|-OutputPath|string|❌|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen.
--|-Force|switch|✅|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert.
--
--=== **Beispiele** ===
--
--Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
--
--{{code language="powershell"}}
--ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
--{{/code}}
--
--= ConvertFrom-AESBIcql =
--
--Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
--
--{{code language="powershell"}}
--$icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>"
--ConvertFrom-AESBIcql -Icql $icqlString
--{{/code}}
--
--Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
--
--{{code language="none" layout="LINENUMBERS"}}
--TargetName     : MyTarget
--TargetType     : Queue
--RoutingKey     : MyRoutingKey
--VirtualRouter  : MyRouter
--ConnectionName : MyConnection
--{{/code}}
--
--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
--
--{{code language="powershell" layout="LINENUMBERS"}}
--# Erstellen eines PSCustomObject mit Beispieldaten
--$exampleObject = [PSCustomObject]@{
--    TargetName    = "MyTarget"
--    TargetType    = "Queue"
--    RoutingKey    = "MyRoutingKey"
--    VirtualRouter = "MyRouter"
--    ConnectionName = "MyConnection"
--}
--
--# Konvertieren des Objekts in eine Icql-Zeichenfolge
--$x = ConvertTo-AESBIcql -InputObject $exampleObject
--
--# Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject
--$decodedObject = ConvertFrom-AESBIcql -Icql $x
--
--# Anzeigen des dekodierten Objekts
--$decodedObjectConvertFrom-AESBIcql -Icql $icqlString
--{{/code}}
--
--= ConvertTo-AESBBase64 =
--
--Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
--
--{{code language="powershell"}}
--ConvertTo-AESBBase64 -Input "Hello World!"
--ConvertFrom-AESBIcql -Icql $icqlString
--{{/code}}
--
--Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
--
--{{code language="powershell"}}
--$string = "Base64 encoding example"
--$base64String = ConvertTo-AESBBase64 -Input $string
--$base64StringConvertFrom-AESBIcql -Icql $icqlString
--{{/code}}
--
--= ConvertTo-AESBBase64FromFile =
--
--Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-InputPath|string|❌|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge
--
--{{code language="powershell"}}
--ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--$filePath = "C:\path\to\anotherfile.txt"
--$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
--$base64String
--{{/code}}
--
--= ConvertTo-AESBIcql =
--
--Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
--
--{{code language="powershell" layout="LINENUMBERS"}}
--# Erstellen eines PSCustomObject mit Beispieldaten
--$exampleObject = [PSCustomObject]@{
--    TargetName    = "MyTarget"
--    TargetType    = "Queue"
--    RoutingKey    = "MyRoutingKey"
--    VirtualRouter = "MyRouter"
--    ConnectionName = "MyConnection"
--}
--
--# Konvertieren des Objekts in eine Icql-Zeichenfolge
--$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
--$icqlString
--{{/code}}
--
--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.
--
--{{code language="powershell" layout="LINENUMBERS"}}
--# Erstellen eines PSCustomObject mit Beispieldaten
--$exampleObject = [PSCustomObject]@{
--    TargetName    = "MyTarget"
--    TargetType    = "Queue"
--    RoutingKey    = "MyRoutingKey"
--    VirtualRouter = "MyRouter"
--    ConnectionName = "MyConnection"
--}
--
--# Konvertieren des Objekts in eine Icql-Zeichenfolge
--$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
--$icqlString
--{{/code}}
--
--= Get-AESBActivityLogItemById =
--
--Gibt den ActivityLog-Eintrag anhand einer ID zurück.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Id|string|❌| |Die ID des Logeintrags
--
--=== **Beispiele** ===
--
--Beispiel 1: Abruf eines Log-Eintrags anhand einer ID
--
--{{code language="powershell"}}
--Get-AESBActivityLogItemById -Id "ItemID"
--
--{{/code}}
--
--= Get-AESBAliasList =
--
--Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung
--
--{{code language="powershell"}}
--Get-AESBAliasList
--
--{{/code}}
--
--Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Get-AESBAliasList -ConnectionName "MyConnection"
--
--{{/code}}
--
--= Get-AESBVirtualRouters =
--
--Gibt eine Liste aller VirtualRouter zurück.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen einer Liste aller VirtualRouter
--
--{{code language="powershell"}}
--Get-AESBVirtualRouters
--
--{{/code}}
--
--= Get-AESBAlias =
--
--Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"
--
--{{code language="powershell"}}
--Get-AESBAlias -Alias "AliasName"
--
--{{/code}}
--
--= Get-AESBConnectionInfo =
--
--Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB
--
--{{code language="powershell" layout="LINENUMBERS"}}
--Get-AESBConnectionInfo
--
--#Beispiel-Output:
--
-- EndPoint             VirtualRouter RoutingKey
----------             ------------- ----------
--wss://localhost:3950 SHELL         SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668
--{{/code}}
--
--Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Get-AESBAliasList -ConnectionName "MyConnection"
--
--{{/code}}
--
--= Get-AESBTargetMessageCount =
--
--Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.
--|-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, unter dem das Target läuft.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"
--
--{{code language="powershell"}}
--Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
--{{/code}}
--
--Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
--
--{{/code}}
--
--= Get-AESBTargets =
--
--Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
--
--{{code language="powershell"}}
--Get-AESBTargets -VirtualRouter "MyRouter"
--
--{{/code}}
--
--Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
--
--{{/code}}
--
--= Publish-AESBMessage =
--
-- Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
--|-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
--|-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
--|-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
--|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
--
--
--Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
--
--* (((
--RoutingParameterSet - Message, VirtualRouter, RoutingKey
--)))
--* (((
--AliasParameterSet - Message, Alias
--)))
--
--=== **Beispiele** ===
--
--Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung
--
--{{code language="powershell"}}
  Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
  {{/code}}
--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
++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.
  {{code language="powershell"}}
  Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
@@ -1121,33 +1121,33 @@
  = Receive-AESBTargetMessages =
--Mit diesem Cmdlet werden Nachrichten von einem Ziel im AESB empfangen.
++Mit diesem Cmdlet können Sie Nachrichten von einem Ziel im AESB empfangen.
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
  |-ConnectionName|//string//|✅|C|Der Name der Verbindung zum AESB.
  |-MessageCount|//int//|✅|MC|Die Anzahl der Nachrichten, die empfangen werden sollen.
  |-TargetName|//string//|❌|TName|Der Name des Ziels, von dem die Nachrichten empfangen werden.
--|-VirtualRouter|//string//|❌|VR|Der Name des VirtualRouters, der für das Ziel verwendet wird.
++|-VirtualRouter|//string//|❌|VR|Der Name des Virtual Routers, der für das Ziel verwendet wird.
  === **Beispiele** ===
--Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung
++Beispiel 1: Empfangen von Nachrichten vom Ziel mit dem Namen "MyTarget", das dem Virtual Router "MyRouter" zugeordnet ist
  {{code language="powershell"}}
--Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
++Receive-AESBTargetMessages -VirtualRouter "MyRouter" -TargetName "MyTarget"
  {{/code}}
--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
++Beispiel 2: Empfangen von bis zu 10 Nachrichten vom Ziel mit dem Namen "MyTarget", das dem Virtual Router "MyRouter" zugeordnet ist
  {{code language="powershell"}}
--Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
++Receive-AESBTargetMessages -VirtualRouter "MyRouter" -TargetName "MyTarget" -MessageCount 10
  {{/code}}
  = Remove-AESBAlias =
--Mit diesem Cmdlet wird ein Alias aus dem AESB entfernt.
++Mit diesem Cmdlet können Sie einen Alias aus dem AESB entfernen.
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
  |-Alias|string|❌|A|Der Name des zu entfernenden Alias.
@@ -1162,7 +1162,7 @@
  {{/code}}
--Beispiel 2: Entfernen vom Alias "MyAlias" aus dem AESB über die angegebene Verbindung
++Beispiel 2: Entfernen vom Alias "MyAlias" aus dem AESB über die angegebene Verbindung
  {{code language="powershell"}}
  Remove-AESBAlias -ConnectionName "MyConnection" -Alias "MyAlias"
@@ -1171,1199 +1171,218 @@
  = Remove-AESBRoutingFromAlias =
--Mit diesem Cmdlet wird ein Routing-Paar (bestehend aus VirtualRouter und RoutingKey) von einem Alias im QNS entfernt. Das Routing-Paar wird dabei vollständig gelöscht.
++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.
--
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Alias|string|❌|A|Der Name des Alias, von dem das Routing-Pärchen entfernt werden soll.
++|-Alias|string|❌|A|Der Name des Alias, von dem das Routing-Paar entfernt werden soll.
  |-ConnectionName|string|✅|C|Der Name der Verbindung, die verwendet wird.
--|-RoutingKey|string|❌|RK|Der RoutingKey, der aus dem Alias entfernt werden soll.
--|-VirtualRouter|string|❌|VR|Der VirtualRouter, der zusammen mit dem RoutingKey entfernt werden soll.
++|-RoutingKey|string|❌|RK|Der Routing Key, der aus dem Alias entfernt werden soll.
++|-VirtualRouter|string|❌|VR|Der Virtual Router, der zusammen mit dem Routing Key entfernt werden soll.
--
--(% class="wikigeneratedid" %)
--Bei den operativen Cmdlets handelt es sich um Shell-Befehle, die für die Steuerung und das weiterführende Arbeiten in AESB verwendet werden können.
--
--= Add-AESBAlias =
--
--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.
--
--(% style="width:977px" %)
--|=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %)Optional|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung
--|-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.
--|-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.
--
  === **Beispiele** ===
--Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung
++Beispiel 1: Entfernen vom Routing-Paar mit Virtual Router "MyRouter" und Routing Key "MyRoutingKey" vom Alias "MyAlias"
  {{code language="powershell"}}
--Add-AESBAlias -Alias "MyAlias"
--{{/code}}
++Remove-AESBRoutingFromAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
--Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection"
--
  {{/code}}
--= Add-AESBCallbackTarget =
++Beispiel 2: Entfernen vom Routing-Paar mit Virtual Router "MyRouter" und Routing Key "MyRoutingKey" vom Alias "MyAlias" unter Verwendung der Verbindung "MyConnection"
--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.
--
--(% style="width:1073px" %)
--|=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Optional|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung
--|(% 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.
--|(% 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.
--|(% 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.
--|(% 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.
--
--=== (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** ===
--
--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
--
  {{code language="powershell"}}
--Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
++Remove-AESBRoutingFromAlias -Alias "MyAlias" -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
  {{/code}}
--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
++= Remove-AESBRoutingKey =
--{{code language="powershell"}}
--Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
++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.
--{{/code}}
--
--= Add-AESBQueueTarget =
--
--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"]]
--
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|(% 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.
--|(% 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.
--|(% 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.
--|(% 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.
++|-ConnectionName|string|✅|C|Der Name der Verbindung, die verwendet werden soll.
++|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, von dem der Routing Key entfernt werden soll.
++|-TargetName|string|❌|TName|Der Name des Ziels, von dem der Routing Key entfernt werden soll.
++|-RoutingKey|string|❌|RK|Der Routing Key, der entfernt werden soll.
  === **Beispiele** ===
--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
++Beispiel 1: Entfernen vom Routing Key "MyRoutingKey" vom Ziel "MyTarget" im Virtual Router "MyRouter"
  {{code language="powershell"}}
--Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
++Remove-AESBRoutingKey -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey"
  {{/code}}
--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
++Beispiel 2: Entfernen vom Routing Key "MyRoutingKey" vom Ziel "MyTarget" im Virtual Router "MyRouter" unter Verwendung der Verbindung "MyConnection"
  {{code language="powershell"}}
--Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
++Remove-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey"
  {{/code}}
--= Add-AESBRoutingKey =
++= Remove-AESBTarget =
--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.
++Mit diesem Cmdlet können Sie ein Ziel aus dem Virtual Router des AESB entfernen.
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, zu dem der Routing Key gehört.
--|-TargetName|string|❌|TName|Der Name des Targets, für das der Routing Key hinzugefügt wird.
--|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der hinzugefügt werden soll.
++|-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB.
++|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, von dem das Ziel entfernt werden soll.
++|-TargetName|string|❌|TName|Der Name des Ziels, das entfernt werden soll.
  === **Beispiele** ===
--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
++Beispiel 1: Entfernen vom Ziel "MyTarget" vom Virtual Router "MyRouter"
  {{code language="powershell"}}
--Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
--
++Remove-AESBTarget -VirtualRouter "MyRouter" -TargetName "MyTarget"
  {{/code}}
--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
++Beispiel 2: Entfernen vom Ziel "MyTarget" vom Virtual Router "MyRouter" unter Verwendung der Verbindung "MyConnection"
  {{code language="powershell"}}
--Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"
--
++Remove-AESBTarget -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
  {{/code}}
--= Add-AESBRoutingToAlias =
++= Remove-AESBVirtualRouter =
--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.
++Mit diesem Cmdlet können Sie einen angegebenen Virtual Router entfernen.
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Alias|string|❌|A|Der Alias, zu dem das Routing-Paar im QNS hinzugefügt werden soll.
--|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Routing-Paar hinzugefügt werden soll.
--|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der zusammen mit dem Virtual Router hinzugefügt werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, der zusammen mit dem Routing Key hinzugefügt werden soll.
++|ConnectionName|string|✅|C|Gibt den Namen der Verbindung an.
++|VirtualRouter|string|❌|VR|Gibt den Namen des zu entfernenden Virtual Router an.
--=== (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** ===
--
--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.
--
--{{code language="powershell"}}
--Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection"
--{{/code}}
--
--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.
--
--{{code language="powershell"}}
--Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
--{{/code}}
--
--= Add-AESBTarget =
--
--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.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll.
--|-RoutingKey|string|❌|RK|Der Routing Key, der dem Target zugewiesen wird.
--|-TargetName|string|❌|TName|Der Name des Targets, das hinzugefügt werden soll.
--|-TargetType|string|❌|TType|Der Typ des Targets, das hinzugefügt werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird.
--
  === **Beispiele** ===
--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
++Beispiel 1: Entfernen vom Virtual Router mit dem Namen "MyRouter"
  {{code language="powershell"}}
--Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"
++Remove-AESBVirtualRouter -VirtualRouter "MyRouter"
  {{/code}}
--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
++Beispiel 2: Entfernen vom Virtual Router mit dem Namen "MyRouter" unter der Verbindung "MyConnection"
  {{code language="powershell"}}
--Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
--
++Remove-AESBVirtualRouter -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
  {{/code}}
--= Add-AESBVirtualRouter =
++= Set-AESBBSelfAsAlias =
--Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
++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.
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouter, der hinzugefügt werden soll.
++{{aagon.warnungsbox}}
++Die Parameter RemoveExistingAlias und AddToExistingAlias dürfen nicht gleichzeitig verwendet werden!
++{{/aagon.warnungsbox}}
--=== **Beispiele** ===
++**Parameter**
--Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung
--
--{{code language="powershell"}}
--Add-AESBVirtualRouter -VirtualRouter "MyRouter"
--
--{{/code}}
--
--Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
--
--{{/code}}
--
--= ConvertFrom-AESBBase64 =
--
--Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
--
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
++|-Alias|string|❌| |Gibt den Namen vom Alias an
++|-RemoveExistingAlias|bool|✅| |Der bestehende Alias wird ersetzt.
++|-AddToExistingAlias|bool|✅| |Der Virtual Router und Routing Key wird zu dem angegebenen Alias hinzugefügt
  === **Beispiele** ===
--Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"
++Beispiel 1: Überschreiben vom existierenden Alias „AliasName“. Wenn z.B. der vorherige Alias mehrere Virtual Router und Routing Keys hatte, werden diese gelöscht
  {{code language="powershell"}}
--ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
++Set-AESBSelfAsAlias -Alias "AliasName" -RemoveExistingAlias $true
  {{/code}}
--Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
++Beispiel 2: Hinzufügen der Virtual Router und Routing Keys vom Alias „AliasName“ zum angegebenen Alias "SelfAliasTest".
  {{code language="powershell"}}
--$base64String = "U29tZSBiYXNlNjQgdGV4dA=="
--ConvertFrom-AESBBase64 -Input $base64String
++Set-AESBSelfAsAlias -Alias "AliasName" -AddToExistingAlias "SelfAliasTest"
  {{/code}}
--= ConvertFrom-AESBBase64ToFile =
++= Show-AESBRoutingTable =
--Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
++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.
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
--|-OutputPath|string|❌|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen.
--|-Force|switch|✅|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert.
++**Parameter**
--=== **Beispiele** ===
--
--Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
--
--{{code language="powershell"}}
--ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
--{{/code}}
--
--= ConvertFrom-AESBIcql =
--
--Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
--
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll.
++|-ConnectionName|string|✅|C|Der Name der Verbindung, die für das Abrufen der Routing-Tabelle verwendet wird.
++|-ExchangeType|ExchangeTypes|✅|ET|Der Typ des Exchanges, der angezeigt werden soll. Mögliche Werte sind DIRECT oder ROUTING.
++|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, für den die Routing-Tabelle angezeigt wird.
  === **Beispiele** ===
--Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
++Beispiel 1: Anzeigen der Routing-Tabelle für den Virtual Router „MyRouter“
  {{code language="powershell"}}
--$icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>"
--ConvertFrom-AESBIcql -Icql $icqlString
--{{/code}}
++Show-AESBRoutingTable -VirtualRouter "MyRouter"
--Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
--
--{{code language="none" layout="LINENUMBERS"}}
--TargetName     : MyTarget
--TargetType     : Queue
--RoutingKey     : MyRoutingKey
--VirtualRouter  : MyRouter
--ConnectionName : MyConnection
  {{/code}}
--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
++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.
--{{code language="powershell" layout="LINENUMBERS"}}
--# Erstellen eines PSCustomObject mit Beispieldaten
--$exampleObject = [PSCustomObject]@{
--    TargetName    = "MyTarget"
--    TargetType    = "Queue"
--    RoutingKey    = "MyRoutingKey"
--    VirtualRouter = "MyRouter"
--    ConnectionName = "MyConnection"
--}
--
--# Konvertieren des Objekts in eine Icql-Zeichenfolge
--$x = ConvertTo-AESBIcql -InputObject $exampleObject
--
--# Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject
--$decodedObject = ConvertFrom-AESBIcql -Icql $x
--
--# Anzeigen des dekodierten Objekts
--$decodedObjectConvertFrom-AESBIcql -Icql $icqlString
--{{/code}}
--
--= ConvertTo-AESBBase64 =
--
--Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
--
  {{code language="powershell"}}
--ConvertTo-AESBBase64 -Input "Hello World!"
--ConvertFrom-AESBIcql -Icql $icqlString
--{{/code}}
++Show-AESBRoutingTable -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -ExchangeType DIRECT
--Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
--
--{{code language="powershell"}}
--$string = "Base64 encoding example"
--$base64String = ConvertTo-AESBBase64 -Input $string
--$base64StringConvertFrom-AESBIcql -Icql $icqlString
  {{/code}}
--= ConvertTo-AESBBase64FromFile =
++= Write-AESBActivityLog =
--Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.
++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.
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-InputPath|string|❌|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll.
++**Parameter**
--=== **Beispiele** ===
--
--Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge
--
--{{code language="powershell"}}
--ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--$filePath = "C:\path\to\anotherfile.txt"
--$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
--$base64String
--{{/code}}
--
--= ConvertTo-AESBIcql =
--
--Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
--
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll.
++|-ConnectionName|string|✅|C|Der Name der Verbindung, die für die Kommunikation verwendet wird.
++|-Id|string|✅|None|Die ID des Log-Eintrags, der aktualisiert werden soll. Wird ein neuer Eintrag erstellt, kann dieser Parameter weggelassen werden.
++|-Name|string|❌|N|Der Name des Log-Eintrags.
++|-Description|string|❌|D|Die Beschreibung des Log-Eintrags.
++|-Status|JobFeedbackResultCode|❌|ST|Der Status des Logs, z.B. "Warning", "Created", "Started", "Running", "Stopping", "Stopped", "Failed" oder "Finished".
++|-ComponentName|string|✅|ComName|Der Name der Komponente, die den Log-Eintrag erstellt hat.
  === **Beispiele** ===
--Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
++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.
--{{code language="powershell" layout="LINENUMBERS"}}
--# Erstellen eines PSCustomObject mit Beispieldaten
--$exampleObject = [PSCustomObject]@{
--    TargetName    = "MyTarget"
--    TargetType    = "Queue"
--    RoutingKey    = "MyRoutingKey"
--    VirtualRouter = "MyRouter"
--    ConnectionName = "MyConnection"
--}
--
--# Konvertieren des Objekts in eine Icql-Zeichenfolge
--$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
--$icqlString
--{{/code}}
--
--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.
--
--{{code language="powershell" layout="LINENUMBERS"}}
--# Erstellen eines PSCustomObject mit Beispieldaten
--$exampleObject = [PSCustomObject]@{
--    TargetName    = "MyTarget"
--    TargetType    = "Queue"
--    RoutingKey    = "MyRoutingKey"
--    VirtualRouter = "MyRouter"
--    ConnectionName = "MyConnection"
--}
--
--# Konvertieren des Objekts in eine Icql-Zeichenfolge
--$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
--$icqlString
--{{/code}}
--
--= Get-AESBActivityLogItemById =
--
--Gibt den ActivityLog-Eintrag anhand einer ID zurück.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Id|string|❌| |Die ID des Logeintrags
--
--=== **Beispiele** ===
--
--Beispiel 1: Abruf eines Log-Eintrags anhand einer ID
--
  {{code language="powershell"}}
--Get-AESBActivityLogItemById -Id "ItemID"
--
++Write-AESBActivityLog -Name "ProcessStart" -Description "Der Prozess wurde gestartet." -Status Started
  {{/code}}
--= Get-AESBAliasList =
++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.
--Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung
--
  {{code language="powershell"}}
--Get-AESBAliasList
++Write-AESBActivityLog -Id "12345" -Name "ProcessUpdate" -Description "Der Prozessstatus wurde aktualisiert." -Status Running
  {{/code}}
--Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
++= Write-AESBBusinessLog =
--{{code language="powershell"}}
--Get-AESBAliasList -ConnectionName "MyConnection"
++Mit diesem Cmdlet wird eine Nachricht in das Business-Log des AESB geschrieben. Jeder Aufruf des Cmdlets erzeugt immer einen neuen Log-Eintrag
--{{/code}}
++**Parameter**
--= Get-AESBVirtualRouters =
--
--Gibt eine Liste aller VirtualRouter zurück.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen einer Liste aller VirtualRouter
--
--{{code language="powershell"}}
--Get-AESBVirtualRouters
--
--{{/code}}
--
--= Get-AESBAlias =
--
--Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.
--
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"
--
--{{code language="powershell"}}
--Get-AESBAlias -Alias "AliasName"
--
--{{/code}}
--
--= Get-AESBConnectionInfo =
--
--Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB
--
--{{code language="powershell" layout="LINENUMBERS"}}
--Get-AESBConnectionInfo
--
--#Beispiel-Output:
--
-- EndPoint             VirtualRouter RoutingKey
----------             ------------- ----------
--wss://localhost:3950 SHELL         SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668
--{{/code}}
--
--Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Get-AESBAliasList -ConnectionName "MyConnection"
--
--{{/code}}
--
--= Get-AESBTargetMessageCount =
--
--Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.
--|-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, unter dem das Target läuft.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"
--
--{{code language="powershell"}}
--Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
--{{/code}}
--
--Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
--
--{{/code}}
--
--= Get-AESBTargets =
--
--Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
--
--{{code language="powershell"}}
--Get-AESBTargets -VirtualRouter "MyRouter"
--
--{{/code}}
--
--Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
--
--{{/code}}
--
--= Publish-AESBMessage =
--
-- Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
--|-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
--|-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
--|-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
--|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
--
--
--Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
--
--* (((
--RoutingParameterSet - Message, VirtualRouter, RoutingKey
--)))
--* (((
--AliasParameterSet - Message, Alias
--)))
--
--=== **Beispiele** ===
--
--Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"
--
--{{code language="powershell"}}
--Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message"
--
--{{/code}}
--
--Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey"
--
--{{code language="powershell"}}
--Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message"
--
--{{/code}}
--
--(% 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".
--
--{{code language="powershell"}}
--ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias"
--
--{{/code}}
--
--= Publish-AESBMessageAndAwait =
--
--Sendet eine Nachricht an ein bestimmtes Target oder einen Alias im AESB und wartet auf eine Bestätigung oder Antwort innerhalb des angegebenen Zeitlimits.
--
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
--|-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
--|-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
--|-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
--|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
--|-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.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
--
--(% class="wikigeneratedid" %)
--(% id="cke_bm_484750S" style="display:none" %) (%%)Arbeiten in AESB verwendet werden können.
--
--= Add-AESBAlias =
--
--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.
--
--(% style="width:977px" %)
--|=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %)Optional|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung
--|-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.
--|-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.
--
--=== **Beispiele** ===
--
--Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung
--
--{{code language="powershell"}}
--Add-AESBAlias -Alias "MyAlias"
--{{/code}}
--
--Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection"
--
--{{/code}}
--
--= Add-AESBCallbackTarget =
--
--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.
--
--(% style="width:1073px" %)
--|=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Optional|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung
--|(% 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.
--|(% 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.
--|(% 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.
--|(% 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.
--
--=== (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** ===
--
--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
--
--{{code language="powershell"}}
--Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
--
--{{/code}}
--
--= Add-AESBQueueTarget =
--
--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"]]
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|(% 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.
--|(% 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.
--|(% 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.
--|(% 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.
--
--=== **Beispiele** ===
--
--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
--
--{{code language="powershell"}}
--Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
--
--{{/code}}
--
--= Add-AESBRoutingKey =
--
--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.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, zu dem der Routing Key gehört.
--|-TargetName|string|❌|TName|Der Name des Targets, für das der Routing Key hinzugefügt wird.
--|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der hinzugefügt werden soll.
--
--=== **Beispiele** ===
--
--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
--
--{{code language="powershell"}}
--Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"
--
--{{/code}}
--
--= Add-AESBRoutingToAlias =
--
--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.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Alias|string|❌|A|Der Alias, zu dem das Routing-Paar im QNS hinzugefügt werden soll.
--|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Routing-Paar hinzugefügt werden soll.
--|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der zusammen mit dem Virtual Router hinzugefügt werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, der zusammen mit dem Routing Key hinzugefügt werden soll.
--
--=== (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** ===
--
--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.
--
--{{code language="powershell"}}
--Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection"
--{{/code}}
--
--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.
--
--{{code language="powershell"}}
--Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
--{{/code}}
--
--= Add-AESBTarget =
--
--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.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll.
--|-RoutingKey|string|❌|RK|Der Routing Key, der dem Target zugewiesen wird.
--|-TargetName|string|❌|TName|Der Name des Targets, das hinzugefügt werden soll.
--|-TargetType|string|❌|TType|Der Typ des Targets, das hinzugefügt werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird.
--
--=== **Beispiele** ===
--
--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
--
--{{code language="powershell"}}
--Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
--
--{{/code}}
--
--= Add-AESBVirtualRouter =
--
--Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouter, der hinzugefügt werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung
--
--{{code language="powershell"}}
--Add-AESBVirtualRouter -VirtualRouter "MyRouter"
--
--{{/code}}
--
--Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
--
--{{/code}}
--
--= ConvertFrom-AESBBase64 =
--
--Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"
--
--{{code language="powershell"}}
--ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
--
--{{/code}}
--
--Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
--
--{{code language="powershell"}}
--$base64String = "U29tZSBiYXNlNjQgdGV4dA=="
--ConvertFrom-AESBBase64 -Input $base64String
--{{/code}}
--
--= ConvertFrom-AESBBase64ToFile =
--
--Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
--|-OutputPath|string|❌|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen.
--|-Force|switch|✅|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert.
--
--=== **Beispiele** ===
--
--Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
--
--{{code language="powershell"}}
--ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
--{{/code}}
--
--= ConvertFrom-AESBIcql =
--
--Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
--
--{{code language="powershell"}}
--$icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>"
--ConvertFrom-AESBIcql -Icql $icqlString
--{{/code}}
--
--Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
--
--{{code language="none" layout="LINENUMBERS"}}
--TargetName     : MyTarget
--TargetType     : Queue
--RoutingKey     : MyRoutingKey
--VirtualRouter  : MyRouter
--ConnectionName : MyConnection
--{{/code}}
--
--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
--
--{{code language="powershell" layout="LINENUMBERS"}}
--# Erstellen eines PSCustomObject mit Beispieldaten
--$exampleObject = [PSCustomObject]@{
--    TargetName    = "MyTarget"
--    TargetType    = "Queue"
--    RoutingKey    = "MyRoutingKey"
--    VirtualRouter = "MyRouter"
--    ConnectionName = "MyConnection"
--}
--
--# Konvertieren des Objekts in eine Icql-Zeichenfolge
--$x = ConvertTo-AESBIcql -InputObject $exampleObject
--
--# Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject
--$decodedObject = ConvertFrom-AESBIcql -Icql $x
--
--# Anzeigen des dekodierten Objekts
--$decodedObjectConvertFrom-AESBIcql -Icql $icqlString
--{{/code}}
--
--= ConvertTo-AESBBase64 =
--
--Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
--
--{{code language="powershell"}}
--ConvertTo-AESBBase64 -Input "Hello World!"
--ConvertFrom-AESBIcql -Icql $icqlString
--{{/code}}
--
--Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
--
--{{code language="powershell"}}
--$string = "Base64 encoding example"
--$base64String = ConvertTo-AESBBase64 -Input $string
--$base64StringConvertFrom-AESBIcql -Icql $icqlString
--{{/code}}
--
--= ConvertTo-AESBBase64FromFile =
--
--Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-InputPath|string|❌|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge
--
--{{code language="powershell"}}
--ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--$filePath = "C:\path\to\anotherfile.txt"
--$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
--$base64String
--{{/code}}
--
--= ConvertTo-AESBIcql =
--
--Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
--
--{{code language="powershell" layout="LINENUMBERS"}}
--# Erstellen eines PSCustomObject mit Beispieldaten
--$exampleObject = [PSCustomObject]@{
--    TargetName    = "MyTarget"
--    TargetType    = "Queue"
--    RoutingKey    = "MyRoutingKey"
--    VirtualRouter = "MyRouter"
--    ConnectionName = "MyConnection"
--}
--
--# Konvertieren des Objekts in eine Icql-Zeichenfolge
--$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
--$icqlString
--{{/code}}
--
--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.
--
--{{code language="powershell" layout="LINENUMBERS"}}
--# Erstellen eines PSCustomObject mit Beispieldaten
--$exampleObject = [PSCustomObject]@{
--    TargetName    = "MyTarget"
--    TargetType    = "Queue"
--    RoutingKey    = "MyRoutingKey"
--    VirtualRouter = "MyRouter"
--    ConnectionName = "MyConnection"
--}
--
--# Konvertieren des Objekts in eine Icql-Zeichenfolge
--$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
--$icqlString
--{{/code}}
--
--= Get-AESBActivityLogItemById =
--
--Gibt den ActivityLog-Eintrag anhand einer ID zurück.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Id|string|❌| |Die ID des Logeintrags
--
--=== **Beispiele** ===
--
--Beispiel 1: Abruf eines Log-Eintrags anhand einer ID
--
--{{code language="powershell"}}
--Get-AESBActivityLogItemById -Id "ItemID"
--
--{{/code}}
--
--= Get-AESBAliasList =
--
--Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung
--
--{{code language="powershell"}}
--Get-AESBAliasList
--
--{{/code}}
--
--Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Get-AESBAliasList -ConnectionName "MyConnection"
--
--{{/code}}
--
--= Get-AESBVirtualRouters =
--
--Gibt eine Liste aller VirtualRouter zurück.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen einer Liste aller VirtualRouter
--
--{{code language="powershell"}}
--Get-AESBVirtualRouters
--
--{{/code}}
--
--= Get-AESBAlias =
--
--Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"
--
--{{code language="powershell"}}
--Get-AESBAlias -Alias "AliasName"
--
--{{/code}}
--
--= Get-AESBConnectionInfo =
--
--Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB
--
--{{code language="powershell" layout="LINENUMBERS"}}
--Get-AESBConnectionInfo
--
--#Beispiel-Output:
--
-- EndPoint             VirtualRouter RoutingKey
----------             ------------- ----------
--wss://localhost:3950 SHELL         SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668
--{{/code}}
--
--Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Get-AESBAliasList -ConnectionName "MyConnection"
--
--{{/code}}
--
--= Get-AESBTargetMessageCount =
--
--Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.
--|-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, unter dem das Target läuft.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"
--
--{{code language="powershell"}}
--Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
--{{/code}}
--
--Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
--
--{{/code}}
--
--= Get-AESBTargets =
--
--Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll.
--
--=== **Beispiele** ===
--
--Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
--
--{{code language="powershell"}}
--Get-AESBTargets -VirtualRouter "MyRouter"
--
--{{/code}}
--
--Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"
--
--{{code language="powershell"}}
--Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
--
--{{/code}}
--
--= Publish-AESBMessage =
--
-- Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
--|-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
--|-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
--|-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
--|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
--|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
--
--Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
--
--* (((
--RoutingParameterSet - Message, VirtualRouter, RoutingKey
--)))
--* (((
--AliasParameterSet - Message, Alias
--)))
--
--=== **Beispiele** ===
--
--Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"
--
--{{code language="powershell"}}
--Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
--
--{{/code}}
--
--Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey"
--
--{{code language="powershell"}}
--Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
--
--{{/code}}
--
--= Receive-AESBTargetMessages =
--
--Mit diesem Cmdlet werden Nachrichten von einem Ziel im AESB empfangen.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|//string//|✅|C|Der Name der Verbindung zum AESB.
--|-MessageCount|//int//|✅|MC|Die Anzahl der Nachrichten, die empfangen werden sollen.
--|-TargetName|//string//|❌|TName|Der Name des Ziels, von dem die Nachrichten empfangen werden.
--|-VirtualRouter|//string//|❌|VR|Der Name des Virtual Routers, der für das Ziel verwendet wird.
--
--=== **Beispiele** ===
--
--Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung
--
--{{code language="powershell"}}
--Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
--
--{{/code}}
--
--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
--
--{{code language="powershell"}}
--Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
--
--{{/code}}
--
--= Remove-AESBAlias =
--
--Mit diesem Cmdlet wird ein Alias aus dem AESB entfernt.
--
--|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-Alias|string|❌|A|Der Name des zu entfernenden Alias.
  |-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB.
++|-IsError|bool|✅|IsErr|Gibt an, ob die Nachricht als Fehler protokolliert wird.
++|-Message|string|❌|M|Die zu protokollierende Nachricht.
++|-ComponentId|string|✅|CId|Die ID des Komponenten.
++|-ComponentName|string|✅|ComName|Der Name des Komponenten.
++|-ComponentPart|string|✅|ComPart|Der Teil des Komponenten.
++|-HostId|string|✅|HId|Die ID des Hosts.
++|-HostName|string|✅|HN|Der Name des Hosts.
++|-Context|string|✅|CT|Der Kontext der Nachricht.
  === **Beispiele** ===
--Beispiel 1: Entfernen vom Routing-Paar mit Virtual Router "MyRouter" und Routing Key "MyRoutingKey" vom Alias "MyAlias".
++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.
  {{code language="powershell"}}
--Remove-AESBRoutingFromAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
++Write-AESBBusinessLog -Message "System started successfully" -ComponentName "MyComponent" -Context "Initialization"
  {{/code}}
--Beispiel 2: Entfernen vom Routing-Paar mit VirtualRouter "MyRouter" und RoutingKey "MyRoutingKey" vom Alias "MyAlias" unter Verwendung der Verbindung "MyConnection".
++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.
  {{code language="powershell"}}
--Remove-AESBRoutingFromAlias -Alias "MyAlias" -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
++Write-AESBBusinessLog -IsError $true -Message "Error connecting to database" -ComponentId "DBComponent" -HostName "Server01"
  {{/code}}
--= Remove-AESBRoutingKey =
--
--Entfernt einen Routing Key von einem bestimmten Ziel in einem VirtualRouter im AESB. Der RoutingKey wird aus der Konfiguration entfernt, die mit dem angegebenen Ziel und VirtualRouter verknüpft ist.
--
--
--
--
--
--= Remove-AESBTarget =
--
--= Remove-AESBVirtualRouter =
--
--= Set-AESBBSelfAsAlias =
--
--= Show-AESBRoutingTable =
--
--= Write-AESBActivityLog =
--
--= Write-AESBBusinessLog =
++