push-winRemote -- 複数のリモート Windows システム上でのコピーと実行

AutoShell › AutoShell コアリファレンス › AutoShell の一般コマンド › push-winRemote コマンド -- 複数のリモート Windows システム上でのコピーと実行（Funclet）

push-winRemote コマンド -- 複数のリモート Windows システム上でのコピーと実行（Funclet）

このコマンドは、1 つ以上のリモート Windows システム上でコピーおよび実行を行います。利用可能なバージョンは以下のとおりです。

単一ターゲットバージョン（1）
複数ターゲットバージョン（2）

コマンドの構文は、以下のとおりです。

（1） push-winRemote -host hostname -localPath path [-cmd cmd] [-user username] [-pass password]
（2） push-winRemote -localPath path [-cmd cmd] [-user username] [-pass password] on remoteTargets

単一ターゲットバージョンは、実行したコマンドの結果コードを返します。

複数ターゲットバージョンは、WinRemote オブジェクトの配列を返します。この配列の要素はそれぞれ、remoteTargets リストの対応する位置にあるリモート Windows ノードに対応します。 WinRemote オブジェクトでは、実行が完了したかどうかやエラーが発生したかどうかを確認し、実行が完了している場合は出力と返された結果を問い合わせることができます。 WinRemote オブジェクトを使用してリモートノードを指定している場合、配列には元の RemoteTarget オブジェクトへの参照が格納されます。ターゲットシステムを文字列で指定すると、RemoteTarget オブジェクトが内部に新規作成され、配列に割り当てられます。

-host hostname

リモート Windows ホストの名前を指定します。引用符で囲まれていない引数トークンは自動的に文字列に変換されます。式を丸かっこで囲み、式が自動的に引用されないようにしてください。

-localPath path

コピーする AutoShell クライアントを示すパスを指定します。引用符で囲まれていない引数トークンは自動的に文字列に変換されます。式を丸かっこで囲み、式が自動的に引用されないようにしてください。このパラメータは、公開鍵認証を使用して、オンザフライで SSH セッションを作成する場合にのみ必要です。

デフォルト： ""

-cmd cmd

（オプション）リモート Windows システムで実行するコマンドを指定します。引用符で囲まれていない引数トークンは自動的に文字列に変換されます。式を丸かっこで囲み、式が自動的に引用されないようにしてください。このパラメータは、公開鍵認証を使用して、オンザフライで SSH セッションを作成する場合にのみ必要です。

デフォルト： ""

-user username

（オプション）リモート Windows システムにログオンするためのユーザ名を指定します。このユーザには、$ADMIN 共有に接続する権限が必要です。ユーザ名を指定しない場合、AutoShell へのログイン時に入力されたユーザ名が使用されます。引用符で囲まれていない引数トークンは自動的に文字列に変換されます。式を丸かっこで囲み、式が自動的に引用されないようにしてください。

デフォルト： $$User

-pass password

（オプション）リモートノードへのログインに使用するパスワードを指定します。パスワードを指定しない場合、AutoShell へのログイン時に入力されたパスワードが使用されます。このコマンドを発行した後に非表示でパスワードを入力するには、引数としてオプションのプロンプトと PW_GET() を指定します。引用符で囲まれていない引数トークンは自動的に文字列に変換されます。式を丸かっこで囲み、式が自動的に引用されないようにしてください。

デフォルト： $$Pass

on remoteTargets

指定したスクリプトを実行するリモートシステムのカンマ区切りリストを指定します。ターゲットノードは、ホスト名/アドレスと WinRemote オブジェクトの 2 つの方法で指定できます。 WinRemote オブジェクトとホスト名またはアドレスを併用してターゲットシステムを指定すると、異なるホストで異なる認証情報を使用するなど、実行プロセスをより柔軟に制御できます。 WinRemote オブジェクトとホスト名/アドレスの文字列は、リモートターゲットリストで一緒に使用できます。ターゲットリストの要素は自動的には文字列化されません。そのため、ホスト名にリテラル文字列を使用する場合は引用符で囲む必要があります。

例

host1 に myinstall.exe をインストールする方法

push-winRemote -host host1 -localpath c:¥installations¥myinstall.exe -cmd myinstall.exe

host1 と host 2 に myinstall.exe をインストールし、host1 の結果を確認する方法

push-winRemote -cmd myinstall.exe -localpath c:¥installations¥myinstall.exe on "host1", "host2";
? x[0].hasCompleted();
? x[0].result();
? x[0].output();