So erstellen Sie ein benutzerdefiniertes Configuration Manager Aktionssteuerelement

Um im Configuration Manager ein benutzerdefiniertes Aktionssteuerelement zu erstellen, erstellen Sie ein Windows-Steuerelement mithilfe der folgenden beiden Klassen:

In diesen Verfahren wird gezeigt, wie Sie mit Visual Studio 2005 eine Configuration Manager Betriebssystem-Bereitstellungssteuerungsassembly erstellen. Wenn das Steuerelement in den Tasksequenz-Editor geladen wird, zeigt es eine Eigenschaftenseite an, die ein Textfeld enthält, das zum Festlegen einer Benutzernamen-Aktionsvariablen für die benutzerdefinierte Aktion verwendet wird.

Nachdem Sie diese Schritte abgeschlossen haben, führen Sie die Schritte in den folgenden Themen aus, um die benutzerdefinierte MOF-Datei (Managed Object Format) für Aktionen zu erstellen und das benutzerdefinierte Aktionssteuerelement zu verwenden.

So erstellen Sie eine MOF-Datei für eine benutzerdefinierte Configuration Manager-Aktion

So verwenden Sie eine benutzerdefinierte Configuration Manager-Aktion

Das Visual Studio-Projekt "Steuerelement"

Mit dem folgenden Verfahren wird das benutzerdefinierte Aktionssteuerungsprojekt erstellt.

Erstellen des Steuerelements

1. Zeigen Sie in Visual Studio 2010 im Menü Datei auf Neu, und klicken Sie dann auf Projekt , um das Dialogfeld Neues Projekt zu öffnen.

2. Wählen Sie in der Liste der Visual C#-Windows-Projekte die Projektvorlage "Windows-Steuerelementbibliothek" aus, und geben Sie dann in das Feld "Name" einConfigMgrTSAction.

3. Klicken Sie auf OK , um das Visual Studio-Projekt zu erstellen.

4. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf UserControl1.cs, klicken Sie auf Umbenennen, und ändern Sie dann den Namen in ConfigMgrTSActionControl.cs.

5. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und klicken Sie dann auf Verweis hinzufügen.

6. Klicken Sie im Dialogfeld Verweis hinzufügen auf die Registerkarte Durchsuchen, navigieren Sie zu %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin, und wählen Sie dann die folgenden Assemblys aus:

   • Adminui.osdcommon.dll

   • Adminui.tasksequenceeditor.dll

   • Adminui.wqlqueryengine.dll

   • Microsoft.configurationmanagement.exe

   • Microsoft.configurationmanagement.managementprovider.dll

7. Klicken Sie auf OK , um die Assemblys als Projektreferenzen hinzuzufügen.

8. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf ConfigMgrTSActionControl.cs, und klicken Sie dann auf Code anzeigen.

9. Fügen Sie den folgenden Code hinzu, um die erforderlichen Namespaces einzuschließen:

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

10. Ändern Sie die Klasse ConfigMgrTSActionControl so, dass sie von SmsOsdEditorPageControl abgeleitet wird.

11. Fügen Sie ConfigMgrTSActionControl.cs den folgenden neuen Konstruktor zur ConfigMgrTSActionControl-Klasse hinzu:

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

12. Fügen Sie die folgende Methode hinzu, um das Steuerelement zu initialisieren:

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

Erstellen eines Optionssteuerelements

Das folgende Verfahren erstellt den Code, der das Optionssteuerelement für die benutzerdefinierte Aktion deklariert. Diese Implementierung verwendet das Standardoptionssteuerelement.

So erstellen Sie ein Optionssteuerelement

• Fügen Sie am Ende von ConfigMgrTSActionControl.cs die folgende neue Klasse im ConfigMgrTSAction-Namespace hinzu:

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

Anpassen der Benutzeroberfläche

Das folgende Verfahren fügt ein Textfeld und einen Code zum Verwalten von Aktionsdaten hinzu.

So fügen Sie die Benutzeroberfläche hinzu

1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf ConfigMgrTSActionControl.cs, und klicken Sie dann auf Designer anzeigen.

2. Klicken Sie in der Toolbox auf die Registerkarte Allgemeine Steuerelemente , und doppelklicken Sie dann auf TextBox. Im Designer der Benutzersteuerung wird dem Steuerelement eine Schaltfläche mit dem Namen textBox1 hinzugefügt.

