タスク シーケンスのデバッグ

Configuration Manager (現在のブランチ) に適用

タスク シーケンス デバッガーは、トラブルシューティング ツールです。 デバッグ モードでタスク シーケンスを小さなコレクションにデプロイします。 これにより、トラブルシューティングと調査に役立つ、制御された方法でタスク シーケンスをステップ実行できます。 デバッガーは現在、タスク シーケンス エンジンと同じデバイスで実行されており、リモート デバッガーではありません。

前提条件

• ターゲット デバイス上の Configuration Manager クライアントを更新する

• ローカルの Administrators グループのユーザーとしてターゲット デバイスにサインインします。 デバッガーは管理者に対してのみ実行されます。

• タスク シーケンスに関連付けられているブート イメージを更新して、最新のクライアント バージョンを使用していることを確認します

ツールの起動

1. Configuration Manager コンソールで、[ソフトウェア ライブラリ] ワークスペースに移動し、[オペレーティング システム] を展開して、[タスク シーケンス] を選択します。

2. タスク シーケンスを選択します。 リボンの [展開] グループで、[ デバッグ] を選択します。

   ヒント

   または、タスク シーケンスが展開されるコレクションまたはコンピューター オブジェクトで変数 TSDebugMode を TRUE に設定します。 この変数が設定されているデバイスは、そのデバイスに展開されているタスク シーケンスをデバッグ モードにします。

3. デバッグ配置を作成します。 デプロイ設定は、通常のタスク シーケンスのデプロイと同じです。 詳細については、「 タスク シーケンスの展開」を参照してください。

   注:

   デバッグ配置用に小さなコレクションのみを選択できます。 10 メンバー以下のデバイス コレクションのみが表示されます。

タスク シーケンス変数 TSDebugOnError を使用して、タスク シーケンスからエラーが返されたときにデバッガーを自動的に起動します。 詳細については、「 タスク シーケンスの変数 - TSDebugOnError」を参照してください。

ツールを使用する

デバイスでタスク シーケンスを実行すると、次のスクリーンショットのように [タスク シーケンス デバッガー] ウィンドウが開きます。

デバッガーには次のコントロールが含まれています。

• 手順: 現在の 位置から、タスク シーケンスの次のステップのみを実行します。

  注:

  タスク シーケンスがデバッグ モードのときに、ステップから致命的なエラーが返された場合でも、タスク シーケンスは通常どおり失敗しません。 この動作により、外部変更を行った後で手順を再試行するオプションが提供されます。

• 実行:現在の 位置から、タスク シーケンスを最後、次の ブレーク ポイント、またはステップが失敗した場合まで通常どおり実行します。 このアクションを使用する前に、必ず [ ブレークの設定 ] アクションでブレーク ポイントを設定してください。

• 現在に設定: デバッガーでステップを選択し、[ 現在に設定] を選択します。 これにより 、現在の ポインターがそのステップに移動します。 この操作により、手順をスキップしたり、後方に移動したりできます。

  警告

  デバッガーは、シーケンスの現在の位置を変更する場合、ステップの種類を考慮しません。 一部の手順では、後の手順による条件評価に必要なタスク シーケンス変数を設定する場合があります。 順序が正しく動作しない場合、一部の手順が失敗したり、デバイスに重大な損傷を与えたりする可能性があります。 このオプションは、自己の責任においてご使用ください。

• ブレークの設定: デバッガーでステップを選択し、[ ブレークの設定] を選択します。 このアクションにより、デバッガーに ブレーク ポイントが追加されます。 タスク シーケンス を実行する と、 休憩時に停止します。

  • 実行 アクションを使用する 前に、ブレークポイントを設定します。

  • デバッガーでブレーク ポイントを作成し、タスク シーケンスによってコンピューターが再起動されると、再起動後もデバッガーはブレーク ポイントを保持します。

• すべてのブレークをクリア: すべてのブレーク ポイントを削除します。

• ログ ファイル: CMTrace を使用して、現在のタスク シーケンス ログ ファイル smsts.logを開きます。 タスク シーケンス エンジンが "デバッガーを待機中" の場合にログ エントリを確認できます。

• コマンド プロンプト: Windows PE で、コマンド プロンプトを開きます。

• キャンセル: デバッガーを閉じ、タスク シーケンスに失敗します。

• 終了: デバッガーをデタッチして閉じますが、タスク シーケンスは正常に実行され続けます。

[ タスク シーケンス 変数] ウィンドウには、タスク シーケンス環境のすべての変数の現在の値が表示されます。 詳細については、「 タスク シーケンスの変数」を参照してください。 [この値を表示しない] オプションを指定して [タスク シーケンス変数の設定] 手順を使用すると、デバッガーは変数値を表示しません。 デバッガーでは変数値を編集できません。

タスク シーケンス デバッガーは、 コンピューターの再起動 手順の後も引き続き実行されます。 再起動後もデバッガーはブレーク ポイントを保持します。 タスク シーケンスでは必要ない場合もありますが、デバッガーはユーザーの操作を必要とするため、続行するには Windows にサインインする必要があります。 1 時間後にサインインしてデバッグを続行しない場合、タスク シーケンスは失敗します。

また、[ タスク シーケンスの実行 ] ステップを使用して子タスク シーケンスにステップ インします。 デバッガー ウィンドウには、子タスク シーケンスのステップとメイン タスク シーケンスが表示されます。

既知の問題

複数の展開を介して同じデバイスに対する通常の展開とデバッグ展開の両方を対象とする場合、タスク シーケンス デバッガーが起動しない可能性があります。

関連項目

• タスク シーケンスの手順について
• タスク シーケンス変数
• タスク シーケンス変数の使用方法
• タスク シーケンスの展開