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 1.AESB Shell.Cmdlet-Dokumentation.WebHome1 +AESB.110.AESB Shell.Cmdlet-Dokumentation.WebHome - Content
-
... ... @@ -3,18 +3,14 @@ 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 - 10 10 = Add-AESBAlias = 11 11 12 12 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. 13 13 14 14 (% style="width:977px" %) 15 -|=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %) Erforderlich|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung16 -|-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.11 +|=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %)Optional|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung 12 +|-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. 18 18 19 19 === **Beispiele** === 20 20 ... ... @@ -36,11 +36,11 @@ 36 36 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. 37 37 38 38 (% style="width:1073px" %) 39 -|=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %) Erforderlich|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung40 -|(% 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.35 +|=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Optional|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung 36 +|(% 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. 44 44 45 45 === (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** === 46 46 ... ... @@ -62,11 +62,11 @@ 62 62 63 63 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"]] 64 64 65 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 9 0px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung66 -|(% style="width:199px" %)-ConnectionName|(% style="width:160px" %)String|(% style="width:9 0px" %)❌|(% 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:9 0px" %)✅|(% 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:9 0px" %)✅|(% 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:9 0px" %)✅|(% style="width:168px" %)Keine|(% style="width:827px" %)Der Routing-Key, der verwendet wird, um Nachrichten an das Queue-Targets zu senden.61 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 62 +|(% 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. 70 70 71 71 === **Beispiele** === 72 72 ... ... @@ -88,11 +88,11 @@ 88 88 89 89 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. 90 90 91 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 9 0px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung92 -|-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.87 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 88 +|-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. 96 96 97 97 === **Beispiele** === 98 98 ... ... @@ -114,11 +114,11 @@ 114 114 115 115 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. 116 116 117 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung118 -|-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.113 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 114 +|-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. 122 122 123 123 === (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** === 124 124 ... ... @@ -138,12 +138,12 @@ 138 138 139 139 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. 140 140 141 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 9 0px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung142 -|-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.137 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 138 +|-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. 147 147 148 148 === **Beispiele** === 149 149 ... ... @@ -165,9 +165,9 @@ 165 165 166 166 Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren. 167 167 168 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 9 0px;" %)Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung169 -|-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.164 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 165 +|-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. 171 171 172 172 === **Beispiele** === 173 173 ... ... @@ -189,8 +189,8 @@ 189 189 190 190 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren. 191 191 192 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung193 -|-Input|string| ✅|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.188 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 189 +|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll. 194 194 195 195 === **Beispiele** === 196 196 ... ... @@ -212,10 +212,10 @@ 212 212 213 213 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern. 214 214 215 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung216 -|-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.211 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 212 +|-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. 219 219 220 220 === **Beispiele** === 221 221 ... ... @@ -236,8 +236,8 @@ 236 236 237 237 Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren. 238 238 239 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung240 -|-Icql|string| ✅|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll.235 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 236 +|-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll. 241 241 242 242 === **Beispiele** === 243 243 ... ... @@ -258,7 +258,7 @@ 258 258 ConnectionName : MyConnection 259 259 {{/code}} 260 260 261 -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 Eingabewerten257 +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 262 262 263 263 {{code language="powershell" layout="LINENUMBERS"}} 264 264 # Erstellen eines PSCustomObject mit Beispieldaten ... ... @@ -284,8 +284,8 @@ 284 284 285 285 Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren. 286 286 287 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung288 -|-Input|string| ✅|In|Die Zeichenfolge, die in Base64 kodiert werden soll.283 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 284 +|-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll. 289 289 290 290 === **Beispiele** === 291 291 ... ... @@ -308,8 +308,8 @@ 308 308 309 309 Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren. 310 310 311 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung312 -|-InputPath|string| ✅|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll.307 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 308 +|-InputPath|string|❌|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll. 313 313 314 314 === **Beispiele** === 315 315 ... ... @@ -332,10 +332,8 @@ 332 332 333 333 Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird. 334 334 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 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. 339 339 340 340 === **Beispiele** === 341 341 ... ... @@ -356,12 +356,29 @@ 356 356 $icqlString 357 357 {{/code}} 358 358 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 + 359 359 = Get-AESBActivityLogItemById = 360 360 361 -Gibt den Activity Log-Eintrag anhand einer ID zurück.372 +Gibt den ActivityLog-Eintrag anhand einer ID zurück. 362 362 363 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung364 -|-Id|string| ✅| |Die ID des Logeintrags374 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 375 +|-Id|string|❌| |Die ID des Logeintrags 365 365 366 366 === **Beispiele** === 367 367 ... ... @@ -376,8 +376,8 @@ 376 376 377 377 Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten. 378 378 379 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung380 -|-ConnectionName|string| ❌|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll.390 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 391 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll. 381 381 382 382 === **Beispiele** === 383 383 ... ... @@ -397,11 +397,11 @@ 397 397 398 398 = Get-AESBVirtualRouters = 399 399 400 -Gibt eine Liste aller Virtual Router zurück.411 +Gibt eine Liste aller VirtualRouter zurück. 401 401 402 402 === **Beispiele** === 403 403 404 -Beispiel 1: Abrufen einer Liste aller Virtual Router415 +Beispiel 1: Abrufen einer Liste aller VirtualRouter 405 405 406 406 {{code language="powershell"}} 407 407 Get-AESBVirtualRouters ... ... @@ -412,8 +412,8 @@ 412 412 413 413 Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder. 414 414 415 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung416 -|-Alias|string| ✅| |Gibt die Informationen zum angegebenen Alias wieder.426 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 427 +|-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder. 417 417 418 418 === **Beispiele** === 419 419 ... ... @@ -428,8 +428,8 @@ 428 428 429 429 Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten. 430 430 431 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung432 -|-ConnectionName|string| ❌|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen.442 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 443 +|-ConnectionName|string|✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen. 433 433 434 434 === **Beispiele** === 435 435 ... ... @@ -456,20 +456,20 @@ 456 456 457 457 Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden. 458 458 459 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung460 -|-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 VirtualRouters, unter dem das Target läuft.470 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 471 +|-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. 463 463 464 464 === **Beispiele** === 465 465 466 -Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual Router "MyRouter"477 +Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" 467 467 468 468 {{code language="powershell"}} 469 469 Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget" 470 470 {{/code}} 471 471 472 -Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem Virtual Router "MyRouter" und der Verbindung "MyConnection"483 +Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection" 473 473 474 474 {{code language="powershell"}} 475 475 Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" ... ... @@ -480,13 +480,13 @@ 480 480 481 481 Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten. 482 482 483 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung484 -|-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.494 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 495 +|-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. 486 486 487 487 === **Beispiele** === 488 488 489 -Beispiel 1: Abrufen der Liste aller Targets unter dem Virtual Router "MyRouter"500 +Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter" 490 490 491 491 {{code language="powershell"}} 492 492 Get-AESBTargets -VirtualRouter "MyRouter" ... ... @@ -493,7 +493,7 @@ 493 493 494 494 {{/code}} 495 495 496 -Beispiel 2: Abrufen der Liste aller Targets für den Virtual Router "MyRouter" und die Verbindung "MyConnection"507 +Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection" 497 497 498 498 {{code language="powershell"}} 499 499 Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter" ... ... @@ -504,15 +504,14 @@ 504 504 505 505 Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden. 506 506 507 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung508 -|-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.518 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 519 +|-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. 514 514 515 -=== Parameter-Sets === 516 516 517 517 Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können: 518 518 ... ... @@ -525,7 +525,7 @@ 525 525 526 526 === **Beispiele** === 527 527 528 -Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"538 +Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" 529 529 530 530 {{code language="powershell"}} 531 531 Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message" ... ... @@ -532,7 +532,7 @@ 532 532 533 533 {{/code}} 534 534 535 -Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey"545 +Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey" 536 536 537 537 {{code language="powershell"}} 538 538 Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" ... ... @@ -539,7 +539,7 @@ 539 539 540 540 {{/code}} 541 541 542 -Beispiel 3: Konvertieren eines P SCustomObject in das ICQL-Format und senden derNachricht an den Alias "MyAlias"552 +(% id="cke_bm_333933S" style="display:none" %) (%%)Beispiel 3: Konvertieren eines PowerShell-Objekts in das ICQL-Format und senden des Objekts an den Alias "MyAlias". 543 543 544 544 {{code language="powershell"}} 545 545 ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias" ... ... @@ -548,301 +548,629 @@ 548 548 549 549 = Publish-AESBMessageAndAwait = 550 550 551 - Mit diesem Cmdletkönnen Sie eine Nachricht an ein bestimmtes Target oder einen Alias im AESBsenden.Anschließendwirdauf eine Bestätigung oder Antwort innerhalb des angegebenen Zeitlimitsgewartet.561 +Sendet eine Nachricht an ein bestimmtes Target oder einen Alias im AESB und wartet auf eine Bestätigung oder Antwort innerhalb des angegebenen Zeitlimits. 552 552 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. 561 561 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 + 562 562 === **Beispiele** === 563 563 564 -Beispiel 1: Senden der Nachricht "Thisis a test message" an denAlias "MyAlias"und wartetbiszu 5 Minutenaufeine Bestätigung587 +Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung 565 565 566 566 {{code language="powershell"}} 567 -Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m" 590 +Add-AESBAlias -Alias "MyAlias" 591 +{{/code}} 568 568 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 + 569 569 {{/code}} 570 570 571 - Beispiel2: Sendender Nachricht "This isatest message" überden Virtual Router "MyRouter" mit dem RoutingKey "MyRoutingKey"und wartet bis zu 1 Stunde auf eine Bestätigung.600 += Add-AESBCallbackTarget = 572 572 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 + 573 573 {{code language="powershell"}} 574 - Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This isatest message" -Timeout "1h"616 +Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1" 575 575 576 576 {{/code}} 577 577 578 - =Receive-AESBTargetMessages=620 +Beispiel 2: Hinzufügen eines Callback-Targets "CallbackTarget1" zur SICS-Verbindung "MyConnection". Dabei wird das Callback-Target über den Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet 579 579 580 -Mit diesem Cmdlet können Sie Nachrichten von einem Ziel im AESB empfangen. 622 +{{code language="powershell"}} 623 +Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1" 581 581 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. 625 +{{/code}} 587 587 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 + 588 588 === **Beispiele** === 589 589 590 -Beispiel 1: EmpfangenvonNachrichtenvomZielmitdemNamen"MyTarget",dasdem Virtual Router "MyRouter" zugeordnetist639 +Beispiel 1: Hinzufügen eines Queue-Targets "QueueTarget1" zur Standardverbindung. Dabei wird das Queue-Target über den Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet 591 591 592 592 {{code language="powershell"}} 593 - Receive-AESBTargetMessages-VirtualRouter "MyRouter" -TargetName "MyTarget"642 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1" 594 594 595 595 {{/code}} 596 596 597 -Beispiel 2: Empfangenvon biszu10 Nachrichtenvom ZielmitdemNamen"MyTarget",dasdem Virtual Router "MyRouter" zugeordnetist646 +Beispiel 2: Hinzufügen eines Queue-Targets "QueueTarget1" zur SICS-Verbindung "MyConnection". Dabei wird das Queue-Target über den Routing-Key "Key1" zum Virtual Router "Router1" zugeordnet 598 598 599 599 {{code language="powershell"}} 600 - Receive-AESBTargetMessages-VirtualRouter "MyRouter" -TargetName "MyTarget" -MessageCount 10649 +Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1" 601 601 602 602 {{/code}} 603 603 604 -= Remove-AESBAlias=653 += Add-AESBRoutingKey = 605 605 606 - Mit diesemCmdletkönnenSie einenAliasausdemAESB entfernen.655 +Dieses Cmdlet wird verwendet, um Routing-Informationen für ein [[AESB-Target>>doc:||anchor="HAdd-AESBTarget"]] zu konfigurieren. Dabei wird ein RoutingKey zu einem Target in einem VirtualRouter hinzugefügt. 607 607 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. 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. 611 611 612 612 === **Beispiele** === 613 613 614 -Beispiel 1: EntfernenvomAlias "MyAlias"ausdemAESB665 +Beispiel 1: Hinzufügen des Routing Keys "Key1" für die Standardverbindung. Dabei wird angegeben, dass der Routing Key für das Target "MyTarget". hinzugefügt wird und zum Virtual Router "Router1" gehört 615 615 616 616 {{code language="powershell"}} 617 - Remove-AESBAlias-Alias"MyAlias"668 +Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1" 618 618 619 619 {{/code}} 620 620 621 -Beispiel 2: Entfernenvom Alias "MyAlias"ausdemAESB überdie angegebeneVerbindung672 +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 622 622 623 623 {{code language="powershell"}} 624 - Remove-AESBAlias-ConnectionName "MyConnection" -Alias"MyAlias"675 +Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" 625 625 626 626 {{/code}} 627 627 628 -= Remove-AESBRoutingFromAlias =679 += Add-AESBRoutingToAlias = 629 629 630 - Mit diesemCmdletkönnen Sie ein Routing-Paar(bestehendausVirtual Router undRouting Key)voneinemAliasim QNSentfernen. Das Routing-Paarwirdvollständig gelöscht.681 +Dieses Cmdlet wird verwendet, um Routing-Informationen für den AESB zu konfigurieren, indem ein Routing-Paar mit einem Alias verknüpft wird. Das Routing-Paar besteht aus einem Virtual Router und einem Routing Key, die zu einem Alias im QNS hinzugefügt werden. 631 631 632 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %) Erforderlich|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung633 -|-Alias|string| ✅|A|DerName desAlias,vondem das Routing-Paarentfernt werden soll.634 -|-ConnectionName|string| ❌|C|Der Name der Verbindung, dieverwendet wird.635 -|-RoutingKey|string| ✅|RK|Der Routing Key, deraus demAliasentfernt werden soll.636 -|-VirtualRouter|string| ✅|VR|Der Virtual Router, der zusammen mit demRouting Keyentfernt werden soll.683 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 684 +|-Alias|string|❌|A|Der Alias, zu dem das Routing-Paar im QNS hinzugefügt werden soll. 685 +|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Routing-Paar hinzugefügt werden soll. 686 +|-RoutingKey|string|❌|RK|Der Name des Routing Keys, der zusammen mit dem Virtual Router hinzugefügt werden soll. 687 +|-VirtualRouter|string|❌|VR|Der Name des Virtual Router, der zusammen mit dem Routing Key hinzugefügt werden soll. 637 637 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 + 638 638 === **Beispiele** === 639 639 640 -Beispiel 1: Entfernenvom Routing-PaarmitVirtual Router"MyRouter" undRouting Key"MyRoutingKey"vom Alias"MyAlias"716 +Beispiel 1: Hinzufügen eines Queue-Targets "MyTarget" für die Standardverbindung. Das Target wird dem Virtual Router "MyRouter" hinzugefügt und ihm wird der Routing Key "MyKey" zugewiesen 641 641 642 642 {{code language="powershell"}} 643 - Remove-AESBRoutingFromAlias-Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"719 +Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey" 644 644 645 645 {{/code}} 646 646 647 -Beispiel 2: Entfernenvom Routing-PaarmitVirtual Router"MyRouter" undRouting Key"MyRoutingKey"vom Alias "MyAlias"unter Verwendung der Verbindung "MyConnection"723 +Beispiel 2: Hinzufügen eines Queue-Targets "MyTarget" für die SICS-Verbindung "MyConnection". Das Target wird dem Virtual Router "MyRouter" hinzugefügt und ihm wird der Routing Key "MyKey" zugewiesen 648 648 649 649 {{code language="powershell"}} 650 - Remove-AESBRoutingFromAlias-Alias"MyAlias" -ConnectionName "MyConnection" -VirtualRouter"MyRouter" -RoutingKey"MyRoutingKey"726 +Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection" 651 651 652 652 {{/code}} 653 653 654 -= Remove-AESBRoutingKey=730 += Add-AESBVirtualRouter = 655 655 656 - Mit diesemCmdletkönnen SieeinenRoutingKey von einembestimmtenZiel ineinemVirtual Router im AESB entfernen. DerRouting Key wirdausderKonfigurationentfernt, die mit dem angegebenenZiel undVirtualRouterverknüpft ist.732 +Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren. 657 657 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. 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. 663 663 664 664 === **Beispiele** === 665 665 666 -Beispiel 1: Entfernenvom Routing Key "MyRoutingKey"vom Ziel "MyTarget" imVirtual Router "MyRouter"740 +Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung 667 667 668 668 {{code language="powershell"}} 669 - Remove-AESBRoutingKey -VirtualRouter"MyRouter"-TargetName "MyTarget" -RoutingKey"MyRoutingKey"743 +Add-AESBVirtualRouter -VirtualRouter "MyRouter" 670 670 671 671 {{/code}} 672 672 673 -Beispiel 2: Entfernenvom Routing Key "MyRoutingKey"vom Ziel "MyTarget" imVirtual Router "MyRouter"unterVerwendungder Verbindung "MyConnection"747 +Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection" 674 674 675 675 {{code language="powershell"}} 676 - Remove-AESBRoutingKey-ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" -RoutingKey "MyRoutingKey"750 +Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection" 677 677 678 678 {{/code}} 679 679 680 -= Remove-AESBTarget=754 += ConvertFrom-AESBBase64 = 681 681 682 - Mit diesemCmdletkönnenSie einZielausdemVirtualRouter des AESBentfernen.756 +Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren. 683 683 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. 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. 688 688 689 689 === **Beispiele** === 690 690 691 -Beispiel 1: EntfernenvomZiel"MyTarget"vom VirtualRouter"MyRouter"763 +Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!" 692 692 693 693 {{code language="powershell"}} 694 -Remove-AESBTarget -VirtualRouter "MyRouter" -TargetName "MyTarget" 766 +ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh" 767 + 695 695 {{/code}} 696 696 697 -Beispiel 2: EntfernenvomZiel"MyTarget"vomVirtualRouter"MyRouter" unterVerwendungderVerbindung "MyConnection"770 +Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text" 698 698 699 699 {{code language="powershell"}} 700 -Remove-AESBTarget -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" 773 +$base64String = "U29tZSBiYXNlNjQgdGV4dA==" 774 +ConvertFrom-AESBBase64 -Input $base64String 701 701 {{/code}} 702 702 703 -= Remove-AESBVirtualRouter=777 += ConvertFrom-AESBBase64ToFile = 704 704 705 - Mit diesemCmdletkönnenSieeinenangegebenenVirtualRouter entfernen.779 +Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern. 706 706 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. 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. 710 710 711 711 === **Beispiele** === 712 712 713 -Beispiel 1: Entfernen vomVirtualRoutermitdemNamen"MyRouter"788 +Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad 714 714 715 715 {{code language="powershell"}} 716 - Remove-AESBVirtualRouter-VirtualRouter"MyRouter"791 +ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt" 717 717 718 718 {{/code}} 719 719 720 -Beispiel 2: Entfernen vomVirtualRoutermitdemNamen"MyRouter"unterderVerbindung"MyConnection"795 +Beispiel 2: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Some base64 text" in der Datei "output.txt" im angegebenen Pfad. Da die Datei bereits vorhanden ist, wird sie überschrieben 721 721 722 722 {{code language="powershell"}} 723 - Remove-AESBVirtualRouter-ConnectionName"MyConnection" -VirtualRouter"MyRouter"798 +ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force 724 724 {{/code}} 725 725 726 -= Set-AESBBSelfAsAlias=801 += ConvertFrom-AESBIcql = 727 727 728 - BeidiesemCmdlet wirdein existierender Aliasverwendet, um einenneuenAliashinzuzufügen.DurchVerwendungdes bereitsexistierenden Alias, müssen so nichtder RoutingKey undVirtual Routerverwendet werden.803 +Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren. 729 729 730 -{{aagon.warnungsbox}} 731 -Die Parameter RemoveExistingAlias und AddToExistingAlias dürfen nicht gleichzeitig verwendet werden! 732 -{{/aagon.warnungsbox}} 805 +|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 806 +|-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll. 733 733 734 -** Parameter**808 +=== **Beispiele** === 735 735 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 810 +Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString 740 740 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 + 741 741 === **Beispiele** === 742 742 743 -Beispiel 1: ÜberschreibenvomexistierendenAlias „AliasName“.Wenn z.B. der vorherige AliasmehrereVirtual Router undRouting Keyshatte, werden diesegelöscht858 +Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version 744 744 745 745 {{code language="powershell"}} 746 -Set-AESBSelfAsAlias -Alias "AliasName" -RemoveExistingAlias $true 861 +ConvertTo-AESBBase64 -Input "Hello World!" 862 +ConvertFrom-AESBIcql -Icql $icqlString 863 +{{/code}} 747 747 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 748 748 {{/code}} 749 749 750 - Beispiel2: Hinzufügen derVirtual Router und Routing Keys vomAlias„AliasName“ zumangegebenen Alias "SelfAliasTest".873 += ConvertTo-AESBBase64FromFile = 751 751 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 + 752 752 {{code language="powershell"}} 753 -Set-AESBSelfAsAlias -Alias "AliasName" -AddToExistingAlias "SelfAliasTest" 885 +ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt" 886 + 754 754 {{/code}} 755 755 756 - =Show-AESBRoutingTable=889 +Beispiel 2: Kodieren des Inhalts der Datei, deren Pfad in der Variable $filePath gespeichert ist, in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String 757 757 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. 891 +{{code language="powershell"}} 892 +$filePath = "C:\path\to\anotherfile.txt" 893 +$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath 894 +$base64String 895 +{{/code}} 759 759 760 - **Parameter**897 += ConvertTo-AESBIcql = 761 761 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. 899 +Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird. 766 766 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 + 767 767 === **Beispiele** === 768 768 769 -Beispiel 1: Anzeigen derRouting-TabellefürdenVirtualRouter„MyRouter“906 +Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück. 770 770 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 + 771 771 {{code language="powershell"}} 772 - Show-AESBRoutingTable -VirtualRouter"MyRouter"952 +Get-AESBActivityLogItemById -Id "ItemID" 773 773 774 774 {{/code}} 775 775 776 - Beispiel2: Anzeigen der Routing-Tabelle für den Virtual Router „MyRouter“ an, wobeinur Einträgevom Typ „DIRECT“ angezeigt werden. Die Verbindung „MyConnection“ wird verwendet.956 += Get-AESBAliasList = 777 777 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 + 778 778 {{code language="powershell"}} 779 - Show-AESBRoutingTable -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -ExchangeType DIRECT968 +Get-AESBAliasList 780 780 781 781 {{/code}} 782 782 783 - =Write-AESBActivityLog=972 +Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection" 784 784 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. 974 +{{code language="powershell"}} 975 +Get-AESBAliasList -ConnectionName "MyConnection" 786 786 787 - **Parameter**977 +{{/code}} 788 788 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. 979 += Get-AESBVirtualRouters = 796 796 981 +Gibt eine Liste aller VirtualRouter zurück. 982 + 797 797 === **Beispiele** === 798 798 799 -Beispiel 1: Erstellen eines neuenLog-Eintrags. DerEintrag 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.985 +Beispiel 1: Abrufen einer Liste aller VirtualRouter 800 800 801 801 {{code language="powershell"}} 802 -Write-AESBActivityLog -Name "ProcessStart" -Description "Der Prozess wurde gestartet." -Status Started 988 +Get-AESBVirtualRouters 989 + 803 803 {{/code}} 804 804 805 - Beispiel2: Aktualisieren eines vorhandenen Log-Eintrags mit der ID "12345". Der Log-Eintrag wird auf den Namen "ProcessUpdate", dieBeschreibung "Der Prozessstatus wurde aktualisiert" und den Status"Running" gesetzt. Die ID wird verwendet, um den spezifischen Eintrag zu finden und zu aktualisieren.992 += Get-AESBAlias = 806 806 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 + 807 807 {{code language="powershell"}} 808 - Write-AESBActivityLog -Id "12345" -Name "ProcessUpdate"-Description "Der Prozessstatuswurde aktualisiert."-Status Running1004 +Get-AESBAlias -Alias "AliasName" 809 809 810 810 {{/code}} 811 811 812 -= Write-AESBBusinessLog=1008 += Get-AESBConnectionInfo = 813 813 814 - Mit diesemCmdlet wirdeineNachrichtindasBusiness-LogdesAESBgeschrieben.Jeder AufrufdesCmdlets erzeugtimmer einenneuenLog-Eintrag.1010 +Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten. 815 815 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}} 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. 819 819 820 -** Parameter**1015 +=== **Beispiele** === 821 821 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. 1017 +Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB 832 832 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 + 833 833 === **Beispiele** === 834 834 835 -Beispiel 1: Erstellen einesneuen Log-Eintragsim Business-Log mitder Nachricht"Systemstarted successfully". DerLog-Eintragwird dem Komponenten-Namen"MyComponent" unddemKontext "Initialization" zugeordnet.1047 +Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" 836 836 837 837 {{code language="powershell"}} 838 -Write-AESBBusinessLog -Message "System started successfully" -ComponentName "MyComponent" -Context "Initialization" 1050 +Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget" 1051 +{{/code}} 839 839 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 + 840 840 {{/code}} 841 841 842 - Beispiel2: Erstellen eines neuen Log-Eintrag imBusiness-Log, derals Fehlergekennzeichnetist.Die Nachricht "Error connecting to database" wird dem Komponenten-ID "DBComponent" und dem Host-Namen "Server01" zugeordnet.1060 += Get-AESBTargets = 843 843 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 + 844 844 {{code language="powershell"}} 845 -Write-AESBBusinessLog -IsError $true -Message "Error connecting to database" -ComponentId "DBComponent" -HostName "Server01" 1073 +Get-AESBTargets -VirtualRouter "MyRouter" 1074 + 846 846 {{/code}} 847 847 848 - 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 =

