- Add-AESBAlias
- Add-AESBCallbackTarget
- Add-AESBQueueTarget
- Add-AESBRoutingKey
- Add-AESBRoutingToAlias
- Add-AESBTarget
- Add-AESBVirtualRouter
- ConvertFrom-AESBBase64
- ConvertFrom-AESBBase64ToFile
- ConvertFrom-AESBIcql
- ConvertTo-AESBBase64
- ConvertTo-AESBBase64FromFile
- ConvertTo-AESBIcql
- Get-AESBActivityLogItemById
- Get-AESBAliasList
- Get-AESBVirtualRouters
- Get-AESBAlias
- Get-AESBConnectionInfo
- Get-AESBTargetMessageCount
- Get-AESBTargets
- Publish-AESBMessage
- Publish-AESBMessageAndAwait
- Receive-AESBTargetMessages
- Remove-AESBAlias
- Remove-AESBRoutingFromAlias
- Remove-AESBRoutingKey
- Remove-AESBTarget
- Remove-AESBVirtualRouter
- Set-AESBBSelfAsAlias
- Show-AESBRoutingTable
- Write-AESBActivityLog
- Write-AESBBusinessLog
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.
Add-AESBAlias
Mit diesem Cmdlet wird ein neuer Alias für eine SICS-Verbindung im Qualified Name Service (QNS) hinzugefügt. Wenn der Parameter -ConnectionName nicht angegeben wird, wird der Alias für die Standardverbindung hinzugefügt.
| Parameter | Datentyp | Optional | Alias | Beschreibung |
|---|---|---|---|---|
| -Alias | String | ❌ | Keine | Der Name des Alias, der dem Qualified Name Service (QNS) hinzugefügt werden soll. |
| -ConnectionName | String | ✅ | Keine | 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
Beispiel 1: Hinzufügen des Alias "MyAlias" für die Standardverbindung
Beispiel 2: Hinzufügen des Alias "MyAlias" für die SICS-Verbindung "MyConnection"
Add-AESBCallbackTarget
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.
| Parameter | Datentyp | Optional | Alias | Beschreibung |
|---|---|---|---|---|
| -ConnectionName | String | ✅ | Keine | 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 | Der Name des Virtual Routers, dem das Callback-Target zugeordnet werden soll. |
| -TargetName | String | ❌ | Keine | Der Name des Callback-Targets, das hinzugefügt werden soll. |
| -RoutingKey | String | ❌ | Keine | Der Routing-Key, der verwendet wird, um Nachrichten an das Callback-Target zu routen. |
Beispiele
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
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
Add-AESBQueueTarget
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.
| Parameter | Datentyp | Optional | Alias | Beschreibung |
|---|---|---|---|---|
| -ConnectionName | String | ✅ | Keine | 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. |
| -VirtualRouter | String | ❌ | Keine | Der Name des Virtual Routers, dem das Queue-Target zugeordnet wird. |
| -TargetName | String | ❌ | Keine | Der Name des Queue-Targets, das hinzugefügt werden soll. |
| -RoutingKey | String | ❌ | Keine | Der Routing-Key, der verwendet wird, um Nachrichten an das Queue-Targets zu senden. |
Beispiele
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
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
Add-AESBRoutingKey
Dieses Cmdlet wird verwendet, um Routing-Informationen für ein AESB-Target zu konfigurieren. Dabei wird ein RoutingKey zu einem Target in einem VirtualRouter hinzugefügt.
| Parameter | Datentyp | Optional | Alias | Beschreibung |
|---|---|---|---|---|
| -ConnectionName | string | ✅ | C | Der Name der SICS-Verbindung, für die der Routing Key hinzugefügt werden soll. |
| -VirtualRouter | string | ❌ | VR | Der Name des Virtual Router, zu dem der Routing Key gehört. |
| -TargetName | string | ❌ | TName | Der Name des Targets, für das der Routing Key hinzugefügt wird. |
| -RoutingKey | string | ❌ | RK | Der Name des Routing Keys, der hinzugefügt werden soll. |
Beispiele
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
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
Add-AESBRoutingToAlias
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.
| Parameter | Datentyp | Optional | Alias | Beschreibung |
|---|---|---|---|---|
| -Alias | string | ❌ | A | Der Alias, zu dem das Routing-Paar im QNS hinzugefügt werden soll. |
| -ConnectionName | string | ✅ | C | Der Name der SICS-Verbindung, für die das Routing-Paar hinzugefügt werden soll. |
| -RoutingKey | string | ❌ | RK | Der Name des Routing Keys, der zusammen mit dem Virtual Router hinzugefügt werden soll. |
| -VirtualRouter | string | ❌ | VR | Der Name des Virtual Router, der zusammen mit dem Routing Key hinzugefügt werden soll. |
Beispiele
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.
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.
Add-AESBTarget
Dieses Cmdlet wird verwendet, um ein neues Target für eine SICS-Verbindung in einem Virtual Router hinzuzufügen. Dabei wird ein Target Type und Target Name mit einem Routing Key verknüpft.
| Parameter | Datentyp | Optional | Alias | 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. |
Beispiele
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
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
Add-AESBVirtualRouter
Dieses Cmdlet wird verwendet, um einen neuen Virtual Router innerhalb der angegebenen SICS-Verbindung zu konfigurieren.
| Parameter | Datentyp | Optional | Alias | Beschreibung |
|---|---|---|---|---|
| -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
Beispiel 2: Hinzufügen eines Virtual Routers "AnotherRouter" in der SICS-Verbindung "MyConnection"
ConvertFrom-AESBBase64
Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zurück in ihre unkodierte Form zu dekodieren.
| Parameter | Datentyp | Optional | Alias | 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!"
Beispiel 2: Dekodieren einer Base64-Zeichenfolge aus der Variable $base64string. Zurückgegeben wird der ursprüngliche Text "Some base64 text"
ConvertFrom-AESBBase64 -Input $base64String
ConvertFrom-AESBBase64ToFile
Dieses Cmdlet wird verwendet, um eine Base64-kodierte Zeichenfolge zu dekodieren und in einer Datei zu speichern.
| Parameter | Datentyp | Optional | Alias | 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
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
ConvertFrom-AESBIcql
Dieses Cmdlet wird verwendet, um eine AESB Icql-Zeichenfolge zurück in ein PowerShell-Objekt zu dekodieren.
| Parameter | Datentyp | Optional | Alias | Beschreibung |
|---|---|---|---|---|
| -Icql | string | ❌ | None | Die AESB Icql-Zeichenfolge, die dekodiert werden soll. |
Beispiele
Beispiel 1: Dekodieren einer AESB Icql-Zeichenfolge aus der Variable $icqlString
ConvertFrom-AESBIcql -Icql $icqlString
Dabei wird das PSCustomObject mit folgenden Daten zurückgegeben:
2
3
4
5
TargetType : Queue
RoutingKey : MyRoutingKey
VirtualRouter : MyRouter
ConnectionName : MyConnection
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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
$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
ConvertTo-AESBBase64
Dieses Cmdlet wird verwendet, um eine Zeichenfolge in das Base64-Format zu konvertieren.
| Parameter | Datentyp | Optional | Alias | 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
ConvertFrom-AESBIcql -Icql $icqlString
Beispiel 2: Kodieren der Zeichenfolge aus der Variable $string in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge in der Variable $base64String
$base64String = ConvertTo-AESBBase64 -Input $string
$base64StringConvertFrom-AESBIcql -Icql $icqlString
ConvertTo-AESBBase64FromFile
Dieses Cmdlet wird verwendet, um den Inhalt einer Datei in eine Base64-kodierte Zeichenfolge zu konvertieren.
| Parameter | Datentyp | Optional | Alias | Beschreibung |
|---|---|---|---|---|
| -InputPath | string | ❌ | InPath | Der Pfad zur Datei, deren Inhalt in Base64 kodiert werden soll. |
Beispiele
Beispiel 1: Kodieren des Inhalts der Datei "file.txt" unter dem angegebenen Pfad in Base64. Zurückgegeben wird die Base64-kodierte Zeichenfolge
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
$base64String = ConvertTo-AESBBase64FromFile -InputPath $filePath
$base64String
ConvertTo-AESBIcql
Dieses Cmdlet wird verwendet, um ein PowerShell-Objekt in das Icql-Format zu kodieren, das vom AESB verwendet wird.
| Parameter | Datentyp | Optional | Alias | Beschreibung |
|---|---|---|---|---|
| -InputObject | psobject | ❌ | InObj | Das PSCustomObject, das in eine AESB Icql-Zeichenfolge konvertiert werden soll. |
Beispiele
Beispiel 1: Konvertiert das PSCustomObject in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge zurück.
2
3
4
5
6
7
8
9
10
11
12
$exampleObject = [PSCustomObject]@{
TargetName = "MyTarget"
TargetType = "Queue"
RoutingKey = "MyRoutingKey"
VirtualRouter = "MyRouter"
ConnectionName = "MyConnection"
}
# Konvertieren des Objekts in eine Icql-Zeichenfolge
$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
$icqlString
Beispiel 2: Konvertiert das PSCustomObject, das in der Variable $exampleObject gespeichert ist, in eine AESB Icql-Zeichenfolge und gibt die resultierende Icql-Zeichenfolge in der Variable $icqlString zurück.
2
3
4
5
6
7
8
9
10
11
12
$exampleObject = [PSCustomObject]@{
TargetName = "MyTarget"
TargetType = "Queue"
RoutingKey = "MyRoutingKey"
VirtualRouter = "MyRouter"
ConnectionName = "MyConnection"
}
# Konvertieren des Objekts in eine Icql-Zeichenfolge
$icqlString = ConvertTo-AESBIcql -InputObject $exampleObject
$icqlString
Get-AESBActivityLogItemById
Gibt den ActivityLog-Eintrag anhand einer ID zurück.
| Parameter | Datentyp | Optional | Alias | Beschreibung |
|---|---|---|---|---|
| -Id | string | ❌ | Die ID des Logeintrags |
Beispiele
Beispiel 1: Abruf eines Log-Eintrags anhand einer ID
Get-AESBAliasList
Dieses Cmdlet wird verwendet, um eine Übersicht der im AESB gespeicherten Aliase zu erhalten.
| Parameter | Datentyp | Optional | Alias | Beschreibung |
|---|---|---|---|---|
| -ConnectionName | string | ✅ | C | Der Name der Verbindung, für die die Alias-Liste abgerufen werden soll. |
Beispiele
Beispiel 1: Abrufen einer Liste aller Aliase im AESB, ohne Angabe einer speziellen Verbindung.
Beispiel 2: Abrufen einer Liste aller Aliase im AESB für die angegebene Verbindung "MyConnection" ab.
Get-AESBVirtualRouters
Gibt eine Liste aller VirtualRouter zurück.
Beispiele
Beispiel 1: Abrufen einer Liste aller VirtualRouter
Get-AESBAlias
Gibt alle Informationen zu einer Verbindung mit einem bestimmten Alias wieder.
| Parameter | Datentyp | Optional | Alias | Beschreibung |
|---|---|---|---|---|
| -Alias | string | ❌ | Gibt die Informationen zum angegebenen Alias wieder. |
Beispiele
Beispiel 1: Abrufen der Informationen zur Verbindung mit dem Alias "AliasName"