前のトピック: テンプレート グループ:項目管理次のトピック: 例


activateItem—テンプレート グループ内の項目の起動

このコマンドでは、ソフトウェア テンプレートに起動ジョブが割り当てられます。

このコマンドのフォーマットは、以下のとおりです。

templategroup action=activateItem 
name=template_group_name
[swTemplate=software_template_name]
item=item_name 
version=item_version
procedure=procedure_name 
installedWith=install_procedure_name
[repeat] 
after={exacttime|boottime} 
[calendarname=delivery_calendar]
[{preaction={none|reboot|logoff}|bootbefore}]
[{postaction=
{none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}
|bootafter}]
[promptUser[={y|n}]] 
[allowCancel[={y|n}]] 
[execTimedOut[={y|n}]]
[prompt=days.hours] 
[offline[={y|n}]] 
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]] 
[globalTime] 
[nocalendar]
[resolveQuery] 
[stagingServer] 
[parameters=user_parameters]
[{jobTimeout=d.h|timeout=hours}]
[userJobMessage]
after

ターゲット システムでのプロシージャの開始時間です。

有効な値は以下のとおりです。

exacttime

atTime に達すると、ただちにプロシージャが開始されます。

boottime

atTime が経過した後の最初のブートまで、プロシージャの開始が遅延されます。

allowCancel

「allowCancel」または「allowCancel =y」をコーディングすると、ユーザに対してジョブ実行のキャンセルが許可されます。
「allowCancel =n」を指定した場合には、キャンセルが許可されません。

パラメータがコーディングされていない場合は、関連するプロシージャのジョブ オプション値によってデフォルトが指定されます。

calendarname

保留中のインストールがキャンセルされる 評価を実施できる時間を制御するカレンダの名前です。

execTimedOut

「execTimedOut」または「execTimedOut=y」を指定すると、ユーザに確認を求めたジョブ実行がタイムアウトしたときには自動的に実行が始まります。
「execTimedOut=n」を指定した場合は、ジョブ実行は自動的には開始されません。

パラメータがコーディングされていない場合は、関連するプロシージャのジョブ オプション値によってデフォルトが指定されます。

globalTime

「globalTime」または「globalTime=y」をコーディングすると、時間指定がエンタープライズ マネージャ時間に基づいたものになります。

「globalTime=n」をコーディングすると、時間指定がドメイン マネージャ時間に基づいたものになります。

installedWith

保留中のインストールがキャンセルされる インストール プロシージャの名前を指定します。

item

保留中のインストールがキャンセルされる 項目の名前 を指定します。

name

保留中のインストールがキャンセルされる テンプレート グループ名 を指定します。

jobTimeout

保留中のインストールがキャンセルされる jobTimeout には、ジョブの有効期間が「d.h」の形式で指定されます。d には日数、h には時間数が指定されます。 パラメータの範囲は、マネージャ側で設定できます。 指定した値が設定されている上限を超える場合には、値はその上限に設定されます。指定した値が下限に満たない場合は、その下限に設定されます。 どの場合でも警告は出されません。
jobTimeout は timeout パラメータと一緒に指定しないでください。両方指定するとエラーが報告されます。 いずれのパラメータも指定されていない場合は、7.0 がデフォルトで設定されます。

noCalendar

「noCalendar」をコーディングすると、このジョブの実行についてはターゲット コンピュータのカレンダが無視されます。

(デフォルト)

offline

「offline」または「offline =y」を指定すると、ターゲット コンピュータとサーバ間の接続がジョブの実行のために一時的に解放され、ジョブの完了後に再び確立されます。
「offline =n」を指定すると、接続は解放されません。

パラメータ

保留中のインストールがキャンセルされる プロシージャに関するユーザ パラメータです。
複数のユーザ パラメータを使用するには、スペース区切りにして二重引用符で囲む必要があります。
空の文字列をコーディングすると、パラメータがないものと解釈されます。

このパラメータが指定されていない場合は、デフォルトのユーザ パラメータが、プロシージャ定義によって与えられます。

postaction

