Changes for page Microservice Cmdlets

Last modified by jklein on 2025/08/15 09:48

From 6.1 to 5.1 From 7.1 to 6.3

From version 6.3

edited by jklein
on 2025/07/16 08:30

Change comment: There is no comment for this version

To version 6.1

edited by jklein
on 2025/07/16 07:29

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -621,8 +621,8 @@
  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die eine Vorlage hinzugefügt werden soll. Wird die Standardverbindung verwendet, wenn nicht angegeben.
--|-TemplateName|String|❌|Keine|Der Name für die Vorlage.
--|-TemplateConfig|XmlDocument|❌|Keine|Die Konfiguration der Vorlage.
++|-TemplateName|String|❌|Keine|Der Name für die Vorlage
++|-TemplateConfig|XmlDocument|❌|Keine|Die Konfiguration der Vorlage
  === **Beispiele** ===
@@ -685,7 +685,7 @@
  === **Rückgabewerte** ===
--Bei erfolgreicher Anwendung erhalten Sie zwei Objekte zurück.
++Bei erfolgreicher Anwendung bekommt man zwei Objekte zurück.
  * String
  ** Erfolgreiche Statusmeldung
@@ -724,237 +724,15 @@
  Dieses Cmdlet ermöglicht es, die Konfiguration einer Microservice-Vorlagen zu exportieren.
--|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
--|-ConnectionName|String|✅|C|Der Name der Verbindung, über die die Microservice-Vorlagen-Konfiguration exportiert werden soll. Wird die Standardverbindung verwendet, wenn nicht angegeben.
--|-TemplateConfig|XmlDocument|❌|Keine|Die Konfiguration, die exportiert werden soll.
--|-Path|String|❌|Keine|Der Pfad, unter dem die Microservice-Vorlagen-Konfiguration gespeichert werden soll.
--=== **Beispiele** ===
--
--Beispiel 1: MicroserviceTemplate exportieren
--
--{{code language="PowerShell"}}
--Export-AESBMicroserviceTemplateConfig -TemplateConfig $templateConfig -Path $path
--
--{{/code}}
--
--In diesem Beispiel wird die $templateConfig am Speicherort "C:\Test.xml" exportiert.
--
--{{code language="PowerShell" layout="LINENUMBERS"}}
--function Export-MicroserviceTemplateConfig {
--    param (
--        [string]$Path
--    )
--
--    $microserviceTemplates = Get-AESBMicroserviceTemplates
--
--    $microserviceTemplateConfig = Get-AESBMicroserviceTemplateConfig -TemplateName $microserviceTemplates[0].Name
--
--    $exportMicroserviceTemplateConfigResult = Export-AESBMicroserviceTemplateConfig -TemplateConfig $microserviceTemplateConfig -Path $Path
--
--    return $exportMicroserviceTemplateConfigResult
--}
--{{/code}}
--
--{{apimacro title="Beispielhafte XML-Datei nach dem Exportieren"}}
--{{code language="XML" layout="LINENUMBERS"}}
--<MicroserviceConfiguration Version="1.11.0.895" Type="SnmpConnector" SessionKey="bcafdb4e94f2572eed78525430ad0e0275229f98">
--  <SnmpConnectorConfiguration>
--    <SnmpReader>
--      <ParallelRequests>10</ParallelRequests>
--      <SchedulingConfig>
--        <SchedulingConfig_Scheduling>Interval</SchedulingConfig_Scheduling>
--        <SchedulingConfig_Interval>P1D</SchedulingConfig_Interval>
--        <SchedulingConfig_IgnoreLastExecutionTime>false</SchedulingConfig_IgnoreLastExecutionTime>
--      </SchedulingConfig>
--      <Groups />
--      <GlobalCredentialLists>
--        <GlobalCredentials />
--        <GlobalCredentialsNoPriv />
--        <GlobalCredentialsNoAuthNoPriv />
--      </GlobalCredentialLists>
--    </SnmpReader>
--    <SnmpWriters>
--      <DescriptionWriteMode>Keep</DescriptionWriteMode>
--      <LocationWriteMode>Ignore</LocationWriteMode>
--      <ContactWriteMode>Ignore</ContactWriteMode>
--      <ProcessorWriter />
--      <DispatcherStarter />
--      <FileDumper />
--    </SnmpWriters>
--  </SnmpConnectorConfiguration>
--</MicroserviceConfiguration>
--{{/code}}
--{{/apimacro}}
--
--=== Rückgabewerte ===
--
--Nach erfolgreichem Exportieren erhalten Sie eine Statusmeldung zurück.
--
--{{code language="none"}}
--Writing the file was successful.
--
--{{/code}}
--
  == Get-AESBMicroserviceTemplateConfig ==