3. Doppelklicken Sie auf das Textfeld. Der Klasse ConfigMgrTSActionControl wird ein Ereignishandler namens textBox1_TextChanged hinzugefügt. Fügen Sie den folgenden Code hinzu, um sicherzustellen, dass Änderungen im Eigenschaften-Manager der Aktion gespeichert werden:

   SetDirtyFlag(true);
   

4. Fügen Sie in der Klasse ConfigMgrTSActionControl die folgende Methode hinzu, um den Textfeldwert in die User Eigenschaft zu schreiben, die in der benutzerdefinierten Aktion MOF definiert ist. Dies wird aufgerufen, wenn auf die Schaltfläche OK oder Übernehmen geklickt wird.

   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. Doppelklicken Sie in der Entwurfsansicht für das Steuerelement auf das Steuerelement, um die Methode ConfigMgrTSActionControl_Load zu erstellen.

6. Fügen Sie der Methode den folgenden Code hinzu. Dieser Code lädt das Textfeld mit einem vorhandenen Benutzerwert. Dies geschieht, wenn die Tasksequenzaktion nach dem Erstellen bearbeitet wird.

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

Ressourcen-Zeichenfolgen

Das folgende Verfahren fügt die Ressourcenzeichenfolgen hinzu, die zum Anzeigen des benutzerdefinierten Aktionsnamens im Tasksequenz-Editor verwendet werden.

So fügen Sie Ressourcenzeichenfolgen hinzu

1. Klicken Sie im Projektmappen-Explorer im Menü Projekt auf Eigenschaften.

2. Klicken Sie auf die Registerkarte Ressourcen . Wenn die Ressourcendatei nicht vorhanden ist, erstellen Sie sie, indem Sie die Meldung auswählen, die auf der Registerkarte Ressourcen angezeigt wird.

3. Zeigen Sie auf der Symbolleiste des Ressourcen-Designers auf das Dropdown-Menü Ressourcenansicht, klicken Sie auf den Pfeil, und vergewissern Sie sich, dass es auf Zeichenfolgen eingestellt ist (Standardeinstellung). Ein Einstellungsraster wird angezeigt, in dem die Zeichenfolgen angezeigt werden, die von dieser Instance des Ressourcen-Designers verwaltet werden.

4. Klicken Sie auf die Spalte Name der letzten Zeile im Raster, die mit einem Sternchen (*) gekennzeichnet ist.

5. Geben Sie in der Spalte Name den Namen der Zeichenfolge ein DefaultDisplay_ConfigMgrTSAction .

6. Geben Sie in der Spalte Wert die Zeichenfolge Benutzerdefinierte Aktion ein. Dies ist die Zeichenfolge, die in der Liste der Tasksequenzaktionen angezeigt wird.

7. Klicken Sie auf die Spalte Name der letzten Zeile im Raster, die mit einem Sternchen (*) gekennzeichnet ist.

8. Geben Sie in der Spalte Name den Namen der Zeichenfolge ein ConfigMgrTSAction .

9. Geben Sie in die Spalte Wert ein Custom Action. Dies ist die Zeichenfolge, die angezeigt wird, wenn Sie die benutzerdefinierte Aktion hinzufügen.

Bereitstellen der Assembly

Mit diesem Verfahren wird die von Ihnen erstellte Assembly erstellt und in den Ordner der Configuration Manager-Konsolenassemblys kopiert. Wichtige Informationen zum Bereitstellen von Configuration Manager-Konsolenerweiterungen finden Sie unter Informationen zur Bereitstellung von Configuration Manager-Administratorkonsolenerweiterungen.

So stellen Sie die Assembly bereit

1. Erstellen Sie das Projekt. Visual Studio erstellt die Assembly als \Visual Studio 2005\Projects\ConfigMgrControl\ConfigMgrTSAction\bin\Debug\ConfigMgrTSActionControl.dll.

2. Kopieren Sie die Assembly in den Ordner %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin.

Siehe auch

Informationen Configuration Manager KonsolenerweiterungConfiguration Manager Bereitstellung von KonsolenerweiterungenSo erstellen Sie eine MOF-Datei für eine benutzerdefinierte Configuration Manager Aktion So verwenden Sie eine benutzerdefinierte Configuration Manager Aktion