Info over Consoleformulieren in Configuration Manager

U kunt de Configuration Manager-console uitbreiden met nieuwe Windows-formulieren. U kunt met name op formulieren gebaseerde dialoogvensters en eigenschappenvensters toevoegen. Een gebruiker heeft toegang tot deze formulieren via acties in Configuration Manager die u definieert.

Opmerking

Wizards zijn een ander Windows-formulier dat wordt gebruikt door de Configuration Manager-console, maar u kunt geen wizards uitbreiden of toevoegen met het consoleframework van Configuration Manager. U kunt echter uw eigen wizardoplossing uitvoeren met behulp van Configuration Manager-acties.

In Configuration Manager worden formulieren opgeslagen in .NET Framework-assembly's die worden aangeroepen door de Configuration Manager-console nadat de juiste actie is geselecteerd.

Een uitbreidingsformulier maken

Als u een uitbreidingsformulier wilt schrijven, gaat u als volgt te werk:

  • Maak de assembly voor het uitbreidingsformulier.

  • De actie Uitbreidingsformulier XML maken.

  • Maak het uitbreidingsformulier XML.

De Assembly Uitbreidingsformulier maken

Eigenschappenvensters

Een eigenschappenvenster bestaat uit een of meer eigenschappenpagina's die u zelf definieert. U kunt eigenschappenpagina's ook integreren in bestaande eigenschappenvensters van Configuration Manager.

Als u een eigenschappenvenster wilt maken, maakt u een Windows-besturingselementenbibliotheekproject in Visual Studio. In dit project maakt u een klasse die de klasse Microsoft.ConfigurationManagement.AdminConsole.SmsPageControl overneemt. Met deze klasse wordt het besturingselement geïmplementeerd dat u wilt weergeven op een eigenschappenpagina. In een eigenschappenvenster maakt u een SmsPageControl-klasse voor elke eigenschappenpagina die u nodig hebt. Het voorbeeld van een prototype van het eigenschappenvenster in de SDK van Configuration Manager bevat een complete oplossing die u kunt gebruiken. Zie Een eigenschappenvenster van Configuration Manager maken voor meer informatie.

Dialoogvensters

Een dialoogvenster in Configuration Manager wordt weergegeven als een standaard, modusloos dialoogvenster. U maakt een SMSPageControl en geeft "Dialog" op in het formulier XML. Zie Een Configuration Manager dialoogvenster maken voor meer informatie.

De formulieractie XML maken

Een actie beschrijft het type extensie dat wordt aangeroepen en waar de actie wordt geplaatst in de gebruikersinterface van de Configuration Manager-console. Bij een uitbreidingsformulier gebruikt u het ShowDialog actietype om het formulier weer te geven. Zie Actie-XML maken voor een eigenschappenvenster van Configuration Manager voor meer informatie.

Zie Informatie over consoleacties in Configuration Manager voor meer informatie over acties.

Het eigenschappenvenster van het formulier XML maken

Ongeacht of het formulier een eigenschappenvenster is, heeft het formulier een XML-bestand voor het formulier dat de assembly, de naamruimte en het type van het formulier definieert. In het eigenschappenvenster bepaalt het de volgorde van de eigenschappenpagina's in het eigenschappenvenster. Er is een XML-bestand met het eigenschappenvenster voor elk formulier van de Configuration Manager-console.

Opmerking

XML-bestanden van het eigenschappenvenster van de Configuration Manager-console worden opgeslagen in %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Forms.

Wanneer u een nieuw formulier maakt, maakt u ook een nieuw XML-bestand in het eigenschappenvenster. Als u een nieuwe eigenschappenpagina toevoegt aan een bestaand eigenschappenvenster, voegt u de XML-pagina van de eigenschappenpagina samen met het bestaande XML-bestand van het eigenschappenvenster.

Opmerking

Eigenschappenvensters van extensies worden opgeslagen in %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms.

Zie Implementatie van de console-extensie van Configuration Manager voor meer informatie over XML-implementatie van formulieren.

Afhankelijk van of u een dialoogvenster of een eigenschappenvenster weergeeft, moet u de waarden voor het kenmerk FormType instellen.

FormType Beschrijving
Eigenschappenvenster Het formulier is een eigenschappenvenster.
Dialoogvenster Het formulier is een dialoogvenster.

Wanneer een actie wordt geselecteerd, gebruikt de Configuration Manager-console het eigenschappenvenster XML om te bepalen welke assembly nodig is om het formulier te laden en weer te geven.

Zie Een XML-formulier maken voor een eigenschappenvenster van een Configuration Manager voor meer informatie.

Objectgegevens in een formulier beheren

Een Configuration Manager-formulier kan worden doorgegeven aan aangepaste gegevens en ook, vanuit het deelvenster resultaten, de objecten die worden geretourneerd door een query. Geselecteerde objecten uit het resultatenvenster worden beschikbaar gesteld aan een formulier via een PropertyManager-object . Zie voor meer informatie Objecten gebruiken die zijn doorgegeven aan een Configuration Manager-formulier. U kunt een formulierbesturingselement koppelen aan objecten die worden doorgegeven aan het .PropertyManager Zie Gegevens aan een formulier koppelen Configuration Manager voor meer informatie.

De Configuration Manager-console serialiseert Configuration Manager-objecten die in een formulier worden doorgegeven wanneer het formulier wordt gesloten.

Query's

U kunt zowel synchrone als asynchrone query's in formulieren uitvoeren met behulp van de beheerde SMS-provider. U krijgt het object Microsoft.ConfigurationManagement.AdminConsole.SmsPageControl.QueryProcessor uit de ConnectionManager van PropertyManager het formulier. Nadat deze is verkregen, is de code identiek aan de voorbeelden van de sms-provider. Zie Een synchrone Configuration Manager-query uitvoeren met behulp van beheerde code voor een voorbeeld van een synchrone query.

Voor een voorbeeld van een asynchrone query raadpleegt u Een asynchrone Configuration Manager-query uitvoeren met behulp van beheerde code.

Zie ook

Een eigenschappenpagina toevoegen aan een bestaand eigenschappenvenster van een Configuration Manager Een eigenschappenvenster van een Configuration Manager koppelen aan een formulierEen eigenschappenvenster van een Configuration Manager makenActie-XML maken voor een Configuration Manager DialoogvensterActie-XML maken voor een eigenschappenvenster van Configuration ManagerDialoogvenster Een Configuration Manager maken Dialoogvenster Formulier-XML maken voor een Configuration ManagerFormulier-XML maken voor een Eigenschappenvenster van Configuration ManagerObjecten gebruiken die zijn doorgegeven aan een Configuration Manager-formulier