Informacje o Configuration Manager niestandardowych aplikacjach klienckich akcji

Sekwencja zadań w Configuration Manager wykonuje niestandardowe operacje akcji podczas wdrażania klienta. Aplikacja może być procesem, skryptem lub innymi poleceniami. Wymagania dotyczące aplikacji są definiowane w pliku MOF (Managed Object Format). Przykładowe wymagania obejmują środowisko operacyjne, argumenty wiersza polecenia, właściwości i kody powrotne. Są one dodawane do środowiska sekwencji zadań podczas przetwarzania akcji.

Plik MOF akcji niestandardowej

Plik MOF dla akcji niestandardowej jest podobny do następującego przykładu:

[   CommandLine("smsswd.exe /run:%1 abc.exe %2"),
    : (custom ui control and category qualifiers for action)
    ]
class MyCustomAction : SMS_TaskSequence_Action
{
    [TaskSequencePackage, CommandLineArg(1)]
    string          PackageIDForAbcExe;

    [CommandLineArg(2), AllowedLen("1-32000")]
    string          AbcCommandLineArgs;

    [SuccessCodes, Not_Null]
    string          AbcSuccessCodes = "0 3010";

    string         SomeOtherPropertyThatAbcNeeds;

    string          SupportedEnvironment = "WinPEandFullOS";
};

W pliku MOF opisano informacje potrzebne do wprowadzenia niestandardowej aplikacji akcji, środowiska, właściwości i informacji o pakiecie wdrażania.

Aby uzyskać więcej informacji, zobacz About the Configuration Manager custom action MOF file (Informacje o pliku MOF akcji niestandardowej Configuration Manager).

Dane wejściowe aplikacji

Akcje niestandardowe muszą być uruchamiane bez nadzoru, więc aplikacja nie powinna monitować o podanie danych wejściowych użytkownika. Wszystkie dane wejściowe powinny być odbierane z wiersza polecenia, środowiska sekwencji zadań lub z pliku danych.

Wiersz polecenia aplikacji akcji jest ustawiany w pliku MOF przy użyciu wbudowanej akcji Uruchom wiersz polecenia .

Przykład:

