前のトピック: listItem—ソフトウェア ポリシーに対して割り当てられたジョブに関する情報の表示次のトピック: showAttrItem—ソフトウェア ポリシーに対して割り当てられたジョブに関する情報の表示


modifyItem—封印解除されたローカル ソフトウェア ポリシーのジョブの変更

このコマンドでは、封印解除されたローカル ソフトウェア ポリシーのジョブを変更します。 オプションで、このコマンドでポリシーを封印できます。

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

swPolicy	action=modifyItem
name=software_policy_name
jobname=name_of_job
[newjobname=new_job_name]
[after={exacttime | boottime}]
[reinstall[={y|n}]]
[preaction={none | reboot | logoff}]
[postaction={none | reboot | logoff | rebootAtEnd | logoffAtEnd | shutdownAtEnd}]
[promptUser[={y|n}]]
[allowCancel[={y|n}]]
[execTimedOut[={y|n}]]
[offline[={y|n}]]
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]]
[triggeredByScalSrv[={y|n}]]
[globaltime[={y|n}]]
[calendarname=delivery_calendar_name]
[noCalendar[={y|n}]]
[resolveQuery[={y|n}]]
[stagingServer[={y|n}]]
[parameters=user_parameters]
[prompt=d.h]
[jobTimeout=d.h]
[repeat[={y|n}]]
[seal[={y|n}]]
[userJobMessage]
name

変更するジョブが含まれているソフトウェア ポリシーの名前。

jobname

変更されるジョブの名前。

newjobname

ジョブの新しい名前。 これをコーディングしないと、古い名前のままとなります。

after

このオプションは、ターゲット システムでジョブの実行が開始される時間を指定します。 有効な値は以下のとおりです。

exacttime

オーダーが期限になるとジョブはただちに処理を開始します。

boottime

期限になった後、ジョブの処理は次の(再)ブート時刻まで遅延されます。

これをコーディングしないと、このオプションは変更されません。

reinstall

「reinstall」または「reinstall=y」がコーディングされている場合、ソフトウェア ポリシーの評価のたびにターゲットで項目が再インストールされます。 「reinstall=n」がコーディングされている場合、ターゲットで項目がない場合にのみインストールされます。 このオプションは、インストール プロシージャでのみ有効です。他のタイプのプロシージャでは、このオプションは無視されます。

これをコーディングしないと、このオプションは変更されません。

preaction={none | reboot | logoff}]

ターゲット コンピュータで関連ジョブが処理される前に実行する必要がある、任意のアクションを指定します。 有効なプレアクションは、以下のとおりです。

none

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

reboot

ジョブを実行する前にシステムを再起動します。

logoff

ジョブを実行する前にユーザをログオフします。

これをコーディングしないと、このオプションは変更されません。

postaction={none | reboot | logoff | rebootAtEnd | logoffAtEnd | shutdownAtEnd}]

ターゲット コンピュータで関連ジョブが処理された後に実行する必要がある、任意のアクションを指定します。 有効なポストアクションは以下のとおりです。

none

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

reboot

ジョブの実行後ににシステムを再起動します。

logoff

ジョブを実行した後にユーザをログオフします。

rebootAtEnd

ジョブ処理の終了後に、ジョブの再起動が必要であることを指定します。 ただし、同じくソフトウェア ポリシーの評価によって起動されたすべてのジョブの処理が完了するまで、あるいは後続のジョブで処理の前または後でただちに再起動を必要するまで、再起動を遅延させることができます。

logoffAtEnd

ジョブ処理の終了後に、ジョブの再起動が必要であることを指定します。 ただし、同じくソフトウェア ポリシーの評価によって起動されたすべてのジョブの処理が完了するまで、あるいは後続のジョブで処理の前または後でただちに再起動またはログオフを必要とするまで、ログオフを遅延させることができます。

shutdownAtEnd

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

これをコーディングしないと、このオプションは変更されません。

promptUser

「promptUser」または「promptUser=y」が指定されている場合、ジョブを実行する前にターゲットのユーザにはプロンプトが表示されます。 「promptUser=n」が指定されている場合、ユーザにプロンプトが表示されないでジョブが実行されます。

これをコーディングしないと、このオプションは変更されません。

allowCancel

「allowCancel」または「allowCancel=y」が指定されている場合、ターゲットのユーザは実行のプロンプトが表示されたときに、ジョブの実行を取り消すことができます。 「allowCancel=n」が指定されている場合、ユーザはジョブを取り消すことはできません。

取り消すことができるようにするには、プロンプトの表示を許可しておく必要があります。そうでないと、エラーが表示されます。

これをコーディングしないと、このオプションは変更されません。

execTimedOut

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

タイムアウト時の開始を有効にするには、プロンプトを許可しておく必要があります。そうでないと、エラーが表示されます。

