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 worden aangeroepen door de Configuration Manager-console 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 de 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-eigenschappenbladen.
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 klasse Microsoft.ConfigurationManagement.AdminConsole.SmsPageControl . 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 het prototype van het eigenschappenvenster in de Configuration Manager SDK heeft een volledige oplossing die u kunt gebruiken. Zie How to Create a Configuration Manager Property Sheet (Een Configuration Manager-eigenschappenvenster maken) voor meer informatie.
Dialoogvensters
Een dialoogvenster in Configuration Manager wordt weergegeven als een typisch modusloos dialoogvenster. U maakt een SMSPageControl en geeft 'Dialoogvenster' op in het XML-bestand van het formulier. Zie Het dialoogvenster Configuration Manager maken voor meer informatie.
De XML van de 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 xml-formulieren.
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. |
| Tweespraak | 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 gesteld aan 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 Configuration Manager-gegevens binden aan 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. U haalt het object Microsoft.ConfigurationManagement.AdminConsole.SmsPageControl.QueryProcessor op 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 behulp van 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 voor een Configuration Manager maken
Actie-XML maken voor een Configuration Manager-eigenschappenvenster
Het dialoogvenster Configuration Manager maken
Formulier-XML maken voor een Configuration Manager-dialoogvenster
Formulier-XML maken voor een Configuration Manager-eigenschappenvenster
Objecten gebruiken die zijn doorgegeven aan een Configuration Manager-formulier