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と組み合わせて接続モードを使用します。

省略した場合は、リモートコントロールを使用しますが使用されます。

サポートされている数値:

  • ファイル転送
  • VPN

例: --mode fileTransfer

quality q

遠隔操作に必要なIDと組み合わせて、接続のクオリティ設定をします。

サポートされている数値:

  1. 自動でクオリティを選択
  2. 画質を最適化する
  3. 速度を最適化する
  4. カスタム設定
  5. 未定義 

例: --quality2

ac - a

遠隔操作に必要なIDと組み合わせて、接続をする際に適用されるアクセスコントロール権限の設定をします。

サポートされている数値:

  • 0: フルアクセス
  • 1: すべての確認
  • 2: 表示
  • 3: カスタム設定

📌注意:カスタムパラメーターを使用する場合、以前のカスタム発信アクセスコントロール値が適用されます。

  • 9: 受信のリモートコントロールセッションの拒否

例:  --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 
  • VPN: 
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 <オプション>

オプション 概要 TeamViewer version

--install

COM APIをインストール

>=11

--uninstall

COM API のアンインストール

>=11

正常にインストールされたかを確認する方法

ログファイル経由

%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にエラーが出力されることを確認します。