Changes for page Basis-Cmdlets

Last modified by jklein on 2025/01/22 15:09

From 7.3 to 7.4 From 13.1 to 14.1

From version 7.4

edited by jklein
on 2024/12/02 14:01

Change comment: There is no comment for this version

To version 13.1

edited by jklein
on 2025/01/09 12:52

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Title

@@ -1,1 +1,1 @@
--Basis-Cmdlets
++Basis-Cmdlets

Content

@@ -139,7 +139,7 @@
  = Get-AESBConnections =
--Dieses Cmdlet gibt eine Liste aller existierenden SICS-Verbindungen aus. Dabei werden die zeigt die Detail-Informationen jeder Verbindung angezeigt.
++Dieses Cmdlet gibt eine Liste aller existierenden SICS-Verbindungen aus. Dabei werden die Detail-Informationen jeder Verbindung angezeigt.
  === **Beispiele** ===
@@ -206,6 +206,7 @@
  |=(% style="width: 170px;" %)Parameter |=(% style="width: 119px;" %)Datentyp|=(% style="width: 84px;" %)Optional|=(% style="width: 56px;" %)Alias|=(% style="width: 582px;" %)Beschreibung
  |-ConnectionName|String|✅|Keine|Der Name der SICS-Verbindung, über welche die PublicAPI-Cmdlets importiert werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
++|-Prefix|String|✅|Keine|Sofern ein Prefix angegeben wird, wird dies bei allen zu importierenden Modulen vor den eigentlichen Modul-Namen hinzugefügt.
  === **Beispiele** ===
@@ -279,16 +279,148 @@
  |-ConnectionName|String|✅|Keine|Der Name der Verbindung, von der die Nachricht gelesen werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
  |-Wait|String|✅|Keine|Die Zeitdauer, in der auf eine Nachricht gewartet wird. Kann in Sekunden (s oder sec oder second(s)), Minuten (m oder min oder minute(s)) oder Stunden (h oder hour(s)) oder Tage (d oder day(s)) angegeben werden.
++=== **Beispiele** ===
++Beispiel 1: Eine Nachricht von der spezifischen Verbindung "MyConnection" lesen und 5 Sekunden warten
++{{code language="powershell"}}
++Receive-AESBMessage -ConnectionName "MyConnection" -Wait 5s
++{{/code}}
++Beispiel 2: Eine Nachricht von der Standardverbindung lesen und 10 Sekunden warten
++{{code language="powershell"}}
++Receive-AESBMessage -Wait 10s
++{{/code}}
++Beispiel 3: Eine Nachricht von der Standardverbindung lesen und 1 Minute warten
++{{code language="powershell"}}
++Receive-AESBMessage -Wait 1min
++{{/code}}
++
++Beispiel 4: Eine Nachricht von der Standardverbindung lesen und 5 Stunden warten
++
++{{code language="powershell"}}
++Receive-AESBMessage -Wait 5h
++{{/code}}
++
  = Receive-AESBMessages =
++Mit diesem Cmdlet können mehrere Nachrichten aus der Queue der verbundenen SICS-Instanz ausgelesen werden. Die Anzahl der Nachrichten, die empfangen werden sollen, kann im Parameter festgelegt werden.
++
++|=(% style="width: 170px;" %)Parameter |=(% style="width: 119px;" %)Datentyp|=(% style="width: 84px;" %)Optional|=(% style="width: 56px;" %)Alias|=(% style="width: 582px;" %)Beschreibung
++|-MessageCount|int|✅|-|Die Anzahl der Nachrichten, die empfangen werden sollen. Wenn nicht angegeben, wird standardmäßig eine Nachricht empfangen.
++|-Wait|string|✅|-|Die Zeitdauer, in der auf eine Nachricht gewartet wird. Kann in Sekunden (s oder sec oder second(s)), Minuten (m oder min oder minute(s)) oder Stunden (h oder hour(s)) oder Tage (d oder day(s)) angegeben werden.
++|-Timeout|string|✅|-|Die Zeitdauer, bis ein Timeout Fehler erscheint. Kann in Sekunden (s oder sec oder second(s)), Minuten (m oder min oder minute(s)) oder Stunden (h oder hour(s)) oder Tage (d oder day(s)) angegeben werden.
++
++=== (% id="cke_bm_167708S" style="display:none" %)** **(%%)Parameter-Sets ===
++
++Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
++
++* (((
++WaitParameterSet - Wait
++)))
++* (((
++MessageCountParameterSet - MessageCount, Timeout
++)))
++
++=== **Beispiele** ===
++
++Beispiel 1: Eine Nachricht von der Standardverbindung empfangen
++
++{{code language="powershell"}}
++Receive-AESBMessages
++{{/code}}
++
++Beispiel 2: Drei Nachrichten von der Standardverbindung empfangen
++
++{{code language="powershell"}}
++Receive-AESBMessages -MessageCount 3
++{{/code}}
++
++Beispiel 3: Nachrichten von der spezifischen Verbindung "TestConnection" empfangen
++
++{{code language="powershell"}}
++Receive-AESBMessages -ConnectionName "TestConnection"
++{{/code}}
++
++Beispiel 4: Fünf Nachrichten von der spezifischen Verbindung "TestConnection" empfangen
++
++{{code language="powershell"}}
++Receive-AESBMessages -ConnectionName "TestConnection" -MessageCount 5
++
++{{/code}}
++
  = Remove-AESBConnection =