これをコーディングしないと、このオプションは変更されません。

offline

「offline」または「offline =y」をコーディングすると、ターゲット コンピュータと関連付けられたサーバ間の接続がジョブの実行のために解放され、「offline=n」をコーディングすると接続は開放されません。

これをコーディングしないと、このオプションは変更されません。

runAtShutdown

「runAtShutdown」または「runAtShutdown=y」をコーディングすると、ジョブの実行がシャットダウン時にのみ開始されます。「runAtShutdown=n」をコーディングすると、ジョブがシャットダウン時以外にもいつでも開始されます。

これをコーディングしないと、このオプションは変更されません。

これは、UNIXのみに適用されます。

preventLogon

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

「preventLogon =n」を指定すると、ユーザがすでにログインしていようと、実行中にログインしようと、ジョブの処理には関係ありません。

これをコーディングしないと、このオプションは変更されません。

このオプションは Windows ターゲットにのみ適用されます。

triggeredByScalSrv

「triggeredByScalSrv」または「triggeredByScalSrv=y」をコーディングすると、ターゲットに関連付けられたスケーラビリティ サーバはジョブの実行を開始します。 「triggeredByScalSrv=n」をコーディングすると、ターゲットでは再起動または jobCheck 時に実行を開始します。

これをコーディングしないと、このオプションは変更されません。

globaltime

「globalTime」または「globalTime=y」をコーディングすると、ジョブに関連付けられたすべての日付がエンタープライズ マネージャ時間に基づいたものになります。「globaltime=n」をコーディングすると、日付はドメイン マネージャ時間に基づいたものになります。

これをコーディングしないと、このオプションは変更されません。

calendarname

スケーラビリティ サーバおよびターゲットへのジョブの配信を担当するカレンダの名前を指定します。 空の文字列(“”)をコーディングすると、配信カレンダのエントリは空になります。

これをコーディングしないと、このオプションは変更されません。

noCalendar

「noCalendar」または「noCalendar=y」をコーディングすると、ターゲットコンピュータに接続されているカレンダの実行は、ジョブの処理に対して無視されます。 「noCalendar=n」をコーディングすると、カレンダは無視されません。

これをコーディングしないと、このオプションは変更されません。

resolveQuery

「resolveQuery」または「resolveQuery=y」をコーディングし、ソフトウェア テンプレートに関連付けられているグループがクエリ グループの場合、ジョブ作成の前にこのグループは再評価されます。 「resolveQuery=n」をコーディングすると、再評価は実行されません。

これをコーディングしないと、このオプションは変更されません。

stagingserver

「stagingserver」または「stagingserver=y」をコーディングすると、関連する項目はターゲットに関連付けられているスケーラビリティ サーバでステージされます。それ以外の場合はステージされません。 ジョブがインストール ジョブでない場合、このオプションは無視されます。 「stagingserver=n」をコーディングすると、ステージング ステップはスキップされます。

これをコーディングしないと、このオプションは変更されません。

parameter

Specifies the parameters that are passed to the job procedure. 空の文字列(“”)をコーディングすると、渡すパラメータはないと見なされます。

これをコーディングしないと、このオプションは変更されません。

prompt

ユーザがジョブの実行を延期した場合、ユーザにジョブ プロシージャ開始の再確認を求める期間を指定します。 期間のフォーマットは「d.h」の形式で指定されます。ここで、d には日数、h には時間数が指定されます。範囲は 0.3 <= d.h <=7.0 となります。

指定した値が下限に満たない場合は、その下限に設定され、指定した値が上限を超える場合には、値はその上限に設定されます。 その場合、警告は出されません。

これをコーディングしないと、このオプションは変更されません。

jobTimeout

期間で表したプロシージャの失効日を指定します。 期間の形式は「d.h」です。d は日、h は時間です。 パラメータの範囲は、マネージャ側で設定できます。

指定した値が下限に満たない場合は、その下限に設定され、指定した値が上限を超える場合には、値はその上限に設定されます。 その場合、警告は出されません。

これをコーディングしないと、このオプションは変更されません。

repeat

「repeat」または「repeat=y」をコーディングすると、評価が実行されるたびに関連するジョブが繰り返されます。 「repeat=n」をコーディングした場合は、関連するジョブは繰り返されません。

これをコーディングしないと、このオプションは変更されません。

seal

「seal」または「seal=y」をコーディングすると、変更が完了した後でポリシーは封印されます。コーティングされていない場合は、さらに変更を行うため封印解除されたままです。 封印は変更が正しく完了され、エラーが何も報告されなかった場合にのみ実行されます。 警告によって封印できなくなることはありません。

これをコーディングしないと、このオプションは変更されません。

userJobMessage

ソフトウェア ポリシー内のジョブ用のカスタム管理者メッセージを変更します。