Come creare un controllo azione personalizzata Configuration Manager

In Configuration Manager, per creare un controllo azione personalizzato, si crea un controllo Windows usando le due classi seguenti:

Queste procedure illustrano come creare un assembly di controllo della distribuzione del sistema operativo Configuration Manager usando Visual Studio 2005. Quando viene caricato nell'editor della sequenza di attività, il controllo visualizza una pagina delle proprietà contenente una casella di testo utilizzata per impostare una variabile di azione nome utente per l'azione personalizzata.

Dopo aver completato questi passaggi, seguire questa procedura negli argomenti seguenti per creare il file MOF (Action Managed Object Format) personalizzato e usare il controllo azione personalizzato.

Come creare un file MOF per un'azione personalizzata Configuration Manager

Come usare un'azione personalizzata Configuration Manager

Progetto Di Visual Studio per il controllo

La procedura seguente crea il progetto di controllo azione personalizzato.

Creare il controllo

1. In Visual Studio 2010 scegliere Nuovo dal menu File e quindi fare clic su Progetto per aprire la finestra di dialogo Nuovo progetto.

2. Nell'elenco dei progetti Di Visual C#, Windows selezionare il modello di progetto Libreria di controlli di Windows e quindi digitare ConfigMgrTSAction nella casella Nome .

3. Fare clic su OK per creare il progetto di Visual Studio.

4. In Esplora soluzioni fare clic con il pulsante destro del mouse su UserControl1.cs, scegliere Rinomina e quindi modificare il nome in ConfigMgrTSActionControl.cs.

5. In Esplora soluzioni fare clic con il pulsante destro del mouse su Riferimenti e quindi scegliere Aggiungi riferimento.

6. Nella finestra di dialogo Aggiungi riferimento fare clic sulla scheda Sfoglia, passare a %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin e quindi selezionare gli assembly seguenti:

   • Adminui.osdcommon.dll

   • Adminui.tasksequenceeditor.dll

   • Adminui.wqlqueryengine.dll

   • Microsoft.configurationmanagement.exe

   • Microsoft.configurationmanagement.managementprovider.dll

7. Fare clic su OK per aggiungere gli assembly come riferimenti al progetto.

8. In Esplora soluzioni fare clic con il pulsante destro del mouse su ConfigMgrTSActionControl.cs e quindi scegliere Visualizza codice.

9. Aggiungere il codice seguente per includere gli spazi dei nomi necessari:

   using Microsoft.ConfigurationManagement.AdminConsole;
   using Microsoft.ConfigurationManagement.AdminConsole.TaskSequenceEditor;
   

10. Modificare la classe ConfigMgrTSActionControl in modo che derivi da SmsOsdEditorPageControl.

11. In ConfigMgrTSActionControl.cs aggiungere il nuovo costruttore seguente alla classe ConfigMgrTSActionControl :

    public ConfigMgrTSActionControl(SmsPageData data) : base(data)
    {
        InitializeComponent();
    }
    

12. Aggiungere il metodo seguente per inizializzare il controllo:

    public override void InitializePageControl()
    {
       base.InitializePageControl();
    }
    

Creare un controllo Options

La procedura seguente crea il codice che dichiara il controllo options per l'azione personalizzata. Questa implementazione usa il controllo opzioni predefinito.

Per creare un controllo options

• Alla fine di ConfigMgrTSActionControl.cs aggiungere la nuova classe seguente nello spazio dei nomi ConfigMgrTSAction :

  public class ConfigureTSActionOptions : TaskSequenceOptionControl
  {
      public ConfigureTSActionOptions() : base()
      {
      }
      public ConfigureTSActionOptions(SmsPageData data) : base(data)
      {
      }
  }
  
  

Personalizzare l'interfaccia utente

La procedura seguente aggiunge una casella di testo e un codice per gestire i dati delle azioni.

Per aggiungere l'interfaccia utente

1. In Esplora soluzioni fare clic con il pulsante destro del mouse su ConfigMgrTSActionControl.cs e quindi scegliere Visualizza Designer.

