macro/command/connect.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
  "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
  <title>connect</title>
  <meta http-equiv="Content-Style-Type" content="text/css">
  <link rel="stylesheet" href="../../style.css" type="text/css">
</head>

<body>


<h1>connect</h1>

<p>
接続する。
</p>

<pre class=".code">
connect &lt;command line parameters&gt;
</pre>

<h2>解説</h2>

<p>
MACRO が Tera Term とリンクされていない場合、Tera Term を起動してMACRO とリンクする。&lt;command line parameters&gt;  は、Tera Term を起動する時のコマンドラインパラメータ。
</p>

<p>
MACRO が Tera Term とすでにリンクされていて、Tera Term がホストに接続されていない場合、Tera Term をコマンドライン &lt;command line parameters&gt; で指定されるホストに接続させる。Tera Term のコマンドラインパラメータについては、"<a href="../../commandline/teraterm.html">Tera Term Pro コマンドライン</a>"を参照。
</p>

<p>
MACRO が Tera Term とすでにリンクされていて、Tera Term がホストにすでに接続されている場合、このコマンドは無視される。
</p>

<p>
このコマンドの結果、リンクと接続の状態に応じて以下のうちの一つの値がシステム変数 result に格納される。
</p>

<table>
 <tr>
  <th>値</th>
  <th>状態</th>
 </tr>
 <tr>
  <td>0</td>
  <td>Tera Term とリンクされていない。</td>
 </tr>
 <tr>
  <td>1</td>
  <td>ホストへの接続はされていないが、Tera Term へのリンクはされている。</td>
 </tr>
 <tr>
  <td>2</td>
  <td>リンクおよび接続両方ともされている。</td>
 </tr>
</table>

<p>
"connect" コマンドを実行する前にリンクと接続の状態を調べるには、"<a href="testlink.html">testlink</a>" コマンドを使うことができる。
</p>

<p>
Tera Term と MACRO のリンクしていない状態では、"connect" と "<a href="cygconnect.html">cygconnect</a>", "<a href="testlink.html">testlink</a>" 以外の通信コマンドは実行できない。
</p>

<h2>接続方法</h2>

<p>
Tera Termマクロから接続する方法には、4 つの種類があります。
</p>

<ul>
 <li>telnet接続 (port 23)</li>
 <li>SSH1 および SSH2 接続 (port 22)</li>
 <li>General connection</li>
 <li>COM port 接続</li>
</ul>

<h3>telnet接続</h2>

<pre class=".code">
<code>connect '<em>myserver</em>:23 /nossh'
connect '<em>myserver</em>:23 /telnet'
connect '<em>myserver</em>:23'
</code></pre>

<p>
/nossh を使う方を強く推奨します。このオプションがない場合、Tera Termは teraterm.ini が最後に保存されたときと同じメソッド（telnet もしくは SSH）を使って、接続しようとします。もし、SSHを使って接続しようとするならば、connectマクロは失敗するでしょう。
</p>

<h3>SSH接続</h3>

<pre class=".code">
<code>connect '<em>myserver</em> /ssh'
</code></pre>

<p>
この方法は、SSHバージョンを指定せずにSSH接続をします。
</p>

<pre class=".code">
<code>connect '<em>myserver</em> /ssh /1'
connect '<em>myserver</em> /ssh /2'
</code></pre>

<p>
/1 と /2 のオプションは、SSH1およびSSH2であることを指定します。
</p>

<pre class=".code">
<code>connect '<em>myserver</em> /ssh /auth=password /user=<em>username</em> /passwd=<em>password</em>'
connect '<em>myserver</em> /ssh /1 /auth=password /user=<em>username</em> /passwd=<em>password</em>'
connect '<em>myserver</em> /ssh /2 /auth=password /user=<em>username</em> /passwd=<em>password</em>'
connect '<em>myserver</em> /ssh /auth=publickey /user=<em>username</em> /passwd=<em>password</em> /keyfile=<em>private-key-file</em>'
connect '<em>myserver</em> /ssh /1 /auth=publickey /user=<em>username</em> /passwd=<em>password</em> /keyfile=<em>private-key-file</em>'
connect '<em>myserver</em> /ssh /2 /auth=publickey /user=<em>username</em> /passwd=<em>password</em> /keyfile=<em>private-key-file</em>'
connect '<em>myserver</em> /ssh /auth=challenge /user=<em>username</em> /passwd=<em>password</em>'
connect '<em>myserver</em> /ssh /1 /auth=challenge /user=<em>username</em> /passwd=<em>password</em>'
connect '<em>myserver</em> /ssh /2 /auth=challenge /user=<em>username</em> /passwd=<em>password</em>'
</code></pre>

