Changes for page Operative Cmdlets
Last modified by jklein on 2025/01/10 07:49
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -254,2108 +254,42 @@ 254 254 ConnectionName : MyConnection 255 255 {{/code}} 256 256 257 -Beispiel 2: Kodieren eines PSCustomObjects in eine Icql-Zeichenfolge und anschließendes dekodieren zurück in ein PSCustomObject. Die resultierenden Daten entsprechen den ursprünglichen Eingabewerten257 +Beispiel 2: 258 258 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}} 278 278 260 + 279 279 = ConvertTo-AESBBase64 = 280 280 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 - 303 303 = ConvertTo-AESBBase64FromFile = 304 304 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 - 327 327 = ConvertTo-AESBIcql = 328 328 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 - 370 370 = Get-AESBActivityLogItemById = 371 371 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 - 386 386 = Get-AESBAliasList = 387 387 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 - 395 -Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung 396 - 397 -{{code language="powershell"}} 398 -Get-AESBAliasList 399 - 400 -{{/code}} 401 - 402 -Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection" 403 - 404 -{{code language="powershell"}} 405 -Get-AESBAliasList -ConnectionName "MyConnection" 406 - 407 -{{/code}} 408 - 409 409 = Get-AESBVirtualRouters = 410 410 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 - 422 422 = Get-AESBAlias = 423 423 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 - 438 438 = Get-AESBConnectionInfo = 439 439 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 - 466 466 = Get-AESBTargetMessageCount = 467 467 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 - 479 -{{code language="powershell"}} 480 -Get-AESBTargetMessageCount -VirtualRouter "MyRouter" -TargetName "MyTarget" 481 -{{/code}} 482 - 483 -Beispiel 2: Abrufen der Anzahl der Nachrichten für das Target "MyTarget" unter dem VirtualRouter "MyRouter" und der Verbindung "MyConnection" 484 - 485 -{{code language="powershell"}} 486 -Get-AESBTargetMessageCount -ConnectionName "MyConnection" -VirtualRouter "MyRouter" -TargetName "MyTarget" 487 - 488 -{{/code}} 489 - 490 490 = Get-AESBTargets = 491 491 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 - 514 514 = Publish-AESBMessage = 515 515 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 - 527 -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 -{{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 - 559 559 = Publish-AESBMessageAndAwait = 560 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. 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 - 1122 1122 = Receive-AESBTargetMessages = 1123 1123 1124 -Mit diesem Cmdlet werden Nachrichten von einem Ziel im AESB empfangen. 1125 - 1126 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 1127 -|-ConnectionName|//string//|✅|C|Der Name der Verbindung zum AESB. 1128 -|-MessageCount|//int//|✅|MC|Die Anzahl der Nachrichten, die empfangen werden sollen. 1129 -|-TargetName|//string//|❌|TName|Der Name des Ziels, von dem die Nachrichten empfangen werden. 1130 -|-VirtualRouter|//string//|❌|VR|Der Name des VirtualRouters, der für das Ziel verwendet wird. 1131 - 1132 -=== **Beispiele** === 1133 - 1134 -Beispiel 1: Senden der Nachricht "This is a test message" an den Alias "MyAlias" und wartet bis zu 5 Minuten auf eine Bestätigung 1135 - 1136 -{{code language="powershell"}} 1137 -Publish-AESBMessageAndAwait -Alias "MyAlias" -Message "This is a test message" -Timeout "5m" 1138 - 1139 -{{/code}} 1140 - 1141 -Beispiel 2: Senden der Nachricht "This is a test message" über den VirtualRouter "MyRouter" mit dem RoutingKey "MyRoutingKey" und wartet bis zu 1 Stunde auf eine Bestätigung 1142 - 1143 -{{code language="powershell"}} 1144 -Publish-AESBMessageAndAwait -VirtualRouter "MyRouter" -RoutingKey "MyRoutingKey" -Message "This is a test message" -Timeout "1h" 1145 - 1146 -{{/code}} 1147 - 1148 1148 = Remove-AESBAlias = 1149 1149 1150 -Mit diesem Cmdlet wird ein Alias aus dem AESB entfernt. 1151 - 1152 -|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung 1153 -|-Alias|string|❌|A|Der Name des zu entfernenden Alias. 1154 -|-ConnectionName|string|✅|C|Der Name der Verbindung zum AESB. 1155 - 1156 -=== **Beispiele** === 1157 - 1158 -Beispiel 1: Entfernen vom Alias "MyAlias" aus dem AESB 1159 - 1160 -{{code language="powershell"}} 1161 -Remove-AESBAlias -Alias "MyAlias" 1162 - 1163 -{{/code}} 1164 - 1165 -Beispiel 2: Entfernen vom Alias "MyAlias" aus dem AESB über die angegebene Verbindung 1166 - 1167 -{{code language="powershell"}} 1168 -Remove-AESBAlias -ConnectionName "MyConnection" -Alias "MyAlias" 1169 - 1170 -{{/code}} 1171 - 1172 1172 = Remove-AESBRoutingFromAlias = 1173 1173 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 - 2351 2351 = Remove-AESBRoutingKey = 2352 2352 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 - 2359 2359 = Remove-AESBTarget = 2360 2360 2361 2361 = Remove-AESBVirtualRouter =