Changes for page Microservice Cmdlets

Last modified by jklein on 2025/08/15 09:48
From version 4.1
edited by jklein
on 2025/06/23 10:40
Change comment: There is no comment for this version
To version 4.2
edited by jklein
on 2025/06/24 08:35
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -533,7 +533,6 @@
533 533  
534 534  Mit diesem Cmdlet werden die angegebenen, laufenden Microservice-Instanzen gestoppt. Die zu stoppenden Microservices können entweder über ihre `InstanceIds` oder über eine `SupervisorId` (die alle zugehörigen Instanzen stoppt) identifiziert werden. Es muss einer der Parameter `-InstanceIds` oder `-SupervisorId` angegeben werden.
535 535  
536 -
537 537  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
538 538  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Instanzen gestoppt werden sollen. Wird die Standardverbindung verwendet, wenn nicht angegeben.
539 539  |-SupervisorId|String|❌|Keine|Gibt die ID des Supervisors an, dessen zugehörige Microservices gestoppt werden sollen. Obligatorisch für Parametersatz `UseSupervisorIdParameterSet`.
... ... @@ -591,10 +591,296 @@
591 591  
592 592  == Get-AESBMicroservicePackages ==
593 593  
593 +Dieses Cmdlet ruft eine Liste aller verfügbaren Microservice-Pakete und deren Versionen ab. Es sind keine spezifischen Parameter erforderlich.
594 +
595 +|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
596 +|-ConnectionName|String|✅|C|Der Name der Verbindung, über die Informationen zu Microservice-Paketen abgerufen werden soll. Wird die Standardverbindung verwendet, wenn nicht angegeben.
597 +
598 +=== **Beispiele** ===
599 +
600 +Beispiel 1: Alle verfügbaren Microservice-Pakete auflisten
601 +
602 +{{code language="PowerShell"}}
603 +Get-AESBMicroservicePackages
604 +
605 +{{/code}}
606 +
607 +Dieser Befehl ruft alle verfügbaren Microservice-Pakete und die zugehörigen Versionen ab.
608 +
609 +=== **Rückgabewert** ===
610 +
611 +Das Cmdlet gibt für jedes gefundene Microservice-Paket ein Objekt zurück. Dieses Objekt enthält typischerweise die folgenden Informationen:
612 +
613 +* **PackageName**: Der Name des Microservice-Pakets.
614 +* **PackageVersions**: Eine Liste der verfügbaren Versionen für dieses Paket.
615 +
594 594  = Templates =
595 595  
596 596  == Add-AESBMicroserviceTemplate ==
597 597  
620 +Dieses Cmdlet fügt eine Microservice-Vorlage auf Basis der beigefügten Vorlagen-Konfiguration hinzu.
621 +
622 +|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
623 +|-ConnectionName|String|✅|C|Der Name der Verbindung, über die eine Vorlage hinzugefügt werden soll. Wird die Standardverbindung verwendet, wenn nicht angegeben.
624 +|-TemplateName|String|❌|Keine|Der Name für die Vorlage
625 +|-TemplateConfig|XmlDocument|❌|Keine|Die Konfiguration der Vorlage
626 +
627 +=== **Beispiele** ===
628 +
629 +Beispiel 1: Fügt ein neues Microservice-Template hinzu
630 +
631 +{{code language="PowerShell"}}
632 +Add-AESBMicroserviceTemplate -TemplateName "Test" -TemplateConfig $templateConfig
633 +{{/code}}
634 +
635 +Dieses Beispiel fügt eine neue Templatekonfiguration mit dem Namen "Test" auf Basis des $templateConfig-Objekts hinzu. Die Standardverbindung wird verwendet.
636 +
637 +
638 +**Beispiel Funktion in PowerShell**
639 +
640 +|(((
641 +1
642 +
643 +2
644 +
645 +3
646 +
647 +4
648 +
649 +5
650 +
651 +6
652 +
653 +7
654 +
655 +8
656 +
657 +9
658 +
659 +10
660 +
661 +11
662 +
663 +12
664 +
665 +13
666 +)))|(((
667 +function Add-MicroserviceTemplate {
668 +
669 + param (
670 +
671 + [string]$Name
672 +
673 + )
674 +
675 +
676 + $packages = Get-AESBMicroservicePackages
677 +
678 +
679 + $microserviceTemplateConfig = New-AESBMicroserviceTemplateConfig -PackageName $packages[0].PackageName -PackageVersion $packages[0].PackageVersions[0]
680 +
681 +
682 + $addMicroserviceResult = Add-AESBMicroserviceTemplate -TemplateName $Name -TemplateConfig $microserviceTemplateConfig
683 +
684 +
685 + return $addMicroserviceResult
686 +
687 +}
688 +)))
689 +
690 +
691 +
692 +**Beispiel Template Konfiguration**
693 +
694 +|(((
695 +1
696 +
697 +2
698 +
699 +3
700 +
701 +4
702 +
703 +5
704 +
705 +6
706 +
707 +7
708 +
709 +8
710 +
711 +9
712 +
713 +10
714 +
715 +11
716 +
717 +12
718 +
719 +13
720 +
721 +14
722 +
723 +15
724 +
725 +16
726 +
727 +17
728 +
729 +18
730 +
731 +19
732 +
733 +20
734 +
735 +21
736 +
737 +22
738 +
739 +23
740 +
741 +24
742 +
743 +25
744 +
745 +26
746 +)))|(((
747 +$templateConfig = "<MicroserviceConfiguration Version=`"1.11.0.895`" Type=`"SnmpConnector`" SessionKey=`"bcafdb4e94f2572eed78525430ad0e0275229f98`">
748 +
749 + <SnmpConnectorConfiguration>
750 +
751 + <SnmpReader>
752 +
753 + <ParallelRequests>10</ParallelRequests>
754 +
755 + <SchedulingConfig>
756 +
757 + <SchedulingConfig_Scheduling>Interval</SchedulingConfig_Scheduling>
758 +
759 + <SchedulingConfig_Interval>P1D</SchedulingConfig_Interval>
760 +
761 + <SchedulingConfig_IgnoreLastExecutionTime>false</SchedulingConfig_IgnoreLastExecutionTime>
762 +
763 + </SchedulingConfig>
764 +
765 + <Groups />
766 +
767 + <GlobalCredentialLists>
768 +
769 + <GlobalCredentials />
770 +
771 + <GlobalCredentialsNoPriv />
772 +
773 + <GlobalCredentialsNoAuthNoPriv />
774 +
775 + </GlobalCredentialLists>
776 +
777 + </SnmpReader>
778 +
779 + <SnmpWriters>
780 +
781 + <DescriptionWriteMode>Keep</DescriptionWriteMode>
782 +
783 + <LocationWriteMode>Ignore</LocationWriteMode>
784 +
785 + <ContactWriteMode>Ignore</ContactWriteMode>
786 +
787 + <ProcessorWriter />
788 +
789 + <DispatcherStarter />
790 +
791 + <FileDumper />
792 +
793 + </SnmpWriters>
794 +
795 + </SnmpConnectorConfiguration>
796 +
797 +</MicroserviceConfiguration>"
798 +)))
799 +
800 +
801 +
802 +==== 12.2. **Rückgabewerte** ====
803 +
804 +Bei erfolgreicher Anwendung bekommt man zwei Objekte zurück.
805 +
806 +* String
807 +** Erfolgreiche Statusmeldung
808 +* TemplateInfo
809 +** TemplateId
810 +*** ID des Templates
811 +** Configuration
812 +*** Aktuelle Konfiguration des Templates
813 +** Name
814 +*** Name des Templates
815 +** Type
816 +*** Der Typ des Templates
817 +** Version
818 +*** Die Versionierung des Templates
819 +
820 +
821 +
822 +**Beispiel Template Konfiguration**
823 +
824 +|(((
825 +1
826 +
827 +2
828 +
829 +3
830 +
831 +4
832 +
833 +5
834 +
835 +6
836 +
837 +7
838 +
839 +8
840 +
841 +9
842 +
843 +10
844 +
845 +11
846 +
847 +12
848 +
849 +13
850 +
851 +14
852 +)))|(((
853 +Successfully added template 'Test'.
854 +
855 +
856 +TemplateId    : 119398aa-8108-43bd-811b-bd3e703e7f5c
857 +
858 +Configuration : <SnmpConnectorConfiguration><SnmpReader><ParallelRequests>10</ParallelRequests><SchedulingConfig><Sched
859 +
860 + ulingConfig_Scheduling>Interval</SchedulingConfig_Scheduling><SchedulingConfig_Interval>P1D</Scheduling
861 +
862 + Config_Interval><SchedulingConfig_IgnoreLastExecutionTime>false</SchedulingConfig_IgnoreLastExecutionTi
863 +
864 + me></SchedulingConfig><Groups /><GlobalCredentialLists><GlobalCredentials /><GlobalCredentialsNoPriv
865 +
866 + /><GlobalCredentialsNoAuthNoPriv /></GlobalCredentialLists></SnmpReader><SnmpWriters><DescriptionWriteM
867 +
868 + ode>Keep</DescriptionWriteMode><LocationWriteMode>Ignore</LocationWriteMode><ContactWriteMode>Ignore</C
869 +
870 + ontactWriteMode><ProcessorWriter /><DispatcherStarter /><FileDumper
871 +
872 + /></SnmpWriters></SnmpConnectorConfiguration>
873 +
874 +Name          : Test
875 +
876 +Type          : SnmpConnector
877 +
878 +Version       : 1.11.0.895
879 +)))
880 +
881 +
882 +
598 598  == Export-MicroserviceTemplateConfig ==
599 599  
600 600  == Get-AESBMicroserviceTemplateConfig ==
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community