Debuggen einer Aufgabensequenz

Gilt für: Configuration Manager (Current Branch)

Der Tasksequenzdebugger ist ein Tool zur Problembehandlung. Sie stellen eine Tasksequenz im Debugmodus für eine kleine Sammlung bereit. Sie ermöglicht Ihnen, die Tasksequenz auf kontrollierte Weise zu durchlaufen, um die Problembehandlung und Untersuchung zu unterstützen. Der Debugger wird derzeit auf demselben Gerät wie das Tasksequenzmodul ausgeführt. Es handelt sich nicht um einen Remotedebugger.

Voraussetzungen

• Aktualisieren des Configuration Manager-Clients auf dem Zielgerät

• Melden Sie sich auf dem Zielgerät als Benutzer in der lokalen Administratorgruppe an. Der Debugger wird nur für Administratoren ausgeführt.

• Aktualisieren Sie das mit der Tasksequenz verknüpfte Startimage, um sicherzustellen, dass es die neueste Clientversion aufweist

Starten des Tools

1. Wechseln Sie in der Configuration Manager-Konsole zum Arbeitsbereich Softwarebibliothek, erweitern Sie Betriebssysteme, und wählen Sie Tasksequenzen aus.

2. Wählen Sie eine Tasksequenz aus. Wählen Sie im Menüband in der Gruppe "Bereitstellung" die Option "Debuggen" aus.

   Tipp

   Alternativ können Sie die Variable TSDebugMode auf ein Sammlungs- oder Computerobjekt festlegen TRUE , für das die Tasksequenz bereitgestellt wird. Jedes Gerät, für das diese Variable festgelegt ist, versetzt jede darauf bereitgestellte Tasksequenz in den Debugmodus.

3. Erstellen Sie eine Debugbereitstellung. Die Bereitstellungseinstellungen sind mit denen bei einer normalen Tasksequenzbereitstellung identisch. Weitere Informationen finden Sie unter Bereitstellen einer Tasksequenz.

   Hinweis

   Sie können nur eine kleine Sammlung für eine Debugbereitstellung auswählen. Es werden nur Gerätesammlungen mit 10 oder weniger Mitgliedern angezeigt.

Verwenden Sie die Tasksequenzvariable TSDebugOnError , um den Debugger automatisch zu starten, wenn die Tasksequenz einen Fehler zurückgibt. Weitere Informationen finden Sie unter Tasksequenzvariablen – TSDebugOnError.

Verwenden des Tools

Wenn die Tasksequenz auf dem Gerät ausgeführt wird, wird das Fenster Tasksequenzdebugger geöffnet, ähnlich wie im folgenden Screenshot:

Der Debugger enthält die folgenden Steuerelemente:

• Schritt: Führen Sie von der aktuellen Position aus nur den nächsten Schritt in der Tasksequenz aus.

  Hinweis

  Wenn sich die Tasksequenz im Debugmodus befindet und ein Schritt einen schwerwiegenden Fehler zurückgibt, schlägt die Tasksequenz nicht wie gewohnt fehl. Dieses Verhalten gibt Ihnen die Möglichkeit, einen Schritt zu wiederholen, nachdem Sie eine externe Änderung vorgenommen haben.

• Ausführen: Führen Sie die Tasksequenz von der aktuellen Position aus normal bis zum Ende, zum nächsten Haltepunkt oder wenn ein Schritt fehlschlägt. Bevor Sie diese Aktion verwenden, stellen Sie sicher, dass Sie alle Haltepunkte mit der Aktion "Umbruch setzen " festlegen.

• Als "Aktuelles festlegen": Wählen Sie einen Schritt im Debugger und dann " Als aktuelles festlegen" aus. Diese Aktion verschiebt den aktuellen Mauszeiger auf diesen Schritt. Mit dieser Aktion können Sie Schritte überspringen oder rückwärts gehen.

  Warnung

  Der Debugger berücksichtigt den Schritttyp nicht, wenn Sie die aktuelle Position in der Sequenz ändern. In einigen Schritten werden möglicherweise Tasksequenzvariablen festgelegt, die für die Bedingungsauswertung in späteren Schritten erforderlich sind. Wenn sie nicht in der richtigen Reihenfolge ausgeführt werden, können einige Schritte fehlschlagen oder erhebliche Schäden an einem Gerät verursachen. Verwenden Sie diese Option auf eigene Gefahr.

• Pause festlegen: Wählen Sie einen Schritt im Debugger und dann Pause festlegen aus. Diese Aktion fügt einen Haltepunkt im Debugger hinzu. Wenn Sie die Tasksequenz ausführen , wird sie an einer Pause angehalten.

  • Bevor Sie die Aktion "Ausführen" verwenden, legen Sie Haltepunkte fest.

  • Wenn Sie im Debugger einen Haltepunkt erstellen und die Tasksequenz dann den Computer neu startet, behält der Debugger Ihre Haltepunkte nach dem Neustart bei.

• Alle Haltepunkte löschen: Entfernen Sie alle Haltepunkte.

• Protokolldatei: Öffnet die aktuelle Tasksequenzprotokolldatei smsts.log mit CMTrace. Sie können Protokolleinträge sehen, wenn das Tasksequenzmodul auf "Warten auf den Debugger" steht.

• Cmd-Eingabeaufforderung: Öffnet in Windows PE eine Eingabeaufforderung.

• Abbrechen: Schließen Sie den Debugger, und lassen Sie die Tasksequenz fehlschlagen.

• Beenden: Trennen und schließen Sie den Debugger, aber die Tasksequenz wird normal weiter ausgeführt.

Im Fenster Tasksequenzvariablen werden die aktuellen Werte für alle Variablen in der Tasksequenzumgebung angezeigt. Weitere Informationen finden Sie unter Tasksequenzvariablen. Wenn Sie den Schritt Tasksequenzvariable festlegen mit der Option Diesen Wert nicht anzeigen verwenden, zeigt der Debugger den Variablenwert nicht an. Sie können die Variablenwerte im Debugger nicht bearbeiten.

Der Tasksequenzdebugger wird nach einem Neustart des Computers weiterhin ausgeführt. Der Debugger behält Ihre Haltepunkte nach dem Neustart bei. Sie müssen sich bei Windows anmelden, um fortzufahren, auch wenn dies für die Tasksequenz nicht erforderlich ist, da der Debugger eine Benutzerinteraktion erfordert. Wenn Sie sich nach einer Stunde nicht anmelden, um das Debuggen fortzusetzen, schlägt die Tasksequenz fehl.

Außerdem wird mit dem Schritt " Tasksequenz ausführen " eine untergeordnete Tasksequenz schrittweise ausgeführt. Im Debuggerfenster werden die Schritte der untergeordneten Tasksequenz zusammen mit der Haupttasksequenz angezeigt.

Bekannte Probleme

Wenn Sie sowohl eine normale Bereitstellung als auch eine Debugbereitstellung auf demselben Gerät über mehrere Bereitstellungen ausrichten, wird der Tasksequenzdebugger möglicherweise nicht gestartet.

Siehe auch

• Info zu Aufgabensequenzschritten
• Aufgabensequenzvariablen
• Verwenden von Aufgabensequenzvariablen
• Bereitstellen einer Aufgabensequenz