Informazioni su Forms console di Configuration Manager

È possibile estendere la console di Configuration Manager con i nuovi Windows Form. In particolare, è possibile aggiungere finestre di dialogo basate su maschere e finestre delle proprietà. Un utente accede a questi moduli dalle azioni di Configuration Manager definite dall'utente.

Nota

Le procedure guidate sono un altro modulo di Windows usato dalla console di Configuration Manager, ma non è possibile estendere o aggiungere procedure guidate usando il framework della console di Configuration Manager. È tuttavia possibile eseguire la propria procedura guidata usando le azioni di Configuration Manager.

In Configuration Manager, i moduli vengono archiviati in assembly .NET Framework chiamati dalla console di Configuration Manager dopo aver selezionato l'azione appropriata.

Creazione di un modulo di estensione

Per scrivere un modulo di estensione, eseguire le operazioni seguenti:

  • Create l'assieme del modulo di estensione.

  • Creare il codice XML dell'azione del modulo di estensione.

  • Creare il codice XML del modulo dell'estensione.

Creare l'assieme della forma di estensione

finestre delle proprietà

Una finestra delle proprietà è composta da una o più pagine delle proprietà definite dall'utente. È anche possibile integrare le pagine delle proprietà nelle finestre delle proprietà di Configuration Manager esistenti.

Per creare una finestra delle proprietà, creare un progetto Libreria di controlli di Windows in Visual Studio. In questo progetto si crea una classe che eredita dalla classe Microsoft.ConfigurationManagement.AdminConsole.SmsPageControl . Questa classe implementa il controllo che si desidera visualizzare in una pagina delle proprietà. In una finestra delle proprietà è possibile creare una classe SmsPageControl per ogni pagina delle proprietà necessaria. L'esempio di prototipo della finestra delle proprietà nell'SDK di Configuration Manager offre una soluzione completa da usare. Per altre informazioni, vedere Come creare una finestra delle proprietà di Configuration Manager.

Finestre di dialogo

Una finestra di dialogo in Configuration Manager viene visualizzata come una tipica finestra di dialogo non modale. Creare un SMSPageControl e specificare "Dialog" nel codice XML del modulo. Per altre informazioni, vedere Come creare una finestra di dialogo di Configuration Manager.

Creare il file XML azione modulo

Un'azione descrive il tipo di estensione chiamata e la posizione in cui viene inserita l'azione nell'interfaccia utente della console di Configuration Manager. Per un modulo di estensione, usare il ShowDialog tipo di azione per visualizzare il modulo. Per altre informazioni, vedere Come creare un codice XML azione per una finestra delle proprietà di Configuration Manager.

Per altre informazioni sulle azioni, vedere Informazioni sulle azioni della console di Configuration Manager.

Creare il file XML della finestra delle proprietà della maschera

Indipendentemente dal fatto che la maschera sia una finestra delle proprietà, la maschera contiene un file XML che definisce l'assembly, lo spazio dei nomi e il tipo di maschera. Nelle finestre delle proprietà definisce l'ordine delle pagine delle proprietà nella finestra delle proprietà. È disponibile un file XML della finestra delle proprietà per ogni modulo della console di Configuration Manager.

Nota

I file XML della finestra delle proprietà della console di Configuration Manager sono archiviati in %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Forms.

Quando si crea una nuova maschera, viene creato un nuovo file XML della finestra delle proprietà. Se si aggiunge una nuova pagina delle proprietà a una finestra delle proprietà esistente, il codice XML della pagina delle proprietà viene unito a un file XML della finestra delle proprietà esistente.

Nota

Le finestre delle proprietà dell'estensione vengono archiviate in %Programmi%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms.

Per altre informazioni sulla distribuzione di moduli XML, vedere Distribuzione dell'estensione della console di Gestione configurazione.

A seconda che si stia visualizzando una finestra di dialogo o una finestra delle proprietà, è necessario impostare i valori dell'attributo FormType.

Tipo di modulo Descrizione
foglio delle proprietà La maschera è una finestra delle proprietà.
Finestra di dialogo La maschera è una finestra di dialogo.

Quando è selezionata un'azione, la console di Configuration Manager usa il codice XML della finestra delle proprietà per determinare quale assembly è necessario per caricare e visualizzare il modulo.

Per altre informazioni, vedere Come creare il formato XML del modulo per una finestra delle proprietà di Gestione configurazione.

Gestione dei dati oggetto in un modulo

A un modulo di Configuration Manager possono essere passati dati personalizzati e inoltre, dal riquadro dei risultati, gli oggetti restituiti da una query. Gli oggetti selezionati dal riquadro dei risultati vengono resi disponibili per un modulo tramite un oggetto PropertyManager . Per ulteriori informazioni, vedere Come utilizzare gli oggetti passati a un modulo di Configuration Manager. È possibile associare un controllo di maschera agli oggetti passati al file del PropertyManagermodulo. Per altre informazioni, vedere Come associare i dati di Configuration Manager a un modulo.

La console di Configuration Manager serializza gli oggetti di Configuration Manager passati in un modulo quando il modulo viene ignorato.

Query

È possibile eseguire query sia sincrone che asincrone nei moduli usando il provider SMS gestito. Si ottiene l'oggetto Microsoft.ConfigurationManagement.AdminConsole.SmsPageControl.QueryProcessor dal ConnectionManager del PropertyManager modulo. Dopo averlo ottenuto, il codice è identico agli esempi del provider SMS. Per un esempio di query sincrona, vedere Come eseguire una query sincrona di Configuration Manager tramite codice gestito.

Per un esempio di query asincrona, vedere Come eseguire una query asincrona di Configuration Manager tramite codice gestito.

Vedere anche

Come aggiungere una pagina delle proprietà a una finestra delle proprietà di Configuration Manager esistenteCome associare i dati di Configuration Manager a una mascheraCome creare una finestra delle proprietà di Configuration ManagerCome creare un XML azione per un gestore di Configuration Manager Finestra di dialogoCome creare un codice XML azione per una finestra delle proprietà di Configuration ManagerCome creare una finestra di dialogo di Configuration ManagerCome creare un file XML modulo per una finestra di dialogo di Configuration ManagerCome creare un modulo XML per un Finestra delle proprietà di Configuration ManagerCome usare gli oggetti passati a un modulo di Configuration Manager