Changes for page Microservice Cmdlets

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

From version 7.1
edited by jklein
on 2025/07/16 09:56
Change comment: There is no comment for this version
To version 11.1
edited by jklein
on 2025/07/21 08:49
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -6,14 +6,15 @@
6 6  
7 7  Mit diesem Cmdlet wird eine neue Microservice-Instanz nach der Vorlage eines Templates hinzugefügt.
8 8  
9 -|=(% style="width: 213px;" %)Parameter |=(% style="width: 209px;" %)ParameterSetName|=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
10 -|-ConnectionName|Keine|String|✅|C|Der Name der Verbindung, über die die Microservice-Instanz hinzugefügt werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
11 -|-InstanceName|Keine|String|❌|Keine|Der Name der Instanz.
12 -|-TemplateName|UseTemplateName|String|❌|Keine|Der Name des Templates für die Vorlage der Instanz.
13 -|-TemplateId|UseTemplateId|String|❌|Keine|Die Id des Templates für die Vorlage der Instanz.
14 -|-SupervisorId|Keine|String|✅|Keine|Die Id des Supervisors zu der die Instanz hinzugefügt werden soll.
15 -|-StartupType|Keine|InstanceStartType|✅|Keine|Setzt die Art der Zeitplanung der Instanz.
16 -|-StoppedAfterCreation|Keine|Bool|✅|Keine|Setzt den Wert um die Instanz direkt nach der Erstellung zu starten.
9 +(% style="width:902px" %)
10 +|=(% style="width: 213px;" %)Parameter |=(% style="width: 154px;" %)ParameterSetName|=(% style="width: 156px;" %)Datentyp|=(% style="width: 55px;" %)Optional|=(% style="width: 76px;" %)Alias|=(% style="width: 206px;" %)Beschreibung
11 +|-ConnectionName|(% style="width:154px" %)Keine|(% style="width:156px" %)String|(% style="width:55px" %)✅|(% style="width:76px" %)C|(% style="width:206px" %)Der Name der Verbindung, über die die Microservice-Instanz hinzugefügt werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
12 +|-InstanceName|(% style="width:154px" %)Keine|(% style="width:156px" %)String|(% style="width:55px" %)❌|(% style="width:76px" %)Keine|(% style="width:206px" %)Der Name der Instanz.
13 +|-TemplateName|(% style="width:154px" %)UseTemplateName|(% style="width:156px" %)String|(% style="width:55px" %)❌|(% style="width:76px" %)Keine|(% style="width:206px" %)Der Name des Templates für die Vorlage der Instanz.
14 +|-TemplateId|(% style="width:154px" %)UseTemplateId|(% style="width:156px" %)String|(% style="width:55px" %)❌|(% style="width:76px" %)Keine|(% style="width:206px" %)Die Id des Templates für die Vorlage der Instanz.
15 +|-SupervisorId|(% style="width:154px" %)Keine|(% style="width:156px" %)String|(% style="width:55px" %)✅|(% style="width:76px" %)Keine|(% style="width:206px" %)Die Id des Supervisors zu der die Instanz hinzugefügt werden soll.
16 +|-StartupType|(% style="width:154px" %)Keine|(% style="width:156px" %)InstanceStartType|(% style="width:55px" %)✅|(% style="width:76px" %)Keine|(% style="width:206px" %)Setzt die Art der Zeitplanung der Instanz.
17 +|-StoppedAfterCreation|(% style="width:154px" %)Keine|(% style="width:156px" %)Bool|(% style="width:55px" %)✅|(% style="width:76px" %)Keine|(% style="width:206px" %)Setzt den Wert um die Instanz direkt nach der Erstellung zu starten.
17 17  
18 18  === **Beispiele** ===
19 19  
... ... @@ -626,13 +626,13 @@
626 626  
627 627  === **Beispiele** ===
628 628  
629 -Beispiel 1: Fügt ein neues Microservice-Template hinzu
630 +Beispiel 1: Fügt ein neue Microservice-Vorlage hinzu
630 630  
631 631  {{code language="PowerShell"}}
632 632  Add-AESBMicroserviceTemplate -TemplateName "Test" -TemplateConfig $templateConfig
633 633  {{/code}}
634 634  
635 -Dieses Beispiel fügt eine neue Templatekonfiguration mit dem Namen "Test" auf Basis des $templateConfig-Objekts hinzu. Die Standardverbindung wird verwendet.
636 +Dieses Beispiel fügt eine neue Vorlagen-konfiguration mit dem Namen "Test" auf Basis des $templateConfig-Objekts hinzu. Die Standardverbindung wird verwendet.
636 636  
637 637  {{apimacro title="Beispiel der Funktion in PowerShell"}}
638 638  {{code language="PowerShell" layout="LINENUMBERS"}}
... ... @@ -652,7 +652,7 @@
652 652  {{/code}}
653 653  {{/apimacro}}
654 654  
655 -{{apimacro title="Beispiel der Template-Konfiguration"}}
656 +{{apimacro title="Beispiel der Vorlagen-Konfiguration"}}
656 656  {{code language="PowerShell" layout="LINENUMBERS"}}
657 657  $templateConfig = "<MicroserviceConfiguration Version=`"1.11.0.895`" Type=`"SnmpConnector`" SessionKey=`"bcafdb4e94f2572eed78525430ad0e0275229f98`">
658 658   <SnmpConnectorConfiguration>
... ... @@ -691,17 +691,17 @@
691 691  ** Erfolgreiche Statusmeldung
692 692  * TemplateInfo
693 693  ** TemplateId
694 -*** ID des Templates
695 +*** ID der Vorlage
695 695  ** Configuration
696 -*** Aktuelle Konfiguration des Templates
697 +*** Aktuelle Konfiguration der Vorlage
697 697  ** Name
698 -*** Name des Templates
699 +*** Name der Vorlage
699 699  ** Type
700 -*** Der Typ des Templates
701 +*** Der Typ der Vorlage
701 701  ** Version
702 -*** Die Versionierung des Templates
703 +*** Die Versionierung der Vorlage
703 703  
704 -{{apimacro title="Rückgabewerte der Template-Konfiguration"}}
705 +{{apimacro title="Rückgabewerte der Vorlagen-Konfiguration"}}
705 705  {{code language="PowerShell" layout="LINENUMBERS"}}
706 706  Successfully added template 'Test'.
707 707  
... ... @@ -731,7 +731,7 @@
731 731  
732 732  === **Beispiele** ===
733 733  
734 -Beispiel 1: MicroserviceTemplate exportieren
735 +Beispiel 1: Microservice-Vorlage exportieren
735 735  
736 736  {{code language="PowerShell"}}
737 737  Export-AESBMicroserviceTemplateConfig -TemplateConfig $templateConfig -Path $path
... ... @@ -806,13 +806,13 @@
806 806  
807 807  === Beispiele ===
808 808  
809 -Beispiel 1: MicroserviceTemplateConfig von //$templateName// anfragen
810 +Beispiel 1: Konfiguration der Microservice-Vorlage von //$templateName// anfragen
810 810  
811 811  {{code language="PowerShell"}}
812 812  Get-AESBMicroserviceTemplateConfig -TemplateName $templateName
813 813  {{/code}}
814 814  
815 -Dieses Beispiel fragt die Templatekonfiguration mit dem Namen //$templateName// an. Die Standardverbindung wird verwendet.
816 +Dieses Beispiel fragt die Vorlagen-Konfiguration mit dem Namen //$templateName// an. Die Standardverbindung wird verwendet.
816 816  
817 817  {{code language="PowerShell" layout="LINENUMBERS"}}
818 818  function Get-MicroserviceTemplateConfig {
... ... @@ -831,7 +831,7 @@
831 831  
832 832  * MicroserviceConfiguration
833 833  ** Version
834 -*** Die jeweilige Versionierung des Microservices
835 +*** Die jeweilige Version des Microservices
835 835  ** Type
836 836  *** Der Typ des Microservices
837 837  ** TypeConfiguration
... ... @@ -851,9 +851,61 @@
851 851  1.11.0.895 SnmpConnector SnmpConnectorConfiguration
852 852  {{/code}}
853 853  
855 +== Get-AESBMicroserviceTemplates ==
856 +
857 +Dieses Cmdlet fragt die vorhandenen Microservice-Vorlagen ab und listet sie auf.
858 +
859 +|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
860 +|-ConnectionName|String|✅|C|Der Name der Verbindung, über die die Microservices-Vorlagen-Konfiguration importiert werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
861 +|-PackageName|String|✅| |Der Name des Microservice-Pakets, dessen Vorlagen geholt werden sollen
862 +|-PackageVersion|String|✅| |Die Version des Pakets, dessen Vorlagen geholt werden sollen
863 +
864 +=== Beispiele ===
865 +
866 +Beispiel 1: Alle vorhandenen Microservice-Vorlagen anzeigen
867 +
868 +{{code language="PowerShell"}}
869 +Get-AESBMicroserviceTemplates
870 +{{/code}}
871 +
872 +Dieses Beispiel listet alle vorhandenen Microservice-Vorlagen auf. Die Standardverbindung wird verwendet. Falls keine Vorlagen vorhanden sind, wird ein Fehler angezeigt.
873 +
874 +Beispiel 2: Die Vorlagen eines bestimmten Microservice-Pakets einer bestimmten Version auflisten
875 +
876 +{{code language="PowerShell"}}
877 +Get-AESBMicroserviceTemplates -PackageName "SnmpConnector" -PackageVersion "1.11.0.895"
878 +
879 +{{/code}}
880 +
881 + Dieses Beispiel listet alle vorhandenen Microservice-Vorlagen des Pakets "SnmpConnector" in der Version "1.11.0.895" auf. Die Standardverbindung wird verwendet.
882 +
883 +=== Rückgabewerte ===
884 +
885 +Bei erfolgreicher Anwendung werden die gewünschten Microservice-Vorlagen als Objekte aufgelistet.
886 +
887 +* MicroserviceTemplate
888 +** Name
889 +*** Der Name der Vorlage
890 +** Id
891 +*** Die Id der Vorlage
892 +** PackageName
893 +*** Der Name des Microservice-Pakets
894 +** PackageVersion
895 +*** Die Version des Microservice-Pakets
896 +
897 +{{code language="PowerShell"}}
898 +Name Id PackageName PackageVersion
899 +
900 +---- -- ----------- --------------
901 +
902 +SnmpConnector a6e37f49-5a15-4213-96f5-e23cc03209a8 SnmpConnector 1.11.0.895
903 +
904 +PS_Microservice1 33618fc3-60f2-484b-b6c9-b9f19c5eb4fa PS_Microservice1 1.1.0.1
905 +{{/code}}
906 +
854 854  == Import-AESBMicroserviceTemplateConfig ==
855 855  
856 -Dieses Cmdlet importiert die Templatekonfiguration vom angegebenen Pfad.
909 +Dieses Cmdlet importiert die Vorlagen-Konfiguration vom angegebenen Pfad.
857 857  
858 858  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
859 859  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die die Microservices-Vorlagen-Konfiguration importiert werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
... ... @@ -861,7 +861,7 @@
861 861  
862 862  === Beispiele ===
863 863  
864 -Beispiel 1: Templatekonfiguration von //$path// laden
917 +Beispiel 1: Vorlagen-Konfiguration von //$path// laden
865 865  
866 866  {{code language="PowerShell"}}
867 867  Import-AESBMicroserviceTemplateConfig -Path $path
... ... @@ -868,7 +868,7 @@
868 868  
869 869  {{/code}}
870 870  
871 -Dieses Beispiel importiert die Templatekonfiguration beim hinterlegten Pfad. Die Standardverbindung wird verwendet.
924 +Dieses Beispiel importiert die Vorlagen-Konfiguration beim hinterlegten Pfad. Die Standardverbindung wird verwendet.
872 872  
873 873  === Rückgabewerte ===
874 874  
... ... @@ -876,7 +876,7 @@
876 876  
877 877  * MicroserviceConfiguration
878 878  ** Version
879 -*** Die jeweilige Versionierung des Microservices
932 +*** Die jeweilige Version des Microservices
880 880  ** Type
881 881  *** Der Typ des Microservices
882 882  ** TypeConfiguration
... ... @@ -908,7 +908,7 @@
908 908  
909 909  === Beispiele ===
910 910  
911 -Beispiel 1: Mehrere Templates auf Version //$templateVersion// migrieren
964 +Beispiel 1: Mehrere Vorlagen auf Version //$templateVersion// migrieren
912 912  
913 913  {{code language="PowerShell"}}
914 914  Migrate-AESBMicroserviceTemplates -TemplateNames $templateNames -TargetVersion $templateVersion
... ... @@ -915,23 +915,23 @@
915 915  
916 916  {{/code}}
917 917  
918 -Dieses Beispiel migriert alle Templates die in //$templateNames// stehen auf die Version //$templateVersion//.
971 +Dieses Beispiel migriert alle Vorlagen, die in //$templateNames// stehen, auf die Version //$templateVersion//.
919 919  
920 920  === Rückgabewerte ===
921 921  
922 -Bei erfolgreicher Anwendung erhalten Sie eine Liste von Template-Informationen mit den neuen Daten der erfolgreich migrierten Templates:
975 +Bei erfolgreicher Anwendung erhalten Sie eine Liste von Vorlagen-Informationen mit den neuen Daten der erfolgreich migrierten Vorlagen:
923 923  
924 924  * TemplateInfo
925 925  ** TemplateId
926 -*** Die neu erstellte / gleichbleibende Id des Templates
979 +*** Die neu erstellte / gleichbleibende Id der Vorlage
927 927  ** Configuration
928 -*** Die aktuelle Konfiguration des Templates
981 +*** Die aktuelle Konfiguration der Vorlage
929 929  ** Name
930 -*** Der neue Name des Template
983 +*** Der neue Name der Vorlage
931 931  ** Type
932 -*** Der Typ des Templates
985 +*** Der Typ der Vorlage
933 933  ** Version
934 -*** Die neue Version des Templates
987 +*** Die neue Version der Vorlage
935 935  
936 936  {{code language="PowerShell"}}
937 937  TemplateId : ffffffff-ffff-ffff-ffff-ffffffffffff"
... ... @@ -965,17 +965,17 @@
965 965  New-AESBMicroserviceTemplateConfig -PackageName $packageName -PackageVersion $packageVersion
966 966  {{/code}}
967 967  
968 -Dieses Beispiel erstellt eine Template-Konfiguration auf Basis des angegebenen Microservicepackage.
1021 +Dieses Beispiel erstellt eine Vorlagen-Konfiguration auf Basis des angegebenen Microservice-Pakets.
969 969  
970 970  === Rückgabewerte ===
971 971  
972 972  * MicroserviceConfiguration
973 973  ** Version
974 -*** Die neue Version des Templates
1027 +*** Die neue Version der Vorlage
975 975  ** Type
976 -*** Der Typ des Templates
1029 +*** Der Typ der Vorlage
977 977  ** Configuration
978 -*** Die aktuelle Konfiguration des Templates
1031 +*** Die aktuelle Konfiguration der Vorlage
979 979  
980 980  {{code language="PowerShell" layout="LINENUMBERS"}}
981 981  $microserviceTemplateConfig = New-AESBMicroserviceTemplateConfig -PackageName $packageName -PackageVersion $packageVersion
... ... @@ -995,7 +995,6 @@
995 995  
996 996  Mit diesem Cmdlet können Sie Microservice-Vorlagen löschen.
997 997  
998 -
999 999  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
1000 1000  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die die Microservice-Vorlagen gelöscht werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
1001 1001  |-TemplateIds|String[]|❌|Keine|Die ID's der Vorlagen, die zu löschen sind.
... ... @@ -1003,7 +1003,7 @@
1003 1003  
1004 1004  === Beispiele ===
1005 1005  
1006 -Beispiel 1: Template löschen
1058 +Beispiel 1: Vorlage löschen
1007 1007  
1008 1008  {{code language="PowerShell"}}
1009 1009  Remove-AESBMicroserviceTemplate -TemplateIds 4b016fd1-47fb-4f24-87dd-4e365fe870d3
... ... @@ -1010,17 +1010,17 @@
1010 1010  
1011 1011  {{/code}}
1012 1012  
1013 -Dieses Beispiel löscht ein Microservice Template auf Basis der angegebenen Id.
1065 +Dieses Beispiel löscht eine Microservice-Vorlage auf Basis der angegebenen Id.
1014 1014  
1015 -Beispiel 2: Templates löschen
1067 +Beispiel 2: Vorlagen löschen
1016 1016  
1017 1017  {{code language="PowerShell"}}
1018 1018  Remove-AESBMicroserviceTemplate -TemplateIds "4b016fd1-47fb-4f24-87dd-4e365fe870d3", "D1936807-E1B0-4F8B-AB7F-98ECD202CF8F"
1019 1019  {{/code}}
1020 1020  
1021 -Dieses Beispiel löscht mehrere Microservice Templates auf Basis der angegebenen Ids.
1073 +Dieses Beispiel löscht mehrere Microservice-Vorlagen auf Basis der angegebenen Ids.
1022 1022  
1023 -Beispiel 3: Templates löschen mitsamt den Referenzen
1075 +Beispiel 3: Vorlagen löschen mitsamt den Referenzen
1024 1024  
1025 1025  {{code language="PowerShell"}}
1026 1026  Remove-AESBMicroserviceTemplate -TemplateIds "4b016fd1-47fb-4f24-87dd-4e365fe870d3" -RemoveReferences
... ... @@ -1027,7 +1027,7 @@
1027 1027  
1028 1028  {{/code}}
1029 1029  
1030 -Dieses Beispiel löscht ein Microservice Template misamt den erstellten Referenzen des Templates.
1082 +Dieses Beispiel löscht eine Microservice-Vorlage mitsamt den erstellten Referenzen der Vorlage .
1031 1031  
1032 1032  === Rückgabewerte ===
1033 1033  
... ... @@ -1035,7 +1035,7 @@
1035 1035  ** StatusResult
1036 1036  *** Ergebnis des Resultats des Vorgangs
1037 1037  ** TemplateId
1038 -*** Die erfolgreich gelöschte Id des Templates
1090 +*** Die erfolgreich gelöschte Id der Vorlage
1039 1039  ** Message
1040 1040  *** Status Nachricht
1041 1041  
... ... @@ -1056,7 +1056,7 @@
1056 1056  
1057 1057  === Beispiele ===
1058 1058  
1059 -Beispiel 1: Template updaten
1111 +Beispiel 1: Vorlage updaten
1060 1060  
1061 1061  {{code language="PowerShell" layout="LINENUMBERS"}}
1062 1062  $templateConfiguration = <MicroserviceConfiguration Version="1.0.0.0" Type="Test" SessionKey="72962557bb8bbd00b53dcb53d99cea685ed636bf">
... ... @@ -1071,7 +1071,7 @@
1071 1071  Update-AESBMicroserviceTemplate -TemplateId "838fb7e2-e293-4004-9602-7223aaa3854a" -TemplateConfig $templateConfiguration
1072 1072  {{/code}}
1073 1073  
1074 -Dieses Beispiel updated das Template mit der beigefügten Konfiguration.
1126 +Dieses Beispiel updated die Vorlage mit der beigefügten Konfiguration.
1075 1075  
1076 1076  === Rückgabewerte ===
1077 1077  
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community