Operative Cmdlets

(% class="wikigeneratedid" %)

Bei den operativen Cmdlets handelt es sich um Shell-Befehle, die für die Steuerung und das weiterführende Arbeiten in AESB verwendet werden können.

5

6

= Add-AESBAlias =

7

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

10

(% style="width:977px" %)

11

12

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.

14

15

=== **Beispiele** ===

16

17

Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung

18

19

20

Add-AESBAlias -Alias "MyAlias"

21

22

23

Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection"

24

25

26

Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection"

= Add-AESBCallbackTarget =

31

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

34

(% style="width:1073px" %)

35

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.

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

46

Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"

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

53

Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"

= Add-AESBQueueTarget =

58

59

Dieses Cmdlet fügt ein neues Target zu einer SICS-Verbindung hinzu. Innerhalb dieses Targets ist eine Queue enthalten, in der Nachrichten weiterverarbeitet werden, die an das Target gesendet werden. Daher handelt es sich bei diesem Cmdlet um eine spezifische Form eines [[AESB-Targets.>>doc:||anchor="HAdd-AESBTarget"]]

60

61

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

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

72

Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"

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

79

Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"

= Add-AESBRoutingKey =

84

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.

=== **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

98

Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"

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

105

Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"

= Add-AESBRoutingToAlias =

110

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.

=== (% id="cke_bm_22527S" style="display:none" %)** **(%%)**Beispiele** ===

120

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.

122

123

124

Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection"

125

126

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.

128

129

130

Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"

= Add-AESBTarget =

Dieses Cmdlet wird verwendet, um ein neues Target für eine SICS-Verbindung in einem Virtual Router hinzuzufügen. Dabei wird ein Target Type und Target Name mit einem Routing Key verknüpft.

=== **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

149

Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"

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

156

Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"

= Add-AESBVirtualRouter =

161

162

Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.

=== **Beispiele** ===

169

170

Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung

171

172

173

Add-AESBVirtualRouter -VirtualRouter "MyRouter"

Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"

178

179

180

Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"

= ConvertFrom-AESBBase64 =

185

186

Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.

=== **Beispiele** ===

192

193

Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"

194

195

196

ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"

Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"

201

202

203

$base64String = "U29tZSBiYXNlNjQgdGV4dA=="

204

ConvertFrom-AESBBase64 -Input $base64String

205

206

207

= ConvertFrom-AESBBase64ToFile =

208

209

Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.

=== **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

221

ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"

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

228

ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force

229

230

231

= ConvertFrom-AESBIcql =

232

233

Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.

=== **Beispiele** ===

239

240

Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString

241

242

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

246

247

Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:

248

249

250

TargetName : MyTarget

251

TargetType : Queue

252

RoutingKey : MyRoutingKey

253

VirtualRouter : MyRouter

254

ConnectionName : MyConnection

255

256

257

Beispiel 2: Kodieren eines PSCustomObjects in eine Icql-Zeichenfolge und anschließendes dekodieren zurück in ein PSCustomObject. Die resultierenden Daten entsprechen den ursprünglichen Eingabewerten

258

259

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

278

279

= ConvertTo-AESBBase64 =

280

281

Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.

=== **Beispiele** ===

287

288

Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version

289

290

291

ConvertTo-AESBBase64 -Input "Hello World!"

292

ConvertFrom-AESBIcql -Icql $icqlString

293

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

298

$string = "Base64 encoding example"

299

$base64String = ConvertTo-AESBBase64 -Input $string

300

$base64StringConvertFrom-AESBIcql -Icql $icqlString

301

302

303

= ConvertTo-AESBBase64FromFile =

304

305

Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.

=== **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

315

ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"

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

322

$filePath = "C:\path\to\anotherfile.txt"

323

$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath

$base64String

= ConvertTo-AESBIcql =

328

329

Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.

=== **Beispiele** ===

335

336

Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.

337

338

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

$icqlString

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

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

$icqlString

= Get-AESBActivityLogItemById =

371

372

Gibt den ActivityLog-Eintrag anhand einer ID zurück.

373

374

375

|-Id|string|❌| |Die ID des Logeintrags

376

377

=== **Beispiele** ===

378

379

Beispiel 1: Abruf eines Log-Eintrags anhand einer ID

380

381

382

Get-AESBActivityLogItemById -Id "ItemID"

= Get-AESBAliasList =

387

388

Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.

=== **Beispiele** ===

394

395

Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung

Get-AESBAliasList

Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"

403

404

405

Get-AESBAliasList -ConnectionName "MyConnection"

= Get-AESBVirtualRouters =

410

411

Gibt eine Liste aller VirtualRouter zurück.

412

413

