前のトピック: 一般的なソフトウェア グループ管理次のトピック: プロシージャのファイル形式


assignGroupToTarget — グループのターゲットへの割り当て

このアクションを使用すると、ソフトウェア グループまたはプロシージャ グループを(ソフトウェア テンプレートを含む)ターゲット コンピュータまたはコンピュータ グループに割り当てることができます。 ソフトウェア グループにサブグループが含まれる場合、それらのサブグループも再帰的に割り当てに参加します。

ほかの情報に加えて、使用されているジョブ コンテナまたは配信の名前が標準出力に出力されます。

このアクションの指定は以下の形式になります。

swLibrary action=assignGroupToTarget name=group_name 
{{computer=computer_name} |
{compgrp=computer_group_name | ccompgrp=(computer_group_name sep groupScope)}
[sep=separator_sign] 
| {swTemplates=software_template_name}}
cname=[name]
[dname=distribution_name] 
[unsealed]
[{nolinkage|transaction[rollback]|synchronized}[nocascade]]
[deliveryTime="YYYY-MM-DD hh:mm"] 
[atTime="YYYY-MM-DD hh:mm"]
after={exacttime|boottime} 
[calendarname=delivery_calendar]
[preaction={none|reboot|logoff}]
[postaction={none|reboot|logoff|rebootAtEnd|logoffAtEnd|shutdownAtEnd}]
[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]
[repeat={y|n}] 
[stagingserver]
[jobTimeout=d.h] 
[procedures=procedures_file]
[{{area=area_name} | {domain=domain_name} | toAllAreas}]
[sendTime="YYYY-MM-DD hh:mm"] 
[haltTime="YYYY-MM-DD hh:mm"]
[jcPriority={1,...,10}]
[distPriority={1,...,10}]	
[reinstall[={y|n}]]
after

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

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

exacttime

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

boottime

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

allowCancel

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

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

promptUser がこの呼び出しによって設定されていないか、すでに有効になっていない場合、このパラメータは無視されます。 警告は表示されません。

area

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

パラメータを何度もコーディングすることができます。 Client Automation ドメインのリストを指定するために、

このパラメータが記述されている場合、配信は封印され、コマンドが正常に実行された後で、自動的に宛先へ送信されます。

area、domain、または toAllAreas パラメータのいずれも記述されていない場合、配信は封印解除されたままで、操作が可能です。

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

(エンタープライズ マネージャのみ)

atTime

保留中のインストールがキャンセルされる アクションが起動される日付と時間を指定します。

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

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

calendarname

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

ccompgrp

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

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

ローカル

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

global

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

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

cname

保留中のインストールがキャンセルされる ジョブ コンテナの一意の名前(オプション).

cname パラメータが指定されていない場合、名前が内部で生成され、コマンド ライン インターフェースで識別子が返されます。

生成されたジョブがこれに割り当てられます。

このジョブ コンテナが存在しない場合は、作成されます。

存在する場合は、コンテナが封印解除されると、生成されたジョブが追加されます。

封印解除された場合は、cadsmcmd がエラーとなって終了します。

compgrp

アドレス指定するコンピュータ グループを指定します。

パラメータを何度もコーディングすることができます。 複数のコンピュータ グループをまとめて指定するために、

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

computer

アドレス指定するコンピュータの名前を指定します。

パラメータを何度もコーディングすることができます。 複数のコンピュータをまとめて指定するために、

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

(ドメイン マネージャのみ)

deliveryTime

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

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

distPriority

保留中のインストールがキャンセルされる 配信に割り当てられる優先度.

優先度は数値で指定し、その値は 1 以上 10 以下である必要があります。

指定されていない場合は、優先度 5 と見なされます。

dname

保留中のインストールがキャンセルされる name of the distribution を指定します。

配信がすでに存在する場合は、この配信が使用されます。ただし、操作できるように開いている場合に使用され、開いていない場合は、エラー メッセージが起動されます。 配信が存在しない場合は、作成されます。

パラメータが記述されていない場合は、デフォルトの名前の配信が生成されます。

(エンタープライズ マネージャのみ)

domain

保留中のインストールがキャンセルされる Client Automation ドメイン グループの名前 を指定します。

パラメータを何度もコーディングすることができます。 Client Automation ドメイン グループをいくつかまとめて指定するために、

