push-client -- Autoshell クライアントをリモート Windows システムにインストール

リファレンスガイド › AutoShell › AutoShell コアリファレンス › AutoShell の一般コマンド › push-client コマンド -- Autoshell クライアントをリモート Windows システムにインストール（Funclet）

push-client コマンド -- Autoshell クライアントをリモート Windows システムにインストール（Funclet）

このコマンドは、リモート Windows システムに AutoShell クライアントをインストールします。

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

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

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

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

単一ターゲットのコマンドは、成功すると true を返します。

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

-host hostname

（オプション）リモート Windows ホストの名前を指定します。引用符で囲まれていない引数トークンは自動的に文字列に変換されます。式のコードは丸かっこ内に配置して、式が自動的に引用符で囲まれないようにします。

-localPath path

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

デフォルト： ""

-user username

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

デフォルト： $$User

-pass password

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

デフォルト： $$Pass

on remoteTargets

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

例

host1 に AutoShell クライアントをインストールする方法

push-client -host host1

host1 と host2 に AutoShell クライアントをインストールする方法

x = push-client on "host1", "host2";
? x[1].hasCompleted();
? x[1].result();
? x[1].output();