How to Create a Configuration Manager Custom Action Control (Jak utworzyć kontrolkę akcji niestandardowej Configuration Manager)

Artykuł
04/04/2023

W Configuration Manager, aby utworzyć niestandardową kontrolkę akcji, należy utworzyć kontrolkę systemu Windows przy użyciu następujących dwóch klas:

Klasa	Opis
SmsOsdEditorPageControl	Kontrolka akcji niestandardowej. Pochodzisz z tej klasy, aby zaimplementować niestandardową kontrolkę akcji wyświetlaną w Edytorze sekwencji zadań.
TaskSequenceOptionControl	Kontrolka opcji dla akcji niestandardowej. Pochodzisz z tej klasy, aby utworzyć stronę opcji akcji niestandardowych wyświetlaną w Edytorze sekwencji zadań.

Te procedury pokazują, jak utworzyć zestaw kontroli wdrażania systemu operacyjnego Configuration Manager przy użyciu programu Visual Studio 2005. Po załadowaniu do Edytora sekwencji zadań kontrolka wyświetla stronę właściwości zawierającą pole tekstowe, które służy do ustawiania zmiennej akcji nazwy użytkownika dla akcji niestandardowej.

Po wykonaniu tych kroków wykonaj kroki opisane w poniższych tematach, aby utworzyć plik mof (custom action managed object format) i użyć niestandardowej kontrolki akcji.

Jak utworzyć plik MOF dla Configuration Manager akcji niestandardowej

Jak używać akcji niestandardowej Configuration Manager

Uwaga

Aby uzyskać informacje na temat korzystania z akcji niestandardowej w ramach wdrożenia, zobacz Informacje o Configuration Manager niestandardowych aplikacji klienckich akcji

Kontrolka projektu programu Visual Studio

Poniższa procedura tworzy niestandardowy projekt kontroli akcji.

Tworzenie kontrolki

W programie Visual Studio 2010 w menu Plik wskaż polecenie Nowy, a następnie kliknij pozycję Projekt , aby otworzyć okno dialogowe Nowy projekt .
Z listy Visual C#, Projekty systemu Windows , wybierz szablon projektu Biblioteki kontrolek systemu Windows , a następnie wpisz ConfigMgrTSAction w polu Nazwa .
Kliknij przycisk OK , aby utworzyć projekt programu Visual Studio.
W Eksplorator rozwiązań kliknij prawym przyciskiem myszy plik UserControl1.cs, kliknij pozycję Zmień nazwę, a następnie zmień nazwę na ConfigMgrTSActionControl.cs.
W Eksplorator rozwiązań kliknij prawym przyciskiem myszy pozycję Odwołania, a następnie kliknij pozycję Dodaj odwołanie.
W oknie dialogowym Dodawanie odwołania kliknij kartę Przeglądaj, przejdź do pozycji %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin, a następnie wybierz następujące zestawy:
- Adminui.osdcommon.dll
- Adminui.tasksequenceeditor.dll
- Adminui.wqlqueryengine.dll
- Microsoft.configurationmanagement.exe
- Microsoft.configurationmanagement.managementprovider.dll
Kliknij przycisk OK , aby dodać zestawy jako odwołania do projektu.
W Eksplorator rozwiązań kliknij prawym przyciskiem myszy plik ConfigMgrTSActionControl.cs, a następnie kliknij pozycję Wyświetl kod.

Dodaj następujący kod, aby uwzględnić wymagane przestrzenie nazw:

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

Zmień klasę ConfigMgrTSActionControl tak, aby pochodziła z kontrolki SmsOsdEditorPageControl.

W pliku ConfigMgrTSActionControl.cs dodaj następujący nowy konstruktor do klasy ConfigMgrTSActionControl :

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

Dodaj następującą metodę, aby zainicjować kontrolkę:

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

Tworzenie kontrolki Opcje

Poniższa procedura tworzy kod, który deklaruje kontrolkę opcji dla akcji niestandardowej. Ta implementacja używa domyślnej kontrolki opcji.

Aby utworzyć kontrolkę opcji

Na końcu pliku ConfigMgrTSActionControl.cs dodaj następującą nową klasę w przestrzeni nazw ConfigMgrTSAction :

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