=== **Beispiele** ===

414

415

Beispiel 1: Abrufen einer Liste aller VirtualRouter

416

417

418

Get-AESBVirtualRouters

= Get-AESBAlias =

Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.

=== **Beispiele** ===

430

431

Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"

432

433

434

Get-AESBAlias -Alias "AliasName"

= Get-AESBConnectionInfo =

439

440

Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.

=== **Beispiele** ===

446

447

Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB

448

449

450

Get-AESBConnectionInfo

#Beispiel-Output:

EndPoint VirtualRouter RoutingKey

455

-------- ------------- ----------

456

wss://localhost:3950 SHELL SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668

457

458

459

Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"

460

461

462

Get-AESBAliasList -ConnectionName "MyConnection"

= Get-AESBTargetMessageCount =

467

468

Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.

=== **Beispiele** ===

476

477

Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"

478

479

480

Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"

481

482

483

Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"

484

485

486

Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"

= Get-AESBTargets =

Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.

=== **Beispiele** ===

499

500

Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"

501

502

503

Get-AESBTargets -VirtualRouter "MyRouter"

Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"

508

509

510

Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"

= Publish-AESBMessage =

515

516

Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.

Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:

528

529

* (((

530

RoutingParameterSet - Message, VirtualRouter, RoutingKey

531

)))

532

* (((

533

AliasParameterSet - Message, Alias

534

)))

535

536

=== **Beispiele** ===

537

538

Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias"

539

540

541

Publish-AESBMessage -Alias "MyAlias" -Message "This is a test message"

Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey"

546

547

548

Publish-AESBMessage -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message"

