Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Sekwencja zadań w programie Configuration Manager wykonuje operacje akcji niestandardowych podczas wdrażania klienta. Aplikacja może być procesem, skryptem lub innymi poleceniami. Wymagania dotyczące aplikacji są definiowane w pliku w formacie 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";
};
Plik MOF zawiera opis informacji wymaganych do wprowadzenia danych wejściowych aplikacji akcji niestandardowej, środowiska, właściwości i informacji o pakiecie wdrożeniowym.
Aby uzyskać więcej informacji, zobacz Informacje o pliku MOF akcji niestandardowej programu Configuration Manager.
Dane wejściowe aplikacji
Akcje niestandardowe muszą być uruchamiane bez nadzoru, więc aplikacja nie powinna wyświetlać monitu o wprowadzenie danych przez użytkownika. Wszystkie dane wejściowe powinny być odbierane z wiersza polecenia, środowiska sekwencji zadań lub z pliku danych.
Wiersz polecenia dla aplikacji akcji jest ustawiany w pliku MOF za pomocą wbudowanej akcji Uruchom wiersz polecenia .
Przykład:
CommandLine("smsswd.exe /run:PackageID abc.exe [any abc.exe command line args]"
Przetwarzanie wniosków
Aplikacja sekwencji zadań uruchamia niestandardowe operacje akcji. Musi być świadomy swojego środowiska operacyjnego i mieć dostęp do zmiennych środowiskowych sekwencjonowania zadań, postępu raportu i zwracanych kodów ukończenia.
Środowisko
Plik MOF powinien określać środowisko operacyjne za pomocą właściwości klasy SupportedEnvironmentWMI 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 przed uruchomieniem prawdopodobnie zostanie wykonana w środowisku Windows PE. Aby uzyskać więcej informacji, zobacz Wymagania dotyczące infrastruktury do wdrożenia systemu operacyjnego. Aktualizacje obecnie zainstalowanych systemów operacyjnych będą używać pełnego środowiska systemu operacyjnego. Na przykład instalacja oprogramowania lub sterownika. Zadania niezależne od środowiska systemu operacyjnego, takie jak ponowne uruchamianie lub tworzenie połączeń sieciowych, można wykonywać przy użyciu obu ustawień środowiska.
Przetwarzanie
Podczas przetwarzania można uzyskać dostęp do zmiennych sekwencji zadań zdefiniowanych przez plik MOF przy użyciu obiektu automatyzacji TSEnvironment COM. Aby uzyskać więcej informacji, zobacz Jak używać zmiennych sekwencji zadań w uruchomionej sekwencji zadań programu 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 postępu akcji niestandardowej programu Configuration Manager.
Zakończenie:
Aplikacja powinna ustawić zmienną środowiskową SuccessCodes jako wartość zwracaną po zakończeniu.
| Powrót | Opis |
|---|---|
| 0 | Sukces |
| Wartość różna od zera | Niepowodzenie |
Jeśli po zakończeniu działania aplikacji wymagane jest ponowne uruchomienie, należy SMSTSRebootRequested ustawić zmienną środowiskową. Aby uzyskać więcej informacji, zobacz Zmienne sekwencji zadań. Aby uzyskać informacje o ustawianiu zmiennych środowiskowych, zobacz Jak używać zmiennych sekwencji zadań w uruchomionej sekwencji zadań programu Configuration Manager.
Wdrożenie
Aby aplikacja akcji niestandardowej mogła być używana przez program Configuration Manager, musi być dostępna z poziomu pakietu programu Configuration Manager. Administrator może utworzyć pakiet przy użyciu konsoli programu Configuration Manager lub języka programowania. Aby uzyskać więcej informacji, zobacz Jak utworzyć pakiet.
Identyfikator pakietu musi być dostępny, aby wdrożenie działało. Zazwyczaj plik MOF deklaruje właściwość, aby ją przechowywać, jak w poniższym przykładzie:
[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;
Uwaga
Identyfikatorem pakietu jest właściwość klasy PackageIDWMI serwera SMS_Package.
Identyfikator pakietu jest uzyskiwany od administratora podczas edytowania akcji niestandardowej w edytorze sekwencji zadań.
Aby włączyć to zachowanie, niestandardowa kontrolka akcji może użyć w swojej implementacji kontrolki edycji tekstu w celu uzyskania identyfikatora pakietu od administratora. Aby zapoznać się z przykładem, który używa kontrolki tekstu, zobacz Jak utworzyć kontrolkę akcji niestandardowej programu Configuration Manager.
Gdy jest używana przez administratora, kontrolka akcji niestandardowej jest edytowana jako część sekwencji zadań przy użyciu edytora sekwencji zadań. Po zapisaniu przez edytor sekwencji zadań jest tworzona klasa WMI serwera SMS_TaskSequencePackage do przechowywania sekwencji zadania, w tym akcji niestandardowej.
Pakiet sekwencji zadań jest następnie ogłaszany do klientów wraz z pakietem akcji niestandardowych, do którego odwołuje się akcja niestandardowa. Aby uzyskać więcej informacji, zobacz Jak utworzyć reklamę.
Podczas uruchamiania akcji niestandardowej na kliencie jest podawany identyfikator pakietu dla tej akcji niestandardowej jako parametr wiersza polecenia, z którego są wyodrębniane i uruchamiane pliki binarne tej akcji niestandardowej.
Identyfikator pakietu jest podawany za pomocą parametru wiersza /run polecenia w celu Smsswd.exe.
Partycja przed siecią i konfiguracja przed partycjami
Jeśli musisz skonfigurować łączność dyskową lub sieciową przed uzyskaniem partycji dysku i przed uzyskaniem łączności z siecią, musisz utworzyć aplikację do wykonywania tych zadań. 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 zestawów ADK systemu Windows dla informatyków.
Uwaga
Dodanie plików do pliku obrazu rozruchowego może zwiększyć minimalne wymagania dotyczące pamięci RAM i może, z powodu małej ilości pamięci, spowodować niepowodzenie sekwencji zadań w nieoczekiwany sposób.
Następnie zaimportuj obraz do programu Configuration Manager jako obraz niestandardowy. Aby uzyskać więcej informacji, zobacz Dodawanie obrazu rozruchowego.
Aplikacja, wszystkie pliki pomocnicze i SMSTS.INI niestandardowy powinny zostać umieszczone w folderze Windows.
Aby użyć aplikacji, użyj niestandardowego obrazu rozruchowego w sekwencji zadań zawierającej krok przed partycją/siecią.
Zobacz też
Informacje o akcjach niestandardowych programu Configuration Manager
Informacje o pliku MOF akcji niestandardowej programu Configuration Manager