Condividi tramite


Informazioni sui moduli della 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 moduli 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 Windows Form 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 una soluzione guidata personalizzata 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:

  • Creare l'assembly del modulo di estensione.

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

  • Creare il formato XML del modulo di estensione.

Creare l'assembly del modulo di estensione

Finestre delle proprietà

Una finestra delle proprietà è costituita 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 windows in Visual Studio. In questo progetto viene creata 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à si crea una classe SmsPageControl per ogni pagina delle proprietà necessaria. L'esempio di prototipo della finestra delle proprietà nell'SDK di Configuration Manager include una soluzione completa che è possibile 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. Si crea un SMSPageControl e si specifica "Dialog" nel formato XML. Per altre informazioni, vedere How to Create a Configuration Manager Dialog Box.For more information, see How to Create a Configuration Manager Dialog Box.

Creare il codice XML dell'azione modulo

Un'azione descrive il tipo di estensione chiamata e la posizione in cui l'azione viene inserita nell'interfaccia utente della console di Configuration Manager. Per un modulo di estensione, utilizzare il ShowDialog tipo di azione per visualizzare il modulo. Per altre informazioni, vedere How to Create Action XML for a Configuration Manager Property Sheet .SEE How to Create Action XML for a Configuration Manager Property Sheet.

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

Creare il codice XML della finestra delle proprietà del modulo

Indipendentemente dal fatto che il modulo sia o meno una finestra delle proprietà, il modulo dispone di un file XML del modulo che definisce l'assembly, lo spazio dei nomi e il tipo del modulo. 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 vengono archiviati in %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Forms.

Quando si crea un nuovo modulo, si crea un nuovo file XML della finestra delle proprietà. Se si aggiunge una nuova pagina delle proprietà a una finestra delle proprietà esistente, si unisce l'XML della pagina delle proprietà con un file XML della finestra delle proprietà esistente.

Nota

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

Per altre informazioni sulla distribuzione XML del modulo, vedere Distribuzione dell'estensione della console di Configuration Manager.

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

FormType Descrizione
PropertySheet La maschera è una finestra delle proprietà.
Finestra di dialogo Il modulo è una finestra di dialogo.

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

Per altre informazioni, vedere 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.

Gestione dei dati degli oggetti in un modulo

Un modulo di Configuration Manager può essere passato a dati personalizzati e anche, dal riquadro dei risultati, agli oggetti restituiti da una query. Gli oggetti selezionati nel riquadro dei risultati vengono resi disponibili a una maschera tramite un oggetto PropertyManager . Per altre informazioni, vedere Come usare gli oggetti passati a un modulo di Configuration Manager. È possibile associare un controllo modulo agli oggetti passati all'oggetto del PropertyManagerform. 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 chiuso.

Query

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

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

Vedere anche

Come aggiungere una pagina delle proprietà a una finestra delle proprietà di Configuration Manager esistente
Come associare i dati di Configuration Manager a un modulo
Come creare una finestra delle proprietà di Configuration Manager
Come creare codice XML azione per una finestra di dialogo di Configuration Manager
Come creare codice XML azione per una finestra delle proprietà di Configuration Manager
Finestra di dialogo Come creare una gestione configurazione
How to Create Form XML for a Configuration Manager Dialog Box
Come creare codice XML modulo per una finestra delle proprietà di Configuration Manager
Come usare gli oggetti passati a un modulo di Configuration Manager