このパラメータが記述されている場合、配信は封印され、コマンドが正常に実行された後で、自動的に宛先へ送信されます。

area、domain、または toAllAreas パラメータのいずれも記述されていない場合、配信は封印解除されたままで、操作が可能です。

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

(エンタープライズ マネージャのみ)

execTimedOut

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

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

promptUser がこの呼び出しによって設定されていないか、すでに有効になっていない場合、このパラメータは無視されます。 警告は表示されません。

globalTime

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

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

haltTime

保留中のインストールがキャンセルされる 配信注文が停止する必要のある日時です。 日付は ISO フォーマット「YYYY-MM-DD hh:mm」で指定する必要があります。

停止された配信の再開の詳細については、resume コマンドを参照してください。

jcPriority

保留中のインストールがキャンセルされる ジョブ コンテナの優先度.

優先度は数値で指定し、その値は 1 以上 10 以下である必要があります。

パラメータを指定しない場合には、優先度は変更されません。

jobTimeout

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

name

保留中のインストールがキャンセルされる グループの名前. ソフトウェア グループの場合、グループのメンバがターゲット サイトにインストールされます。

ターゲットで実行するメンバのプロシージャを procedures オプションで指定して設定できます。 オプションがコーディングされていない場合は、メンバのデフォルト インストール プロシージャが使用されます。

プロシージャ グループの場合、含まれるプロシージャがターゲット サイトで実行されます。

noCalendar

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

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

noCascade

ジョブ リンク オプションが「カスケーディングを無視」に設定されます。

このパラメータは、「transaction」または「synchronized」をコーディングした場合にのみ認められます。

noLinkage

コンテナ内のほかのジョブに影響されることなくジョブを実行します。

offline

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

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

パラメータ

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

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

postaction

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

none

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

reboot

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

logoff

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

rebootAtEnd

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

logoffAtEnd

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

shutdownAtEnd

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

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

preaction

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

none

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

reboot

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

logoff

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

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

preventLogon

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

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

手順

保留中のインストールがキャンセルされる ソフトウェア グループを対象とするプロシージャを定義するファイルの名前かプロシージャ(ソフトウェアおよびプロシージャ グループ)に関する個々のジョブ オプションを定義するファイルの名前、またはその両方の名前.

このプロシージャ ファイルの内容は、プロシージャ ファイル形式で表示されます。

prompt=d.h

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

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

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

promptUser

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

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

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

reinstall

「reinstall」オプションは任意です。デフォルトは「reinstall=n」です。

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

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

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

resolveQuery

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

rollback

ジョブ リンク オプションを「トランザクションの有効化」に設定します。

runAtShutdown

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

sendtime

保留中のインストールがキャンセルされる 関連付けられた配信をアドレス指定されたドメイン マネージャに送信する時間です。 日付は ISO フォーマット「YYYY-MM-DD hh:mm」で指定する必要があります。 このパラメータが指定されていない場合、現在の日時が使用されます。

(エンタープライズ マネージャのみ)

sep

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

stagingServer

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

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

swTemplates

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

このパラメータは 1 つ以上のソフトウェア テンプレートを指定する場合、1 回以上コーディングすることができます。
これがコーディングされていると、cname パラメータは無効となり、生成されるジョブはソフトウェア テンプレート以外どのジョブ コンテナにも割り当てられません。 そのためには、リストのソフトウェア テンプレートを封印しないようにする必要があります。

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

synchronized

ジョブ リンク オプションが「同期化されたジョブの実行」に設定されます。

toAllAreas

コーディングすると、関連する配信がエンタープライズ マネージャに登録されたすべての Client Automation ドメインに送信されます。

「toAllAreas」は、「area」または「domain」パラメータと一緒にコーディングしないでください。

area、domain、または toAllAreas パラメータのいずれも記述されていない場合、配信は封印解除されたままで、操作が可能です。

(エンタープライズ マネージャのみ)

transaction

ジョブ リンク オプションが「バッチ ジョブの実行」に設定されます。

これはデフォルトです。

unsealed

対象のジョブが正常に作成された後も、アドレス指定されたジョブ コンテナが封印解除されたままになります。

(ドメイン マネージャのみ)

注:

area、domain、または toAllAreas のいずれも記述されていない場合、配信コンテナは封印が解除されたままであるため、さらに操作することもできます。

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