前のトピック: ジョブ管理コマンド次のトピック: プロシージャのファイル形式


addJob — ジョブ コンテナへのジョブの追加

このアクションでは、既存のジョブ コンテナにジョブを追加します。 ジョブ コンテナを封印してはなりません。

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

jobcontainer action=addjob
name=job_container_name
{item=item_name version=item_version  
procedure=procedure_name
{[task=install] 
|task={configure|activate|uninstall}
[installedWith=install_procedure]}
| group=group_name [procedures=file]}
{{{compgrp=computer_group_name | ccompgrp=(computer_group_name sep groupScope)} 
[sep=separator_sign]
|{computer=computer_name}}
[deliverytime="YYYY-MM-DD hh:mm" ] 
[attime="YYYY-MM-DD hh:mm" ]
[{preaction={none|reboot|logoff}|bootbefore}]
[{postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}|bootafter}]
[promptUser[={y|n}]] 
[allowCancel[={y|n}]] 
[execTimedOut[={y|n}]]
[offline[={y|n}]] 
[runAtShutdown[={y|n}]]
[preventLogon[={y|n}]] 
after={exacttime|boottime}
[calendarname=delivery_calendar]
[globalTime=y|n] 
[nocalendar[={y|n}]]
[resolveQuery[={y|n}]] 
[stagingServer[={y|n}]]
[parameters=user_parameters]
[prompt=days.hours]] 
[jobTimeOut=days.hours]
[reinstall[={y|n}]]
[userJobMessage]
after

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

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

exacttime

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

boottime

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

allowCancel

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

「allowCancel =n」を指定した場合には、キャンセルが許可されません。

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

atTime

アクションが起動される日付と時間を指定します。

日付は、ISO の形式「YYYY-MM-DD hh:mm」になります。

パラメータがコーディングされていない場合は、実際の日時が使用されます。

calendarname

評価を実施できる時間を制御するカレンダの名前を指定します。

ccompgrp

グループ名およびスコープのペアとして指定されるコンピュータ グループを指定します。 デフォルトでは、名前とスコープはドット(「.」)で区切られていますが、「sep」オプションを使用して代替の区切りを指定 することができます。 名前の一部として区切りを使用しないでください。

グループ スコープのみの場合、有効な値は以下のとおりです。

ローカル

グループはローカル ドメイン マネージャで作成されます。

global

グループはエンタープライズ マネージャで作成され、複製される可能性があります。

「ccompgrp」は、1 回の呼び出しで 「compgrp」とともにコーティングできます。

compgrp

指定した製品を処理するコンピュータ グループの名前を指定します。

このパラメータは 1 台以上のコンピュータ グループを指定する場合、1 回以上記述することができます。

このパラメータは、computer パラメータと一緒にコーディングしないでください。

computer

指定した製品を処理するコンピュータの名前を指定します。

このパラメータは 1 台以上のコンピュータを指定する場合、1 回以上記述することができます。

このパラメータは、compgrp パラメータと一緒にコーディングしないでください。

deliveryTime

保留中のインストールがキャンセルされる ドメイン マネージャからの配信の開始時間です。
日付は、ISO の形式「YYYY-MM-DD hh:mm」になります。

パラメータがコーディングされていない場合は、実際の日時が使用されます。

execTimedOut

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

「execTimedOut=n」を指定した場合は、ジョブ実行は自動的には開始されません。

globalTime

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

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

group

ジョブを生成するソフトウェアまたはプロシージャ グループの名前を指定します。

このパラメータは、item パラメータと一緒にコーディングしないでください。

installedWith

インストール プロシージャの名前を指定します。

設定、起動、アンインストールの各タスクでは、このパラメータが必須です。 それ以外では無視されます。

item

処理する項目の名前を指定します。

このパラメータは、group パラメータと一緒にコーディングしないでください。

jobTimeOut

期間で表したジョブの失効日を指定します。

期間は「d.h」という形式で指定します。d は日、h は時間です。

このパラメータの範囲は、3 時間から 7 日間までです(0.3 - 7.0)。

指定した値が有効な最小値を下回る場合には、最小値に置き換えられます。

指定した値が有効な最大値を上回る場合には、最大値に置き換えられます。

警告は表示されません。

name

ジョブが追加されるジョブ コンテナの名前を指定します。

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 は時間です。

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

promptUser

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

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

reinstall

オプション。 デフォルト:「reinstall=n」

「reinstall」または「reinstall=y」がコーディングされていると、ドメイン マネージャによってジョブが評価される前にオーダーに関連付けられている可能なインストール レコードは削除されます。

「reinstall=n」がコーディングされている場合、レコードはそのまま残ります。

注: オプションはジョブのインストールにのみ適用されます。 それ以外の場合は無視されます。

resolveQuery

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

runAtShutdown

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

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

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

このパラメータは、Unix がターゲットの場合にのみ有効です。

sep

「ccompgroup」 オプションで使用される代替の区切りを指定します。 区切りは ccompgroup オプションで指定したグループ名の一部には使用しないでください。

stagingServer

関連する製品もターゲット コンピュータのスケーラビリティ サーバのステージング ライブラリに配信します。

このパラメータは、タスク タイプ「インストール」のプロシージャにのみ適用されます。

task

項目プロシージャによって実行されるタスクのタイプを指定します。

有効なタイプは以下のとおりです。

activate

プロシージャで項目を起動します。

configure

プロシージャで項目を設定します。

install

プロシージャで項目をインストールします。

uninstall

プロシージャで項目をアンインストールします。

このパラメータをコーディングしないと、install を指定したものとみなされます。

version

処理する項目のバージョンを指定します。

userJobMessage

ジョブ コンテナ内のジョブ用のカスタム管理者メッセージを指定します。

注: 以下を考慮する必要があります。