(% 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

555

ConvertTo-AESBIcql $exampleObject | Publish-AESBMessage -Alias "MyAlias"

= Publish-AESBMessageAndAwait =

560

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.

|-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

572

573

(% class="wikigeneratedid" %)

574

(% id="cke_bm_484750S" style="display:none" %) (%%)Arbeiten in AESB verwendet werden können.

= Add-AESBAlias =

Mit diesem Cmdlet wird ein neuer Alias für eine SICS-Verbindung im Qualified Name Service (QNS) hinzugefügt. Wenn der Parameter //-ConnectionName// nicht angegeben wird, wird der Alias für die Standardverbindung hinzugefügt.

579

580

(% style="width:977px" %)

581

582

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

590

Add-AESBAlias -Alias "MyAlias"

591

592

593

Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection"

594

595

596

Add-AESBAlias -Alias "MyAlias" -ConnectionName "MyConnection"

= 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

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

616

Add-AESBCallbackTarget -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"

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

623

Add-AESBCallbackTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "CallbackTarget1" -RoutingKey "Key1"

= 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

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

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

642

Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"

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

649

Add-AESBQueueTarget -ConnectionName "MyConnection" -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"

= 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.

=== **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

668

Add-AESBQueueTarget -VirtualRouter "Router1" -TargetName "QueueTarget1" -RoutingKey "Key1"

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

675

Add-AESBRoutingKey -ConnectionName "MyConnection" -VirtualRouter "AnotherRouter" -TargetName "AnotherTarget" -RoutingKey "AnotherKey"

= 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.

=== (% 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

694

Add-AESBRoutingToAlias -Alias "MyAlias" -VirtualRouter "MyRouter" -RoutingKey "MyKey" -ConnectionName "MyConnection"

695

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

700

Add-AESBRoutingToAlias -Alias "AnotherAlias" -VirtualRouter "AnotherRouter" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"

= Add-AESBTarget =

Dieses Cmdlet wird verwendet, um ein neues Target für eine SICS-Verbindung in einem Virtual Router hinzuzufügen. Dabei wird ein Target Type und Target Name mit einem Routing Key verknüpft.

=== **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

719

Add-AESBTarget -VirtualRouter "MyRouter" -TargetType "Queue" -TargetName "MyTarget" -RoutingKey "MyKey"

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

726

Add-AESBTarget -VirtualRouter "AnotherRouter" -TargetType "Queue" -TargetName "AnotherTarget" -RoutingKey "AnotherKey" -ConnectionName "MyConnection"

= Add-AESBVirtualRouter =

731

732

Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.

=== **Beispiele** ===

739

740

Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung

741

742

743

Add-AESBVirtualRouter -VirtualRouter "MyRouter"

Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"

748

749

750

Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"

= ConvertFrom-AESBBase64 =

755

756

Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.

=== **Beispiele** ===

762

763

Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"

764

765

766

ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"

Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"

771

772

773

$base64String = "U29tZSBiYXNlNjQgdGV4dA=="

774

ConvertFrom-AESBBase64 -Input $base64String

775

776

777

= ConvertFrom-AESBBase64ToFile =

778

779

Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.

=== **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

791

ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"

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

798

ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force

799

800

801

= ConvertFrom-AESBIcql =

802

803

Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.

=== **Beispiele** ===

809

810

Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString

811

812

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

816

817

Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:

818

819

820

TargetName : MyTarget

821

TargetType : Queue

822

RoutingKey : MyRoutingKey

823

VirtualRouter : MyRouter

824

ConnectionName : MyConnection

825

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

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

848

849

= ConvertTo-AESBBase64 =

850

851

Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.

=== **Beispiele** ===

857

858

Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version

859

860

861

ConvertTo-AESBBase64 -Input "Hello World!"

862

ConvertFrom-AESBIcql -Icql $icqlString

863

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

868

$string = "Base64 encoding example"

869

$base64String = ConvertTo-AESBBase64 -Input $string

870

$base64StringConvertFrom-AESBIcql -Icql $icqlString

871

872

873

= ConvertTo-AESBBase64FromFile =

874

875

Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.

=== **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

885

ConvertTo-AESBBase64FromFile -InputPath "C:\path\to\file.txt"

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

892

$filePath = "C:\path\to\anotherfile.txt"

893

$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath

$base64String

= ConvertTo-AESBIcql =

898

899

Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.

=== **Beispiele** ===

905

906

Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.

907

908

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

$icqlString

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

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

$icqlString

= Get-AESBActivityLogItemById =

941

942

Gibt den ActivityLog-Eintrag anhand einer ID zurück.

943

944

945

|-Id|string|❌| |Die ID des Logeintrags

946

947

=== **Beispiele** ===

948

949

Beispiel 1: Abruf eines Log-Eintrags anhand einer ID

950

951

952

Get-AESBActivityLogItemById -Id "ItemID"

= Get-AESBAliasList =

957

958

Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.

=== **Beispiele** ===

964

965

Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung

Get-AESBAliasList

Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection"

973

974

975

Get-AESBAliasList -ConnectionName "MyConnection"

= 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

988

Get-AESBVirtualRouters

= Get-AESBAlias =

Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.

=== **Beispiele** ===

1000

1001

Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"

1002

1003

1004

Get-AESBAlias -Alias "AliasName"

= Get-AESBConnectionInfo =

1009

1010

Dieses Cmdlet wird verwendet, um Details über die Konfiguration und den Status einer Verbindung zu erhalten.

=== **Beispiele** ===

1016

1017

Beispiel 1: Abrufen von Informationen zu allen verfügbaren Verbindungen im AESB

1018

1019

1020

Get-AESBConnectionInfo

#Beispiel-Output:

EndPoint VirtualRouter RoutingKey

1025

-------- ------------- ----------

1026

wss://localhost:3950 SHELL SICS.Aagon.Shell.local.a9857af7-bf81-44cd-8047-628956aad668

1027

1028

1029

Beispiel 2: Abrufen der Informationen zur Verbindung "MyConnection"

1030

1031

1032

Get-AESBAliasList -ConnectionName "MyConnection"

= Get-AESBTargetMessageCount =

1037

1038

Dieses Cmdlet wird verwendet, um die Anzahl der Nachrichten zu ermitteln, die sich derzeit im angegebenen Target befinden.

=== **Beispiele** ===

1046

1047

Beispiel 1: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter"

1048

1049

1050

Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget"

1051

1052

1053

Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection"

1054

1055

1056

Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget"

= Get-AESBTargets =

Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB definierten Targets zu erhalten.

=== **Beispiele** ===

1069

1070

Beispiel 1: Abrufen der Liste aller Targets unter dem VirtualRouter "MyRouter"

1071

1072

1073

Get-AESBTargets -VirtualRouter "MyRouter"

Beispiel 2: Abrufen der Liste aller Targets für den VirtualRouter "MyRouter" und die Verbindung "MyConnection"

1078

1079

1080

Get-AESBTargets -ConnectionName "MyConnection" -VirtualRouter "MyRouter"

= Publish-AESBMessage =

1085

1086

Dieses Cmdlet wird verwendet, um Nachrichten an die angegebenen Ziele oder Aliase zu senden.

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

1111

Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"

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

1118

Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"

= Receive-AESBTargetMessages =

1123

1124

Mit diesem Cmdlet werden Nachrichten von einem Ziel im AESB empfangen.

|-MessageCount|//int//|✅|MC|Die Anzahl der Nachrichten, die empfangen werden sollen.

=== **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

1137

Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m"

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

1144

Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h"

= Remove-AESBAlias =

Mit diesem Cmdlet wird ein Alias aus dem AESB entfernt.