--Dieses Cmdlet fragt die TemplateConfig einer bestimmten Microservice-Vorlage ab.
--
--|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
--|-ConnectionName|String|✅|C|Der Name der Verbindung, über die die Microservice-Vorlagen-Konfiguration exportiert werden soll. Wird die Standardverbindung verwendet, wenn nicht angegeben.
--|-TemplateName|String|❌|Keine|Der Name der Vorlage für die gewünschte Konfiguration.
--
--=== Beispiele ===
--
--Beispiel 1: MicroserviceTemplateConfig von $templateName anfragen
--
--{{code language="PowerShell"}}
--Get-AESBMicroserviceTemplateConfig -TemplateName $templateName
--{{/code}}
--
--Dieses Beispiel fragt die Templatekonfiguration mit dem Namen $templateName an. Die Standardverbindung wird verwendet.
--
--{{code language="PowerShell" layout="LINENUMBERS"}}
--function Get-MicroserviceTemplateConfig {
--
--    $aesbMicroserviceTemplates = Get-AESBMicroserviceTemplates
--
--    $microserviceTemplateConfig = Get-AESBMicroserviceTemplateConfig -TemplateName $aesbMicroserviceTemplates[0].Name
--
--    return $microserviceTemplateConfig
--}
--{{/code}}
--
--=== Rückgabewerte ===
--
--Bei erfolgreicher Anwendung erhalten Sie die gewünschte Microservice-Konfiguration zurück:
--
--* MicroserviceConfiguration
--** Version
--*** Die jeweilige Versionierung des Microservices
--** Type
--*** Der Typ des Microservices
--** TypeConfiguration
--*** Die jeweilige Typ-Konfiguration des Microservices
--
--{{code language="PowerShell"}}
--$microserviceTemplateConfig
--
--MicroserviceConfiguration
---------------------------
--MicroserviceConfiguration
--
--$microserviceTemplateConfig.MicroserviceConfiguration
--
--Version    Type          SnmpConnectorConfiguration
---------    ----          --------------------------
--1.11.0.895 SnmpConnector SnmpConnectorConfiguration
--{{/code}}
--
  == Import-AESBMicroserviceTemplateConfig ==
--Dieses Cmdlet importiert die Templatekonfiguration vom angegebenen Pfad.
--
--|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
--|-ConnectionName|String|✅|C|Der Name der Verbindung, über die die Microservices-Vorlagen-Konfiguration importiert werden soll. Wird die Standardverbindung verwendet, wenn nicht angegeben.
--|-Path|String|❌|Keine|Der Pfad, von dem die Konfiguration importiert werden soll.
--
--=== Beispiele ===
--
--Beispiel 1: Templatekonfiguration von $path laden
--
--{{code language="PowerShell"}}
--Import-AESBMicroserviceTemplateConfig -Path $path
--
--{{/code}}
--
--Dieses Beispiel importiert die Templatekonfiguration beim hinterlegten Pfad. Die Standardverbindung wird verwendet.
--
--=== Rückgabewerte ===
--
--Bei erfolgreicher Anwendung erhalten Sie die gewünschte MicroserviceConfiguration zurück:
--
--* MicroserviceConfiguration
--** Version
--*** Die jeweilige Versionierung des Microservices
--** Type
--*** Der Typ des Microservices
--** TypeConfiguration
--*** Die jeweilige Typ-Konfiguration des Microservices
--
--{{code language="PowerShell"}}
--$microserviceTemplateConfig
--
--MicroserviceConfiguration
---------------------------
--MicroserviceConfiguration
--
--$microserviceTemplateConfig.MicroserviceConfiguration
--
--Version    Type          SnmpConnectorConfiguration
---------    ----          --------------------------
--1.11.0.895 SnmpConnector SnmpConnectorConfiguration
--{{/code}}
--
  == Migrate-AESBMicroserviceTemplate ==
--Mit diesem Cmdlet werden bestehende Vorlagen auf die gewünschte Zielversion übertragen.
--
--|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
--|-ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Vorlagen migriert werden sollen. Wird die Standardverbindung verwendet, wenn nicht angegeben.
--|-TemplateNames|String[]|❌|Keine|Hier sind die Namen der Vorlagen, die übertragen werden sollen.
--|-TargetVersion|String|❌|Keine|Die Zielversion, auf die die Vorlagen migriert werden sollen.
--|-KeepTemplateIds|SwitchParameter|✅|Keine|Hier wird festgelegt, ob die bestehenden Template-IDs gleich bleiben oder beim Migrieren neu erstellt werden sollen.
--
--=== Beispiele ===
--
--Beispiel 1: Mehrere Templates auf Version $templateVersion migrieren
--
--{{code language="PowerShell"}}
--Migrate-AESBMicroserviceTemplates -TemplateNames $templateNames -TargetVersion $templateVersion
--
--{{/code}}
--
--Dieses Beispiel migriert alle Templates die in $templateNames stehen auf die Version $templateVersion
--
--=== Rückgabewerte ===
--
--Bei erfolgreicher Anwendung erhalten Sie eine Liste von Template-Informationen mit den neuen Daten der erfolgreich migrierten Templates:
--
--* TemplateInfo
--** TemplateId
--*** Die neu erstellte / gleichbleibende Id des Templates
--** Configuration
--*** Die aktuelle Konfiguration des Templates
--** Name
--*** Der neue Name des Template
--** Type
--*** Der Typ des Templates
--** Version
--*** Die neue Version des Templates
--
--{{code language="PowerShell"}}
--TemplateId    : ffffffff-ffff-ffff-ffff-ffffffffffff"
--Configuration : <Configuration>
--                  <SchedulingConfig>
--                    <SchedulingConfig_Scheduling>Disabled</SchedulingConfig_Scheduling>
--                  </SchedulingConfig>
--                </Configuration>
--Name          : TestTest_1_0_0_1
--Type          : Test
--Version       : 1.0.0.1
--{{/code}}
--
  == New-AESBMicroserviceTemplateConfig ==
--
--
--
--
--
--
--
--
  == Remove-AESBMicroserviceTemplate ==
  == Update-AESBMicroserviceTemplate ==