この記事は、コーポレートまたはテンサーライセンスをご利用のお客様に適用されます。
またTeamViewerバージョン13.2以上をご利用であることが条件となります。
サポートされているWindowsバージョンはWin 7、Win 8、Win 10です。
Windows上にてTeamViewer ホストおよびTeamViewer フルバージョンを一括展開する方法について説明します。
インストール
Windowsの場合TeamViewerには2つのMSIインストーラがあります。
- TeamViewer_Host.msi：TeamViewerの（カスタマイズされた）ホストモジュールをインストールします。
- TeamViewer_Full.msi：TeamViewerのフルバージョンをインストールします。
標準のホストクライアント
ユーザーの操作なしで大量展開シナリオにTeamViewerをインストールするには、スクリプト内から、コマンドラインから直接、または展開ソリューションで次のコマンドを使用する必要があります。
- msiexec.exe /i "<path to your TeamViewer_Host.msi>" /qnm
- プロパティ /i は、インストールを行うことを示します。
- プロパティ /qn は、インストールを強制的に静かにします。これは、インストール中にユーザーの操作が必要ないことを意味します。
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn
TeamViewerのインストールには管理者権限が必要です。インストールを制御するために使用できるWindowsインストーラーのプロパティは他にもあります。コマンド プロンプトに次のように入力します: msiexec.exe /?
カスタマイズされたホストクライアント
ユーザーの操作なしでカスタマイズされたホストをインストールする場合は、次の手順に従う必要があります。
1）新しいカスタマイズを作成するか、既存のカスタマイズを開きます
💡ホストをカスタマイズする方法: 「カスタマイズ＆配布」ページにアクセスして、TeamViewer管理コンソール内でカスタマイズを設定してください。ホストのカスタマイズを作成すると、Configuration ID が生成されます。開いたページの下部にある対応するモジュールエントリの編集をクリックすると、それを見つけることができます。
2) カスタマイズしたホストから ConfigurationID をコピーします
3）管理者権限でWindowsコマンドプロンプト（CMD）を開くか、スクリプト（バッチなど）を介してMSIを実行します。
💡コマンドプロンプトは管理者として開始する必要があります。スクリプト内で MSI を実行する場合、スクリプトも管理者権限で実行する必要があります。
4) コマンドプロンプトに次のように入力します: msiexec.exe /i "Path\To\TeamViewer_Host.msi>" /qn CUSTOMCONFIGID=<YOUR_CUSTOMCONFIG_ID>
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn CUSTOMCONFIGID=<YOUR_CUSTOMCONFIG_ID>
5）以下は、デバイスを割り当ててカスタマイズするために必要なものの例です。
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn CUSTOMCONFIGID=YOURIDCCODE
ping -n 31 127.0.0.1>nul
Path\To\TeamViewer.exe assign --api-token=YOURTOKEN --grant-easy-access
フルバージョン
ユーザーの操作なしでの展開シナリオで TeamViewer をインストールする方法は以下の通りです。
1) 管理者権限で Windows コマンドプロンプト (CMD) を開くか、スクリプト (バッチなど) を介して MSI を実行します。
💡コマンドプロンプトは管理者として開始する必要があります。スクリプト内で MSI を実行する場合、スクリプトも管理者権限で実行する必要があります。
2) コマンドプロンプトに次のように入力します: msiexec.exe /i "Path\To\TeamViewer_Full.msi>" /qnプロパティ /i は、インストールを行うことを示します
プロパティ /qn は、インストールを強制的に静かにします。これは、インストール中にユーザーの操作が必要ないことを意味します
msiexec.exe /i "Path\To\TeamViewer_Full.msi" /qn
💡Windowsインストーラーのヘルプ：インストールを制御するために使用できるWindowsインストーラーのプロパティは他にもあります。コマンドプロンプトに次のように入力するだけです。msiexec.exe/？
カスタマイズされたフルバージョン
詳細については、こちらの記事をご覧くださいませ。
インストールの設定
TeamViewerオプションの適用（推奨）
1) TeamViewer クライアントから設定ファイルをエクスポートします。バージョン15.4以降、*。tvoptファイルを受け取ります。以前のバージョンでは、TeamViewerは* .regファイルをエクスポートしていました。インポートには両方のファイル タイプを使用できますが、*.tvopt ファイルを使用することをお勧めします。
💡設定ファイルの入手方法：
TeamViewer を 1 台のコンピューターにインストールし、ニーズに合わせて構成します。
1) [詳細設定] カテゴリのダイアログ ([追加] | [オプション]) に移動し、[エクスポート...] をクリックしてオプション ファイルをエクスポートし、ファイルに名前を付けます (この例では、このファイルに my_settingsfile という名前を付けます)。
2）TeamViewer_Host.msiまたはTeamViewer_Full.msiをインストールするときに、プロパティSETTINGSFILE = "ABSOLUTE_PATH / TO / SETTINGSFILE"をコマンドに追加します。指定するパスは、ローカルパスまたはネットワーク共有へのパスのいずれかである必要があります。
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn SETTINGSFILE="C:/my_settingsfile.tvopt"
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn SETTINGSFILE="\\share\my_settingsfile.tvopt"
⚠ コマンドラインで .tvopt ファイルの正確な名前を使用してください。
TeamViewer設定の適用（非推奨）
パラメータIMPORTREGFILEは、バージョン15.4以降非推奨になりました。現在でもバージョン15.3以下で使用できますが、パラメータは今後のバージョンで削除される予定です。したがって、パラメータSETTINGSFILEに切り替えることをお勧めします。
1) 設定ファイル「TeamViewer_Settings.reg」(ファイル名は必須)をMSIファイルと同じディレクトリに置きます。
💡設定ファイルを取得する方法：1台のコンピュータにTeamViewerをインストールし、必要に応じて構成します。 [オプション] ダイアログ ([その他] | [オプション]) の [詳細] カテゴリで、[エクスポート...] をクリックして設定ファイルをエクスポートします。
2) TeamViewer_Host.msi (バージョン 13.2 以降) または TeamViewer_Full.msi (バージョン 14.0 以降) をインストールするときに、プロパティ IMPORTREGFILE=1 をコマンドに追加します。 0はIMPORTREGFILEのデフォルト値であり、設定はインポートされません。
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn IMPORTREGFILE=1
ホストまたはフルクライアントをアカウントに割り当て
大量展開プロセスでは、新しい TeamViewer インストールを既存のアカウントに割り当てると便利な場合があります。これは次の方法で実行できます。
1) MSI 経由で TeamViewer をインストールする
2）インストール後、TeamViewerがオンラインになるまで待ちます
3) TeamViewer.exe を呼び出して、API トークンと割り当てプロパティをコマンド ライン タスク「割り当て」に追加します。
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn CUSTOMCONFIGID=YOURIDCCODE
ping -n 31 127.0.0.1>nul
Path\To\TeamViewer.exe assign --api-token=YOURTOKEN --grant-easy-access
プロパティの構成について
コピー用
msiexec.exe /i "Path\To\TeamViewer_Host.msi" ENABLEOUTLOOKPLUGIN="false"
📌注意: TeamViewerが正常に配備されたら、TeamViewerポリシーの設定方法についての記事をご確認ください。設定ポリシーでは、TeamViewer マネージメントコンソールを介して、インストールされたすべてのTeamViewerクライアントのオプションを一元的に設定することができます。これにより、すべてのクライアントに同じ設定を展開して適用することができます。
TeamViewerのアップデート
TeamViewer_Host.msi
TeamViewerホストクライアントをインストールし、既にTeamViewerバージョンがインストールされている場合は、特定のアップグレードパスがサポートされていることを確認する必要があります。次の表は、インストールが可能な場合と、以前のバージョンをアンインストールする必要がある場合について説明しています。
TeamViewer.msi
TeamViewer フルバージョンをインストールし、既にTeamViewerバージョンがインストールされている場合、TeamViewer_Full.msi（TV 14.0以上）は以前にインストールされたバージョンのTeamViewerと互換性がないとみなす必要があります。
インストールにMSIファイルを使用している場合、TeamViewerの自動更新は利用できなくなります。 Windowsインストーラーで再度更新する必要があります。
TeamViewerのアンインストール
必要に応じてTeamViewerをアンインストールできます。（ホストからフルバージョンに切り替える場合など）
1) インストールにも使用したのとまったく同じWindows MSIインストーラを使用します。
2) オペレーティングシステム機能を使用します。
Windowsインストーラによるアンインストール
Windows MSIインストーラー（/ uninstallまたは/ x）からuninstallコマンドを使用できます。アンインストールには必ず正しい MSI (フルまたはホスト) を使用してください。
msiexec.exe /uninstall "Path\To\TeamViewer_Host.msi"
管理者権限は、コマンドラインを開始するときに必要です。
割り当て
概要
TeamViewerホストまたはフルクライアントは、TeamViewerアカウントに割り当てられるように設定できます。これは、インストール処理中に行うことができます。
この説明は、TeamViewer 14.x以上およびホストv13.2以上に有効です。
次の2つの方法でデバイスをTeamViewerアカウントに割り当てることができます。
- Windows MSIインストーラ（msiまたはTeamViewer_Host.msi）を使用します。
- インストール後のTeamViewer実行可能ファイル（exe）を使用します。
旧バージョンのTeamViewerをお持ちの場合は、割り当てツールを使用して勘定割当を行う必要があります。これに関する詳細は、こちらをご覧ください。
割り当ての実行方法
課題を行うには、次のものが必要です。
1)（必須）有効なAPIトークン。
2) （任意）割り当てオプションを使用して、デバイスをどのように割り当てるかをより正確に定義します。
💡APIトークンは、次の2つの方法で取得できます。
1) 作成時に割り当てツールを使用してアカウント割り当てを許可するオプションをオンにしている場合は、カスタムホスト設定から選択します。
2) ユーザープロフィール>アプリでスクリプトトークンを作成することができます。このスクリプトトークンには、少なくとも次のアクセス許可が必要です。
グループ管理➔グループの表示
コンピュータとパートナー➔項目の表示、追加、編集、削除
TeamViewer 実行可能ファイルによる割り当て (推奨)
TeamViewer Host または Full クライアントがインストールされた後で、割り当てを行う必要があります。割り当てるマシンで TeamViewer を起動することが重要です。
コマンド assign を使用して TeamViewer.exe (または単に Teamviewer) を呼び出し、続いてプロパティ --api-token と割り当てオプションを指定します。
TeamViewer.exe assign --api-token <APITOKEN> [--group-id <GROUP_ID> --grant-easy-access --reassign --proxy <YOUR_PROXY> --proxy-user <YOUR_PROXY_USER> --proxy-pw <PASSWORD>]
Windows MSIインストーラによる割り当て
インストールプロセス中に割り当てを行うには、MSIインストーラを実行し、プロパティAPITOKENとオプションでプロパティASSIGNMENTOPTIONSを追加するだけです。
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> [ASSIGNMENTOPTIONS="<YOUR OPTIONAL SETTINGS>"]
msiexec.exe /i "Path\To\TeamViewer_Full.msi" /qn APITOKEN=<YOUR_APITOKEN> [ASSIGNMENTOPTIONS="<YOUR OPTIONAL SETTINGS>"]
割り当てオプション
オプション
内容
--alias[<name>]
コンピュータと連絡先リストの新しいデバイスのエイリアス。デバイスがすでに連絡先リストにある場合、エイリアスは適用されません。
- --alias (without value) → alias of the computer will be the teamviewerID
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--alias --group MyGroup"
- --alias hallo → alias of the computer will be "hallo"
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--alias hello --group MyGroup"
- alias parameter not specified → alias of this computer will be %computername%
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--group MyGroup"
- --alias %systemvariable% → alias will be the used system variable e.g. %username%
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--alias %systemvariable% --group MyGroup"
--grant-easy-access
割り当て後に簡単にアクセスできるようにします（TeamViewerの「簡易アクセスを許可」オプションと同じ）
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--grant-easy-access --group MyGroup"
--reassign
デバイスがすでにアカウントに割り当てられている場合でも、デバイスをアカウントに割り当てます。
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--reassign --group MyGroup"
--group<name>
デバイスが追加されるグループの名前。グループが存在しない場合、自動的に作成されます。デバイスが既に別のグループのコンピュータと連絡先リストに存在する場合、そのグループに移動されません。
*カスタムホストが使用されていない場合にのみ必要です。カスタム設定で既定のグループが既に定義されているためです。
カスタム設定でデフォルトグループがすでに定義されているため、カスタムホストを使用する場合は不要です。
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--group MyGroup"
--group-id<ID>
このオプションは、グループのIDがわかっている場合に--groupパラメーターを使用する代わりの方法です。これは、割り当てプロセスを高速化するため、非常に大規模な顧客環境で役立つ場合があります。通常は--groupを使用するだけで十分です。
📌注意：IDの前にはリテラル「g」を付ける必要があります。
管理コンソールにログインし、グループをクリックしてURLを確認すると、グループIDを見つけることができます。 URL の最後に「g/12345678」があります。
グループIDを取得するには、「/」を削除してください。
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--group-id g123"
--proxy<name>:<port>
プロキシのURL（割り当ての場合のみ） :例： --proxy yourproxy:3201
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypass --group MyGroup"
⚠URL の「http://」は省いてください
--proxy-user<name>
プロキシとの認証に使用されるユーザー名（割り当ての場合のみ）
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypass --group MyGroup"
--proxy-pw<password>
プロキシとの認証に使用されるパスワード（割り当ての場合のみ）。
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypass --group MyGroup"
--proxy-pw-base64<encoded_password>
--proxy-pwと同じですが、パスワードはBase64でエンコードされた文字列として入力する必要があります。特殊文字を含むパスワードが必要な場合があります。
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw-base64 bXlwYXNz --group MyGroup"
--monitoring-policyid <policy_id>
このオプションは、TeamViewer_Full.msiをインストールする際にのみ使用できます。このオプションでは、割り当てが正常に終了した後に適用されるリモート管理監視のポリシーIDを指定します。これには --patchmanagement-policyid も必要です。
msiexec.exe /i "Path\To\TeamViewer_Full.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--monitoring-policyid <YOUR_MONITORING_POLICYID> --patchmanagement-policyid <YOUR_PATCHMANAGEMENT_POLICYID> --group MyGroup"
--patchmanagement-policyid <policy_id>
このオプションは、TeamViewer_Full.msiをインストールする際にのみ使用できます。このオプションでは、割り当てが正常に終了した後に適用される、リモート管理監視のポリシーIDを指定します。これには--monitoring-policyidも必要です。
msiexec.exe /i "Path\To\TeamViewer_Full.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--monitoring-policyid <YOUR_MONITORING_POLICYID> --patchmanagement-policyid <YOUR_PATCHMANAGEMENT_POLICYID> --group MyGroup"
割り当てオプションについて
- パラメータ値（たとえばグループ名）が空の場合は、2つの二重引用符を使用します。（ふたつのシングル引用符ではない）
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--group ""Test group"""
割り当てパラメータ名は大文字と小文字を区別しません (バージョン 14.0 以降)
- ASSIGNMENTOPTIONS 内の割り当てには、プロキシ設定を指定できます。 TeamViewer接続自体には追加のプロキシ設定があります。（TeamViewerクライアントオプションで定義されています）これらは、ASSIGNMENTOPTIONSの外部で設定する必要があります。
- インストール/割り当て用のコマンドに環境変数を挿入して、動的な値を追加することもできます。エイリアスの場合。 %%を使用して環境変数を使用できます。
msiexec.exe /i "Path\To\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> ASSIGNMENTOPTIONS="--alias %COMPUTERNAME%"
