Informationen zu benutzerdefinierten Configuration Manager-Clientanwendungen für benutzerdefinierte Aktionen

Die Tasksequenz im Configuration Manager führt während der Clientbereitstellung benutzerdefinierte Aktionsvorgänge aus. Bei der Anwendung kann es sich um einen Prozess, ein Skript oder andere Befehle handeln. Die Anforderungen für die Anwendung werden in einer MOF-Datei (Managed Object Format) definiert. Zu den Beispielanforderungen gehören die Betriebsumgebung, Befehlszeilenargumente, Eigenschaften und Rückgabecodes. Sie werden der Tasksequenzumgebung hinzugefügt, wenn die Aktion verarbeitet wird.

Benutzerdefinierte Aktion MOF-Datei

Die MOF-Datei für eine benutzerdefinierte Aktion sieht ähnlich wie im folgenden Beispiel aus:

[   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";
};

Die MOF-Datei beschreibt die Informationen, die für die Eingabe, Umgebung, Eigenschaften und Bereitstellungspaketinformationen der benutzerdefinierten Aktion erforderlich sind.

Weitere Informationen finden Sie unter Informationen zur MOF-Datei für benutzerdefinierte Aktionen im Configuration Manager.

Anwendungseingabe

Benutzerdefinierte Aktionen müssen unbeaufsichtigt ausgeführt werden, daher sollte die Anwendung nicht zur Eingabe durch den Benutzer aufgefordert werden. Alle Eingaben sollten entweder über die Befehlszeile, die Tasksequenzumgebung oder aus einer Datendatei empfangen werden.

Die Befehlszeile für die Aktionsanwendung wird in der MOF-Datei mithilfe der integrierten Aktion "Befehlszeile ausführen " festgelegt.

Zum Beispiel:

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

Bearbeitung von Anträgen

Die Tasksequenzanwendung führt die benutzerdefinierten Aktionsvorgänge aus. Es muss seine Betriebsumgebung kennen und Zugriff auf die Umgebungsvariablen für die Aufgabensequenz haben, den Fortschritt melden und Abschlusscodes zurückgeben.

Umgebung

Die MOF-Datei sollte die Betriebsumgebung mit der Eigenschaft SMS_TaskSequence_Action Server WMI ClassSupportedEnvironment angeben. Die verfügbaren Umgebungen sind Windows PE (WinPE), vollständiges Betriebssystem (FullOS) oder beide Umgebungen (WinPEandFullOS).

Die Wahl der Umgebung hängt von den Umständen ab. So wird beispielsweise die vorbetriebliche Installationskonfiguration wahrscheinlich in der Windows PE-Umgebung vorgenommen. Weitere Informationen finden Sie unter Infrastrukturanforderungen für die Betriebssystembereitstellung. Updates für aktuell installierte Betriebssysteme verwenden die vollständige Betriebssystemumgebung. Beispiel: Software- oder Treiberinstallation. Betriebssystemunabhängige Aufgaben wie Neustarts oder das Erstellen von Netzwerkverbindungen können mit beiden Umgebungseinstellungen ausgeführt werden.

Verarbeitung

Während der Verarbeitung greifen Sie mit dem TSEnvironment COM-Automatisierungsobjekt auf die Tasksequenzvariablen zu, die von der MOF-Datei definiert werden. Weitere Informationen finden Sie unter Verwenden von Tasksequenzvariablen in einer ausgeführten Tasksequenz des Configuration Manager.

Wenn der Vorgang lange dauert, können Sie den Fortschritt an die Tasksequenzumgebung melden und eine Statusanzeige anzeigen, indem Sie die COM-Automatisierungsklasse des ProgressUI-Clients verwenden. Weitere Informationen finden Sie unter Informationen zum Status der benutzerdefinierten Aktion in Configuration Manager.

Abschluss

Die Anwendung sollte die SuccessCodes Umgebungsvariable als Rückgabewert festlegen, wenn sie abgeschlossen ist.

