コマンドラインを使用して、TeamViewer をデバイスに適用することができます。デバイスの OS に応じて、次の手順を実行してください。
この記事は 、デバイスに TeamViewer (バージョン 15 以降) を導入したいCorporateおよびTensorライセンス所有者に適用されます。
コマンドラインでデバイスを割り当てる方法
- Windows
- macOS
- Linux
コマンドラインを使用して Windows デバイスを割り当てるには、以下の手順に従ってください。
- CMD を開きます。
- TeamViewer のインストールフォルダに移動します。
- コマンド (下記参照)をコマンドラインに入力します。
- キーボードのEnterキーを押します。
- 次のように入力します。(任意)
echo %errorlevel%
プロセスが成功したかどうかを確認するには、コマンドラインに次のコードを入力します:
- 割り当てが成功した場合、コマンドラインに値「0」が返されます。
- その他の戻り値は、割り当て中に問題が発生したことを示します。詳細については、エラー・コードを参照してください。
TeamViewer.exe assignment --id paste_your_assignment_id_here --offline
例:
TeamViewer.exe assignment --id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
任意のコマンドラインオプション
他にもコマンドラインに追加できるオプションがあります:
Alias
--device-alias=[<name>]
デバイスリスト内の新しいデバイスのエイリアスです。このプロパティは以下の値を取ることができます:
- --alias (値なし)
- コンピューターのエイリアスがTeamViewer IDになります。
- --alias hello
- コンピューターのエイリアスが "hello "になります。
- Alias パラメータが指定されていない場合
- このコンピュータのエイリアスは %computername% になります。
- --alias %systemvariable% とした場合
- エイリアスは使用されているシステム変数(例:%username%)になります。
例:
"C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=%COMPUTERNAME%-%USERNAME%
ヒント: スペースを使う場合は、次の例のようにすべて"... "で囲んでください:
"C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=“%COMPUTERNAME Test %USERNAME%“
再試行
--retries
一時的なエラーの場合は、割り当てが再試行されます。各試行の間に1秒の待ち時間があることに注意してください。
タイムアウト
--timeout
すべての割り当て試行で使用される全体のタイムアウトを秒単位で設定します。
例:
TeamViewer.exe assignment --id YOUR_ASSIGNMENT_ID --retries=3 --timeout=120
オフラインデバイスについて
--offline
割り当て時にオフラインのデバイスを処理するために、割り当て情報は暗号化されたプロパティとしてレジストリに保存され、デバイスがオンラインになると自動的に実行されます。
このプロパティは、デバイスが正常に割り当てられると削除されます。
同一の割り当て ID を使用した再割り当てについて
--reassign
このパラメーターを使用すると、同じ割り当て ID を用いてデバイスを再割り当てすることが可能になります。通常、割り当て ID が変更されていない場合、デバイスは再割り当ての試行を拒否します。--reassign を指定することで、既存の割り当て ID を強制的に適用でき、新しい割り当て ID を生成せずに再割り当てを行う必要がある場面で有効です。
エラーコード
割り当ての更新/上書き方法
すでに割り当てられたデバイスがあり、再度コマンドラインから割り当てを実行すると、デバイスの割り当ては新しいもので上書きされます。上書きは古い割り当てが削除されることを意味し、すでに割り当てられた管理者やポリシーは失われます。
注意: TeamViewer ポリシーの「アカウント割り当ての削除を防止」は、すでに割り当てられているデバイスへの新しい割り当てを防止するものです。
要件:
- TeamViewer がすでにインストールされている。
- TeamViewer full clientの場合、macOS で起動オプションを有効にする必要があります。
コマンドラインを使用して macOS デバイスを割り当てるには、以下の手順に従ってください。
- ターミナルを開きます。
- コマンド(下記参照)をコマンドラインに入力します。
- キーボードの Enter キーを押します。
- macOS Host
- macOS Full client
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -assignment_id <ID> --offline
例:
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -assignment_id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
オプションのコマンドライン引数
以下は、コマンドラインに追加できるオプションです。
エイリアス
--device_alias [<name>]
新しいデバイスに対して、デバイス一覧で表示されるエイリアスを指定します。
すでに連絡先リストに登録されているデバイスには、エイリアスは適用されません。
このプロパティには、以下の値を指定できます:
- --alias(値なし)
コンピューターのエイリアスは TeamViewer ID になります。 - --alias hello
コンピューターのエイリアスは「hello」になります。
--offline
割り当て時にオフラインのデバイスを処理するために、割り当て情報は暗号化されたプロパティとしてレジストリに保存され、デバイスがオンラインになると自動的に実行されます。
このプロパティは、デバイスが正常に割り当てられると削除されます。
同一の割り当て ID を使用した再割り当てについて
--reassign
このパラメーターを使用すると、同じ割り当て ID を用いてデバイスを再割り当てすることが可能になります。通常、割り当て ID が変更されていない場合、デバイスは再割り当ての試行を拒否します。--reassign を指定することで、既存の割り当て ID を強制的に適用でき、新しい割り当て ID を生成せずに再割り当てを行う必要がある場面で有効です。
割り当ての更新/上書き方法
すでに割り当てられたデバイスがあり、再度コマンドラインから割り当てを実行すると、デバイスの割り当ては新しいもので上書きされます。上書きは古い割り当てが削除されることを意味し、すでに割り当てられた管理者やポリシーは失われます。
注意: TeamViewer ポリシーの「アカウント割り当ての削除を防止」は、すでに割り当てられているデバイスへの新しい割り当てを防止するものです。
sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -assignment_id paste_your_assignment_id_here --offline
例:
sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -assignment_id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline
オプションのコマンドライン引数
以下は、コマンドラインに追加できるオプションです。
エイリアス
--device_alias [<name>]
新しいデバイスに対して、デバイス一覧で表示されるエイリアスを指定します。
すでに連絡先リストに登録されているデバイスには、エイリアスは適用されません。
このプロパティには、以下の値を指定できます:
- --alias(値なし)
コンピューターのエイリアスは TeamViewer ID になります。 - --alias hello
コンピューターのエイリアスは「hello」になります。
--offline
割り当て時にオフラインのデバイスを処理するために、割り当て情報は暗号化されたプロパティとしてレジストリに保存され、デバイスがオンラインになると自動的に実行されます。
このプロパティは、デバイスが正常に割り当てられると削除されます
同一の割り当て ID を使用した再割り当てについて
--reassign
このパラメーターを使用すると、同じ割り当て ID を用いてデバイスを再割り当てすることが可能になります。通常、割り当て ID が変更されていない場合、デバイスは再割り当ての試行を拒否します。--reassign を指定することで、既存の割り当て ID を強制的に適用でき、新しい割り当て ID を生成せずに再割り当てを行う必要がある場面で有効です。
割り当ての更新/上書き方法
すでに割り当てられたデバイスがあり、再度コマンドラインから割り当てを実行すると、デバイスの割り当ては新しいもので上書きされます。上書きは古い割り当てが削除されることを意味し、すでに割り当てられた管理者やポリシーは失われます。
注意: TeamViewer ポリシーの「アカウント割り当ての削除を防止」は、すでに割り当てられているデバイスへの新しい割り当てを防止するものです。
sudo teamviewer assignment --id paste_your_assignment_id_here --offline
例:
sudo teamviewer assignment --id 0001CoABChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAO4PLaOBrqNDgr6jwtNCVK_JiM5lVdgdfgYo3uQ3pGkAbX8bo_VqPw1Rt61-RLe9AKSwZ14uwOXtUN7FYflrHbWAqRKBF0h8V18ldMcVT1rLF --offline
オプションのコマンドライン引数
以下は、コマンドラインに追加できるオプションです。
エイリアス
--device_alias [<name>]
新しいデバイスに対して、デバイス一覧で表示されるエイリアスを指定します。
すでに連絡先リストに登録されているデバイスには、エイリアスは適用されません。
このプロパティには、以下の値を指定できます:
- --alias(値なし)
コンピューターのエイリアスは TeamViewer ID になります。 - --alias hello
コンピューターのエイリアスは「hello」になります。
--offline
割り当て時にオフラインのデバイスを処理するために、割り当て情報は暗号化されたプロパティとしてレジストリに保存され、デバイスがオンラインになると自動的に実行されます。
このプロパティは、デバイスが正常に割り当てられると削除されます。
同一の割り当て ID を使用した再割り当てについて
--reassign
このパラメーターを使用すると、同じ割り当て ID を用いてデバイスを再割り当てすることが可能になります。通常、割り当て ID が変更されていない場合、デバイスは再割り当ての試行を拒否します。--reassign を指定することで、既存の割り当て ID を強制的に適用でき、新しい割り当て ID を生成せずに再割り当てを行う必要がある場面で有効です。
エラーコード
割り当ての更新/上書き方法
すでに割り当てられたデバイスがあり、再度コマンドラインから割り当てを実行すると、デバイスの割り当ては新しいもので上書きされます。上書きは古い割り当てが削除されることを意味し、すでに割り当てられた管理者やポリシーは失われます。
注意: TeamViewer ポリシーの「アカウント割り当ての削除を防止」は、すでに割り当てられているデバイスへの新しい割り当てを防止するものです。