Dostosowywanie interfejsu użytkownika

Poniższa procedura dodaje pole tekstowe i kod do zarządzania danymi akcji.

Aby dodać interfejs użytkownika

W Eksplorator rozwiązań kliknij prawym przyciskiem myszy plik ConfigMgrTSActionControl.cs, a następnie kliknij pozycję Projektant widoków.
W przyborniku kliknij kartę Typowe kontrolki , a następnie kliknij dwukrotnie pole tekstowe. Do kontrolki w Projektancie kontroli użytkownika zostanie dodany przycisk o nazwie textBox1 .
Kliknij dwukrotnie pole tekstowe. Program obsługi zdarzeń o nazwie textBox1_TextChanged jest dodawany do klasy ConfigMgrTSActionControl. Dodaj następujący kod, aby upewnić się, że zmiany zostaną zapisane w menedżerze właściwości akcji:
```
SetDirtyFlag(true);  
```

W klasie ConfigMgrTSActionControl dodaj następującą metodę, aby zapisać wartość pola tekstowego do User właściwości zdefiniowanej w akcji niestandardowej MOF. Jest to wywoływane po kliknięciu przycisku OK lub Zastosuj .

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);  
}

W widoku projektu kontrolki kliknij dwukrotnie kontrolkę, aby utworzyć metodę ConfigMgrTSActionControl_Load.
Dodaj następujący kod do metody . Ten kod ładuje pole tekstowe z istniejącą wartością Użytkownika. Dzieje się tak, gdy akcja sekwencji zadań jest edytowana po jej utworzeniu.
```
textBox1.Text = this.PropertyManager["User"].StringValue;  
```

Ciągi zasobów

Poniższa procedura dodaje ciągi zasobów, które są używane do wyświetlania nazwy akcji niestandardowej w Edytorze sekwencji zadań.

Aby dodać ciągi zasobów

W Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.
Kliknij kartę Zasoby . Jeśli plik zasobów nie istnieje, utwórz go, wybierając komunikat wyświetlany na karcie Zasoby .
Na pasku narzędzi Projektant zasobów wskaż listę rozwijaną widoku zasobów, kliknij strzałkę i upewnij się, że jest ustawiona wartość Ciągi (która jest domyślna). Zostanie wyświetlona siatka ustawień z wyświetlonymi ciągami obsługiwanymi przez to wystąpienie projektanta zasobów.
Kliknij kolumnę Nazwa ostatniego wiersza w siatce, która jest oznaczona gwiazdką (*).
W kolumnie Nazwa wprowadź DefaultDisplay_ConfigMgrTSAction jako nazwę ciągu.
W kolumnie Wartość wprowadź ciąg Akcja niestandardowa. Jest to ciąg wyświetlany na liście akcji sekwencji zadań.
Kliknij kolumnę Nazwa ostatniego wiersza w siatce, która jest oznaczona gwiazdką (*).
W kolumnie Nazwa wprowadź ConfigMgrTSAction jako nazwę ciągu.
W kolumnie Value (Wartość ) wprowadź wartość Custom Action. Jest to ciąg wyświetlany podczas dodawania akcji niestandardowej.

Wdrażanie zestawu

Ta procedura kompiluje i kopiuje utworzony zestaw do folderu zestawów konsoli Configuration Manager. Aby uzyskać ważne informacje na temat wdrażania rozszerzeń konsoli Configuration Manager, zobacz About Configuration Manager Administrator Console Extension Deployment (Informacje o wdrożeniu rozszerzenia konsoli administratora Configuration Manager).

Aby wdrożyć zestaw

Skompiluj projekt. Program Visual Studio tworzy zestaw jako \Visual Studio 2005\Projects\ConfigMgrControl\ConfigMgrTSAction\bin\Debug\ConfigMgrTSActionControl.dll.
Skopiuj zestaw do folderu %ProgramFiles%\Microsoft Configuration Manager\AdminUI\bin.

Zobacz też

Informacje o rozszerzeniu konsoli Configuration Manager
Wdrażanie rozszerzenia konsoli Configuration Manager
Jak utworzyć plik MOF dla Configuration Manager akcji niestandardowej
Jak używać akcji niestandardowej Configuration Manager

Udostępnij za pośrednictwem