Wenn nach Abschluss der Anwendung ein Neustart erforderlich ist, sollte die SMSTSRebootRequested Umgebungsvariable gesetzt werden. Weitere Informationen finden Sie unter Tasksequenzvariablen. Informationen zum Festlegen von Umgebungsvariablen finden Sie unter Verwenden von Tasksequenzvariablen in einer ausgeführten Tasksequenz des Configuration Manager.

Bereitstellung)

Damit die Anwendung der benutzerdefinierten Aktion vom Configuration Manager verwendet werden kann, muss sie in einem Configuration Manager-Paket verfügbar sein. Der Administrator kann das Paket entweder mithilfe der Configuration Manager-Konsole oder mithilfe einer Programmiersprache erstellen. Weitere Informationen finden Sie unter Erstellen eines Pakets.

Der Paketbezeichner muss verfügbar sein, damit die Bereitstellung funktioniert. In der Regel deklariert die MOF-Datei eine Eigenschaft, die sie enthält, wie im folgenden Beispiel:

[TaskSequencePackage, CommandLineArg(1)]
string PackageIDForAbcExe;

Der Paketbezeichner wird vom Administrator abgerufen, wenn die benutzerdefinierte Aktion im Tasksequenz-Editor bearbeitet wird.

Um dieses Verhalten zu aktivieren, kann das benutzerdefinierte Aktionssteuerelement in seiner Implementierung ein Textbearbeitungssteuerelement verwenden, um den Paketbezeichner vom Administrator zu erhalten. Ein Beispiel, in dem ein Textsteuerelement verwendet wird, finden Sie unter Erstellen eines benutzerdefinierten Configuration Manager-Aktionssteuerelements.

Bei Verwendung durch den Administrator wird das benutzerdefinierte Aktionssteuerelement als Teil einer Tasksequenz mithilfe des Tasksequenz-Editors bearbeitet. Beim Speichern durch den Tasksequenz-Editor wird eine SMS_TaskSequencePackage Server WMI-Klasse erstellt, die die Tasksequenz, einschließlich der benutzerdefinierten Aktion, enthält.

Das Tasksequenzpaket wird dann zusammen mit dem benutzerdefinierten Aktionspaket, auf das die benutzerdefinierte Aktion verweist, den Clients angekündigt. Weitere Informationen finden Sie unter Erstellen einer Ankündigung.

Wenn die benutzerdefinierte Aktion auf dem Client ausgeführt wird, wird der Paketbezeichner für die benutzerdefinierte Aktion als Befehlszeilenparameter bereitgestellt, aus dem die Binärdateien für die benutzerdefinierte Aktion extrahiert und ausgeführt werden.

Der Paketbezeichner wird mithilfe des /run Befehlszeilenparameters zum Smsswd.exe bereitgestellt.

Vor-Netzwerk-Partition und Vor-Partitions-Setup

Wenn Sie die Datenträger- oder Netzwerkkonnektivität konfigurieren müssen, bevor Sie eine Datenträgerpartition und vor der Netzwerkkonnektivität haben, müssen Sie eine Anwendung für diese Aufgaben erstellen. Ihre Anwendung sollte mithilfe des Windows Assessment and Deployment Kit (ADK) in einem benutzerdefinierten Startimage platziert werden. Weitere Informationen finden Sie unter Windows ADK-Szenarien für IT-Spezialisten.

Importieren Sie dann das Image als benutzerdefiniertes Image in Configuration Manager. Weitere Informationen finden Sie unter Hinzufügen eines Startimages.

Die Anwendung, alle unterstützenden Dateien und die benutzerdefinierte SMSTS.INI sollten im Windows-Ordner abgelegt werden.

Um die Anwendung zu verwenden, verwenden Sie das benutzerdefinierte Startimage in einer Tasksequenz, die einen Schritt vor der Partitionierung/dem Netzwerk enthält.

Siehe auch

Informationen zu benutzerdefinierten Aktionen im Configuration Manager

Informationen zur benutzerdefinierten MOF-Datei des Configuration Manager