コマンドラインパラメーター

0%が役に立ったと言っています (0/1)

この記事は、macOSまたはWindows OSを搭載したすべてのTeamViewerユーザー向けのご案内です。

 

Windowsでのコマンドラインパラメーター

利用方法:

数値の有無によるパラメータ

: 数値のあると値のない2種類のパラメータがあります。

数値のないパラメータ例:

TeamViewer.exe –noInstallation

 

数値のあるパラメータ例:

TeamViewer.exe --id 123456789

数値は、それぞれの列に指定された型として解析されます。ほとんどの場合、1つの数値しか表示されません。

複数指定すると、最後のものだけが使用されます。

パラメータの数値にスペースが含まれている場合は、数値を ""で囲む必要があります。

 

その他の情報

 長いパラメータは、(with two “-“ -> “--“): TeamViewer.exe –Minimizeのように表示されます。

パラメータに短いバリアントがある場合は、 “-“: TeamViewer.exe -nを1つだけ使用して呼び出すこともできます。

ただし、一部のプラットフォームで "-n"を使用することができます。

1つの表示で複数のパラメータを組み合わせることができ、パラメータでは大文字と小文字で区別されます。

 

コマンドラインタスク

通常、コマンドラインパラメータが付与されることで、TeamViewerは動作し続けます。ただし、TeamViewerが終了する為のコマンドラインでトリガーできる「タスク」がいくつかあります。

タスク:

  • デバイス割り当て
  • COM APIのインストール

 

アプリケーション

以下のオプションがサポートされています。

 

パラメーター 短縮型 内容
Minimize TeamViewerを最小限にします。「Windowsと同時にTeamViewerを開始する」が有効になっている場合、TeamViewerはトレイで開始されます。
id  i 指定されたパートナーIDへの接続を開始します。
Password P 遠隔操作に必要なIDと組み合わせてパスワードを使用します。
PasswordB64 B 遠隔操作に必要なIDと組み合わせて、Base64暗号化されたパスワードを使用します。
mode m

遠隔操作に必要なIDと組み合わせて接続モードを使用します。省略するとリモコンが使用されます。

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

  •  ・ファイル転送
  • ・VPN

例: --mode fileTransfer

quality q

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

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

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

例: --quality 2

ac a

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

 

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

  • 0: フルアクセス
  • 1: すべての確認
  • 2: 表示
  • 3: カスタム設定
  • 9: 受信のリモートコントロールセッションの拒否

例: –-ac 1

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

マニュアルの proxy の場合は次のように設定されます。(TeamViewer オプション → 全般→ プロキシ設定→ 設定)
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

 

デバイスの割り当て

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」は管理者権限を取得する必要があります。ツールはアプリケーションバンドルからのみ実行できます。その他の方法ではツールは必要なフレームワークを見つけることができません。

数値(例えばグループ)にスペースが含まれている場合は、その値を ""で囲むか、または各スペースをmacOSに\でカプセル化する必要があります。

各オプションの前にはWindows用に “--" を使用し、各オプションの前にmacOS用に “-“を使用します。

以下のオプションがサポートされています:

オプション 必須 デフォルト数値 内容
api-token  yes   トークンはAPIにアクセスする必要があり、これはマネージメントコンソールで生成することができます。(プロファイル設定/アプリケーションなど)カスタムホストのEasy-Rollout用のトークンもご利用できます。
devoce alias     コンピューター&パートナーリストの新しいデバイスのエイリアス(名称)。デバイスがすでに連絡先リストにある場合、エイリアス(名称)は適用されません。
grant-easy-access   false 割り当て後に簡単にアクセスできるようにします。(TeamViewerメインウィンドウの「簡易アクセス」機能と同じです)
reassign   false デバイスが既にアカウントに割り当てられている場合でも、デバイスをアカウントに割り当てます。
wait   10 割り当て作業に伴うデータファイルの作成をする際の待機時間(秒単位)。通常はデフォルト数値で十分です。
group *  

デバイスが追加されるグループ名。グループが存在しない場合、自動的に生成されます。

デバイスが既に別のグループのコンピューターとコンピューター&パートナーリストに存在する場合、そのグループに移動されません。

group-id     このオプションは、グループのIDが認知されている場合、グループパラメーターを使用する代わりに使用できます。大規模な顧客環境がある場合、割り当て作業の効率向上に役立ちます。通常は—groupを使用されば十分です。
proxy     プロキシのURL<名前>:<ポート>です。例)--proxy yourproxy:3201
proxy-user     プロキシとの認証に使用されるユーザー名を指します。
proxy-pw     プロキシとの認証に使用されるパスワードを指します。
proxy-pw-base64     --proxy-pwと同じですが、パスワードはBease64でエンコードされた文字列として入力する必要があります。特殊文字を含むパスワードが必要な場合があります。
verbose macOSのみ対応   より詳細なロギングを有効にするために使用します。エラー分析の場合にのみ使用する必要があります。

 

例:

Windows

基本的な割り当て:

TeamViewer.exe assign --api-token 12345678 --group SomeGroup

エイリアスと簡易アクセスを含むデバイス割り当て:

TeamViewer.exe assign --api-token 12345678 --group "Some Group" --devicealias %COMPUTERNAME% --grant-easy-access

認証付きプロキシ利用環境でのデバイス割り当て:

TeamViewer.exe assign --api-token 12345678 --group SomeGroup --reassign --proxy testproxy:3201 --proxy-user someuser --proxy-pw passwd

 

macOS

こちらの例はホストバージョンです。フルバージョンの場合はTeamViewerHost.appをTeamViewer.appに変更してください。

基本的な割り当て:

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment assign YES -api-token 12345678 -group SomeGroup

エイリアスと簡易アクセスを含むデバイス割り当て:

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment assign YES -api-token 12345678 -group "Some Group" -alias $USER -grant-easy-access 

認証付きプロキシ利用環境でのデバイス割り当て:

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment assign YES -api-token 12345678 -group SomeGroup -reassign -proxy testproxy:3201 -proxy-user someuser -proxy-pw passwd

 

 COM API

Windowsでは、COM APIは次のように使用できます。

TeamViewer.exe api <オプション>

 

オプション 内容 TeamViewer バージョン
--install COM APIをインストール TeamViewer 3-6
--uninstall COM APIをアンインストール TeamViewer 3-6

 

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

ログファイル経由

%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に書き込まれることを確認します。

例:

Powershell1.png

 

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

ログファイル経由

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

Powershell2.png

 

バージョン履歴
改訂番号
8/8
最終更新:
‎28 6 2019, 4:01 PM
更新者:
 
寄稿者: