Changes for page Operative Cmdlets
Last modified by jklein on 2025/08/06 13:00
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Parent
-
... ... @@ -1,1 +1,1 @@ 1 -AESB.11 0.AESB Shell.Cmdlet-Dokumentation.WebHome1 +AESB.111.AESB Shell.Cmdlet-Dokumentation.WebHome - Content
-
... ... @@ -3,14 +3,18 @@ 3 3 (% class="wikigeneratedid" %) 4 4 Bei den operativen Cmdlets handelt es sich um Shell-Befehle, die für die Steuerung und das weiterführende Arbeiten in AESB verwendet werden können. 5 5 6 +{{aagon.infobox}} 7 +Falls bei der Ausführung eines Cmdlets mit ausschließlich optionalen Parametern keine Parameter angegeben werden, wird immer die Standardverbindung mit dem standardmäßigen Parameter-Set genutzt. 8 +{{/aagon.infobox}} 9 + 6 6 = Add-AESBAlias = 7 7 8 8 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. 9 9 10 10 (% style="width:977px" %) 11 -|=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %) Optional|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung12 -|-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.13 -|-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.15 +|=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %)Erforderlich|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung 16 +|-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. 17 +|-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. 14 14 15 15 === **Beispiele** === 16 16 ... ... @@ -32,11 +32,11 @@ 32 32 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. 33 33 34 34 (% style="width:1073px" %) 35 -|=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %) Optional|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung36 -|(% 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.37 -|(% 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.38 -|(% 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.39 -|(% 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.39 +|=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Erforderlich|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung 40 +|(% 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. 41 +|(% 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. 42 +|(% 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. 43 +|(% 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. 40 40 41 41 === (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** === 42 42 ... ... @@ -58,11 +58,11 @@ 58 58 59 59 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"]] 60 60 61 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung62 -|(% 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.63 -|(% 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.64 -|(% 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.65 -|(% 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.65 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 90px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 66 +|(% style="width:199px" %)-ConnectionName|(% style="width:160px" %)String|(% style="width:90px" %)❌|(% 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. 67 +|(% style="width:199px" %)-VirtualRouter|(% style="width:160px" %)String|(% style="width:90px" %)✅|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name des Virtual Routers, dem das Queue-Target zugeordnet wird. 68 +|(% style="width:199px" %)-TargetName|(% style="width:160px" %)String|(% style="width:90px" %)✅|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name des Queue-Targets, das hinzugefügt werden soll. 69 +|(% style="width:199px" %)-RoutingKey|(% style="width:160px" %)String|(% style="width:90px" %)✅|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Routing-Key, der verwendet wird, um Nachrichten an das Queue-Targets zu senden. 66 66 67 67 === **Beispiele** === 68 68 ... ... @@ -84,11 +84,11 @@ 84 84 85 85 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. 86 86 87 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung88 -|-ConnectionName|string| ✅|C|Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll.89 -|-VirtualRouter|string| ❌|VR|Der Name des Virtual Router, zu dem der Routing Key gehört.90 -|-TargetName|string| ❌|TName|Der Name des Targets, für das der Routing Key hinzugefügt wird.91 -|-RoutingKey|string| ❌|RK|Der Name des Routing Keys, der hinzugefügt werden soll.91 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 90px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 92 +|-ConnectionName|string|(% style="width:90px" %)❌|C|Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll. 93 +|-VirtualRouter|string|(% style="width:90px" %)✅|VR|Der Name des Virtual Router, zu dem der Routing Key gehört. 94 +|-TargetName|string|(% style="width:90px" %)✅|TName|Der Name des Targets, für das der Routing Key hinzugefügt wird. 95 +|-RoutingKey|string|(% style="width:90px" %)✅|RK|Der Name des Routing Keys, der hinzugefügt werden soll. 92 92 93 93 === **Beispiele** === 94 94 ... ... @@ -110,11 +110,11 @@ 110 110 111 111 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. 112 112 113 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung114 -|-Alias|string| ❌|A|Der Alias, zu dem das Routing-Paar im QNS hinzugefügt werden soll.115 -|-ConnectionName|string| ✅|C|Der Name der SICS-Verbindung, für die das Routing-Paar hinzugefügt werden soll.116 -|-RoutingKey|string| ❌|RK|Der Name des Routing Keys, der zusammen mit dem Virtual Router hinzugefügt werden soll.117 -|-VirtualRouter|string| ❌|VR|Der Name des Virtual Router, der zusammen mit dem Routing Key hinzugefügt werden soll.117 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 118 +|-Alias|string|✅|A|Der Alias, zu dem das Routing-Paar im QNS hinzugefügt werden soll. 119 +|-ConnectionName|string|❌|C|Der Name der SICS-Verbindung, für die das Routing-Paar hinzugefügt werden soll. 120 +|-RoutingKey|string|✅|RK|Der Name des Routing Keys, der zusammen mit dem Virtual Router hinzugefügt werden soll. 121 +|-VirtualRouter|string|✅|VR|Der Name des Virtual Router, der zusammen mit dem Routing Key hinzugefügt werden soll. 118 118 119 119 === (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** === 120 120 ... ... @@ -134,12 +134,12 @@ 134 134 135 135 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. 136 136 137 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung138 -|-ConnectionName|string| ✅|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll.139 -|-RoutingKey|string| ❌|RK|Der Routing Key, der dem Target zugewiesen wird.140 -|-TargetName|string| ❌|TName|Der Name des Targets, das hinzugefügt werden soll.141 -|-TargetType|string| ❌|TType|Der Typ des Targets, das hinzugefügt werden soll.142 -|-VirtualRouter|string| ❌|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird.141 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 90px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 142 +|-ConnectionName|string|(% style="width:90px" %)❌|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll. 143 +|-RoutingKey|string|(% style="width:90px" %)✅|RK|Der Routing Key, der dem Target zugewiesen wird. 144 +|-TargetName|string|(% style="width:90px" %)✅|TName|Der Name des Targets, das hinzugefügt werden soll. 145 +|-TargetType|string|(% style="width:90px" %)✅|TType|Der Typ des Targets, das hinzugefügt werden soll. 146 +|-VirtualRouter|string|✅|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird. 143 143 144 144 === **Beispiele** === 145 145 ... ... @@ -161,9 +161,9 @@ 161 161 162 162 Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren. 163 163 164 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung165 -|-ConnectionName|string| ✅|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll.166 -|-VirtualRouter|string| ❌|VR|Der Name des VirtualRouter, der hinzugefügt werden soll.168 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 90px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 169 +|-ConnectionName|string|(% style="width:90px" %)❌|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll. 170 +|-VirtualRouter|string|(% style="width:90px" %)✅|VR|Der Name des VirtualRouter, der hinzugefügt werden soll. 167 167 168 168 === **Beispiele** === 169 169 ... ... @@ -185,8 +185,8 @@ 185 185 186 186 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren. 187 187 188 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung189 -|-Input|string| ❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.192 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 193 +|-Input|string|✅|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll. 190 190 191 191 === **Beispiele** === 192 192 ... ... @@ -208,10 +208,10 @@ 208 208 209 209 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern. 210 210 211 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung212 -|-Input|string| ❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.213 -|-OutputPath|string| ❌|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen.214 -|-Force|switch| ✅|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert.215 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 216 +|-Input|string|✅|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll. 217 +|-OutputPath|string|✅|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen. 218 +|-Force|switch|❌|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert. 215 215 216 216 === **Beispiele** === 217 217 ... ... @@ -232,8 +232,8 @@ 232 232 233 233 Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren. 234 234 235 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung236 -|-Icql|string| ❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll.239 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 240 +|-Icql|string|✅|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll. 237 237 238 238 === **Beispiele** === 239 239 ... ... @@ -254,7 +254,7 @@ 254 254 ConnectionName : MyConnection 255 255 {{/code}} 256 256 257 -Beispiel 2: Kodieren eines PSCustomObjects in eine Icql-Zeichenfolge und anschließendes dekodieren zurück in ein PSCustomObject. Die resultierenden Daten entsprechen den ursprünglichen Eingabewerten261 +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 258 258 259 259 {{code language="powershell" layout="LINENUMBERS"}} 260 260 # Erstellen eines PSCustomObject mit Beispieldaten ... ... @@ -280,8 +280,8 @@ 280 280 281 281 Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren. 282 282 283 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung284 -|-Input|string| ❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll.287 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 288 +|-Input|string|✅|In|Die Zeichenfolge, die in Base64 kodiert werden soll. 285 285 286 286 === **Beispiele** === 287 287 ... ... @@ -304,8 +304,8 @@ 304 304 305 305 Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren. 306 306 307 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung308 -|-InputPath|string| ❌|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll.311 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 312 +|-InputPath|string|✅|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll. 309 309 310 310 === **Beispiele** === 311 311 ... ... @@ -328,8 +328,10 @@ 328 328 329 329 Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird. 330 330 331 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 332 -|-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll. 335 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 336 +|-InputObject|psobject|✅|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll. 337 +|-Sequence|string|❌| |Setzt die Sequence einer ICQL Message 338 +|-Action|string|❌| |Setzt die Action einer ICQL Message 333 333 334 334 === **Beispiele** === 335 335 ... ... @@ -350,29 +350,12 @@ 350 350 $icqlString 351 351 {{/code}} 352 352 353 -Beispiel 2: Konvertiert das PSCustomObject, das in der Variable $exampleObject gespeichert ist, in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge in der Variable $icqlString zurück. 354 - 355 -{{code language="powershell" layout="LINENUMBERS"}} 356 -# Erstellen eines PSCustomObject mit Beispieldaten 357 -$exampleObject = [PSCustomObject]@{ 358 - TargetName = "MyTarget" 359 - TargetType = "Queue" 360 - RoutingKey = "MyRoutingKey" 361 - VirtualRouter = "MyRouter" 362 - ConnectionName = "MyConnection" 363 -} 364 - 365 -# Konvertieren des Objekts in eine Icql-Zeichenfolge 366 -$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject 367 -$icqlString 368 -{{/code}} 369 - 370 370 = Get-AESBActivityLogItemById = 371 371 372 -Gibt den ActivityLog-Eintrag anhand einer ID zurück. 361 +Gibt den Activity Log-Eintrag anhand einer ID zurück. 373 373 374 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung375 -|-Id|string| ❌| |Die ID des Logeintrags363 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 364 +|-Id|string|✅| |Die ID des Logeintrags 376 376 377 377 === **Beispiele** === 378 378 ... ... @@ -387,8 +387,8 @@ 387 387 388 388 Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten. 389 389 390 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung391 -|-ConnectionName|string| ✅|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll.379 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 380 +|-ConnectionName|string|❌|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll. 392 392 393 393 === **Beispiele** === 394 394 ... ... @@ -408,11 +408,11 @@ 408 408 409 409 = Get-AESBVirtualRouters = 410 410 411 -Gibt eine Liste aller VirtualRouter zurück. 400 +Gibt eine Liste aller Virtual Router zurück. 412 412 413 413 === **Beispiele** === 414 414 415 -Beispiel 1: Abrufen einer Liste aller VirtualRouter 404 +Beispiel 1: Abrufen einer Liste aller Virtual Router 416 416 417 417 {{code language="powershell"}} 418 418 Get-AESBVirtualRouters ... ... @@ -423,8 +423,8 @@ 423 423 424 424 Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder. 425 425 426 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung427 -|-Alias|string| ❌| |Gibt die Informationen zum angegebenen Alias wieder.415 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 416 +|-Alias|string|✅| |Gibt die Informationen zum angegebenen Alias wieder. 428 428 429 429 === **Beispiele** === 430 430 ... ... @@ -439,8 +439,8 @@ 439 439 440 440 Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten. 441 441 442 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung443 -|-ConnectionName|string| ✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen.431 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 432 +|-ConnectionName|string|❌|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen. 444 444 445 445 === **Beispiele** === 446 446 ... ... @@ -467,20 +467,20 @@ 467 467 468 468 Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden. 469 469 470 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung471 -|-ConnectionName|string| ✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.472 -|-TargetName|string| ❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.473 -|-VirtualRouter|string| ❌|VR|Der Name des VirtualRouters, unter dem das Target läuft.459 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 460 +|-ConnectionName|string|❌|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll. 461 +|-TargetName|string|✅|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll. 462 +|-VirtualRouter|string|✅|VR|Der Name des Virtual Routers, unter dem das Target läuft. 474 474 475 475 === **Beispiele** === 476 476 477 -Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" 466 +Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual Router "MyRouter" 478 478 479 479 {{code language="powershell"}} 480 480 Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget" 481 481 {{/code}} 482 482 483 -Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection" 472 +Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual Router "MyRouter" und der Verbindung "MyConnection" 484 484 485 485 {{code language="powershell"}} 486 486 Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" ... ... @@ -491,13 +491,13 @@ 491 491 492 492 Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten. 493 493 494 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung495 -|-ConnectionName|string| ✅|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll.496 -|-VirtualRouter|string| ❌|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll.483 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 484 +|-ConnectionName|string|❌|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll. 485 +|-VirtualRouter|string|✅|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll. 497 497 498 498 === **Beispiele** === 499 499 500 -Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter" 489 +Beispiel 1: Abrufen der Liste aller Targets unter dem Virtual Router "MyRouter" 501 501 502 502 {{code language="powershell"}} 503 503 Get-AESBTargets -VirtualRouter "MyRouter" ... ... @@ -504,7 +504,7 @@ 504 504 505 505 {{/code}} 506 506 507 -Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection" 496 +Beispiel 2: Abrufen der Liste aller Targets für den Virtual Router "MyRouter" und die Verbindung "MyConnection" 508 508 509 509 {{code language="powershell"}} 510 510 Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter" ... ... @@ -515,14 +515,15 @@ 515 515 516 516 Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden. 517 517 518 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung519 -|-Alias|string| ❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.520 -|-ConnectionName|string| ✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.521 -|-Force|switch| ✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.522 -|-Message|Object| ❌|M|Die Nachricht, die veröffentlicht werden soll.523 -|-RoutingKey|string| ❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.524 -|-VirtualRouter|string| ❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.507 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 508 +|-Alias|string|✅|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll. 509 +|-ConnectionName|string|❌|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll. 510 +|-Force|switch|❌|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre. 511 +|-Message|Object|✅|M|Die Nachricht, die veröffentlicht werden soll. 512 +|-RoutingKey|string|✅|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird. 513 +|-VirtualRouter|string|✅|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll. 525 525 515 +=== Parameter-Sets === 526 526 527 527 Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können: 528 528 ... ... @@ -535,7 +535,7 @@ 535 535 536 536 === **Beispiele** === 537 537 538 -Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"528 +Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" 539 539 540 540 {{code language="powershell"}} 541 541 Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message" ... ... @@ -542,7 +542,7 @@ 542 542 543 543 {{/code}} 544 544 545 -Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey"535 +Beispiel 2: Senden der Nachricht "This is a test message" über den Virtual Router "MyRouter" mit dem Routing Key "MyRoutingKey" 546 546 547 547 {{code language="powershell"}} 548 548 Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" ... ... @@ -549,7 +549,7 @@ 549 549 550 550 {{/code}} 551 551 552 - (% id="cke_bm_333933S" style="display:none" %) (%%)Beispiel 3: Konvertieren eines PowerShell-Objektsin das ICQL-Format und senden desObjektsan den Alias "MyAlias".542 +Beispiel 3: Konvertieren eines PSCustomObject in das ICQL-Format und senden der Nachricht an den Alias "MyAlias" 553 553 554 554 {{code language="powershell"}} 555 555 ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias" ... ... @@ -558,629 +558,301 @@ 558 558 559 559 = Publish-AESBMessageAndAwait = 560 560 561 - Sendet eine Nachricht an ein bestimmtes Target oder einen Alias im AESBund wartetauf eine Bestätigung oder Antwort innerhalb des angegebenen Zeitlimits.551 +Mit diesem Cmdlet können Sie eine Nachricht an ein bestimmtes Target oder einen Alias im AESB senden. Anschließend wird auf eine Bestätigung oder Antwort innerhalb des angegebenen Zeitlimits gewartet. 562 562 553 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 554 +|-Alias|string|✅|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll. 555 +|-ConnectionName|string|❌|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll. 556 +|-Force|switch|❌|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre. 557 +|-Message|Object|✅|M|Die Nachricht, die veröffentlicht werden soll. 558 +|-RoutingKey|string|✅|RK|Der Routing Key, der für das Routing der Nachricht verwendet wird. 559 +|-Timeout|string|❌|T|Die maximale Zeitdauer, die auf eine Bestätigung gewartet wird. Der Wert kann in Sekunden, Minuten oder Stunden angegeben werden, z.B. "5s", "5 sec", "5 seconds", "5m", "5 min", "5 minutes", "2h", "2 hours". Standardmäßig wird der Wert in Sekunden interpretiert. 560 +|-VirtualRouter|string|✅|VR|Der Name des Virtual Routers, über den die Nachricht veröffentlicht werden soll. 563 563 564 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 565 -|-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll. 566 -|-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll. 567 -|-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre. 568 -|-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll. 569 -|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird. 570 -|-Timeout|string|✅|T|Die maximale Zeitdauer, die auf eine Bestätigung gewartet wird. Der Wert kann in Sekunden, Minuten oder Stunden angegeben werden, z.B. "5s", "5 sec", "5 seconds", "5m", "5 min", "5 minutes", "2h", "2 hours". Standardmäßig wird der Wert in Sekunden interpretiert. 571 -|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll. 572 - 573 -(% class="wikigeneratedid" %) 574 -(% id="cke_bm_484750S" style="display:none" %) (%%)Arbeiten in AESB verwendet werden können. 575 - 576 -= Add-AESBAlias = 577 - 578 -Mit diesem Cmdlet wird ein neuer Alias für eine SICS-Verbindung im Qualified Name Service (QNS) hinzugefügt. Wenn der Parameter //-ConnectionName// nicht angegeben wird, wird der Alias für die Standardverbindung hinzugefügt. 579 - 580 -(% style="width:977px" %) 581 -|=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %)Optional|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung 582 -|-Alias|(% style="width:101px" %)String|(% style="width:94px" %)❌|(% style="width:87px" %)Keine|(% style="width:505px" %)Der Name des Alias, der dem Qualified Name Service (QNS) hinzugefügt werden soll. 583 -|-ConnectionName|(% style="width:101px" %)String|(% style="width:94px" %)✅|(% style="width:87px" %)Keine|(% style="width:505px" %)Der Name der SICS-Verbindung, für die der Alias hinzugefügt wird. Wenn dieser Parameter nicht angegeben ist, wird der Alias für die Standardverbindung hinzugefügt. 584 - 585 585 === **Beispiele** === 586 586 587 -Beispiel 1: Hinzufügen des Alias "MyAlias"fürdieStandardverbindung564 +Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung 588 588 589 589 {{code language="powershell"}} 590 -Add-AESBAlias -Alias "MyAlias" 591 -{{/code}} 567 +Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m" 592 592 593 -Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection" 594 - 595 -{{code language="powershell"}} 596 -Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection" 597 - 598 598 {{/code}} 599 599 600 - =Add-AESBCallbackTarget=571 +Beispiel 2: Senden der Nachricht "This is a test message" über den Virtual Router "MyRouter" mit dem Routing Key "MyRoutingKey" und wartet bis zu 1 Stunde auf eine Bestätigung. 601 601 602 -Mtit diesem Cmdlet wird ein neues Callback-Target zur SICS-Verbindung hinzugefügt. Das Callback-Target wird für den Empfang von Nachrichten verwendet und erfordert eine Routing-Key-Konfiguration sowie einen Virtual Router. 603 - 604 -(% style="width:1073px" %) 605 -|=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Optional|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung 606 -|(% style="width:166px" %)-ConnectionName|(% style="width:127px" %)String|(% style="width:90px" %)✅|(% style="width:74px" %)Keine|(% style="width:614px" %)Der Name der SICS-Verbindung, zu der das Callback-Target hinzugefügt wird. Wenn dieser Parameter nicht angegeben ist, wird das Callback-Target zur Standardverbindung hinzugefügt. 607 -|(% style="width:166px" %)-VirtualRouter|(% style="width:127px" %)String|(% style="width:90px" %)❌|(% style="width:74px" %)Keine|(% style="width:614px" %)Der Name des Virtual Routers, dem das Callback-Target zugeordnet werden soll. 608 -|(% style="width:166px" %)-TargetName|(% style="width:127px" %)String|(% style="width:90px" %)❌|(% style="width:74px" %)Keine|(% style="width:614px" %)Der Name des Callback-Targets, das hinzugefügt werden soll. 609 -|(% style="width:166px" %)-RoutingKey|(% style="width:127px" %)String|(% style="width:90px" %)❌|(% style="width:74px" %)Keine|(% style="width:614px" %)Der Routing-Key, der verwendet wird, um Nachrichten an das Callback-Target zu routen. 610 - 611 -=== (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** === 612 - 613 -Beispiel 1: Hinzufügen eines Callback-Targets "CallbackTarget1" zur Standardverbindung. Dabei wird das Callback-Target über den Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet 614 - 615 615 {{code language="powershell"}} 616 - Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey"Key1"574 +Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h" 617 617 618 618 {{/code}} 619 619 620 - Beispiel2: Hinzufügeneines Callback-Targets "CallbackTarget1" zur SICS-Verbindung "MyConnection". Dabei wird dasCallback-Targetüber den Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet578 += Receive-AESBTargetMessages = 621 621 622 -{{code language="powershell"}} 623 -Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1" 580 +Mit diesem Cmdlet können Sie Nachrichten von einem Ziel im AESB empfangen. 624 624 625 -{{/code}} 582 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 583 +|-ConnectionName|//string//|❌|C|Der Name der Verbindung zum AESB. 584 +|-MessageCount|//int//|❌|MC|Die Anzahl der Nachrichten, die empfangen werden sollen. 585 +|-TargetName|//string//|✅|TName|Der Name des Ziels, von dem die Nachrichten empfangen werden. 586 +|-VirtualRouter|//string//|✅|VR|Der Name des Virtual Routers, der für das Ziel verwendet wird. 626 626 627 -= Add-AESBQueueTarget = 628 - 629 -Dieses Cmdlet fügt ein neues Target zu einer SICS-Verbindung hinzu. Innerhalb dieses Targets ist eine Queue enthalten, in der Nachrichten weiterverarbeitet werden, die an das Target gesendet werden. Daher handelt es sich bei diesem Cmdlet um eine spezifische Form eines [[AESB-Targets.>>doc:||anchor="HAdd-AESBTarget"]] 630 - 631 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 632 -|(% style="width:199px" %)-ConnectionName|(% style="width:160px" %)String|(% style="width:119px" %)✅|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name der SICS-Verbindung, zu der das Queue-Target hinzugefügt wird. Wenn dieser Parameter nicht angegeben ist, wird das Queue-Target zur Standardverbindung hinzugefügt. 633 -|(% style="width:199px" %)-VirtualRouter|(% style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name des Virtual Routers, dem das Queue-Target zugeordnet wird. 634 -|(% style="width:199px" %)-TargetName|(% style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Name des Queue-Targets, das hinzugefügt werden soll. 635 -|(% style="width:199px" %)-RoutingKey|(% style="width:160px" %)String|(% style="width:119px" %)❌|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Routing-Key, der verwendet wird, um Nachrichten an das Queue-Targets zu senden. 636 - 637 637 === **Beispiele** === 638 638 639 -Beispiel 1: Hinzufügeneines Queue-Targets "QueueTarget1" zur Standardverbindung.DabeiwirddasQueue-Targetüberden Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet590 +Beispiel 1: Empfangen von Nachrichten vom Ziel mit dem Namen "MyTarget", das dem Virtual Router "MyRouter" zugeordnet ist 640 640 641 641 {{code language="powershell"}} 642 - Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1"-RoutingKey "Key1"593 +Receive-AESBTargetMessages -VirtualRouter "MyRouter" -TargetName "MyTarget" 643 643 644 644 {{/code}} 645 645 646 -Beispiel 2: HinzufügeneinesQueue-Targets"QueueTarget1"zurSICS-Verbindung "MyConnection".DabeiwirddasQueue-Targetüberden Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet597 +Beispiel 2: Empfangen von bis zu 10 Nachrichten vom Ziel mit dem Namen "MyTarget", das dem Virtual Router "MyRouter" zugeordnet ist 647 647 648 648 {{code language="powershell"}} 649 - Add-AESBQueueTarget-ConnectionName"MyConnection"-VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey"Key1"600 +Receive-AESBTargetMessages -VirtualRouter "MyRouter" -TargetName "MyTarget" -MessageCount 10 650 650 651 651 {{/code}} 652 652 653 -= Add-AESBRoutingKey=604 += Remove-AESBAlias = 654 654 655 - DiesesCmdletwird verwendet,um Routing-Informationenfürein[[AESB-Target>>doc:||anchor="HAdd-AESBTarget"]]zukonfigurieren. Dabei wirdeinRoutingKey zueinem Targetineinem VirtualRouter hinzugefügt.606 +Mit diesem Cmdlet können Sie einen Alias aus dem AESB entfernen. 656 656 657 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 658 -|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll. 659 -|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, zu dem der Routing Key gehört. 660 -|-TargetName|string|❌|TName|Der Name des Targets, für das der Routing Key hinzugefügt wird. 661 -|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der hinzugefügt werden soll. 608 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 609 +|-Alias|string|✅|A|Der Name des zu entfernenden Alias. 610 +|-ConnectionName|string|❌|C|Der Name der Verbindung zum AESB. 662 662 663 663 === **Beispiele** === 664 664 665 -Beispiel 1: Hinzufügen des Routing Keys "Key1"für dieStandardverbindung. Dabei wird angegeben,dass der RoutingKey für dasTarget"MyTarget".hinzugefügtwirdund zumVirtual Router "Router1" gehört614 +Beispiel 1: Entfernen vom Alias "MyAlias" aus dem AESB 666 666 667 667 {{code language="powershell"}} 668 - Add-AESBQueueTarget-VirtualRouter"Router1" -TargetName"QueueTarget1" -RoutingKey "Key1"617 +Remove-AESBAlias -Alias "MyAlias" 669 669 670 670 {{/code}} 671 671 672 -Beispiel 2: HinzufügendesRoutingKeys "AnotherKey"fürdie SICS-Verbindung"MyConnection". Dabeiwirdangegeben, dass derRouting Key fürdas Target "AnotherTarget". hinzugefügt wirdund zum Virtual Router "AnotherRouter"gehört621 +Beispiel 2: Entfernen vom Alias "MyAlias" aus dem AESB über die angegebene Verbindung 673 673 674 674 {{code language="powershell"}} 675 - Add-AESBRoutingKey-ConnectionName "MyConnection" -VirtualRouter"AnotherRouter" -TargetName"AnotherTarget" -RoutingKey "AnotherKey"624 +Remove-AESBAlias -ConnectionName "MyConnection" -Alias "MyAlias" 676 676 677 677 {{/code}} 678 678 679 -= Add-AESBRoutingToAlias =628 += Remove-AESBRoutingFromAlias = 680 680 681 - DiesesCmdletwird verwendet, um Routing-Informationenfür den AESB zu konfigurieren,indem ein Routing-Paarmit einem Alias verknüpft wird. Das Routing-PaarbestehtauseinemVirtual Router undeinemRouting Key,diezueinemAliasim QNShinzugefügt werden.630 +Mit diesem Cmdlet können Sie ein Routing-Paar (bestehend aus Virtual Router und Routing Key) von einem Alias im QNS entfernen. Das Routing-Paar wird vollständig gelöscht. 682 682 683 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung684 -|-Alias|string| ❌|A|DerAlias,zudem das Routing-Paarim QNS hinzugefügt werden soll.685 -|-ConnectionName|string| ✅|C|Der Name derSICS-Verbindung,fürdiedas Routing-Paarhinzugefügt werden soll.686 -|-RoutingKey|string| ❌|RK|DerName desRouting Keys, derzusammenmitdemVirtualRouterhinzugefügt werden soll.687 -|-VirtualRouter|string| ❌|VR|DerName desVirtual Router, der zusammen mit demRouting Keyhinzugefügt werden soll.632 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 633 +|-Alias|string|✅|A|Der Name des Alias, von dem das Routing-Paar entfernt werden soll. 634 +|-ConnectionName|string|❌|C|Der Name der Verbindung, die verwendet wird. 635 +|-RoutingKey|string|✅|RK|Der Routing Key, der aus dem Alias entfernt werden soll. 636 +|-VirtualRouter|string|✅|VR|Der Virtual Router, der zusammen mit dem Routing Key entfernt werden soll. 688 688 689 -=== (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** === 690 - 691 -Beispiel 1: Hinzufügen des Routing-Paars zum Alias "MyAlias" für die Standardverbindung. Dabei werden der Routing Key "MyKey" und der Virtual Router "MyRouter" als Routing-Paar verknüpft. 692 - 693 -{{code language="powershell"}} 694 -Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection" 695 -{{/code}} 696 - 697 -Beispiel 2: Hinzufügen des Routing-Paars zum Alias "AnotherAlias" für die SICS-Verbindung "MyConnection". Dabei werden der Routing Key "AnotherKey" und der Virtual Router "AnotherRouter" als Routing-Paar verknüpft. 698 - 699 -{{code language="powershell"}} 700 -Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection" 701 -{{/code}} 702 - 703 -= Add-AESBTarget = 704 - 705 -Dieses Cmdlet wird verwendet, um ein neues Target für eine SICS-Verbindung in einem Virtual Router hinzuzufügen. Dabei wird ein Target Type und Target Name mit einem Routing Key verknüpft. 706 - 707 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 708 -|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll. 709 -|-RoutingKey|string|❌|RK|Der Routing Key, der dem Target zugewiesen wird. 710 -|-TargetName|string|❌|TName|Der Name des Targets, das hinzugefügt werden soll. 711 -|-TargetType|string|❌|TType|Der Typ des Targets, das hinzugefügt werden soll. 712 -|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird. 713 - 714 714 === **Beispiele** === 715 715 716 -Beispiel 1: HinzufügeneinesQueue-Targets "MyTarget" für die Standardverbindung. Das Targetwird demVirtual Router"MyRouter"hinzugefügt undihm wird derRouting Key"MyKey"zugewiesen640 +Beispiel 1: Entfernen vom Routing-Paar mit Virtual Router "MyRouter" und Routing Key "MyRoutingKey" vom Alias "MyAlias" 717 717 718 718 {{code language="powershell"}} 719 - Add-AESBTarget -VirtualRouter "MyRouter" -TargetType"Queue" -TargetName "MyTarget" -RoutingKey"MyKey"643 +Remove-AESBRoutingFromAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" 720 720 721 721 {{/code}} 722 722 723 -Beispiel 2: Hinzufügen eines Queue-Targets "MyTarget"für dieSICS-Verbindung"MyConnection". Das Targetwird demVirtual Router"MyRouter"hinzugefügt undihm wird derRouting Key"MyKey"zugewiesen647 +Beispiel 2: Entfernen vom Routing-Paar mit Virtual Router "MyRouter" und Routing Key "MyRoutingKey" vom Alias "MyAlias" unter Verwendung der Verbindung "MyConnection" 724 724 725 725 {{code language="powershell"}} 726 - Add-AESBTarget -VirtualRouter "AnotherRouter"-TargetType"Queue" -TargetName "AnotherTarget" -RoutingKey"AnotherKey" -ConnectionName "MyConnection"650 +Remove-AESBRoutingFromAlias -Alias "MyAlias" -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" 727 727 728 728 {{/code}} 729 729 730 -= Add-AESBVirtualRouter=654 += Remove-AESBRoutingKey = 731 731 732 - DiesesCmdletwirdverwendet,umeinen neuenVirtual Router innerhalbder angegebenenSICS-Verbindungzukonfigurieren.656 +Mit diesem Cmdlet können Sie einen Routing Key von einem bestimmten Ziel in einem Virtual Router im AESB entfernen. Der Routing Key wird aus der Konfiguration entfernt, die mit dem angegebenen Ziel und Virtual Router verknüpft ist. 733 733 734 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 735 -|-ConnectionName|string|✅|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll. 736 -|-VirtualRouter|string|❌|VR|Der Name des VirtualRouter, der hinzugefügt werden soll. 658 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 659 +|-ConnectionName|string|❌|C|Der Name der Verbindung, die verwendet werden soll. 660 +|-VirtualRouter|string|✅|VR|Der Name des Virtual Routers, von dem der Routing Key entfernt werden soll. 661 +|-TargetName|string|✅|TName|Der Name des Ziels, von dem der Routing Key entfernt werden soll. 662 +|-RoutingKey|string|✅|RK|Der Routing Key, der entfernt werden soll. 737 737 738 738 === **Beispiele** === 739 739 740 -Beispiel 1: Hinzufügen einesVirtual Routers"MyRouter"in der Standardverbindung666 +Beispiel 1: Entfernen vom Routing Key "MyRoutingKey" vom Ziel "MyTarget" im Virtual Router "MyRouter" 741 741 742 742 {{code language="powershell"}} 743 - Add-AESBVirtualRouter -VirtualRouter"MyRouter"669 +Remove-AESBRoutingKey -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey" 744 744 745 745 {{/code}} 746 746 747 -Beispiel 2: Hinzufügen einesVirtual Routers"AnotherRouter"in derSICS-Verbindung "MyConnection"673 +Beispiel 2: Entfernen vom Routing Key "MyRoutingKey" vom Ziel "MyTarget" im Virtual Router "MyRouter" unter Verwendung der Verbindung "MyConnection" 748 748 749 749 {{code language="powershell"}} 750 - Add-AESBVirtualRouter-VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"676 +Remove-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey" 751 751 752 752 {{/code}} 753 753 754 -= ConvertFrom-AESBBase64=680 += Remove-AESBTarget = 755 755 756 - DiesesCmdletwird verwendet,um eineBase64-kodierteZeichenfolgezurückin ihreunkodierteFormzudekodieren.682 +Mit diesem Cmdlet können Sie ein Ziel aus dem Virtual Router des AESB entfernen. 757 757 758 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 759 -|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll. 684 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 685 +|-ConnectionName|string|❌|C|Der Name der Verbindung zum AESB. 686 +|-VirtualRouter|string|✅|VR|Der Name des Virtual Routers, von dem das Ziel entfernt werden soll. 687 +|-TargetName|string|✅|TName|Der Name des Ziels, das entfernt werden soll. 760 760 761 761 === **Beispiele** === 762 762 763 -Beispiel 1: DekodiereneinerBase64-kodiertenZeichenfolge. Zurückgegebenwird derursprünglicheText "HelloWorld!"691 +Beispiel 1: Entfernen vom Ziel "MyTarget" vom Virtual Router "MyRouter" 764 764 765 765 {{code language="powershell"}} 766 -ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh" 767 - 694 +Remove-AESBTarget -VirtualRouter "MyRouter" -TargetName "MyTarget" 768 768 {{/code}} 769 769 770 -Beispiel 2: DekodiereneinerBase64-Zeichenfolgeaus der Variable$base64string. Zurückgegebenwird derursprünglicheText"Somebase64text"697 +Beispiel 2: Entfernen vom Ziel "MyTarget" vom Virtual Router "MyRouter" unter Verwendung der Verbindung "MyConnection" 771 771 772 772 {{code language="powershell"}} 773 -$base64String = "U29tZSBiYXNlNjQgdGV4dA==" 774 -ConvertFrom-AESBBase64 -Input $base64String 700 +Remove-AESBTarget -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" 775 775 {{/code}} 776 776 777 -= ConvertFrom-AESBBase64ToFile =703 += Remove-AESBVirtualRouter = 778 778 779 - DiesesCmdletwird verwendet,umeineBase64-kodierteZeichenfolgezudekodierenund ineiner Datei zu speichern.705 +Mit diesem Cmdlet können Sie einen angegebenen Virtual Router entfernen. 780 780 781 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 782 -|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll. 783 -|-OutputPath|string|❌|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen. 784 -|-Force|switch|✅|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert. 707 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 708 +|ConnectionName|string|❌|C|Gibt den Namen der Verbindung an. 709 +|VirtualRouter|string|✅|VR|Gibt den Namen des zu entfernenden Virtual Router an. 785 785 786 786 === **Beispiele** === 787 787 788 -Beispiel 1: DekodiereneinerBase64-ZeichenfolgeundSpeichernvomursprünglichen Text"HelloWorld!"inderDatei"output.txt" im angegebenen Pfad713 +Beispiel 1: Entfernen vom Virtual Router mit dem Namen "MyRouter" 789 789 790 790 {{code language="powershell"}} 791 - ConvertFrom-AESBBase64ToFile -Input"SGVsbG8gV29ybGQh"-OutputPath"C:\path\to\output.txt"716 +Remove-AESBVirtualRouter -VirtualRouter "MyRouter" 792 792 793 793 {{/code}} 794 794 795 -Beispiel 2: DekodiereneinerBase64-ZeichenfolgeundSpeichernvomursprünglichen Text"Some base64text"inderDatei"output.txt"im angegebenenPfad. Da dieDatei bereits vorhandenist, wird sieüberschrieben720 +Beispiel 2: Entfernen vom Virtual Router mit dem Namen "MyRouter" unter der Verbindung "MyConnection" 796 796 797 797 {{code language="powershell"}} 798 - ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath"C:\path\to\output.txt" -Force723 +Remove-AESBVirtualRouter -ConnectionName "MyConnection" -VirtualRouter "MyRouter" 799 799 {{/code}} 800 800 801 -= ConvertFrom-AESBIcql =726 += Set-AESBBSelfAsAlias = 802 802 803 - DiesesCmdlet wird verwendet, um eineAESBIcql-Zeichenfolgezurückin einPowerShell-Objektzudekodieren.728 +Bei diesem Cmdlet wird ein existierender Alias verwendet, um einen neuen Alias hinzuzufügen. Durch Verwendung des bereits existierenden Alias, müssen so nicht der Routing Key und Virtual Router verwendet werden. 804 804 805 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 806 -|-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll. 730 +{{aagon.warnungsbox}} 731 +Die Parameter RemoveExistingAlias und AddToExistingAlias dürfen nicht gleichzeitig verwendet werden! 732 +{{/aagon.warnungsbox}} 807 807 808 - ===**Beispiele**===734 +**Parameter** 809 809 810 -Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString 736 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 737 +|-Alias|string|✅| |Gibt den Namen vom Alias an 738 +|-RemoveExistingAlias|bool|❌| |Der bestehende Alias wird ersetzt. 739 +|-AddToExistingAlias|bool|❌| |Der Virtual Router und Routing Key wird zu dem angegebenen Alias hinzugefügt 811 811 812 -{{code language="powershell"}} 813 -$icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>" 814 -ConvertFrom-AESBIcql -Icql $icqlString 815 -{{/code}} 816 - 817 -Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben: 818 - 819 -{{code language="none" layout="LINENUMBERS"}} 820 -TargetName : MyTarget 821 -TargetType : Queue 822 -RoutingKey : MyRoutingKey 823 -VirtualRouter : MyRouter 824 -ConnectionName : MyConnection 825 -{{/code}} 826 - 827 -Beispiel 2: Kodieren eines PSCustomObjects in eine Icql-Zeichenfolge und anschließendes dekodieren zurück in ein PSCustomObject. Die resultierenden Daten entsprechen den ursprünglichen Eingabewerten 828 - 829 -{{code language="powershell" layout="LINENUMBERS"}} 830 -# Erstellen eines PSCustomObject mit Beispieldaten 831 -$exampleObject = [PSCustomObject]@{ 832 - TargetName = "MyTarget" 833 - TargetType = "Queue" 834 - RoutingKey = "MyRoutingKey" 835 - VirtualRouter = "MyRouter" 836 - ConnectionName = "MyConnection" 837 -} 838 - 839 -# Konvertieren des Objekts in eine Icql-Zeichenfolge 840 -$x = ConvertTo-AESBIcql -InputObject $exampleObject 841 - 842 -# Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject 843 -$decodedObject = ConvertFrom-AESBIcql -Icql $x 844 - 845 -# Anzeigen des dekodierten Objekts 846 -$decodedObjectConvertFrom-AESBIcql -Icql $icqlString 847 -{{/code}} 848 - 849 -= ConvertTo-AESBBase64 = 850 - 851 -Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren. 852 - 853 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 854 -|-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll. 855 - 856 856 === **Beispiele** === 857 857 858 -Beispiel 1: KodierenderZeichenfolge////"HelloWorld!"// //in Base64.ZurückgegebenwirddieBase64-kodierteVersion743 +Beispiel 1: Überschreiben vom existierenden Alias „AliasName“. Wenn z.B. der vorherige Alias mehrere Virtual Router und Routing Keys hatte, werden diese gelöscht 859 859 860 860 {{code language="powershell"}} 861 -ConvertTo-AESBBase64 -Input "Hello World!" 862 -ConvertFrom-AESBIcql -Icql $icqlString 863 -{{/code}} 746 +Set-AESBSelfAsAlias -Alias "AliasName" -RemoveExistingAlias $true 864 864 865 -Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String 866 - 867 -{{code language="powershell"}} 868 -$string = "Base64 encoding example" 869 -$base64String = ConvertTo-AESBBase64 -Input $string 870 -$base64StringConvertFrom-AESBIcql -Icql $icqlString 871 871 {{/code}} 872 872 873 - =ConvertTo-AESBBase64FromFile=750 +Beispiel 2: Hinzufügen der Virtual Router und Routing Keys vom Alias „AliasName“ zum angegebenen Alias "SelfAliasTest". 874 874 875 -Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren. 876 - 877 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 878 -|-InputPath|string|❌|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll. 879 - 880 -=== **Beispiele** === 881 - 882 -Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge 883 - 884 884 {{code language="powershell"}} 885 -ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt" 886 - 753 +Set-AESBSelfAsAlias -Alias "AliasName" -AddToExistingAlias "SelfAliasTest" 887 887 {{/code}} 888 888 889 - Beispiel2: Kodieren des Inhalts der Datei, deren Pfad in der Variable $filePath gespeichert ist, in Base64. Zurückgegebenwird die Base64-kodierte Zeichenfolge in der Variable$base64String756 += Show-AESBRoutingTable = 890 890 891 -{{code language="powershell"}} 892 -$filePath = "C:\path\to\anotherfile.txt" 893 -$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath 894 -$base64String 895 -{{/code}} 758 +Dieses Cmdlet zeigt die Routing-Tabelle für den angegebenen Virtual Router an. Mit den Parametern ist es möglich, die angezeigten Daten weiter einzuschränken. 896 896 897 - = ConvertTo-AESBIcql =760 +**Parameter** 898 898 899 -Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird. 762 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 763 +|-ConnectionName|string|❌|C|Der Name der Verbindung, die für das Abrufen der Routing-Tabelle verwendet wird. 764 +|-ExchangeType|ExchangeTypes|❌|ET|Der Typ des Exchanges, der angezeigt werden soll. Mögliche Werte sind DIRECT oder ROUTING. 765 +|-VirtualRouter|string|✅|VR|Der Name des Virtual Routers, für den die Routing-Tabelle angezeigt wird. 900 900 901 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 902 -|-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll. 903 - 904 904 === **Beispiele** === 905 905 906 -Beispiel 1: Konvertiertdas PSCustomObjectineine AESB Icql-Zeichenfolgeundgibtdie resultierendeIcql-Zeichenfolge zurück.769 +Beispiel 1: Anzeigen der Routing-Tabelle für den Virtual Router „MyRouter“ 907 907 908 -{{code language="powershell" layout="LINENUMBERS"}} 909 -# Erstellen eines PSCustomObject mit Beispieldaten 910 -$exampleObject = [PSCustomObject]@{ 911 - TargetName = "MyTarget" 912 - TargetType = "Queue" 913 - RoutingKey = "MyRoutingKey" 914 - VirtualRouter = "MyRouter" 915 - ConnectionName = "MyConnection" 916 -} 917 - 918 -# Konvertieren des Objekts in eine Icql-Zeichenfolge 919 -$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject 920 -$icqlString 921 -{{/code}} 922 - 923 -Beispiel 2: Konvertiert das PSCustomObject, das in der Variable $exampleObject gespeichert ist, in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge in der Variable $icqlString zurück. 924 - 925 -{{code language="powershell" layout="LINENUMBERS"}} 926 -# Erstellen eines PSCustomObject mit Beispieldaten 927 -$exampleObject = [PSCustomObject]@{ 928 - TargetName = "MyTarget" 929 - TargetType = "Queue" 930 - RoutingKey = "MyRoutingKey" 931 - VirtualRouter = "MyRouter" 932 - ConnectionName = "MyConnection" 933 -} 934 - 935 -# Konvertieren des Objekts in eine Icql-Zeichenfolge 936 -$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject 937 -$icqlString 938 -{{/code}} 939 - 940 -= Get-AESBActivityLogItemById = 941 - 942 -Gibt den ActivityLog-Eintrag anhand einer ID zurück. 943 - 944 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 945 -|-Id|string|❌| |Die ID des Logeintrags 946 - 947 -=== **Beispiele** === 948 - 949 -Beispiel 1: Abruf eines Log-Eintrags anhand einer ID 950 - 951 951 {{code language="powershell"}} 952 - Get-AESBActivityLogItemById-Id"ItemID"772 +Show-AESBRoutingTable -VirtualRouter "MyRouter" 953 953 954 954 {{/code}} 955 955 956 - =Get-AESBAliasList=776 +Beispiel 2: Anzeigen der Routing-Tabelle für den Virtual Router „MyRouter“ an, wobei nur Einträge vom Typ „DIRECT“ angezeigt werden. Die Verbindung „MyConnection“ wird verwendet. 957 957 958 -Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten. 959 - 960 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 961 -|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll. 962 - 963 -=== **Beispiele** === 964 - 965 -Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung 966 - 967 967 {{code language="powershell"}} 968 - Get-AESBAliasList779 +Show-AESBRoutingTable -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -ExchangeType DIRECT 969 969 970 970 {{/code}} 971 971 972 - Beispiel2: Abrufen einer ListeallerAliase im AESBfür die angegebene Verbindung "MyConnection"783 += Write-AESBActivityLog = 973 973 974 -{{code language="powershell"}} 975 -Get-AESBAliasList -ConnectionName "MyConnection" 785 +Mit diesem Cmdlet wird ein Eintrag in das ActivityLog des AESB geschrieben. Wenn keine ID angegeben wird, wird ein neuer Log-Eintrag erstellt. Falls eine ID angegeben wird, wird der vorhandene Log-Eintrag mit dieser ID aktualisiert. 976 976 977 - {{/code}}787 +**Parameter** 978 978 979 -= Get-AESBVirtualRouters = 789 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 790 +|-ConnectionName|string|❌|C|Der Name der Verbindung, die für die Kommunikation verwendet wird. 791 +|-Id|string|❌|None|Die ID des Log-Eintrags, der aktualisiert werden soll. Wird ein neuer Eintrag erstellt, kann dieser Parameter weggelassen werden. 792 +|-Name|string|✅|N|Der Name des Log-Eintrags. 793 +|-Description|string|✅|D|Die Beschreibung des Log-Eintrags. 794 +|-Status|JobFeedbackResultCode|✅|ST|Der Status des Logs, z.B. "Warning", "Created", "Started", "Running", "Stopping", "Stopped", "Failed" oder "Finished". 795 +|-ComponentName|string|❌|ComName|Der Name der Komponente, die den Log-Eintrag erstellt hat. 980 980 981 -Gibt eine Liste aller VirtualRouter zurück. 982 - 983 983 === **Beispiele** === 984 984 985 -Beispiel 1: Abrufen einerListe allerVirtualRouter799 +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. 986 986 987 987 {{code language="powershell"}} 988 -Get-AESBVirtualRouters 989 - 802 +Write-AESBActivityLog -Name "ProcessStart" -Description "Der Prozess wurde gestartet." -Status Started 990 990 {{/code}} 991 991 992 - =Get-AESBAlias=805 +Beispiel 2: Aktualisieren eines vorhandenen Log-Eintrags mit der ID "12345". Der Log-Eintrag wird auf den Namen "ProcessUpdate", die Beschreibung "Der Prozessstatus wurde aktualisiert" und den Status "Running" gesetzt. Die ID wird verwendet, um den spezifischen Eintrag zu finden und zu aktualisieren. 993 993 994 -Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder. 995 - 996 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 997 -|-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder. 998 - 999 -=== **Beispiele** === 1000 - 1001 -Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName" 1002 - 1003 1003 {{code language="powershell"}} 1004 - Get-AESBAlias -Alias"AliasName"808 +Write-AESBActivityLog -Id "12345" -Name "ProcessUpdate" -Description "Der Prozessstatus wurde aktualisiert." -Status Running 1005 1005 1006 1006 {{/code}} 1007 1007 1008 -= Get-AESBConnectionInfo=812 += Write-AESBBusinessLog = 1009 1009 1010 - DiesesCmdlet wirdverwendet,umDetailsüberdieKonfigurationund denStatus einerVerbindungzuerhalten.814 +Mit diesem Cmdlet wird eine Nachricht in das Business-Log des AESB geschrieben. Jeder Aufruf des Cmdlets erzeugt immer einen neuen Log-Eintrag. 1011 1011 1012 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 1013 -|-ConnectionName|string|✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen. 816 +{{aagon.infobox}} 817 +Das BusinessLog dient zur Information über Prozessabläufe und -ergebnisse durch aussagekräftige Benachrichtigungen. Daher ist es nicht möglich, Objekte in der Nachricht des BusinessLogs auszugeben. 818 +{{/aagon.infobox}} 1014 1014 1015 - ===**Beispiele**===820 +**Parameter** 1016 1016 1017 -Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB 822 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 823 +|-ConnectionName|string|❌|C|Der Name der Verbindung zum AESB. 824 +|-IsError|bool|❌|IsErr|Gibt an, ob die Nachricht als Fehler protokolliert wird. 825 +|-Message|string|✅|M|Die zu protokollierende Nachricht. 826 +|-ComponentId|string|❌|CId|Die ID des Komponenten. 827 +|-ComponentName|string|❌|ComName|Der Name des Komponenten. 828 +|-ComponentPart|string|❌|ComPart|Der Teil des Komponenten. 829 +|-HostId|string|❌|HId|Die ID des Hosts. 830 +|-HostName|string|❌|HN|Der Name des Hosts. 831 +|-Context|string|❌|CT|Der Kontext der Nachricht. 1018 1018 1019 -{{code language="powershell" layout="LINENUMBERS"}} 1020 -Get-AESBConnectionInfo 1021 - 1022 -#Beispiel-Output: 1023 - 1024 - EndPoint VirtualRouter RoutingKey 1025 --------- ------------- ---------- 1026 -wss://localhost:3950 SHELL SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668 1027 -{{/code}} 1028 - 1029 -Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection" 1030 - 1031 -{{code language="powershell"}} 1032 -Get-AESBAliasList -ConnectionName "MyConnection" 1033 - 1034 -{{/code}} 1035 - 1036 -= Get-AESBTargetMessageCount = 1037 - 1038 -Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden. 1039 - 1040 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 1041 -|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll. 1042 -|-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll. 1043 -|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, unter dem das Target läuft. 1044 - 1045 1045 === **Beispiele** === 1046 1046 1047 -Beispiel 1: AbrufenderAnzahlder NachrichtenfürdasTarget "MyTarget" unterdemVirtualRouter"MyRouter"835 +Beispiel 1: Erstellen eines neuen Log-Eintrags im Business-Log mit der Nachricht "System started successfully". Der Log-Eintrag wird dem Komponenten-Namen "MyComponent" und dem Kontext "Initialization" zugeordnet. 1048 1048 1049 1049 {{code language="powershell"}} 1050 -Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget" 1051 -{{/code}} 838 +Write-AESBBusinessLog -Message "System started successfully" -ComponentName "MyComponent" -Context "Initialization" 1052 1052 1053 -Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection" 1054 - 1055 -{{code language="powershell"}} 1056 -Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" 1057 - 1058 1058 {{/code}} 1059 1059 1060 - = Get-AESBTargets=842 +Beispiel 2: Erstellen eines neuen Log-Eintrag im Business-Log, der als Fehler gekennzeichnet ist. Die Nachricht "Error connecting to database" wird dem Komponenten-ID "DBComponent" und dem Host-Namen "Server01" zugeordnet. 1061 1061 1062 -Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten. 1063 - 1064 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 1065 -|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll. 1066 -|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll. 1067 - 1068 -=== **Beispiele** === 1069 - 1070 -Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter" 1071 - 1072 1072 {{code language="powershell"}} 1073 -Get-AESBTargets -VirtualRouter "MyRouter" 1074 - 845 +Write-AESBBusinessLog -IsError $true -Message "Error connecting to database" -ComponentId "DBComponent" -HostName "Server01" 1075 1075 {{/code}} 1076 1076 1077 -Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection" 1078 - 1079 -{{code language="powershell"}} 1080 -Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter" 1081 - 1082 -{{/code}} 1083 - 1084 -= Publish-AESBMessage = 1085 - 1086 - Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden. 1087 - 1088 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 1089 -|-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll. 1090 -|-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll. 1091 -|-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre. 1092 -|-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll. 1093 -|-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird. 1094 -|-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll. 1095 - 1096 - 1097 -Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können: 1098 - 1099 -* ((( 1100 -RoutingParameterSet - Message, VirtualRouter, RoutingKey 1101 -))) 1102 -* ((( 1103 -AliasParameterSet - Message, Alias 1104 -))) 1105 - 1106 -=== **Beispiele** === 1107 - 1108 -Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung 1109 - 1110 -{{code language="powershell"}} 1111 -Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m" 1112 - 1113 -{{/code}} 1114 - 1115 -Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey" und wartet bis zu 1 Stunde auf eine Bestätigung 1116 - 1117 -{{code language="powershell"}} 1118 -Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h" 1119 - 1120 -{{/code}} 1121 - 1122 -= Receive-AESBTargetMessages = 1123 - 1124 -Mit diesem Cmdlet werden Nachrichten von einem Ziel im AESB empfangen. 1125 - 1126 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 1127 -|-ConnectionName|//string//|✅|C|Der Name der Verbindung zum AESB. 1128 -|-MessageCount|//int//|✅|MC|Die Anzahl der Nachrichten, die empfangen werden sollen. 1129 -|-TargetName|//string//|❌|TName|Der Name des Ziels, von dem die Nachrichten empfangen werden. 1130 -|-VirtualRouter|//string//|❌|VR|Der Name des VirtualRouters, der für das Ziel verwendet wird. 1131 - 1132 -=== **Beispiele** === 1133 - 1134 -Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung 1135 - 1136 -{{code language="powershell"}} 1137 -Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m" 1138 - 1139 -{{/code}} 1140 - 1141 -Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey" und wartet bis zu 1 Stunde auf eine Bestätigung 1142 - 1143 -{{code language="powershell"}} 1144 -Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h" 1145 - 1146 -{{/code}} 1147 - 1148 -= Remove-AESBAlias = 1149 - 1150 -Mit diesem Cmdlet wird ein Alias aus dem AESB entfernt. 1151 - 1152 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 1153 -|-Alias|string|❌|A|Der Name des zu entfernenden Alias. 1154 -|-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB. 1155 - 1156 -=== **Beispiele** === 1157 - 1158 -Beispiel 1: Entfernen vom Alias "MyAlias" aus dem AESB 1159 - 1160 -{{code language="powershell"}} 1161 -Remove-AESBAlias -Alias "MyAlias" 1162 - 1163 -{{/code}} 1164 - 1165 -Beispiel 2: Entfernen vom Alias "MyAlias" aus dem AESB über die angegebene Verbindung 1166 - 1167 -{{code language="powershell"}} 1168 -Remove-AESBAlias -ConnectionName "MyConnection" -Alias "MyAlias" 1169 - 1170 -{{/code}} 1171 - 1172 -= Remove-AESBRoutingFromAlias = 1173 - 1174 -= Remove-AESBRoutingKey = 1175 - 1176 -= Remove-AESBTarget = 1177 - 1178 -= Remove-AESBVirtualRouter = 1179 - 1180 -= Set-AESBBSelfAsAlias = 1181 - 1182 -= Show-AESBRoutingTable = 1183 - 1184 -= Write-AESBActivityLog = 1185 - 1186 -= Write-AESBBusinessLog = 848 +

