前のトピック: showAttrItem—ソフトウェア テンプレート内の項目の属性表示次のトピック: 例


uninstallItem—テンプレート グループからの項目の削除

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

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

templategroup action=uninstallItem name=template_group_name
[swTemplate=software_template_name]
item=item_name
version=item_version 
procedure=procedure_name
[installedWith=install_procedure] 
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] 
[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

アンインストールする項目の名前を指定します。

jobTimeout

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

name

アンインストール オーダの追加先の テンプレート グループ名 を指定します。

noCalendar

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

「noCalendar=n」を指定すると、カレンダが無視されなくなります(デフォルト)。

offline

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

parameter

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

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

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」をコーディングすると、そのような確認が求められません。

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

resolveQuery

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

runAtShutdown

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

swTemplate

アンインストール オーダの追加先の ソフトウェア テンプレートの名前です。 を指定します。

指定がない場合は、デフォルト名「<グループ名> [$date $time]」が使用されます。

timeout

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

version

アンインストールする 項目のバージョン を指定します。

userJobMessage

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

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