Come creare un controllo azione personalizzato di Configuration Manager

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

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

Dopo aver completato questi passaggi, eseguire i passaggi descritti negli argomenti seguenti per creare il file MOF (Action Managed Object Format) personalizzato e usare il controllo dell'azione personalizzato.

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

Come usare un'azione personalizzata di Configuration Manager

Il progetto Control Visual Studio

Nella procedura seguente viene creato il progetto di controllo azione personalizzato.

Creare il controllo

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

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

3. Fare clic su OK per creare il progetto 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 %Programmi%\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 assiemi 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, aggiungi 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 Opzioni

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

Per creare un controllo opzioni

• Alla fine di ConfigMgrTSActionControl.cs aggiungi la seguente nuova classe 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 nel 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 nel gestore proprietà dell'azione:

   SetDirtyFlag(true);
   

4. Nella classe ConfigMgrTSActionControl, aggiungi il metodo seguente per scrivere il valore della casella di testo nella User proprietà definita nell'azione personalizzata MOF. Questa opzione viene chiamata 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 struttura del 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 utente esistente. Ciò si verifica quando l'azione della sequenza di attività viene modificata dopo la sua 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, nel menu Progetto fare clic su Proprietà.

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

3. Sulla barra degli strumenti Resource Designer posizionare il puntatore del mouse sull'elenco a discesa visualizzazione risorse, fare clic sulla freccia e verificare che sia impostata su Stringhe (impostazione predefinita). Viene visualizzata una griglia delle impostazioni che mostra le stringhe gestite da tale istanza del Designer di risorse.

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

5. Nella colonna Nome immettere DefaultDisplay_ConfigMgrTSAction come nome stringa.

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

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

8. Nella colonna Nome immettere ConfigMgrTSAction come nome stringa.

9. Nella colonna Valore immettere Custom Action. Si tratta della stringa visualizzata quando si aggiunge l'azione personalizzata.

Distribuire l'assembly

Questa procedura compila e copia l'assembly creato nella cartella degli assembly della console di Configuration Manager. Per informazioni importanti sulla distribuzione delle estensioni della console di Configuration Manager, vedi Informazioni sulla distribuzione delle estensioni della console di amministrazione di 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 Configuration Manager estensione della consoleConfiguration Manager distribuzione dell'estensione della consoleCome creare un file MOF per un'azione personalizzata Configuration ManagerCome usare un Configuration Manager personalizzato Azione