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();