Wiki source code of Operative Cmdlets

Version 19.1 by jklein on 2024/12/16 14:56

Hide last authors
jklein 1.1 1 {{aagon.floatingbox/}}
jklein 2.1 2
jklein 3.1 3 (% class="wikigeneratedid" %)
jklein 4.1 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.
jklein 2.1 5
jklein 3.1 6 = Add-AESBAlias =
7
jklein 5.1 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
jklein 14.1 10 (% style="width:977px" %)
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.
jklein 5.1 14
15 === **Beispiele** ===
16
17 Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung
18
19 {{code language="powershell"}}
20 Add-AESBAlias -Alias "MyAlias"
21 {{/code}}
22
23 Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection"
24
25 {{code language="powershell"}}
26 Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection"
27
28 {{/code}}
29
jklein 2.1 30 = Add-AESBCallbackTarget =
31
jklein 5.1 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
jklein 13.1 34 (% style="width:1073px" %)
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.
jklein 5.1 40
41 === (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** ===
42
43 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
44
45 {{code language="powershell"}}
46 Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
47
48 {{/code}}
49
50 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
51
52 {{code language="powershell"}}
53 Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
54
55 {{/code}}
56
jklein 2.1 57 = Add-AESBQueueTarget =
58
jklein 9.1 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"]]
jklein 6.1 60
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.
66
67 === **Beispiele** ===
68
69 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
70
71 {{code language="powershell"}}
72 Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
73
74 {{/code}}
75
76 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
77
78 {{code language="powershell"}}
79 Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
80
81 {{/code}}
82
jklein 2.1 83 = Add-AESBRoutingKey =
84
jklein 7.1 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
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.
92
93 === **Beispiele** ===
94
95 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
96
97 {{code language="powershell"}}
98 Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
99
100 {{/code}}
101
102 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
103
104 {{code language="powershell"}}
105 Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"
106
107 {{/code}}
108
jklein 2.1 109 = Add-AESBRoutingToAlias =
110
jklein 9.1 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.
jklein 7.1 112
jklein 9.1 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.
jklein 7.1 118
jklein 9.1 119 === (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** ===
jklein 7.1 120
jklein 9.1 121 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.
jklein 7.1 122
jklein 9.1 123 {{code language="powershell"}}
124 Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection"
125 {{/code}}
jklein 7.1 126
jklein 10.1 127 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.
jklein 7.1 128
jklein 10.1 129 {{code language="powershell"}}
130 Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
131 {{/code}}
jklein 8.1 132
jklein 10.1 133 = Add-AESBTarget =
jklein 9.1 134
jklein 10.1 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.
jklein 9.1 136
jklein 10.1 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.
jklein 2.1 143
jklein 10.1 144 === **Beispiele** ===
145
146 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
147
148 {{code language="powershell"}}
149 Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"
150
151 {{/code}}
152
153 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
154
155 {{code language="powershell"}}
156 Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
157
158 {{/code}}
159
jklein 2.1 160 = Add-AESBVirtualRouter =
161
jklein 11.1 162 Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
jklein 10.1 163
jklein 11.1 164 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
jklein 15.1 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.
jklein 10.1 167
jklein 15.1 168 === **Beispiele** ===
jklein 10.1 169
jklein 15.1 170 Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung
171
172 {{code language="powershell"}}
173 Add-AESBVirtualRouter -VirtualRouter "MyRouter"
174
175 {{/code}}
176
177 Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
178
179 {{code language="powershell"}}
180 Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
181
182 {{/code}}
183
jklein 2.1 184 = ConvertFrom-AESBBase64 =
185
jklein 15.1 186 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
187
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.
190
191 === **Beispiele** ===
192
193 Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"
194
195 {{code language="powershell"}}
196 ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
197
198 {{/code}}
199
200 Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
201
202 {{code language="powershell"}}
203 $base64String = "U29tZSBiYXNlNjQgdGV4dA=="
204 ConvertFrom-AESBBase64 -Input $base64String
205 {{/code}}
206
jklein 2.1 207 = ConvertFrom-AESBBase64ToFile =
208
jklein 15.2 209 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
210
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.
215
216 === **Beispiele** ===
217
218 Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
219
220 {{code language="powershell"}}
221 ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
222
223 {{/code}}
224
225 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
226
227 {{code language="powershell"}}
228 ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
229 {{/code}}
230
jklein 2.1 231 = ConvertFrom-AESBIcql =
232
jklein 15.2 233 Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
234
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.
237
238 === **Beispiele** ===
239
240 Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
241
242 {{code language="powershell"}}
243 $icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>"
244 ConvertFrom-AESBIcql -Icql $icqlString
245 {{/code}}
246
247 Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
248
249 {{code language="none" layout="LINENUMBERS"}}
250 TargetName : MyTarget
251 TargetType : Queue
252 RoutingKey : MyRoutingKey
253 VirtualRouter : MyRouter
254 ConnectionName : MyConnection
255 {{/code}}
256
jklein 16.1 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 Eingabewerten
jklein 15.2 258
jklein 16.1 259 {{code language="powershell" layout="LINENUMBERS"}}
260 # Erstellen eines PSCustomObject mit Beispieldaten
261 $exampleObject = [PSCustomObject]@{
262 TargetName = "MyTarget"
263 TargetType = "Queue"
264 RoutingKey = "MyRoutingKey"
265 VirtualRouter = "MyRouter"
266 ConnectionName = "MyConnection"
267 }
268
269 # Konvertieren des Objekts in eine Icql-Zeichenfolge
270 $x = ConvertTo-AESBIcql -InputObject $exampleObject
271
272 # Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject
273 $decodedObject = ConvertFrom-AESBIcql -Icql $x
274
275 # Anzeigen des dekodierten Objekts
276 $decodedObjectConvertFrom-AESBIcql -Icql $icqlString
277 {{/code}}
jklein 15.2 278
jklein 2.1 279 = ConvertTo-AESBBase64 =
280
jklein 16.1 281 Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
282
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.
285
286 === **Beispiele** ===
287
288 Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
289
290 {{code language="powershell"}}
291 ConvertTo-AESBBase64 -Input "Hello World!"
292 ConvertFrom-AESBIcql -Icql $icqlString
293 {{/code}}
294
295 Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
296
297 {{code language="powershell"}}
298 $string = "Base64 encoding example"
299 $base64String = ConvertTo-AESBBase64 -Input $string
300 $base64StringConvertFrom-AESBIcql -Icql $icqlString
301 {{/code}}
302
jklein 2.1 303 = ConvertTo-AESBBase64FromFile =
304
jklein 17.1 305 Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.
306
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.
309
310 === **Beispiele** ===
311
312 Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge
313
314 {{code language="powershell"}}
315 ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
316
317 {{/code}}
318
319 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
320
321 {{code language="powershell"}}
322 $filePath = "C:\path\to\anotherfile.txt"
323 $base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
324 $base64String
325 {{/code}}
326
jklein 2.1 327 = ConvertTo-AESBIcql =
328
jklein 17.2 329 Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
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.
333
334 === **Beispiele** ===
335
336 Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
337
338 {{code language="powershell" layout="LINENUMBERS"}}
339 # Erstellen eines PSCustomObject mit Beispieldaten
340 $exampleObject = [PSCustomObject]@{
341 TargetName = "MyTarget"
342 TargetType = "Queue"
343 RoutingKey = "MyRoutingKey"
344 VirtualRouter = "MyRouter"
345 ConnectionName = "MyConnection"
346 }
347
348 # Konvertieren des Objekts in eine Icql-Zeichenfolge
349 $icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
350 $icqlString
351 {{/code}}
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
jklein 2.1 370 = Get-AESBActivityLogItemById =
371
jklein 18.1 372 Gibt den ActivityLog-Eintrag anhand einer ID zurück.
373
374 |=(% 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
376
377 === **Beispiele** ===
378
379 Beispiel 1: Abruf eines Log-Eintrags anhand einer ID
380
381 {{code language="powershell"}}
382 Get-AESBActivityLogItemById -Id "ItemID"
383
384 {{/code}}
385
jklein 2.1 386 = Get-AESBAliasList =
387
jklein 18.1 388 Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.
389
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.
392
393 === **Beispiele** ===
394
jklein 18.2 395 Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung
jklein 18.1 396
397 {{code language="powershell"}}
398 Get-AESBAliasList
399
400 {{/code}}
401
jklein 18.2 402 Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
jklein 18.1 403
404 {{code language="powershell"}}
405 Get-AESBAliasList -ConnectionName "MyConnection"
406
407 {{/code}}
408
jklein 2.1 409 = Get-AESBVirtualRouters =
410
jklein 18.1 411 Gibt eine Liste aller VirtualRouter zurück.
412
413 === **Beispiele** ===
414
415 Beispiel 1: Abrufen einer Liste aller VirtualRouter
416
417 {{code language="powershell"}}
418 Get-AESBVirtualRouters
419
420 {{/code}}
421
jklein 2.1 422 = Get-AESBAlias =
423
jklein 18.1 424 Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.
425
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.
428
429 === **Beispiele** ===
430
431 Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"
432
433 {{code language="powershell"}}
434 Get-AESBAlias -Alias "AliasName"
435
436 {{/code}}
437
jklein 2.1 438 = Get-AESBConnectionInfo =
439
jklein 18.2 440 Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.
441
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.
444
445 === **Beispiele** ===
446
447 Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB
448
449 {{code language="powershell" layout="LINENUMBERS"}}
450 Get-AESBConnectionInfo
451
452 #Beispiel-Output:
453
454 EndPoint VirtualRouter RoutingKey
455 -------- ------------- ----------
456 wss://localhost:3950 SHELL SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668
457 {{/code}}
458
459 Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"
460
461 {{code language="powershell"}}
462 Get-AESBAliasList -ConnectionName "MyConnection"
463
464 {{/code}}
465
jklein 2.1 466 = Get-AESBTargetMessageCount =
467
jklein 18.2 468 Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.
469
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.
474
475 === **Beispiele** ===
476
477 Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"
478
jklein 18.3 479 {{code language="powershell"}}
jklein 18.2 480 Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
481 {{/code}}
482
jklein 18.3 483 Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"
jklein 18.2 484
485 {{code language="powershell"}}
486 Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
487
488 {{/code}}
489
jklein 2.1 490 = Get-AESBTargets =
491
jklein 18.3 492 Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.
493
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.
497
498 === **Beispiele** ===
499
500 Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
501
502 {{code language="powershell"}}
503 Get-AESBTargets -VirtualRouter "MyRouter"
504
505 {{/code}}
506
507 Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"
508
509 {{code language="powershell"}}
510 Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
511
512 {{/code}}
513
jklein 2.1 514 = Publish-AESBMessage =
515
jklein 18.3 516 Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.
517
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.
525
526
jklein 18.4 527 Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
jklein 18.3 528
jklein 18.4 529 * (((
530 RoutingParameterSet - Message, VirtualRouter, RoutingKey
531 )))
532 * (((
533 AliasParameterSet - Message, Alias
534 )))
jklein 18.3 535
jklein 18.4 536 === **Beispiele** ===
537
538 Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"
539
540 {{code language="powershell"}}
541 Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message"
542
543 {{/code}}
544
545 Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey"
546
547 {{code language="powershell"}}
548 Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message"
549
550 {{/code}}
551
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".
553
554 {{code language="powershell"}}
555 ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias"
556
557 {{/code}}
558
jklein 2.1 559 = Publish-AESBMessageAndAwait =
560
jklein 18.4 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.
562
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 === **Beispiele** ===
586
587 Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung
588
589 {{code language="powershell"}}
590 Add-AESBAlias -Alias "MyAlias"
591 {{/code}}
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 {{/code}}
599
600 = Add-AESBCallbackTarget =
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 {{code language="powershell"}}
616 Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
617
618 {{/code}}
619
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
621
622 {{code language="powershell"}}
623 Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
624
625 {{/code}}
626
627 = Add-AESBQueueTarget =
628
629 Dieses Cmdlet fügt ein neues Target zu einer SICS-Verbindung hinzu. Innerhalb dieses Targets ist eine Queue enthalten, in der Nachrichten weiterverarbeitet werden, die an das Target gesendet werden. Daher handelt es sich bei diesem Cmdlet um eine spezifische Form eines [[AESB-Targets.>>doc:||anchor="HAdd-AESBTarget"]]
630
631 |=(% 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 === **Beispiele** ===
638
639 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
640
641 {{code language="powershell"}}
642 Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
643
644 {{/code}}
645
646 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
647
648 {{code language="powershell"}}
649 Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
650
651 {{/code}}
652
653 = Add-AESBRoutingKey =
654
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.
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.
662
663 === **Beispiele** ===
664
665 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
666
667 {{code language="powershell"}}
668 Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
669
670 {{/code}}
671
672 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
673
674 {{code language="powershell"}}
675 Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"
676
677 {{/code}}
678
679 = Add-AESBRoutingToAlias =
680
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.
682
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.
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 === **Beispiele** ===
715
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
717
718 {{code language="powershell"}}
719 Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"
720
721 {{/code}}
722
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
724
725 {{code language="powershell"}}
726 Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
727
728 {{/code}}
729
730 = Add-AESBVirtualRouter =
731
732 Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
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.
737
738 === **Beispiele** ===
739
740 Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung
741
742 {{code language="powershell"}}
743 Add-AESBVirtualRouter -VirtualRouter "MyRouter"
744
745 {{/code}}
746
747 Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
748
749 {{code language="powershell"}}
750 Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
751
752 {{/code}}
753
754 = ConvertFrom-AESBBase64 =
755
756 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
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.
760
761 === **Beispiele** ===
762
763 Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"
764
765 {{code language="powershell"}}
766 ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
767
768 {{/code}}
769
770 Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
771
772 {{code language="powershell"}}
773 $base64String = "U29tZSBiYXNlNjQgdGV4dA=="
774 ConvertFrom-AESBBase64 -Input $base64String
775 {{/code}}
776
777 = ConvertFrom-AESBBase64ToFile =
778
779 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
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.
785
786 === **Beispiele** ===
787
788 Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
789
790 {{code language="powershell"}}
791 ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
792
793 {{/code}}
794
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
796
797 {{code language="powershell"}}
798 ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
799 {{/code}}
800
801 = ConvertFrom-AESBIcql =
802
803 Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
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.
807
808 === **Beispiele** ===
809
810 Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
811
812 {{code language="powershell"}}
813 $icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>"
814 ConvertFrom-AESBIcql -Icql $icqlString
815 {{/code}}
816
817 Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
818
819 {{code language="none" layout="LINENUMBERS"}}
820 TargetName : MyTarget
821 TargetType : Queue
822 RoutingKey : MyRoutingKey
823 VirtualRouter : MyRouter
824 ConnectionName : MyConnection
825 {{/code}}
826
827 Beispiel 2: Kodieren eines PSCustomObjects in eine Icql-Zeichenfolge und anschließendes dekodieren zurück in ein PSCustomObject. Die resultierenden Daten entsprechen den ursprünglichen Eingabewerten
828
829 {{code language="powershell" layout="LINENUMBERS"}}
830 # Erstellen eines PSCustomObject mit Beispieldaten
831 $exampleObject = [PSCustomObject]@{
832 TargetName = "MyTarget"
833 TargetType = "Queue"
834 RoutingKey = "MyRoutingKey"
835 VirtualRouter = "MyRouter"
836 ConnectionName = "MyConnection"
837 }
838
839 # Konvertieren des Objekts in eine Icql-Zeichenfolge
840 $x = ConvertTo-AESBIcql -InputObject $exampleObject
841
842 # Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject
843 $decodedObject = ConvertFrom-AESBIcql -Icql $x
844
845 # Anzeigen des dekodierten Objekts
846 $decodedObjectConvertFrom-AESBIcql -Icql $icqlString
847 {{/code}}
848
849 = ConvertTo-AESBBase64 =
850
851 Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
852
853 |=(% 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 === **Beispiele** ===
857
858 Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
859
860 {{code language="powershell"}}
861 ConvertTo-AESBBase64 -Input "Hello World!"
862 ConvertFrom-AESBIcql -Icql $icqlString
863 {{/code}}
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 {{/code}}
872
873 = ConvertTo-AESBBase64FromFile =
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 {{code language="powershell"}}
885 ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
886
887 {{/code}}
888
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
890
891 {{code language="powershell"}}
892 $filePath = "C:\path\to\anotherfile.txt"
893 $base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
894 $base64String
895 {{/code}}
896
897 = ConvertTo-AESBIcql =
898
899 Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
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 === **Beispiele** ===
905
906 Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
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 {{code language="powershell"}}
952 Get-AESBActivityLogItemById -Id "ItemID"
953
954 {{/code}}
955
956 = Get-AESBAliasList =
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 {{code language="powershell"}}
968 Get-AESBAliasList
969
970 {{/code}}
971
972 Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
973
974 {{code language="powershell"}}
975 Get-AESBAliasList -ConnectionName "MyConnection"
976
977 {{/code}}
978
979 = Get-AESBVirtualRouters =
980
981 Gibt eine Liste aller VirtualRouter zurück.
982
983 === **Beispiele** ===
984
985 Beispiel 1: Abrufen einer Liste aller VirtualRouter
986
987 {{code language="powershell"}}
988 Get-AESBVirtualRouters
989
990 {{/code}}
991
992 = Get-AESBAlias =
993
994 Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.
995
996 |=(% 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 {{code language="powershell"}}
1004 Get-AESBAlias -Alias "AliasName"
1005
1006 {{/code}}
1007
1008 = Get-AESBConnectionInfo =
1009
1010 Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.
1011
1012 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1013 |-ConnectionName|string|✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen.
1014
1015 === **Beispiele** ===
1016
1017 Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB
1018
1019 {{code language="powershell" layout="LINENUMBERS"}}
1020 Get-AESBConnectionInfo
1021
1022 #Beispiel-Output:
1023
1024 EndPoint VirtualRouter RoutingKey
1025 -------- ------------- ----------
1026 wss://localhost:3950 SHELL SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668
1027 {{/code}}
1028
1029 Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"
1030
1031 {{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 === **Beispiele** ===
1046
1047 Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"
1048
1049 {{code language="powershell"}}
1050 Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
1051 {{/code}}
1052
1053 Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"
1054
1055 {{code language="powershell"}}
1056 Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
1057
1058 {{/code}}
1059
1060 = Get-AESBTargets =
1061
1062 Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.
1063
1064 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1065 |-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll.
1066 |-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll.
1067
1068 === **Beispiele** ===
1069
1070 Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
1071
1072 {{code language="powershell"}}
1073 Get-AESBTargets -VirtualRouter "MyRouter"
1074
1075 {{/code}}
1076
1077 Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"
1078
1079 {{code language="powershell"}}
1080 Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
1081
1082 {{/code}}
1083
1084 = Publish-AESBMessage =
1085
1086 Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.
1087
1088 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1089 |-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
1090 |-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
1091 |-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
1092 |-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
1093 |-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
1094 |-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
1095
1096
1097 Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
1098
1099 * (((
1100 RoutingParameterSet - Message, VirtualRouter, RoutingKey
1101 )))
1102 * (((
1103 AliasParameterSet - Message, Alias
1104 )))
1105
1106 === **Beispiele** ===
1107
1108 Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung
1109
1110 {{code language="powershell"}}
1111 Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
1112
1113 {{/code}}
1114
1115 Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey" und wartet bis zu 1 Stunde auf eine Bestätigung
1116
1117 {{code language="powershell"}}
1118 Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
1119
1120 {{/code}}
1121
jklein 2.1 1122 = Receive-AESBTargetMessages =
1123
jklein 18.4 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
jklein 2.1 1148 = Remove-AESBAlias =
1149
jklein 18.4 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
jklein 2.1 1172 = Remove-AESBRoutingFromAlias =
1173
jklein 19.1 1174 Mit diesem Cmdlet wird ein Routing-Paar (bestehend aus VirtualRouter und RoutingKey) von einem Alias im QNS entfernt. Das Routing-Paar wird dabei vollständig gelöscht.
1175
1176
1177 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1178 |-Alias|string|❌|A|Der Name des Alias, von dem das Routing-Pärchen entfernt werden soll.
1179 |-ConnectionName|string|✅|C|Der Name der Verbindung, die verwendet wird.
1180 |-RoutingKey|string|❌|RK|Der RoutingKey, der aus dem Alias entfernt werden soll.
1181 |-VirtualRouter|string|❌|VR|Der VirtualRouter, der zusammen mit dem RoutingKey entfernt werden soll.
1182
1183
1184 (% class="wikigeneratedid" %)
1185 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.
1186
1187 = Add-AESBAlias =
1188
1189 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.
1190
1191 (% style="width:977px" %)
1192 |=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %)Optional|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung
1193 |-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.
1194 |-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.
1195
1196 === **Beispiele** ===
1197
1198 Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung
1199
1200 {{code language="powershell"}}
1201 Add-AESBAlias -Alias "MyAlias"
1202 {{/code}}
1203
1204 Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection"
1205
1206 {{code language="powershell"}}
1207 Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection"
1208
1209 {{/code}}
1210
1211 = Add-AESBCallbackTarget =
1212
1213 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.
1214
1215 (% style="width:1073px" %)
1216 |=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Optional|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung
1217 |(% 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.
1218 |(% 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.
1219 |(% 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.
1220 |(% 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.
1221
1222 === (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** ===
1223
1224 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
1225
1226 {{code language="powershell"}}
1227 Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
1228
1229 {{/code}}
1230
1231 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
1232
1233 {{code language="powershell"}}
1234 Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
1235
1236 {{/code}}
1237
1238 = Add-AESBQueueTarget =
1239
1240 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"]]
1241
1242 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1243 |(% 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.
1244 |(% 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.
1245 |(% 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.
1246 |(% 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.
1247
1248 === **Beispiele** ===
1249
1250 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
1251
1252 {{code language="powershell"}}
1253 Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
1254
1255 {{/code}}
1256
1257 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
1258
1259 {{code language="powershell"}}
1260 Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
1261
1262 {{/code}}
1263
1264 = Add-AESBRoutingKey =
1265
1266 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.
1267
1268 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1269 |-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll.
1270 |-VirtualRouter|string|❌|VR|Der Name des Virtual Router, zu dem der Routing Key gehört.
1271 |-TargetName|string|❌|TName|Der Name des Targets, für das der Routing Key hinzugefügt wird.
1272 |-RoutingKey|string|❌|RK|Der Name des Routing Keys, der hinzugefügt werden soll.
1273
1274 === **Beispiele** ===
1275
1276 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
1277
1278 {{code language="powershell"}}
1279 Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
1280
1281 {{/code}}
1282
1283 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
1284
1285 {{code language="powershell"}}
1286 Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"
1287
1288 {{/code}}
1289
1290 = Add-AESBRoutingToAlias =
1291
1292 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.
1293
1294 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1295 |-Alias|string|❌|A|Der Alias, zu dem das Routing-Paar im QNS hinzugefügt werden soll.
1296 |-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Routing-Paar hinzugefügt werden soll.
1297 |-RoutingKey|string|❌|RK|Der Name des Routing Keys, der zusammen mit dem Virtual Router hinzugefügt werden soll.
1298 |-VirtualRouter|string|❌|VR|Der Name des Virtual Router, der zusammen mit dem Routing Key hinzugefügt werden soll.
1299
1300 === (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** ===
1301
1302 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.
1303
1304 {{code language="powershell"}}
1305 Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection"
1306 {{/code}}
1307
1308 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.
1309
1310 {{code language="powershell"}}
1311 Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
1312 {{/code}}
1313
1314 = Add-AESBTarget =
1315
1316 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.
1317
1318 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1319 |-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll.
1320 |-RoutingKey|string|❌|RK|Der Routing Key, der dem Target zugewiesen wird.
1321 |-TargetName|string|❌|TName|Der Name des Targets, das hinzugefügt werden soll.
1322 |-TargetType|string|❌|TType|Der Typ des Targets, das hinzugefügt werden soll.
1323 |-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird.
1324
1325 === **Beispiele** ===
1326
1327 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
1328
1329 {{code language="powershell"}}
1330 Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"
1331
1332 {{/code}}
1333
1334 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
1335
1336 {{code language="powershell"}}
1337 Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
1338
1339 {{/code}}
1340
1341 = Add-AESBVirtualRouter =
1342
1343 Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
1344
1345 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1346 |-ConnectionName|string|✅|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll.
1347 |-VirtualRouter|string|❌|VR|Der Name des VirtualRouter, der hinzugefügt werden soll.
1348
1349 === **Beispiele** ===
1350
1351 Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung
1352
1353 {{code language="powershell"}}
1354 Add-AESBVirtualRouter -VirtualRouter "MyRouter"
1355
1356 {{/code}}
1357
1358 Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
1359
1360 {{code language="powershell"}}
1361 Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
1362
1363 {{/code}}
1364
1365 = ConvertFrom-AESBBase64 =
1366
1367 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
1368
1369 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1370 |-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
1371
1372 === **Beispiele** ===
1373
1374 Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"
1375
1376 {{code language="powershell"}}
1377 ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
1378
1379 {{/code}}
1380
1381 Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
1382
1383 {{code language="powershell"}}
1384 $base64String = "U29tZSBiYXNlNjQgdGV4dA=="
1385 ConvertFrom-AESBBase64 -Input $base64String
1386 {{/code}}
1387
1388 = ConvertFrom-AESBBase64ToFile =
1389
1390 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
1391
1392 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1393 |-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
1394 |-OutputPath|string|❌|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen.
1395 |-Force|switch|✅|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert.
1396
1397 === **Beispiele** ===
1398
1399 Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
1400
1401 {{code language="powershell"}}
1402 ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
1403
1404 {{/code}}
1405
1406 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
1407
1408 {{code language="powershell"}}
1409 ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
1410 {{/code}}
1411
1412 = ConvertFrom-AESBIcql =
1413
1414 Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
1415
1416 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1417 |-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll.
1418
1419 === **Beispiele** ===
1420
1421 Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
1422
1423 {{code language="powershell"}}
1424 $icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>"
1425 ConvertFrom-AESBIcql -Icql $icqlString
1426 {{/code}}
1427
1428 Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
1429
1430 {{code language="none" layout="LINENUMBERS"}}
1431 TargetName : MyTarget
1432 TargetType : Queue
1433 RoutingKey : MyRoutingKey
1434 VirtualRouter : MyRouter
1435 ConnectionName : MyConnection
1436 {{/code}}
1437
1438 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
1439
1440 {{code language="powershell" layout="LINENUMBERS"}}
1441 # Erstellen eines PSCustomObject mit Beispieldaten
1442 $exampleObject = [PSCustomObject]@{
1443 TargetName = "MyTarget"
1444 TargetType = "Queue"
1445 RoutingKey = "MyRoutingKey"
1446 VirtualRouter = "MyRouter"
1447 ConnectionName = "MyConnection"
1448 }
1449
1450 # Konvertieren des Objekts in eine Icql-Zeichenfolge
1451 $x = ConvertTo-AESBIcql -InputObject $exampleObject
1452
1453 # Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject
1454 $decodedObject = ConvertFrom-AESBIcql -Icql $x
1455
1456 # Anzeigen des dekodierten Objekts
1457 $decodedObjectConvertFrom-AESBIcql -Icql $icqlString
1458 {{/code}}
1459
1460 = ConvertTo-AESBBase64 =
1461
1462 Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
1463
1464 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1465 |-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll.
1466
1467 === **Beispiele** ===
1468
1469 Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
1470
1471 {{code language="powershell"}}
1472 ConvertTo-AESBBase64 -Input "Hello World!"
1473 ConvertFrom-AESBIcql -Icql $icqlString
1474 {{/code}}
1475
1476 Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
1477
1478 {{code language="powershell"}}
1479 $string = "Base64 encoding example"
1480 $base64String = ConvertTo-AESBBase64 -Input $string
1481 $base64StringConvertFrom-AESBIcql -Icql $icqlString
1482 {{/code}}
1483
1484 = ConvertTo-AESBBase64FromFile =
1485
1486 Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.
1487
1488 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1489 |-InputPath|string|❌|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll.
1490
1491 === **Beispiele** ===
1492
1493 Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge
1494
1495 {{code language="powershell"}}
1496 ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
1497
1498 {{/code}}
1499
1500 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
1501
1502 {{code language="powershell"}}
1503 $filePath = "C:\path\to\anotherfile.txt"
1504 $base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
1505 $base64String
1506 {{/code}}
1507
1508 = ConvertTo-AESBIcql =
1509
1510 Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
1511
1512 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1513 |-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll.
1514
1515 === **Beispiele** ===
1516
1517 Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
1518
1519 {{code language="powershell" layout="LINENUMBERS"}}
1520 # Erstellen eines PSCustomObject mit Beispieldaten
1521 $exampleObject = [PSCustomObject]@{
1522 TargetName = "MyTarget"
1523 TargetType = "Queue"
1524 RoutingKey = "MyRoutingKey"
1525 VirtualRouter = "MyRouter"
1526 ConnectionName = "MyConnection"
1527 }
1528
1529 # Konvertieren des Objekts in eine Icql-Zeichenfolge
1530 $icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
1531 $icqlString
1532 {{/code}}
1533
1534 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.
1535
1536 {{code language="powershell" layout="LINENUMBERS"}}
1537 # Erstellen eines PSCustomObject mit Beispieldaten
1538 $exampleObject = [PSCustomObject]@{
1539 TargetName = "MyTarget"
1540 TargetType = "Queue"
1541 RoutingKey = "MyRoutingKey"
1542 VirtualRouter = "MyRouter"
1543 ConnectionName = "MyConnection"
1544 }
1545
1546 # Konvertieren des Objekts in eine Icql-Zeichenfolge
1547 $icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
1548 $icqlString
1549 {{/code}}
1550
1551 = Get-AESBActivityLogItemById =
1552
1553 Gibt den ActivityLog-Eintrag anhand einer ID zurück.
1554
1555 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1556 |-Id|string|❌| |Die ID des Logeintrags
1557
1558 === **Beispiele** ===
1559
1560 Beispiel 1: Abruf eines Log-Eintrags anhand einer ID
1561
1562 {{code language="powershell"}}
1563 Get-AESBActivityLogItemById -Id "ItemID"
1564
1565 {{/code}}
1566
1567 = Get-AESBAliasList =
1568
1569 Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.
1570
1571 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1572 |-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll.
1573
1574 === **Beispiele** ===
1575
1576 Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung
1577
1578 {{code language="powershell"}}
1579 Get-AESBAliasList
1580
1581 {{/code}}
1582
1583 Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
1584
1585 {{code language="powershell"}}
1586 Get-AESBAliasList -ConnectionName "MyConnection"
1587
1588 {{/code}}
1589
1590 = Get-AESBVirtualRouters =
1591
1592 Gibt eine Liste aller VirtualRouter zurück.
1593
1594 === **Beispiele** ===
1595
1596 Beispiel 1: Abrufen einer Liste aller VirtualRouter
1597
1598 {{code language="powershell"}}
1599 Get-AESBVirtualRouters
1600
1601 {{/code}}
1602
1603 = Get-AESBAlias =
1604
1605 Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.
1606
1607 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1608 |-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder.
1609
1610 === **Beispiele** ===
1611
1612 Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"
1613
1614 {{code language="powershell"}}
1615 Get-AESBAlias -Alias "AliasName"
1616
1617 {{/code}}
1618
1619 = Get-AESBConnectionInfo =
1620
1621 Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.
1622
1623 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1624 |-ConnectionName|string|✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen.
1625
1626 === **Beispiele** ===
1627
1628 Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB
1629
1630 {{code language="powershell" layout="LINENUMBERS"}}
1631 Get-AESBConnectionInfo
1632
1633 #Beispiel-Output:
1634
1635 EndPoint VirtualRouter RoutingKey
1636 -------- ------------- ----------
1637 wss://localhost:3950 SHELL SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668
1638 {{/code}}
1639
1640 Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"
1641
1642 {{code language="powershell"}}
1643 Get-AESBAliasList -ConnectionName "MyConnection"
1644
1645 {{/code}}
1646
1647 = Get-AESBTargetMessageCount =
1648
1649 Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.
1650
1651 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1652 |-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.
1653 |-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.
1654 |-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, unter dem das Target läuft.
1655
1656 === **Beispiele** ===
1657
1658 Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"
1659
1660 {{code language="powershell"}}
1661 Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
1662 {{/code}}
1663
1664 Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"
1665
1666 {{code language="powershell"}}
1667 Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
1668
1669 {{/code}}
1670
1671 = Get-AESBTargets =
1672
1673 Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.
1674
1675 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1676 |-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll.
1677 |-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll.
1678
1679 === **Beispiele** ===
1680
1681 Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
1682
1683 {{code language="powershell"}}
1684 Get-AESBTargets -VirtualRouter "MyRouter"
1685
1686 {{/code}}
1687
1688 Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"
1689
1690 {{code language="powershell"}}
1691 Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
1692
1693 {{/code}}
1694
1695 = Publish-AESBMessage =
1696
1697 Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.
1698
1699 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1700 |-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
1701 |-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
1702 |-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
1703 |-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
1704 |-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
1705 |-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
1706
1707
1708 Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
1709
1710 * (((
1711 RoutingParameterSet - Message, VirtualRouter, RoutingKey
1712 )))
1713 * (((
1714 AliasParameterSet - Message, Alias
1715 )))
1716
1717 === **Beispiele** ===
1718
1719 Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"
1720
1721 {{code language="powershell"}}
1722 Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message"
1723
1724 {{/code}}
1725
1726 Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey"
1727
1728 {{code language="powershell"}}
1729 Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message"
1730
1731 {{/code}}
1732
1733 (% 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".
1734
1735 {{code language="powershell"}}
1736 ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias"
1737
1738 {{/code}}
1739
1740 = Publish-AESBMessageAndAwait =
1741
1742 Sendet eine Nachricht an ein bestimmtes Target oder einen Alias im AESB und wartet auf eine Bestätigung oder Antwort innerhalb des angegebenen Zeitlimits.
1743
1744
1745 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1746 |-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
1747 |-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
1748 |-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
1749 |-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
1750 |-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
1751 |-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.
1752 |-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
1753
1754 (% class="wikigeneratedid" %)
1755 (% id="cke_bm_484750S" style="display:none" %) (%%)Arbeiten in AESB verwendet werden können.
1756
1757 = Add-AESBAlias =
1758
1759 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.
1760
1761 (% style="width:977px" %)
1762 |=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %)Optional|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung
1763 |-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.
1764 |-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.
1765
1766 === **Beispiele** ===
1767
1768 Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung
1769
1770 {{code language="powershell"}}
1771 Add-AESBAlias -Alias "MyAlias"
1772 {{/code}}
1773
1774 Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection"
1775
1776 {{code language="powershell"}}
1777 Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection"
1778
1779 {{/code}}
1780
1781 = Add-AESBCallbackTarget =
1782
1783 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.
1784
1785 (% style="width:1073px" %)
1786 |=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Optional|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung
1787 |(% 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.
1788 |(% 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.
1789 |(% 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.
1790 |(% 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.
1791
1792 === (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** ===
1793
1794 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
1795
1796 {{code language="powershell"}}
1797 Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
1798
1799 {{/code}}
1800
1801 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
1802
1803 {{code language="powershell"}}
1804 Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"
1805
1806 {{/code}}
1807
1808 = Add-AESBQueueTarget =
1809
1810 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"]]
1811
1812 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1813 |(% 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.
1814 |(% 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.
1815 |(% 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.
1816 |(% 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.
1817
1818 === **Beispiele** ===
1819
1820 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
1821
1822 {{code language="powershell"}}
1823 Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
1824
1825 {{/code}}
1826
1827 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
1828
1829 {{code language="powershell"}}
1830 Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
1831
1832 {{/code}}
1833
1834 = Add-AESBRoutingKey =
1835
1836 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.
1837
1838 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1839 |-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll.
1840 |-VirtualRouter|string|❌|VR|Der Name des Virtual Router, zu dem der Routing Key gehört.
1841 |-TargetName|string|❌|TName|Der Name des Targets, für das der Routing Key hinzugefügt wird.
1842 |-RoutingKey|string|❌|RK|Der Name des Routing Keys, der hinzugefügt werden soll.
1843
1844 === **Beispiele** ===
1845
1846 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
1847
1848 {{code language="powershell"}}
1849 Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"
1850
1851 {{/code}}
1852
1853 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
1854
1855 {{code language="powershell"}}
1856 Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"
1857
1858 {{/code}}
1859
1860 = Add-AESBRoutingToAlias =
1861
1862 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.
1863
1864 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1865 |-Alias|string|❌|A|Der Alias, zu dem das Routing-Paar im QNS hinzugefügt werden soll.
1866 |-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Routing-Paar hinzugefügt werden soll.
1867 |-RoutingKey|string|❌|RK|Der Name des Routing Keys, der zusammen mit dem Virtual Router hinzugefügt werden soll.
1868 |-VirtualRouter|string|❌|VR|Der Name des Virtual Router, der zusammen mit dem Routing Key hinzugefügt werden soll.
1869
1870 === (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** ===
1871
1872 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.
1873
1874 {{code language="powershell"}}
1875 Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection"
1876 {{/code}}
1877
1878 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.
1879
1880 {{code language="powershell"}}
1881 Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
1882 {{/code}}
1883
1884 = Add-AESBTarget =
1885
1886 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.
1887
1888 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1889 |-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll.
1890 |-RoutingKey|string|❌|RK|Der Routing Key, der dem Target zugewiesen wird.
1891 |-TargetName|string|❌|TName|Der Name des Targets, das hinzugefügt werden soll.
1892 |-TargetType|string|❌|TType|Der Typ des Targets, das hinzugefügt werden soll.
1893 |-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird.
1894
1895 === **Beispiele** ===
1896
1897 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
1898
1899 {{code language="powershell"}}
1900 Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"
1901
1902 {{/code}}
1903
1904 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
1905
1906 {{code language="powershell"}}
1907 Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"
1908
1909 {{/code}}
1910
1911 = Add-AESBVirtualRouter =
1912
1913 Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
1914
1915 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1916 |-ConnectionName|string|✅|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll.
1917 |-VirtualRouter|string|❌|VR|Der Name des VirtualRouter, der hinzugefügt werden soll.
1918
1919 === **Beispiele** ===
1920
1921 Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung
1922
1923 {{code language="powershell"}}
1924 Add-AESBVirtualRouter -VirtualRouter "MyRouter"
1925
1926 {{/code}}
1927
1928 Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
1929
1930 {{code language="powershell"}}
1931 Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
1932
1933 {{/code}}
1934
1935 = ConvertFrom-AESBBase64 =
1936
1937 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
1938
1939 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1940 |-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
1941
1942 === **Beispiele** ===
1943
1944 Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"
1945
1946 {{code language="powershell"}}
1947 ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
1948
1949 {{/code}}
1950
1951 Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
1952
1953 {{code language="powershell"}}
1954 $base64String = "U29tZSBiYXNlNjQgdGV4dA=="
1955 ConvertFrom-AESBBase64 -Input $base64String
1956 {{/code}}
1957
1958 = ConvertFrom-AESBBase64ToFile =
1959
1960 Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
1961
1962 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1963 |-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
1964 |-OutputPath|string|❌|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen.
1965 |-Force|switch|✅|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert.
1966
1967 === **Beispiele** ===
1968
1969 Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
1970
1971 {{code language="powershell"}}
1972 ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
1973
1974 {{/code}}
1975
1976 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
1977
1978 {{code language="powershell"}}
1979 ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
1980 {{/code}}
1981
1982 = ConvertFrom-AESBIcql =
1983
1984 Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
1985
1986 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
1987 |-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll.
1988
1989 === **Beispiele** ===
1990
1991 Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
1992
1993 {{code language="powershell"}}
1994 $icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>"
1995 ConvertFrom-AESBIcql -Icql $icqlString
1996 {{/code}}
1997
1998 Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
1999
2000 {{code language="none" layout="LINENUMBERS"}}
2001 TargetName : MyTarget
2002 TargetType : Queue
2003 RoutingKey : MyRoutingKey
2004 VirtualRouter : MyRouter
2005 ConnectionName : MyConnection
2006 {{/code}}
2007
2008 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
2009
2010 {{code language="powershell" layout="LINENUMBERS"}}
2011 # Erstellen eines PSCustomObject mit Beispieldaten
2012 $exampleObject = [PSCustomObject]@{
2013 TargetName = "MyTarget"
2014 TargetType = "Queue"
2015 RoutingKey = "MyRoutingKey"
2016 VirtualRouter = "MyRouter"
2017 ConnectionName = "MyConnection"
2018 }
2019
2020 # Konvertieren des Objekts in eine Icql-Zeichenfolge
2021 $x = ConvertTo-AESBIcql -InputObject $exampleObject
2022
2023 # Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject
2024 $decodedObject = ConvertFrom-AESBIcql -Icql $x
2025
2026 # Anzeigen des dekodierten Objekts
2027 $decodedObjectConvertFrom-AESBIcql -Icql $icqlString
2028 {{/code}}
2029
2030 = ConvertTo-AESBBase64 =
2031
2032 Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
2033
2034 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2035 |-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll.
2036
2037 === **Beispiele** ===
2038
2039 Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
2040
2041 {{code language="powershell"}}
2042 ConvertTo-AESBBase64 -Input "Hello World!"
2043 ConvertFrom-AESBIcql -Icql $icqlString
2044 {{/code}}
2045
2046 Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
2047
2048 {{code language="powershell"}}
2049 $string = "Base64 encoding example"
2050 $base64String = ConvertTo-AESBBase64 -Input $string
2051 $base64StringConvertFrom-AESBIcql -Icql $icqlString
2052 {{/code}}
2053
2054 = ConvertTo-AESBBase64FromFile =
2055
2056 Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.
2057
2058 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2059 |-InputPath|string|❌|InPath|Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll.
2060
2061 === **Beispiele** ===
2062
2063 Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge
2064
2065 {{code language="powershell"}}
2066 ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"
2067
2068 {{/code}}
2069
2070 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
2071
2072 {{code language="powershell"}}
2073 $filePath = "C:\path\to\anotherfile.txt"
2074 $base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
2075 $base64String
2076 {{/code}}
2077
2078 = ConvertTo-AESBIcql =
2079
2080 Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
2081
2082 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2083 |-InputObject|psobject|❌|InObj|Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll.
2084
2085 === **Beispiele** ===
2086
2087 Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
2088
2089 {{code language="powershell" layout="LINENUMBERS"}}
2090 # Erstellen eines PSCustomObject mit Beispieldaten
2091 $exampleObject = [PSCustomObject]@{
2092 TargetName = "MyTarget"
2093 TargetType = "Queue"
2094 RoutingKey = "MyRoutingKey"
2095 VirtualRouter = "MyRouter"
2096 ConnectionName = "MyConnection"
2097 }
2098
2099 # Konvertieren des Objekts in eine Icql-Zeichenfolge
2100 $icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
2101 $icqlString
2102 {{/code}}
2103
2104 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.
2105
2106 {{code language="powershell" layout="LINENUMBERS"}}
2107 # Erstellen eines PSCustomObject mit Beispieldaten
2108 $exampleObject = [PSCustomObject]@{
2109 TargetName = "MyTarget"
2110 TargetType = "Queue"
2111 RoutingKey = "MyRoutingKey"
2112 VirtualRouter = "MyRouter"
2113 ConnectionName = "MyConnection"
2114 }
2115
2116 # Konvertieren des Objekts in eine Icql-Zeichenfolge
2117 $icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
2118 $icqlString
2119 {{/code}}
2120
2121 = Get-AESBActivityLogItemById =
2122
2123 Gibt den ActivityLog-Eintrag anhand einer ID zurück.
2124
2125 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2126 |-Id|string|❌| |Die ID des Logeintrags
2127
2128 === **Beispiele** ===
2129
2130 Beispiel 1: Abruf eines Log-Eintrags anhand einer ID
2131
2132 {{code language="powershell"}}
2133 Get-AESBActivityLogItemById -Id "ItemID"
2134
2135 {{/code}}
2136
2137 = Get-AESBAliasList =
2138
2139 Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.
2140
2141 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2142 |-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll.
2143
2144 === **Beispiele** ===
2145
2146 Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung
2147
2148 {{code language="powershell"}}
2149 Get-AESBAliasList
2150
2151 {{/code}}
2152
2153 Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"
2154
2155 {{code language="powershell"}}
2156 Get-AESBAliasList -ConnectionName "MyConnection"
2157
2158 {{/code}}
2159
2160 = Get-AESBVirtualRouters =
2161
2162 Gibt eine Liste aller VirtualRouter zurück.
2163
2164 === **Beispiele** ===
2165
2166 Beispiel 1: Abrufen einer Liste aller VirtualRouter
2167
2168 {{code language="powershell"}}
2169 Get-AESBVirtualRouters
2170
2171 {{/code}}
2172
2173 = Get-AESBAlias =
2174
2175 Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.
2176
2177 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2178 |-Alias|string|❌| |Gibt die Informationen zum angegebenen Alias wieder.
2179
2180 === **Beispiele** ===
2181
2182 Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"
2183
2184 {{code language="powershell"}}
2185 Get-AESBAlias -Alias "AliasName"
2186
2187 {{/code}}
2188
2189 = Get-AESBConnectionInfo =
2190
2191 Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.
2192
2193 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2194 |-ConnectionName|string|✅|C|Der Name der Verbindung, für die Informationen abgerufen werden sollen.
2195
2196 === **Beispiele** ===
2197
2198 Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB
2199
2200 {{code language="powershell" layout="LINENUMBERS"}}
2201 Get-AESBConnectionInfo
2202
2203 #Beispiel-Output:
2204
2205 EndPoint VirtualRouter RoutingKey
2206 -------- ------------- ----------
2207 wss://localhost:3950 SHELL SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668
2208 {{/code}}
2209
2210 Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"
2211
2212 {{code language="powershell"}}
2213 Get-AESBAliasList -ConnectionName "MyConnection"
2214
2215 {{/code}}
2216
2217 = Get-AESBTargetMessageCount =
2218
2219 Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.
2220
2221 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2222 |-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Zielnachrichtenzahl abgerufen werden soll.
2223 |-TargetName|string|❌|TName|Der Name des Targets, für das die Nachrichtenzahl abgerufen werden soll.
2224 |-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, unter dem das Target läuft.
2225
2226 === **Beispiele** ===
2227
2228 Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"
2229
2230 {{code language="powershell"}}
2231 Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"
2232 {{/code}}
2233
2234 Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"
2235
2236 {{code language="powershell"}}
2237 Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"
2238
2239 {{/code}}
2240
2241 = Get-AESBTargets =
2242
2243 Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.
2244
2245 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2246 |-ConnectionName|string|✅|C|Der Name der Verbindung, für die die Liste der Targets abgerufen werden soll.
2247 |-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, für den die Liste der Targets abgerufen werden soll.
2248
2249 === **Beispiele** ===
2250
2251 Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"
2252
2253 {{code language="powershell"}}
2254 Get-AESBTargets -VirtualRouter "MyRouter"
2255
2256 {{/code}}
2257
2258 Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"
2259
2260 {{code language="powershell"}}
2261 Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"
2262
2263 {{/code}}
2264
2265 = Publish-AESBMessage =
2266
2267 Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.
2268
2269 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2270 |-Alias|string|❌|A|Der Name des Alias, an den die Nachricht veröffentlicht werden soll.
2271 |-ConnectionName|string|✅|C|Der Name der Verbindung, über die die Nachricht gesendet werden soll.
2272 |-Force|switch|✅|F|Zwingt die Veröffentlichung der Nachricht, auch wenn dies normalerweise nicht zulässig wäre.
2273 |-Message|Object|❌|M|Die Nachricht, die veröffentlicht werden soll.
2274 |-RoutingKey|string|❌|RK|Der RoutingKey, der für das Routing der Nachricht verwendet wird.
2275 |-VirtualRouter|string|❌|VR|Der Name des VirtualRouters, über den die Nachricht veröffentlicht werden soll.
2276
2277 Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
2278
2279 * (((
2280 RoutingParameterSet - Message, VirtualRouter, RoutingKey
2281 )))
2282 * (((
2283 AliasParameterSet - Message, Alias
2284 )))
2285
2286 === **Beispiele** ===
2287
2288 Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"
2289
2290 {{code language="powershell"}}
2291 Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
2292
2293 {{/code}}
2294
2295 Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey"
2296
2297 {{code language="powershell"}}
2298 Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
2299
2300 {{/code}}
2301
2302 = Receive-AESBTargetMessages =
2303
2304 Mit diesem Cmdlet werden Nachrichten von einem Ziel im AESB empfangen.
2305
2306 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2307 |-ConnectionName|//string//|✅|C|Der Name der Verbindung zum AESB.
2308 |-MessageCount|//int//|✅|MC|Die Anzahl der Nachrichten, die empfangen werden sollen.
2309 |-TargetName|//string//|❌|TName|Der Name des Ziels, von dem die Nachrichten empfangen werden.
2310 |-VirtualRouter|//string//|❌|VR|Der Name des Virtual Routers, der für das Ziel verwendet wird.
2311
2312 === **Beispiele** ===
2313
2314 Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung
2315
2316 {{code language="powershell"}}
2317 Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"
2318
2319 {{/code}}
2320
2321 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
2322
2323 {{code language="powershell"}}
2324 Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"
2325
2326 {{/code}}
2327
2328 = Remove-AESBAlias =
2329
2330 Mit diesem Cmdlet wird ein Alias aus dem AESB entfernt.
2331
2332 |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
2333 |-Alias|string|❌|A|Der Name des zu entfernenden Alias.
2334 |-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB.
2335
2336 === **Beispiele** ===
2337
2338 Beispiel 1: Entfernen vom Routing-Paar mit Virtual Router "MyRouter" und Routing Key "MyRoutingKey" vom Alias "MyAlias".
2339
2340 {{code language="powershell"}}
2341 Remove-AESBRoutingFromAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
2342
2343 {{/code}}
2344
2345 Beispiel 2: Entfernen vom Routing-Paar mit VirtualRouter "MyRouter" und RoutingKey "MyRoutingKey" vom Alias "MyAlias" unter Verwendung der Verbindung "MyConnection".
2346
2347 {{code language="powershell"}}
2348 Remove-AESBRoutingFromAlias -Alias "MyAlias" -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey"
2349 {{/code}}
2350
jklein 2.1 2351 = Remove-AESBRoutingKey =
2352
jklein 19.1 2353 Entfernt einen Routing Key von einem bestimmten Ziel in einem VirtualRouter im AESB. Der RoutingKey wird aus der Konfiguration entfernt, die mit dem angegebenen Ziel und VirtualRouter verknüpft ist.
2354
2355
2356
2357
2358
jklein 2.1 2359 = Remove-AESBTarget =
2360
2361 = Remove-AESBVirtualRouter =
2362
2363 = Set-AESBBSelfAsAlias =
2364
2365 = Show-AESBRoutingTable =
2366
2367 = Write-AESBActivityLog =
2368
2369 = Write-AESBBusinessLog =
© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community