Changes for page Operative Cmdlets

Last modified by jklein on 2025/01/10 07:49

From 11.1 to 12.1 From 16.1 to 17.1

From version 12.1

edited by jklein
on 2024/12/04 14:50

Change comment: There is no comment for this version

To version 16.1

edited by jklein
on 2024/12/05 12:57

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -7,10 +7,10 @@
  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.
--(% style="width:1080px" %)
--|=Parameter |=Datentyp|=Optional|=Alias|=(% style="width: 612px;" %)Beschreibung
--|-Alias|String|❌|Keine|(% style="width:612px" %)Der Name des Alias, der dem Qualified Name Service (QNS) hinzugefügt werden soll.
--|-ConnectionName|String|✅|Keine|(% style="width:612px" %)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.
++(% style="width:977px" %)
++|=Parameter |=(% style="width: 101px;" %)Datentyp|=(% style="width: 94px;" %)Optional|=(% style="width: 87px;" %)Alias|=(% style="width: 505px;" %)Beschreibung
++|-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.
++|-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.
  === **Beispiele** ===
@@ -31,12 +31,12 @@
  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.
--(% style="width:1094px" %)
--|=Parameter |=Datentyp|=Optional|=Alias|=(% style="width: 626px;" %)Beschreibung
--|-ConnectionName|String|✅|Keine|(% style="width:626px" %)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.
--|-VirtualRouter|String|❌|Keine|(% style="width:626px" %)Der Name des Virtual Routers, dem das Callback-Target zugeordnet werden soll.
--|-TargetName|String|❌|Keine|(% style="width:626px" %)Der Name des Callback-Targets, das hinzugefügt werden soll.
--|-RoutingKey|String|❌|Keine|(% style="width:626px" %)Der Routing-Key, der verwendet wird, um Nachrichten an das Callback-Target zu routen.
++(% style="width:1073px" %)
++|=(% style="width: 166px;" %)Parameter |=(% style="width: 127px;" %)Datentyp|=(% style="width: 90px;" %)Optional|=(% style="width: 74px;" %)Alias|=(% style="width: 614px;" %)Beschreibung
++|(% 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.
++|(% 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.
++|(% 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.
++|(% 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.
  === (% id="cke_bm_70797S" style="display:none" %)** **(%%)**Beispiele** ===
@@ -162,23 +162,144 @@
  Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
  |=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
--|-ConnectionName|string|✅|C|Der Name der SICS-Verbindung, für die das Target hinzugefügt werden soll.
--|-RoutingKey|string|❌|RK|Der Routing Key, der dem Target zugewiesen wird.
--|-TargetName|string|❌|TName|Der Name des Targets, das hinzugefügt werden soll.
--|-TargetType|string|❌|TType|Der Typ des Targets, das hinzugefügt werden soll.
--|-VirtualRouter|string|❌|VR|Der Name des Virtual Routers, zu dem das Target hinzugefügt wird.
++|-ConnectionName|string|✅|C|Der Name der Verbindung, in der der VirtualRouter hinzugefügt werden soll.
++|-VirtualRouter|string|❌|VR|Der Name des VirtualRouter, der hinzugefügt werden soll.
++=== **Beispiele** ===
++Beispiel 1: Hinzufügen eines Virtual Routers "MyRouter" in der Standardverbindung
++{{code language="powershell"}}
++Add-AESBVirtualRouter -VirtualRouter "MyRouter"
++{{/code}}
++
++Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
++
++{{code language="powershell"}}
++Add-AESBVirtualRouter -VirtualRouter "AnotherRouter" -ConnectionName "MyConnection"
++
++{{/code}}
++
  = ConvertFrom-AESBBase64 =
++Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
++
++|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
++|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
++
++=== **Beispiele** ===
++
++Beispiel 1: Dekodieren einer Base64-kodierten Zeichenfolge. Zurückgegeben wird der ursprüngliche Text "Hello World!"
++
++{{code language="powershell"}}
++ConvertFrom-AESBBase64 -Input "SGVsbG8gV29ybGQh"
++
++{{/code}}
++
++Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
++
++{{code language="powershell"}}
++$base64String = "U29tZSBiYXNlNjQgdGV4dA=="
++ConvertFrom-AESBBase64 -Input $base64String
++{{/code}}
++
  = ConvertFrom-AESBBase64ToFile =
++Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
++
++|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
++|-Input|string|❌|In|Die Base64-kodierte Zeichenfolge, die dekodiert werden soll.
++|-OutputPath|string|❌|None|Der Pfad inklusive Dateinamen, unter dem die dekodierten Daten gespeichert werden sollen.
++|-Force|switch|✅|F|Überschreibt die Datei am OutputPath, falls bereits eine Datei mit diesem Namen existiert.
++
++=== **Beispiele** ===
++
++Beispiel 1: Dekodieren einer Base64-Zeichenfolge und Speichern vom ursprünglichen Text "Hello World!" in der Datei "output.txt" im angegebenen Pfad
++
++{{code language="powershell"}}
++ConvertFrom-AESBBase64ToFile -Input "SGVsbG8gV29ybGQh" -OutputPath "C:\path\to\output.txt"
++
++{{/code}}
++
++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
++
++{{code language="powershell"}}
++ConvertFrom-AESBBase64ToFile -Input "U29tZSBiYXNlNjQgdGV4dA==" -OutputPath "C:\path\to\output.txt" -Force
++{{/code}}
++
  = ConvertFrom-AESBIcql =
++Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
++
++|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
++|-Icql|string|❌|None|Die AESB Icql-Zeichenfolge, die dekodiert werden soll.
++
++=== **Beispiele** ===
++
++Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
++
++{{code language="powershell"}}
++$icqlString = "<ICQL><POWERSHELL><MESSAGE><TargetName>MyTarget</TargetName><TargetType>Queue</TargetType><RoutingKey>MyRoutingKey</RoutingKey><VirtualRouter>MyRouter</VirtualRouter><ConnectionName>MyConnection</ConnectionName></MESSAGE></POWERSHELL></ICQL>"
++ConvertFrom-AESBIcql -Icql $icqlString
++{{/code}}
++
++Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
++
++{{code language="none" layout="LINENUMBERS"}}
++TargetName     : MyTarget
++TargetType     : Queue
++RoutingKey     : MyRoutingKey
++VirtualRouter  : MyRouter
++ConnectionName : MyConnection
++{{/code}}
++
++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
++
++{{code language="powershell" layout="LINENUMBERS"}}
++# Erstellen eines PSCustomObject mit Beispieldaten
++$exampleObject = [PSCustomObject]@{
++    TargetName    = "MyTarget"
++    TargetType    = "Queue"
++    RoutingKey    = "MyRoutingKey"
++    VirtualRouter = "MyRouter"
++    ConnectionName = "MyConnection"
++}
++
++# Konvertieren des Objekts in eine Icql-Zeichenfolge
++$x = ConvertTo-AESBIcql -InputObject $exampleObject
++
++# Zurückkonvertieren der Icql-Zeichenfolge in ein PSCustomObject
++$decodedObject = ConvertFrom-AESBIcql -Icql $x
++
++# Anzeigen des dekodierten Objekts
++$decodedObjectConvertFrom-AESBIcql -Icql $icqlString
++{{/code}}
++
  = ConvertTo-AESBBase64 =
++Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
++
++|=(% style="width: 199px;" %)Parameter |=(% style="width: 160px;" %)Datentyp|=(% style="width: 119px;" %)Optional|=(% style="width: 168px;" %)Alias|=(% style="width: 827px;" %)Beschreibung
++|-Input|string|❌|In|Die Zeichenfolge, die in Base64 kodiert werden soll.
++
++=== **Beispiele** ===
++
++Beispiel 1: Kodieren der Zeichenfolge// //"Hello World!"// //in Base64. Zurückgegeben wird die Base64-kodierte Version
++
++{{code language="powershell"}}
++ConvertTo-AESBBase64 -Input "Hello World!"
++ConvertFrom-AESBIcql -Icql $icqlString
++{{/code}}
++
++Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
++
++{{code language="powershell"}}
++$string = "Base64 encoding example"
++$base64String = ConvertTo-AESBBase64 -Input $string
++$base64StringConvertFrom-AESBIcql -Icql $icqlString
++{{/code}}
++
  = ConvertTo-AESBBase64FromFile =
  = ConvertTo-AESBIcql =