指定された手順の完了後に実行する必要があるアクションを指定します。 有効な値は以下のとおりです。

none

ポストアクションを実行しません。

reboot

プロシージャの完了の後にシステムを再起動します。

logoff

プロシージャの完了後にユーザをログオフします。

rebootAtEnd

このコンテナのすべてのジョブの完了後にシステムを再起動します。

logoffAtEnd

このコンテナのすべてのジョブの完了後にユーザをログオフします。

shutdownAtEnd

ジョブの完了後にターゲット コンピュータをシャットダウンします。

preaction

指定された手順を開始する前に実行する必要があるアクションを指定します。 有効な値は以下のとおりです。

none

プレアクションを実行しません。

reboot

プロシージャの開始前にシステムを再起動します。

logoff

プロシージャの開始前にユーザをログオフします。

preventLogon

「preventLogon」または「preventLogon=y」をコーディングすると、ジョブの実行中はユーザのログオンが拒否されます。 すでにユーザがログオンしている場合、そのユーザがログオフするまでジョブの実行は延期されます。
「preventLogon =n」を指定すると、ユーザのログオンは拒否されません。

パラメータがコーディングされていない場合は、関連するプロシージャのジョブ オプション値によってデフォルトが指定されます。

procedure

保留中のインストールがキャンセルされる プロシージャの名前 (タイプ: アクティブ)を指定します。

prompt=d.h

保留中のインストールがキャンセルされる ユーザにジョブ開始の確認を求める期間です。

期間の形式は「d.h」です。d は日、h は時間です。

このパラメータの範囲は、3 時間から 7 日間までです(0.3 - 7.0)。 指定した値が有効な最小値を下回る場合には、最小値に置き換えられます。 指定した値が有効な最大値を上回る場合には、最大値に置き換えられます。 警告は表示されません。

promptUser

「promptUser」または「promptUser=y」をコーディングすると、ユーザにジョブ実行の確認が求められます。

「promptUser=n」をコーディングすると、そのような確認が求められません。

パラメータがコーディングされていない場合は、関連するプロシージャのジョブ オプション値によってデフォルトが指定されます。

repeat

記述されている場合は、評価の発生ごとにジョブが繰り返されます。

resolveQuery

ジョブを生成する前に関連のあるクエリ グループを評価します。

runAtShutdown

「runAtShutdown」または「runAtShutdown=y」をコーディングすると、ジョブの実行がシャットダウン時にのみ開始されます。
「runAtShutdown=n」をコーディングすると、ジョブがシャットダウン時以外にもいつでも開始されます。
パラメータがコーディングされていない場合は、関連するプロシージャのジョブ オプション値によってデフォルトが指定されます。
このパラメータは、Unix がターゲットの場合にのみ有効です。

swTemplate

保留中のインストールがキャンセルされる ソフトウェア テンプレートの名前です。 を指定します。

コーディングされていない場合、注文はデフォルト名「<group name> [$date $time]」のソフトウェア テンプレートに割り当てられます。

timeout

保留中のインストールがキャンセルされる timeout には、ジョブの失効期間が「h」の形式で指定されます。ここで、h は時間数です。 パラメータの範囲は、マネージャ側で設定できます。 指定した値が設定されている上限を超える場合には、値はその上限に設定されます。指定した値が下限に満たない場合は、その下限に設定されます。 どの場合でも警告は出されません。
timeout は jobTimeout パラメータと一緒に指定しないでください。両方指定するとエラーが報告されます。 いずれのパラメータも指定されていない場合は、168 がデフォルトで設定されます。

version

保留中のインストールがキャンセルされる 項目のバージョン を指定します。

userJobMessage

テンプレート グループ内の起動ジョブ用のカスタム管理者メッセージを指定します。

「allowCancel」、「execTimedOut」、「prompt」の各パラメータは、「promptUser」オプションがすでに設定されているか、またはこのコマンドの「promptUser」パラメータで設定される場合に有効になります。
ジョブの「promptUser」オプションもコマンドの「promptUser」パラメータも設定されていない場合は、いずれのパラメータも無視されます。
警告は表示されません。