Viewer パラメータ
概要
Windows CMD または PowerShell でコマンドラインパラメータを使用して Viewer を実行することによって、リモートセッションを開始できます。以下の構文を使用してください(オプションのパラメータは [...] で示されています):
rutview.exe -name:connection_name -connection_mode [-username:username] [-password:password] [other_parameters]
ここで:
-name:connection_name
—アドレス帳で使用される接続名です。スペースを含む場合は、引用符で囲んでください ("")。-connection_mode
—選択した接続モードです。「接続モードパラメータ」セクションを下に参照してください。-username:username
—Remote Utilities セキュリティ認証方法のためのユーザー名です。このパラメータはオプションです。-password:password
—シングルパスワードセキュリティまたは Remote Utilities セキュリティ認証方法のためのパスワードです。このパラメータはオプションです。
例えば:
rutview.exe -name:"My remote PC" -fullcontrol -username:admin -password:123456789
Viewer アドレス帳 で "My remote PC" というタイトルの接続を見つけ、フルコントロール 接続モードでリモートセッションを開始します。Remote Utilities セキュリティ 認証方法が、ユーザー名 "admin" とパスワード "123456789" を使用して実行されます。この方法が有効になっている場合に限ります(下記の "Authentication" を参照してください)。
認証
コマンドライン経由でリモートセッションを開始する際には、二つの認証方法がサポートされています—シングルパスワードセキュリティ と Remote Utilities セキュリティ。どちらが使用されるかは、接続のプロパティ→認証 で選択されたオプションに依存します。対象となる接続は アドレス帳 にあります:
自動が選択されている場合、プログラムは以下の優先順序で認証方法を試みます:
- Remote Utilities セキュリティ
- シングルパスワードセキュリティ
これらの方法は、ドロップダウンリストで明示的に選択することもできます。この場合、選択した方法が使用されます。いずれの場合でも、認証方法を使用するためにはリモートコンピュータのHostの設定→認証 でも有効にされている必要があります。
Windows セキュリティ および カスタムサーバーセキュリティ の資格情報は、コマンドライン経由で送信することはできません。したがって、これらの認証方法が選択された場合は無視されます。
-username および -password パラメータ
-username
と -password
パラメータはオプションです。これらを省略すると、二つの可能な結果があります:
- パスワード(シングルパスワードセキュリティ)またはユーザー名/パスワード(Remote Utilities セキュリティ)が接続のプロパティのセキュリティタブに保存されている場合。この場合、プログラムはそれらを認証に使用します。
- パスワードまたはユーザー名/パスワードが接続のプロパティに保存されていない場合。この場合、プログラムはリモートセッションを開始するためのアクセス認証情報を入力するようユーザーに促します。
接続モードパラメータ
-fullcontrol
—フルコントロールモードを実行します。-viewonly
—表示のみモードを実行します。-ftp
—ファイル転送モードを実行します。-shutdown
—電源コントロールモードを実行します。このパラメータは、次の具体的なパラメータとともに使用できます:
-restart
-poweroff
-switchoff
-lock
-telnet
—ターミナルモードを実行します。このパラメータは以下のオプションとも一緒に使用できます:
-powershell
—PowerShellシェルを起動します。-cmd
—CMDシェルを起動します。-system
—システムとして実行します。-user
—現在のユーザーとして実行します。
-taskmanager
—タスクマネージャーモードを実行します。-registry
—リモートレジストリモードを実行します。-remoteexecute
—実行モードを実行します。このパラメータは次の具体的なパラメータとともに使用できます:
-filename:program_name
-hidden
-devicemanager
—インベントリマネージャーモードを実行します。-rdp
—RDP接続モードを実行します。-chat
—チャットモードを実行します。-avchat
—音声&ビデオチャットモードを実行します。-send_message
—メッセージの送信モードを実行します。-screenrecord
—画面レコーダーモードを実行します。
新しい接続の追加
コマンドラインパラメータを使用して、新しい接続をアドレス帳に追加することができます。以下の構文を使用してください(オプションのパラメータは [...] で示されています):
rutview.exe -create [-name:connection_name] [-host:IP_address_or_Internet-ID] [-port:port] [-group:group_name]
-create
—指定された名前、IPアドレス/インターネットID、ポートで新しい接続を作成し、必要に応じてグループに割り当てます。-name:connection_name
—この名前の接続が見つからなかった場合、新しく作成されます。名前にスペースが含まれている場合、引用符("")で囲みます。-host:IP_address_or_Internet-ID_code
—リモートコンピュータのIPアドレスまたはインターネットIDコード。-port:port_value
—Hostのリスニングポート(デフォルトは5650)。-group:group_name
—新たに作成された接続が追加されるフォルダを指定します。
例えば:
rutview.exe -create -name:"My remote PC 2" -host:192.168.0.100 -port:37300 -group:"Test"
これにより、Viewer アドレス帳 に "My remote PC 2" というタイトルの新しい接続が作成され、IPアドレス 192.168.0.100、ポート37300が与えられ、"Test" グループに配置されます。
その他の例
Host PC の名前 "Remote PC 1" で Windows 計算機をリモートで開始します:
rutview.exe -name:"Remote PC 1" -password:123456789 -remoteexecute -filename:calc.exe
名前 "Remote PC 1" を持つリモートホストを再起動します:
rutview.exe -name:"Remote PC 1" -password:123456789 -shutdown -restart
名前 "Test connection" の Host PC で PowerShell を使用してターミナルモードでリモートセッションを開始します:
rutview.exe -telnet -powershell -name:"Test connection" -password:"6784930"