2. Nella casella degli strumenti fare clic sulla scheda Controlli comuni e quindi fare doppio clic su Casella di testo. Un pulsante denominato textBox1 viene aggiunto al controllo nella Designer Controllo utente.

3. Fare doppio clic sulla casella di testo. Un gestore eventi denominato textBox1_TextChanged viene aggiunto alla classe ConfigMgrTSActionControl. Aggiungere il codice seguente per assicurarsi che le modifiche vengano salvate nella gestione proprietà dell'azione:

   SetDirtyFlag(true);
   

4. Nella classe ConfigMgrTSActionControl aggiungere il metodo seguente per scrivere il valore della casella di testo nella User proprietà definita nell'azione personalizzata MOF. Viene chiamato quando si fa clic sul pulsante OK o Applica .

   protected override bool ApplyChanges(out Control errorControl, out bool showError)
   {
       // You can check the error here and return false.
       if (this.HasError(out errorControl) == true)
       {
           this.ShowMessageBox(
               this.GetErrorString(),
               "Error",
               MessageBoxButtons.OK,
               MessageBoxIcon.Warning);
           errorControl = null;
           showError = true;
           return false;
       }
       this.PropertyManager["User"].StringValue = textBox1.Text;
   
       return base.ApplyChanges(out errorControl, out showError);
   }
   

5. Nella visualizzazione progettazione per il controllo fare doppio clic sul controllo per creare il metodo ConfigMgrTSActionControl_Load.

6. Aggiungere il codice seguente al metodo . Questo codice carica la casella di testo con un valore User esistente. Ciò si verifica quando l'azione della sequenza di attività viene modificata dopo la creazione.

   textBox1.Text = this.PropertyManager["User"].StringValue;
   

Stringhe di risorse

La procedura seguente aggiunge le stringhe di risorse usate per visualizzare il nome dell'azione personalizzata nell'editor della sequenza di attività.

Per aggiungere stringhe di risorse

1. In Esplora soluzioni scegliere Proprietà dal menu Progetto.

2. Fare clic sulla scheda Risorse . Se il file di risorse non esiste, crearlo selezionando il messaggio visualizzato nella scheda Risorse .

3. Nella barra degli strumenti Designer risorse scegliere l'elenco a discesa visualizzazione risorse, fare clic sulla freccia e assicurarsi che sia impostata su Stringhe (impostazione predefinita). Viene visualizzata una griglia di impostazioni che visualizza le stringhe gestite da tale istanza di Resource Designer.

4. Fare clic sulla colonna Nome dell'ultima riga della griglia, contrassegnata con un asterisco (*).

5. Nella colonna Nome immettere DefaultDisplay_ConfigMgrTSAction come nome stringa.

6. Nella colonna Valore immettere la stringa Azione personalizzata. Questa è la stringa visualizzata nell'elenco delle azioni della sequenza di attività.

7. Fare clic sulla colonna Nome dell'ultima riga della griglia, contrassegnata con un asterisco (*).

8. Nella colonna Nome immettere ConfigMgrTSAction come nome stringa.

9. Nella colonna Valore immettere Custom Action. Questa è la stringa visualizzata quando si aggiunge l'azione personalizzata.

Distribuire l'assembly

Questa procedura compila e copia l'assembly creato nella cartella Configuration Manager assembly della console. Per informazioni importanti sulla distribuzione di Configuration Manager estensioni della console, vedere Informazioni sulla distribuzione di estensioni della console di amministrazione Configuration Manager.

Per distribuire l'assembly

1. Generare il progetto. Visual Studio crea l'assembly come \Visual Studio 2005\Projects\ConfigMgrControl\ConfigMgrTSAction\bin\Debug\ConfigMgrTSActionControl.dll.

2. Copiare l'assembly nella cartella %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin.

Vedere anche

Informazioni sull'estensione Configuration Manager consoleConfiguration Manager distribuzione dell'estensione della consoleCome creare un file MOF per un'azione personalizzata Configuration ManagerCome usare un Configuration Manager personalizzato Azione