Delen via


Over Configuration Manager consoleformulieren

U kunt de Configuration Manager-console uitbreiden met nieuwe Windows-formulieren. U kunt met name dialoogvensters en eigenschappenvensters op basis van formulieren toevoegen. Een gebruiker opent deze formulieren vanuit Configuration Manager acties die u definieert.

Opmerking

Wizards zijn een ander Windows-formulier dat wordt gebruikt door de Configuration Manager-console, maar u kunt wizards niet uitbreiden of toevoegen met behulp van het Configuration Manager consoleframework. 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 door de Configuration Manager-console worden aangeroepen nadat de juiste actie is geselecteerd.

Een extensieformulier maken

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

  • Maak de assembly van het extensieformulier.

  • Maak de actie-XML van het extensieformulier.

  • Maak het extensieformulier XML.

De extensieformulierassembly maken

Eigenschappenvensters

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

Als u een eigenschappenvenster wilt maken, maakt u een Windows-besturingselementbibliotheekproject in Visual Studio. In dit project maakt u een klasse die wordt overgenomen van de Microsoft. ConfigurationManagement.AdminConsole.SmsPageControl-klasse. Deze klasse implementeert het besturingselement dat u wilt weergeven op een eigenschappenpagina. In een eigenschappenvenster maakt u een klasse SmsPageControl voor elke eigenschappenpagina die u nodig hebt. Het voorbeeld van prototype van het eigenschappenvenster in de Configuration Manager SDK bevat een volledige oplossing die u kunt gebruiken. Zie Een Configuration Manager eigenschappenvenster maken voor meer informatie.

Dialoogvensters

Een dialoogvenster in Configuration Manager wordt weergegeven als een normaal dialoogvenster zonder modus. U maakt een SMSPageControl en geeft 'Dialoogvenster' op in de XML van het formulier. Zie Het dialoogvenster Een Configuration Manager maken voor meer informatie.

Het XML-bestand voor formulieractie maken

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

Zie Over Configuration Manager consoleacties voor meer informatie over acties.

De XML van het formuliereigenschappenvenster maken

Ongeacht of het formulier een eigenschappenvenster is, heeft het formulier een XML-formulierbestand dat de assembly, naamruimte en het type van het formulier definieert. In eigenschappenvensters definieert het de volgorde van de eigenschappenpagina's op het eigenschappenvenster. Er is een XML-bestand voor het eigenschappenvenster voor elk Configuration Manager consoleformulier.

Opmerking

De 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 een nieuw XML-bestand voor het eigenschappenvenster. Als u een nieuwe eigenschappenpagina toevoegt aan een bestaand eigenschappenvenster, voegt u de XML van de eigenschappenpagina samen met een bestaand XML-bestand van het eigenschappenvenster.

Opmerking

Uitbreidingseigenschappenbladen worden opgeslagen in %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms.

Zie implementatie van Configuration Manager consoleextensie voor meer informatie over de implementatie van formulier-XML.

Afhankelijk van of u een dialoogvenster of een eigenschappenvenster weergeeft, moeten de kenmerkwaarden van FormType worden ingesteld.

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

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

Zie Formulier-XML maken voor een Configuration Manager eigenschappenvenster voor meer informatie.

Objectgegevens beheren in een formulier

Een Configuration Manager formulier kan aangepaste gegevens en ook, vanuit het resultatenvenster, de objecten die worden geretourneerd door een query worden doorgegeven. Geselecteerde objecten uit het resultatenvenster worden beschikbaar gemaakt voor een formulier via een PropertyManager-object . Zie Objecten gebruiken die zijn doorgegeven aan een Configuration Manager-formulier voor meer informatie. U kunt een formulierbesturingselement binden aan objecten die worden doorgegeven aan de .PropertyManager Zie How to Bind Configuration Manager Data to a Form (Configuration Manager gegevens verbinden met een formulier) voor meer informatie.

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

Query 's

U kunt zowel synchrone als asynchrone query's uitvoeren in formulieren met behulp van de beheerde SMS-provider. Je krijgt de Microsoft. ConfigurationManagement.AdminConsole.SmsPageControl.QueryProcessor-object uit de ConnectionManager van PropertyManager het formulier. Nadat deze is verkregen, is de code identiek aan de SMS-providervoorbeelden. Zie How to Perform a Synchronous Configuration Manager Query by Using Managed Code (Een synchrone Configuration Manager-query uitvoeren met beheerde code) voor een voorbeeld van een synchrone query.

Zie How to Perform an Asynchronous Configuration Manager Query by Using Managed Code (Een Asynchrone Configuration Manager-query uitvoeren met beheerde code) voor een voorbeeld van een asynchrone query.

Zie ook

Een eigenschappenpagina toevoegen aan een bestaand Configuration Manager eigenschappenvenster
Configuration Manager-gegevens binden aan een formulier
Een Configuration Manager eigenschappenvenster maken
Het dialoogvenster Actie-XML maken voor een Configuration Manager
Actie-XML maken voor een Configuration Manager eigenschappenvenster
Dialoogvenster Een Configuration Manager maken
Het dialoogvenster Formulier-XML maken voor een Configuration Manager
Formulier-XML maken voor een Configuration Manager eigenschappenvenster
Objecten gebruiken die zijn doorgegeven aan een Configuration Manager-formulier