Informationen zu Configuration Manager-Konsolenformularen

Artikel
04/04/2023

Sie können die Configuration Manager-Konsole mit neuen Windows Forms erweitern. Insbesondere können Sie formularbasierte Dialogfelder und Eigenschaftenblätter hinzufügen. Ein Benutzer greift über Configuration Manager von Ihnen definierten Aktionen auf diese Formulare zu.

Hinweis

Assistenten sind ein weiteres Windows-Formular, das von der Configuration Manager-Konsole verwendet wird. Sie können jedoch keine Assistenten mithilfe des Configuration Manager-Konsolenframeworks erweitern oder hinzufügen. Sie können jedoch ihre eigene Assistentenlösung ausführen, indem Sie Configuration Manager Aktionen verwenden.

In Configuration Manager werden Formulare in .NET Framework Assemblys gespeichert, die von der Configuration Manager-Konsole aufgerufen werden, nachdem die entsprechende Aktion ausgewählt wurde.

Erstellen eines Erweiterungsformulars

Gehen Sie wie folgt vor, um ein Erweiterungsformular zu schreiben:

Erstellen Sie die Erweiterungsformularassembly.
Erstellen Sie den XML-Code für die Erweiterungsformularaktion.
Erstellen Sie die XML-Datei für das Erweiterungsformular.

Erstellen der Erweiterungsformularassembly

Eigenschaftenblätter

Ein Eigenschaftenblatt besteht aus einer oder mehreren Eigenschaftenseiten, die Sie definieren. Sie können Auch Eigenschaftenseiten in vorhandene Configuration Manager Eigenschaftenblätter integrieren.

Um ein Eigenschaftenblatt zu erstellen, erstellen Sie ein Windows-Steuerelementbibliotheksprojekt in Visual Studio. In diesem Projekt erstellen Sie eine Klasse, die vom Microsoft erbt. ConfigurationManagement.AdminConsole.SmsPageControl-Klasse. Diese Klasse implementiert das Steuerelement, das Sie auf einer Eigenschaftenseite anzeigen möchten. In einem Eigenschaftenblatt erstellen Sie eine SmsPageControl-Klasse für jede Eigenschaftenseite, die Sie benötigen. Das Beispiel für den Prototyp des Eigenschaftenblatts im Configuration Manager SDK enthält eine vollständige Lösung, die Sie verwenden können. Weitere Informationen finden Sie unter Erstellen eines Configuration Manager Eigenschaftenblatts.

Dialogfelder

Ein Dialogfeld in Configuration Manager wird wie ein typisches Dialogfeld ohne Modus angezeigt. Sie erstellen ein SMSPageControl-Steuerelement und geben "Dialog" in der Formular-XML an. Weitere Informationen finden Sie unter Erstellen eines Configuration Manager Dialogfelds.

Erstellen der XML-Datei für die Formularaktion

Eine Aktion beschreibt den Typ der aufgerufenen Erweiterung und den Speicherort der Aktion in der Configuration Manager Konsolenbenutzeroberfläche. Für ein Erweiterungsformular verwenden Sie den ShowDialog Aktionstyp, um das Formular anzuzeigen. Weitere Informationen finden Sie unter How to Create Action XML for a Configuration Manager Property Sheet.For more information, see How to Create Action XML for a Configuration Manager Property Sheet.

Weitere Informationen zu Aktionen finden Sie unter Informationen Configuration Manager Konsolenaktionen.

Erstellen der XML-Datei des Formulareigenschaftenblatts

Unabhängig davon, ob das Formular ein Eigenschaftenblatt ist oder nicht, verfügt das Formular über eine XML-Formulardatei, die die Assembly, den Namespace und den Typ des Formulars definiert. In Eigenschaftenblättern wird die Reihenfolge der Eigenschaftenseiten auf dem Eigenschaftenblatt definiert. Es gibt eine XML-Datei des Eigenschaftenblatts für jedes Configuration Manager-Konsolenformular.

Hinweis

Die XML-Dateien des Configuration Manager-Konsoleneigenschaftenblatts werden in %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Forms gespeichert.

Wenn Sie ein neues Formular erstellen, erstellen Sie eine neue XML-Datei des Eigenschaftenblatts. Wenn Sie einem vorhandenen Eigenschaftenblatt eine neue Eigenschaftenseite hinzufügen, führen Sie die XML-Datei der Eigenschaftenseite mit einer vorhandenen XML-Datei des Eigenschaftenblatts zusammen.

Hinweis

Erweiterungseigenschaftenblätter werden in %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms gespeichert.

Weitere Informationen zur Xml-Bereitstellung von Formularen finden Sie unter Configuration Manager Bereitstellung der Konsolenerweiterung.

Je nachdem, ob Sie ein Dialogfeld oder ein Eigenschaftenblatt anzeigen, müssen die FormType-Attributwerte festgelegt werden.

FormType	Beschreibung
Propertysheet.showdialog	Das Formular ist ein Eigenschaftenblatt.
Dialogfeld	Das Formular ist ein Dialogfeld.

Wenn eine Aktion ausgewählt ist, verwendet die Configuration Manager-Konsole den XML-Code des Eigenschaftenblatts, um zu bestimmen, welche Assembly zum Laden und Anzeigen des Formulars erforderlich ist.

Weitere Informationen finden Sie unter How to Create Form XML for a Configuration Manager Property Sheet.For more information, see How to Create Form XML for a Configuration Manager Property Sheet.

Verwalten von Objektdaten in einem Formular

Ein Configuration Manager Formular kann benutzerdefinierte Daten und auch aus dem Ergebnisbereich die von einer Abfrage zurückgegebenen Objekte übergeben werden. Ausgewählte Objekte aus dem Ergebnisbereich werden einem Formular über ein PropertyManager-Objekt zur Verfügung gestellt. Weitere Informationen finden Sie unter How to Use Objects Passed to a Configuration Manager Form.For more information, see How to Use Objects Passed to a Configuration Manager Form. Sie können ein Formularsteuerelement an Objekte binden, die an das des Formulars PropertyManagerübergeben werden. Weitere Informationen finden Sie unter Binden von Configuration Manager Daten an ein Formular.

Die Configuration Manager-Konsole serialisiert Configuration Manager Objekte, die an ein Formular übergeben werden, wenn das Formular geschlossen wird.

Abfragen

Sie können sowohl synchrone als auch asynchrone Abfragen in Formularen ausführen, indem Sie den verwalteten SMS-Anbieter verwenden. Sie erhalten die Microsoft. ConfigurationManagement.AdminConsole.SmsPageControl.QueryProcessor-Objekt aus dem ConnectionManager des FormularsPropertyManager. Nachdem er abgerufen wurde, ist der Code mit den Beispielen für den SMS-Anbieter identisch. Ein Beispiel für eine synchrone Abfrage finden Sie unter Ausführen einer synchronen Configuration Manager Abfrage mithilfe von verwaltetem Code.

Ein Beispiel für eine asynchrone Abfrage finden Sie unter Ausführen einer asynchronen Configuration Manager Abfrage mithilfe von verwaltetem Code.

Siehe auch

Freigeben über

Informationen zu Configuration Manager-Konsolenformularen

Erstellen eines Erweiterungsformulars

Erstellen der Erweiterungsformularassembly

Eigenschaftenblätter

Dialogfelder

Erstellen der XML-Datei für die Formularaktion

Erstellen der XML-Datei des Formulareigenschaftenblatts

Verwalten von Objektdaten in einem Formular

Abfragen

Siehe auch

Feedback

Zusätzliche Ressourcen