<p>
この9つの方法は、マクロからユーザ名とパスワードを渡すことにより、SSH認証ダイアログをスキップさせることができます。/auth=passwordはパスワード認証、/auth=publickeyは公開鍵認証、/auth=challengeはチャレンジレスポンス認証であることを表します。
</p>

<pre class=".code">
<code>connect '<em>myserver</em> /ssh /auth=pageant /user=<em>username</em>'
connect '<em>myserver</em> /ssh /1 /auth=pageant /user=<em>username</em>'
connect '<em>myserver</em> /ssh /2 /auth=pageant /user=<em>username</em>'
</code></pre>

<p>
この3つの方法は、マクロからユーザ名を渡すことにより、SSH認証ダイアログをスキップさせることができます。/auth=pageantはPageantを使用した認証であることを表します。
</p>

<pre class=".code">
<code>connect '<em>myserve</em> /ssh /auth=password /user=<em>username</em> /ask4passwd'
connect '<em>myserver</em> /ssh /1 /auth=password /user=<em>username</em> /ask4passwd'
connect '<em>myserver</em> /ssh /2 /auth=password /user=<em>username</em> /ask4passwd'
connect '<em>myserver</em> /ssh /auth=publickey /user=<em>username</em> /ask4passwd /keyfile=<em>private-key-file</em>'
connect '<em>myserver</em> /ssh /1 /auth=publickey /user=<em>username</em> /ask4passwd /keyfile=<em>private-key-file</em>'
connect '<em>myserver</em> /ssh /2 /auth=publickey /user=<em>username</em> /ask4passwd /keyfile=<em>private-key-file</em>'
connect '<em>myserve</em> /ssh /auth=challenge /user=<em>username</em> /ask4passwd'
connect '<em>myserver</em> /ssh /1 /auth=challenge /user=<em>username</em> /ask4passwd'
connect '<em>myserver</em> /ssh /2 /auth=challenge /user=<em>username</em> /ask4passwd'
</code></pre>

<p>
この9つの方法は、マクロからユーザ名と認証方法を渡して、ポップアップでパスワードの入力を促します。
</p>

<h3>General connection</h3>

<pre class=".code">
<code>connect 'myserver /timeout=&lt;value&gt;'
</code></pre>

