Windows 版 TeamViewerのフルバージョンでは、事前に設定された ID、パスワード、および接続モード を使用してリモートデバイスへのセッションを開始するコマンドラインパラメータを実行できます。
これらのパラメータを使用して、コマンドプロンプト、スクリプト(例: .bat ファイル)、またはデスクトップやスタートメニューのショートカットから TeamViewerを実行することができます。
この記事は、macOSまたはWindows OSを使用する TeamViewerユーザーに適用されます。
📌注意: リモートアクセスライセンスをお持ちのお客様は、コマンドラインからリモートコントロール接続を確立することはできません。
📌注意: 一部のパラメーターは、TeamViewer (Classic) バージョン 13.2 でのみ使用可能です。
パラメーターには、数値のあるパラメーターと値のないパラメータの2種類があります。
数値のないパラメーター例:
TeamViewer.exe --noInstallation
数値のあるパラメーター例:
TeamViewer.exe --id 123456789
ほとんどの場合、1つの数値しか表示されません。複数指定すると、最後のものだけが使用されます。
パラメーターの値にスペースが含まれている場合は、数値を引用符("")で囲む必要があります。
📌注意:
以下のオプションがサポートされています。
📌注意: 最初の行にパラメーターと短いバリアントがあり、その下にそれぞれの説明があります。
TeamViewerを最小化して起動します。「Windowsと同時にTeamViewerを開始する」が有効になっている場合、代わりに TeamViewerがトレイで開始されます。
指定されたパートナーIDへの接続を開始します。
遠隔操作に必要なIDと組み合わせてパスワードを使用します。
遠隔操作に必要なIDと組み合わせて、Base64暗号化されたパスワードを使用します。
遠隔操作に必要なIDと組み合わせて接続モードを使用します。
省略した場合は、リモートコントロールを使用しますが使用されます。
サポートされている数値:
例: --mode fileTransfer
遠隔操作に必要なIDと組み合わせて、接続のクオリティ設定をします。
サポートされている数値:
例: --quality2
遠隔操作に必要なIDと組み合わせて、接続をする際に適用されるアクセスコントロール権限の設定をします。
サポートされている数値:
📌注意:カスタムパラメーターを使用する場合、以前のカスタム発信アクセスコントロール値が適用されます。
例: --ac1
TeamViewerのセッションファイルを再生する (*.tvs)
例: TeamViewer.exe --play C:Users\shvarts\Desktop\A\abc.tvs
指定された制御ファイル(*.tvc)で指定されたIDへの接続(RC/Meeting) を開始します。
.tvc ファイルの入手先:
例: TeamViewer.exe --control C:\Users\shvarts\Desktop\A\abc.tvc
フォーマットされたProxy IP と Portの表示: IPAddress:Port
例: TeamViewer.exe --ProxyIP 192.168.0.2:8080
"ProxyIP"と組み合わせてプロキシユーザー名を使用します。
例: TeamViewer.exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin
"ProxyIP"と組み合わせてProxy Password Base64 encodedを使用します。
例: TeamViewer.exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin --ProxyPassword test
パートナーリストのパートナーにファイルリストを送信します。ログインと受信者の選択のためにプロンプトが開きます。
例:
ひとつのファイル: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にアクセスするために必要なトークンで、 management console(例:"profile settings/Apps")で生成することができます。カスタムHostの展開に必要なトークンも使用可能です。
コンピュータ&パートナーリスト内の新しいデバイスのエイリアスです。
デバイスがすでに連絡先リストに登録されている場合、エイリアスは適用されません。
DEFAULT VALUE: false
割り当て後に簡易アクセスを許可します(TeamViewerのメインウィンドウの簡易アクセスを許可するオプションと同じものです)
DEFAULT VALUE: false
デバイスがすでにアカウントに割り当てられている場合でも、そのアカウントに割り当てます。
DEFAULT VALUE: 10
データファイルが作成されるまでの割り当ての待ち時間を秒単位で指定します。通常、デフォルト値で問題ありません。
グループはカスタム構成ですでに定義されているため、カスタムHost を使用しない場合のみ必要です。グループが存在しない場合は、自動的に作成されます。デバイスがすでにコンピュータ&パートナーリストで別のグループに存在している場合、そのグループには移動しません。
グループIDが既知の場合、--group
パラメータに代わって使用します。大規模な ユーザー環境では、割り当て処理を高速化することができるので便利です。通常、--group
を使用すれば十分です。
プロキシのURLを<name>:<port>の形式で記述します。
例: --proxy yourproxy:3201
プロキシとの認証に使用するユーザー名です。
プロキシとの認証に使用するパスワードです。
--proxy-pw
と同じですが、パスワードはBase64エンコードされた文字列で入力する必要があります。
macOSの場合のみ必要です。より詳細なロギングを可能にするために使用することができます。エラー解析の場合のみ使用します。
一時的なエラーの場合、割り当てを再試行します。なお、各試行の間には1秒の待ち時間があります。
すべての割り当て試行で使用される全体のタイムアウトを秒単位で設定します。
基本的な割り当て:
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
📌注意: 例は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
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
$tv = new-object -com TeamViewer.Application
Powershellにエラーが出力されることを確認します。