Changes for page Microservice Cmdlets

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

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

Summary

Details

Page properties
Content
... ... @@ -533,6 +533,7 @@
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 +
536 536  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
537 537  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Instanzen gestoppt werden sollen. Wird die Standardverbindung verwendet, wenn nicht angegeben.
538 538  |-SupervisorId|String|❌|Keine|Gibt die ID des Supervisors an, dessen zugehörige Microservices gestoppt werden sollen. Obligatorisch für Parametersatz `UseSupervisorIdParameterSet`.
... ... @@ -590,296 +590,10 @@
590 590  
591 591  == Get-AESBMicroservicePackages ==
592 592  
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 -
616 616  = Templates =
617 617  
618 618  == Add-AESBMicroserviceTemplate ==
619 619  
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 -
883 883  == Export-MicroserviceTemplateConfig ==
884 884  
885 885  == Get-AESBMicroserviceTemplateConfig ==
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community