スクリプト作成機能でのKスクリプトの作成・編集について (4252473)

この記事ではスクリプト作成機能でのKスクリプトの作成・編集について説明します。

Kスクリプトの構成要素　

Kスクリプトには次の構成要素があります。

設定

展開

Windowsの指定実行

通知

スケジュール

依存関係

Kスクリプトで使用するためのファイルを登録する場所です。

このファイルはエージェントでの実行時には トークン置換変数 の１つである$(KACE_DEPENDENCY_DIR) に配置されます。

トークン置換変数については スクリプト詳細画面の タスクセクションの [?] をクリックすることで確認できます。

タスク

スクリプトは1つ以上のタスクを持たなければなりません。1つのタスクは、"検証"、"成功時"、"修復"、"修復の成功時"、"修復の失敗時" それぞれのセクションを持ちます。

1スクリプトに複数のタスクを持たせることも可能です。

各セクションには「ステップ」を追加できます。ステップに実施させたいコマンドや処理を指定します。

重要事項

■ 実行ユーザーについて

WindowsデバイスでKScriptを実行して出力したファイルを社内のファイルサーバー共有フォルダに書き込もうとして失敗することがあります。
スクリプトログに 'アクセスが拒否されました。'  というエラーが発生します。 KスクリプトはSYSTEMユーザーで実行されているため、ファイル共有への十分なアクセス権限がないことが考えられます。
また スクリプト内でファイル共有からローカルシステムアカウントでアクセスしていることにより、ファイルの取得・読み出しで失敗することもあります。
これらの対処については一定の方法はございません。 ファイル共有側の書き込み許可の設定、 クライアンドデバイスのドメインメンバーへの参加が必要な場合があります。
Kscriptの実行ユーザーについて (4257416)

■ batファイル、VBScriptの登録呼び出しについて

BATファイルをスクリプトにて端末で実行する方法 (4260721)
Kスクリプトを使用してVBScriptを実行させる方法 (4314950)
64 Bit Windowsでの実行においては記事 4272388 の内容もご参照ください。

■ タスクの継続設定（失敗時オプション）について

1つのKスクリプトにタスクを複数登録しておくと、タスク1のあとでタスク2の処理に進ませることができます。

タスク1の失敗時の設定が 中止 となっている場合、タスク1の[検証セクション] での評価結果が["成功時"セクション]に進まなかった場合には、タスク２が実行されません。

■ ステップ（手順）の追加

各セクションで使用できるステップについては オンラインヘルプ あるいは 管理者ガイド「付録 スクリプトのタスクセクションへの手順の追加」を参照してください。

プラットフォームの選択状態により、選択可能なステップなどが異なります。

■ セクション内でのステップ（手順）の挙動

"検証"、"成功時"、"修復"、"修復の成功時"、"修復の失敗時"、いずれのセクションにおいても ステップを複数記述できます。

スクリプトは上から実行され、そのうち1つでも失敗判定（コマンドならNon-Zeroの終了コード）を返したら同セクション内のステップは実行されず、次のフロー（セクションやタスクあるいは終了）に移ります。

以下のようなスクリプトのタスクでは最初にC:\MyDirが存在していたとしても  File1.txtを作成することは可能ですが、ステップS1 が失敗するとそれ以降は実行されないため、File2.txt を作成する処理は常に行われません。

例: 

[検証セクション]
ステップV1: ディレクトリ C:\MyDir が存在する

[成功時セクション]
ステップS1: ｛ファイル C:\MyDir\File1.txtを作成する処理｝
ステップS2: ｛何か失敗する処理｝→ここで終わり
ステップS3: ｛ファイル C:\MyDir\File2txtを作成する}

ステップR1: ディレクトリ C:\MyDir を作成する

-- 終了 --

タスクとステップの移動についてまとめた図を以下に示します。

Click To See Full Image.

■ スクリプトのステータスについて

最後に実行されたタスクのセクション とその最後のステップの結果によってスクリプトのステータスが異なります。 セクションとステップ実行結果の戻り値に応じて以下のようになります。

• [検証セクション] ステップの戻り値 0  [正常時セクション] ステップの戻り値0    ->  ステータス1（実行は成功しました）
• [検証セクション] ステップの戻り値 0  [正常時セクション] ステップの戻り値 NonZero ->  ステータス3 (実行は失敗しました)
• [検証セクション] ステップの戻り値 NonZero [修復時セクション] ステップの戻り値0  ->  ステータス2（実行は成功しました）
• [検証セクション] ステップの戻り値 NonZero [修復時セクション] ステップの戻り値 NonZero ->  ステータス4 (実行は失敗しました)

注意: これらの 1,2,3,4のステータスはKスクリプトのステータスでありコマンドの戻り値そのものではありません。