++Dieses Cmdlet löscht eine SICS-Verbindung aus dem Verzeichnis aller Verbindungen. Dabei muss im Parameter //-ConnectionName// angegebenen werden, welche SICS-Verbindung konkret entfernt werden soll.
++
++|=(% style="width: 170px;" %)Parameter |=(% style="width: 119px;" %)Datentyp|=(% style="width: 84px;" %)Optional|=(% style="width: 56px;" %)Alias|=(% style="width: 582px;" %)Beschreibung
++|-ConnectionName|String|❌|Keine|Der Name der SICS-Verbindung, die aus dem Verzeichnis aller Verbindungen entfernt werden soll.
++
++=== **Beispiele** ===
++
++Beispiel 1: Entfernen der spezifischen Verbindung "MyConnection"
++
++{{code language="powershell"}}
++Remove-AESBConnection -ConnectionName "MyConnection"
++{{/code}}
++
  = Set-AESBDefaultConnection =
++Mit diesem Cmdlet kann der Benutzer eine neue Standardverbindung für die AESB Shell festlegen. Die angegebene Verbindung wird zur Standardverbindung für alle zukünftigen Cmdlet-Aufrufe, bei denen keine andere Verbindung angegeben ist.
++
++|=(% style="width: 170px;" %)Parameter |=(% style="width: 119px;" %)Datentyp|=(% style="width: 84px;" %)Optional|=(% style="width: 56px;" %)Alias|=(% style="width: 582px;" %)Beschreibung
++|-ConnectionName|String|❌|Keine|Der Name der SICS-Verbindung, die als neue Standardverbindung gesetzt werden soll.
++
++=== **Beispiele** ===
++
++Beispiel 1: Festlegen einer neuen Standardverbindung
++
++{{code language="powershell"}}
++Remove-AESBConnection -ConnectionName "MyConnection"
++{{/code}}
++
  = Show-AESBInfrastructure =
++
++Dieses Cmdlet zeigt die aktuelle Infrastruktur des AESB Systems an, einschließlich der virtuellen Router und weiterer konfigurierter Elemente. Es ermöglicht eine detaillierte Ansicht der Systemkonfiguration.
++
++|=(% style="width: 170px;" %)Parameter |=(% style="width: 119px;" %)Datentyp|=(% style="width: 84px;" %)Optional|=(% style="width: 56px;" %)Alias|=(% style="width: 582px;" %)Beschreibung
++|-ConnectionName|string|✅|None|Der Name der Verbindung, für die die Infrastruktur angezeigt wird.
++|-ExcludeVirtualRouters|string[]|✅|None|Eine Liste von virtuellen Routern, die von der Anzeige ausgeschlossen werden sollen.
++|-IncludeVirtualRouters|string[]|✅|None|Eine Liste von virtuellen Routern, die in die Anzeige eingeschlossen werden sollen.
++
++=== Parameter-Sets ===
++
++Für die Parameter dieses Cmdlets wurden eigene Parameter-Sets definiert, die Sie verwenden können:
++
++* (((
++IncludeVirtualRoutersParameterSet- IncludeVirtualRouters
++
++ExcludeVirtualRoutersParameterSet- ExcludeVirtualRouters
++)))
++
++=== **Beispiele** ===
++
++Beispiel 1:** **Infrastruktur ohne die virtuellen Router "Router1" und "Router2" anzeigen
++
++{{code language="powershell"}}
++Show-AESBInfrastructure -ExcludeVirtualRouters "Router1", "Router2"
++{{/code}}
++
++Beispiel 2: Infrastruktur der spezifischen Verbindung "MyConnection" anzeigen
++
++{{code language="powershell"}}
++Show-AESBInfrastructure -ConnectionName "MyConnection"
++
++{{/code}}
++
++Beispiel 3: Infrastruktur mit eingeschlossenem  virtuellen Router "Router3" anzeigen
++
++{{code language="powershell"}}
++Show-AESBInfrastructure -IncludeVirtualRouters "Router3"
++
++{{/code}}
++
++