<p>
Note: This option value is connecting timeout value(per seconds). Connecting to myserver could be canceled after timeout has occurred with the specified value. Conversely, no action if the value is zero. The default value is zero. Also this value would be saved as `ConnectingTimeout' entry in teraterm.ini file.
</p>

<h3>COMポート接続</h3>

<pre class=".code">
<code>connect '/C=x'
</code></pre>

<p>
xはCOMポート番号を表します。たとえば、COM1に接続したいのなら、 connect '/C=1' とします。
</p>

<p>
出典: <a href="http://logmett.com/forum/viewtopic.php?t=28">http://logmett.com/forum/viewtopic.php?t=28</a>
</p>

<h2>例</h2>

<pre class="macro-example">
; パラメータなしで Tera Term を起動
connect ''

; 接続が成功しなかった場合、5秒でタイムアウトが発生
connect '<em>myserver</em> /timeout=5'

; Tera Term を起動し、telnet セッションを開く
connect '<em>myserver</em>:23 /nossh'

; Tera Term を起動し、SSH セッションを開く
connect '<em>myserver</em> /ssh'

; Tera Term を起動し、SSH1 セッションを開く
connect '<em>myserver</em> /ssh /1'

; Tera Term を起動し、SSH2 セッションを開く
connect '<em>myserver</em> /ssh /2'

; Tera Term を起動する。SSH セッションを開き、ユーザ名とパスワードのプロンプトは表示されない。
connect '<em>myserver</em> /ssh /auth=password /user=<em>username</em> /passwd=<em>password</em>'

; Tera Term を起動する。SSH1 セッションを開き、ユーザ名とパスワードのプロンプトは表示されない。
connect '<em>myserver</em> /ssh /1 /auth=password /user=<em>username</em> /passwd=<em>password</em>'

; Tera Term を起動する。SSH2 セッションを開き、ユーザ名とパスワードのプロンプトは表示されない。
connect '<em>myserver</em> /ssh /2 /auth=password /user=<em>username</em> /passwd=<em>password</em>'

; Tera Term を起動する。SSH セッションを開き、ユーザ名とパスワードと秘密鍵ファイルのプロンプトは表示されない。
connect '<em>myserver</em> /ssh /auth=publickey/user=<em>username</em> /passwd=<em>password</em> /keyfile=<em>private-key-file</em>'

; Tera Term を起動する。SSH1 セッションを開き、ユーザ名とパスワードと秘密鍵ファイルのプロンプトは表示されない。
connect '<em>myserver</em> /ssh /1 /auth=publickey/user=<em>username</em> /passwd=<em>password</em> /keyfile=<em>private-key-file</em>'

; Tera Term を起動する。SSH2 セッションを開き、ユーザ名とパスワードと秘密鍵ファイルのプロンプトは表示されない。
connect '<em>myserver</em> /ssh /2 /auth=publickey /user=<em>username</em> /passwd=<em>password</em> /keyfile=<em>private-key-file</em>'


; Pageantを利用して、公開鍵認証で接続する。ユーザ名とパスワードと秘密鍵ファイルのプロンプトは表示されない。
connect '<em>myserver</em> /ssh /auth=pageant /user=<em>username</em>'


; Tera Term を起動し、シリアルポート接続を開く。ポート番号は 1 から 256 の範囲内
connect '/C=x'

CommandLine = '111.111.11.11'
connect CommandLine
</pre>


<pre class="macro-example">
; Sample macro for Tera Term
;  Telnet login

; open Tera Term
;   command line = 'TERATERM myhost.mydomain' (telnet)
connect 'myhost.mydomain'

; set username
UsernamePrompt = 'Username:'
Username = 'MYNAME'
PasswordPrompt = 'Password:'
; get password from file
getpassword 'password.dat' 'mypassword' Password

; login
wait   UsernamePrompt
sendln Username

wait   PasswordPrompt
sendln Password

; OK, auto login complete.
</pre>


<pre class="macro-example">
; sample macro of Tera Term
; 
; File: ssh2login.ttl
; Description: auto login with SSH2 protocol
; Environment: generic

username = 'nike'
hostname = '192.168.1.3'

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

msg = 'Enter password for user '
strconcat msg username
passwordbox msg 'Get password'

msg = hostname
strconcat msg ':22 /ssh /auth=password /user='
strconcat msg username
strconcat msg ' /passwd='
strconcat msg inputstr

connect msg
</pre>


<h2>注意</h2>

<ol>
 <li>このページの例において斜体で表示されている値を、実際の値に置き換える必要があります。</li>
 <li>パスワードにはスペースを含むことが可能です。パスワードの中でスペースを表すには、 "@" で置き換えてください。もし "@" がパスワードの一部である場合は、連続した "@" つまり "@@" で置き換えてください。</li>
 <li>Tera Termマクロにユーザ名とパスワードを指定した場合、そのマクロファイルをプレーンテキストとして保存したのなら、セキュリティ的に安全な場所に置く必要があることを肝に銘じておいてください。</li>
 <li>ホストとの接続を終了してすぐにconnectコマンドで新しい接続を開始しようとした場合、タイミングによっては接続できない場合があります。詳しくは"<a href="../appendixes/disconnecttiming.html">切断後すぐに接続する場合の注意点</a>"を参照してください。</li>
</ol>

<h2>参照</h2>

<ul>
 <li>"<a href="closett.html">closett</a>"</li>
 <li>"<a href="cygconnect.html">cygconnect</a>"</li>
 <li>"<a href="disconnect.html">disconnect</a>"</li>
 <li>"<a href="testlink.html">testlink</a>"</li>
 <li>"<a href="unlink.html">unlink</a>"</li>
 <li><a href="../appendixes/disconnecttiming.html">切断後すぐに接続する場合の注意点</a></li>
</ul>

</body>
</html>