Windows 版 TeamViewerのフルバージョンでは、事前に設定された ID、パスワード、および接続モード を使用してリモートデバイスへのセッションを開始するコマンドラインパラメータを実行できます。
これらのパラメータを使用して、コマンドプロンプト、スクリプト(例: .bat ファイル)、またはデスクトップやスタートメニューのショートカットから TeamViewerを実行することができます。
この記事は、macOSまたはWindows OSを使用する TeamViewerユーザーに適用されます。
コマンド ライン パラメーターの使用方法
📌注意: リモートアクセスライセンスをお持ちのお客様は、コマンドラインからリモートコントロール接続を確立することはできません。
数値の有無によるパラメーター
📌注意: 一部のパラメーターは、TeamViewer (Classic) バージョン 13.2 でのみ使用可能です。
パラメーターには、数値のあるパラメーターと値のないパラメータの2種類があります。
数値のないパラメーター例：
TeamViewer.exe --noInstallation
数値のあるパラメーター例：
TeamViewer.exe --id 123456789
ほとんどの場合、1つの数値しか表示されません。複数指定すると、最後のものだけが使用されます。
パラメーターの値にスペースが含まれている場合は、数値を引用符（""）で囲む必要があります。
📌注意:
- 長いパラメーターは次のように呼び出されます (2 つの「-」 -> 「--」): TeamViewer.exe --Minimize
- パラメータが短い場合は、「-」を 1 つだけ使用して呼び出すこともできます: TeamViewer.exe -n
- ただし、一部のプラットフォームでは「--n」を使用することもできます。複数のパラメーターを 1 回の呼び出しで組み合わせることができ、パラメーターは大文字と小文字が区別されます。
アプリケーション
以下のオプションがサポートされています。
📌注意: 最初の行にパラメーターと短いバリアントがあり、その下にそれぞれの説明があります。
最小化
TeamViewerを最小化して起動します。「Windowsと同時にTeamViewerを開始する」が有効になっている場合、代わりに TeamViewerがトレイで開始されます。
id - i
指定されたパートナーIDへの接続を開始します。
Password - p
遠隔操作に必要なIDと組み合わせてパスワードを使用します。
Password B64 - B
遠隔操作に必要なIDと組み合わせて、Base64暗号化されたパスワードを使用します。
mode - M
遠隔操作に必要なIDと組み合わせて接続モードを使用します。
省略した場合は、リモートコントロールを使用しますが使用されます。
サポートされている数値：
例: --mode fileTransfer
quality q
遠隔操作に必要なIDと組み合わせて、接続のクオリティ設定をします。
サポートされている数値:
- 自動でクオリティを選択
- 画質を最適化する
- 速度を最適化する
- カスタム設定
- 未定義
例: --quality2
ac - a
遠隔操作に必要なIDと組み合わせて、接続をする際に適用されるアクセスコントロール権限の設定をします。
サポートされている数値:
- 0: フルアクセス
- 1: すべての確認
- 2: 表示
- 3: カスタム設定
📌注意:カスタムパラメーターを使用する場合、以前のカスタム発信アクセスコントロール値が適用されます。
例: --ac1
play
TeamViewerのセッションファイルを再生する (*.tvs)
例: TeamViewer.exe --play C:Users\shvarts\Desktop\A\abc.tvs
control
指定された制御ファイル(*.tvc)で指定されたIDへの接続(RC/Meeting) を開始します。
.tvc ファイルの入手先:
- %appdata%\TeamViewer\MRU\RemoteSupport
- %appdata%\TeamViewer\MRU\Meeting
例: TeamViewer.exe --control C:\Users\shvarts\Desktop\A\abc.tvc
ProxyIP
フォーマットされたProxy IP と Portの表示: IPAddress:Port
例: TeamViewer.exe --ProxyIP 192.168.0.2:8080
ProxyUser
"ProxyIP"と組み合わせてプロキシユーザー名を使用します。
例: TeamViewer.exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin
ProxyPassword
"ProxyIP"と組み合わせてProxy Password Base64 encodedを使用します。
例: TeamViewer.exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin --ProxyPassword test
sendto
パートナーリストのパートナーにファイルリストを送信します。ログインと受信者の選択のためにプロンプトが開きます。
例:
ひとつのファイル： TeamViewer.exe --Sendto C:\Users\shvarts\Desktop\A\abc.jpg
複数ファイル: TeamViewer.exe --Sendto C:\Users\shvarts\Desktop\A\abc.jpg C:\Users\shvarts\Desktop\A\abcd.jpg
例
teamviewer.exe -i <ID> -P <Password>
teamviewer.exe -i <ID> -P <Password> -m fileTransfer
teamviewer.exe -i <ID> -P <Password> -m vpn
デバイスの割り当て(旧バージョン)
Windowsでは、以下のように割り当てタスクが開始されます：
TeamViewer.exe assign <options>
macOSの場合:
Host バージョン:
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment <options>
フルバージョン:
sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment <options>
AssignmentData.json は TeamViewer_Service によって制限された権限で記述されているため、管理者権限を取得するために "sudo "が必要です。このツールは、アプリバンドル内からのみ実行できます。そうでない場合、ツールは必要なフレームワークを見つけることができません。
値(groupなど)にスペースが含まれる場合は、値を""で囲むか、macOSの場合は各スペースを"\" で囲む必要があります。
Windowsでは各オプションの前に"--"、macOSでは各オプションの前に"-"を使用します。
パラメーター
以下のオプションがサポートされています：
📌注意: 各オプションとその説明は以下の通りです。
api-token - REQUIRED
APIにアクセスするために必要なトークンで、 management console（例："profile settings/Apps"）で生成することができます。カスタムHostの展開に必要なトークンも使用可能です。
alias
コンピュータ＆パートナーリスト内の新しいデバイスのエイリアスです。
デバイスがすでに連絡先リストに登録されている場合、エイリアスは適用されません。
grant-easy-access
DEFAULT VALUE: false割り当て後に簡易アクセスを許可します(TeamViewerのメインウィンドウの簡易アクセスを許可するオプションと同じものです)
reassign
DEFAULT VALUE: falseデバイスがすでにアカウントに割り当てられている場合でも、そのアカウントに割り当てます。
wait
DEFAULT VALUE: 10データファイルが作成されるまでの割り当ての待ち時間を秒単位で指定します。通常、デフォルト値で問題ありません。
group
グループはカスタム構成ですでに定義されているため、カスタムHost を使用しない場合のみ必要です。グループが存在しない場合は、自動的に作成されます。デバイスがすでにコンピュータ＆パートナーリストで別のグループに存在している場合、そのグループには移動しません。
group-id
グループIDが既知の場合、--groupパラメータに代わって使用します。大規模な ユーザー環境では、割り当て処理を高速化することができるので便利です。通常、--groupを使用すれば十分です。
proxy
プロキシのURLを<name>:<port>の形式で記述します。
例: --proxy yourproxy:3201
proxy-user
プロキシとの認証に使用するユーザー名です。
proxy-pw
プロキシとの認証に使用するパスワードです。
proxy-pwbase64
--proxy-pw と同じですが、パスワードはBase64エンコードされた文字列で入力する必要があります。
verbose
macOSの場合のみ必要です。より詳細なロギングを可能にするために使用することができます。エラー解析の場合のみ使用します。
retries
一時的なエラーの場合、割り当てを再試行します。なお、各試行の間には1秒の待ち時間があります。
timeout
すべての割り当て試行で使用される全体のタイムアウトを秒単位で設定します。
例:
Windows
基本的な割り当て:
TeamViewer.exe assign --api-token 12345678 --group SomeGroup
エイリアスを使用し、簡易アクセスを許可する:
TeamViewer.exe assign --api-token 12345678 --group "Some Group" --alias %COMPUTERNAME% --grant-easy-access
認証付きプロキシを使用する:
TeamViewer.exe assign --api-token 12345678 --group SomeGroup --reassign --proxy testproxy:3201 --proxy-user someuser --proxy-pw passwd
macOS
📌注意: 例はHost 版のものです。フルバージョンの場合は、TeamViewerHost.app を TeamViewer.app に置き換えてください。
基本的な割り当て:
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token 12345678 -group SomeGroup
エイリアスを使用し、簡易アクセスを許可する:
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token 12345678 -group "Some Group" -alias $USER -grant-easy-access
認証付きプロキシを使用する:
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token 12345678 -group Some
（新）デバイスの割り当て
TeamViewer バージョン 15 以降で一括展開する場合は、新しいコマンドラインパラメータを使用することをお勧めします。詳しくはナレッジベースをご覧ください：コマンドラインからデバイスを割り当てる - 8/9
COM API
Windowsでは、COM APIは次のように使用できます。
TeamViewer.exe api <オプション>
正常にインストールされたかを確認する方法
ログファイル経由
％appdata％\ TeamViewerのTVログファイルを開くと、以下のエントリが見つかります：
CommandLineTasks: initializing...
CommandLineTasks: installing COM-API
API: Installing API ...
API: ... successfully installed, calling SignalServiceParamChange ...
API: ... SignalServiceParamChange finished
CommandLineTasks: installing COM-API successful
CommandLineTasks: finished
Windows Powershell経由
次のPowershellコマンドを使用します。
$tv = new-object -com TeamViewer.Application
$tv.ApiVersion
任意のバージョンがWindows Powershellに書き込まれることを確認します。
例:
正常にアンインストールされたかを確認する方法
ログファイル経由
％appdata％\ TeamViewerのTVログファイルを開くと、以下のエントリが見つかります：
CommandLineTasks: initializing...
CommandLineTasks: uninstalling COM-API
API: Uninstalling API ...
API: ... successfully uninstalled, calling SignalServiceParamChange ...
API: ... SignalServiceParamChange finished
CommandLineTasks: uninstalling COM-API successful
CommandLineTasks: finished
Windows Powershell経由で 次のPowershellコマンドを使用します。
$tv = new-object -com TeamViewer.Application
Powershellにエラーが出力されることを確認します。