CommandLine("smsswd.exe /run:PackageID abc.exe [any abc.exe command line args]"

Przetwarzanie aplikacji

Aplikacja sekwencji zadań uruchamia niestandardowe operacje akcji. Musi mieć świadomość swojego środowiska operacyjnego i mieć dostęp do sekwencjonowania zmiennych środowiskowych zadania, postępu raportu i zwracanych kodów ukończenia.

Środowiska

Plik MOF powinien określać środowisko operacyjne za pomocą właściwości klasy WMISupportedEnvironment serwera SMS_TaskSequence_Action. Dostępne środowiska to Windows PE (WinPE), pełny system operacyjny (FullOS) lub oba środowiska (WinPEandFullOS).

Wybór środowiska zależy od okoliczności. Na przykład konfiguracja instalacji wstępnej będzie prawdopodobnie wykonywana w środowisku windows PE. Aby uzyskać więcej informacji, zobacz Wymagania dotyczące infrastruktury dotyczące wdrażania systemu operacyjnego. Aktualizacje obecnie zainstalowanych systemów operacyjnych będzie korzystać z pełnego środowiska systemu operacyjnego. Na przykład instalacja oprogramowania lub sterownika. Zadania niezależne od środowiska systemu operacyjnego, takie jak ponowny rozruch lub tworzenie połączeń sieciowych, mogą być wykonywane przy użyciu obu ustawień środowiska.

Przetwarzania

Podczas przetwarzania uzyskujesz dostęp do zmiennych sekwencji zadań zdefiniowanych przez plik MOF przy użyciu obiektu TSEnvironment automatyzacji COM. Aby uzyskać więcej informacji, zobacz How to Use Task Sequence Variables in a Running Configuration Manager Task Sequence (Jak używać zmiennych sekwencji zadań w uruchomionej sekwencji zadań Configuration Manager).

Jeśli operacja trwa długo, możesz zgłosić postęp do środowiska sekwencji zadań i wyświetlić wskaźnik postępu przy użyciu klasy automatyzacji COM klienta ProgressUI. Aby uzyskać więcej informacji, zobacz Informacje o raportowaniu Configuration Manager postępu akcji niestandardowej.

Zakończenia

Po zakończeniu SuccessCodes aplikacja powinna ustawić zmienną środowiskową jako wartość zwracaną.

Zwraca	Opis
0	Sukces
Niezerowe	Awarii

Jeśli po zakończeniu działania aplikacji jest wymagany ponowny rozruch, należy ustawić zmienną środowiskową SMSTSRebootRequested . Aby uzyskać więcej informacji, zobacz Zmienne sekwencji zadań. Aby uzyskać informacje na temat ustawiania zmiennych środowiskowych, zobacz How to use task sequence variables in a running Configuration Manager task sequence (Jak używać zmiennych sekwencji zadań w uruchomionej sekwencji zadań Configuration Manager).

Wdrożenie

Aby była używana przez Configuration Manager, aplikacja akcji niestandardowej musi być dostępna z pakietu Configuration Manager. Administrator może utworzyć pakiet przy użyciu konsoli Configuration Manager lub języka programowania. Aby uzyskać więcej informacji, zobacz How to create a package (Jak utworzyć pakiet).

Identyfikator pakietu musi być dostępny, aby wdrożenie działało. Zazwyczaj plik MOF deklaruje właściwość do przechowywania, jak w poniższym przykładzie:

[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;

Uwaga

Identyfikator pakietu jest właściwością klasy WMIPackageID serwera SMS_Package.

Identyfikator pakietu jest uzyskiwany od administratora, gdy akcja niestandardowa jest edytowana w edytorze sekwencji zadań.

Aby włączyć to zachowanie, kontrolka akcji niestandardowej może użyć kontrolki edycji tekstu w jej implementacji, aby uzyskać identyfikator pakietu od administratora. Przykład, który używa kontrolki tekstu, można znaleźć w temacie How to create a Configuration Manager custom action control (Jak utworzyć kontrolkę akcji niestandardowej Configuration Manager).

W przypadku użycia przez administratora kontrolka akcji niestandardowej jest edytowana w ramach sekwencji zadań przy użyciu edytora sekwencji zadań. Po zapisaniu przez edytor sekwencji zadań jest tworzona klasa WMI serwera SMS_TaskSequencePackage w celu przechowywania sekwencji zadań, w tym akcji niestandardowej.

Pakiet sekwencji zadań jest następnie anonsowany do klientów wraz z niestandardowym pakietem akcji, do którego odwołuje się akcja niestandardowa. Aby uzyskać więcej informacji, zobacz Jak utworzyć anons.

Po uruchomieniu akcji niestandardowej na kliencie identyfikator pakietu dla akcji niestandardowej jest dostarczany jako parametr wiersza polecenia, z którego są wyodrębniane i uruchamiane pliki binarne dla akcji niestandardowej.

Identyfikator pakietu jest udostępniany przy użyciu parametru /run wiersza polecenia do Smsswd.exe.

Konfiguracja partycji przed siecią i partycji wstępnej

Jeśli musisz skonfigurować łączność dyskową lub sieciową przed utworzeniem partycji dysku i przed połączeniem sieciowym, musisz utworzyć aplikację, aby wykonać te zadania. Aplikacja powinna zostać umieszczona w niestandardowym obrazie rozruchowym przy użyciu zestawu Windows Assessment and Deployment Kit (ADK). Aby uzyskać więcej informacji, zobacz Scenariusze zestawu Windows ADK dla specjalistów IT.

Uwaga

Dodanie plików do pliku obrazu rozruchowego może zwiększyć minimalne wymagania dotyczące pamięci RAM i z powodu małej ilości pamięci może spowodować nieoczekiwane niepowodzenie sekwencji zadań.

Następnie zaimportuj obraz do Configuration Manager jako obraz niestandardowy. Aby uzyskać więcej informacji, zobacz Dodawanie obrazu rozruchowego.

Aplikacja, wszystkie pliki pomocnicze i SMSTS.INI niestandardowe powinny zostać umieszczone w folderze systemu Windows.

Aby użyć aplikacji, użyj niestandardowego obrazu rozruchowego w sekwencji zadań zawierającej krok przed partycją/siecią.

Zobacz też

Informacje o Configuration Manager akcjach niestandardowych

Informacje o pliku MOF akcji niestandardowej Configuration Manager