コマンドラインでデバイスを割り当てる方法

コマンドラインを使用して Windows デバイスを割り当てるには、以下の手順に従ってください。

  1. CMD を開きます。
  2. TeamViewer のインストールフォルダに移動します。
  3. コマンド (下記参照)をコマンドラインに入力します。
  4. キーボードのEnterキーを押します。
  5.  次のように入力します。(任意)
echo %errorlevel%

プロセスが成功したかどうかを確認するには、コマンドラインに次のコードを入力します: 

  • 割り当てが成功した場合、コマンドラインに値「0」が返されます。
  • その他の戻り値は、割り当て中に問題が発生したことを示します。詳細については、エラー・コードを参照してください。

TeamViewer.exe assignment --id paste_your_assignment_id_here --offline 

例: 

TeamViewer.exe assignment --id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline

任意のコマンドラインオプション

他にもコマンドラインに追加できるオプションがあります:

Alias

Windows:

--device-alias=[<name>]

デバイスリスト内の新しいデバイスのエイリアスです。このプロパティは以下の値を取ることができます:

  1. --alias (値なし)
    • コンピューターのエイリアスがTeamViewer IDになります。
  2. --alias hello
    • コンピューターのエイリアスが "hello "になります。
  3. Alias パラメータが指定されていない場合
    • このコンピュータのエイリアスは %computername% になります。
  4. --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

割り当て時にオフラインのデバイスを処理するために、割り当て情報は暗号化されたプロパティとしてレジストリに保存され、デバイスがオンラインになると自動的に実行されます。
このプロパティは、デバイスが正常に割り当てられると削除されます

エラーコード

Error code
説明
問題/解決策

1

無効なコマンドライン引数

コマンドの綴りが間違っているか、無効なコマンドが使用されています。コマンドを確認して、もう一度お試しください。

2

署名検証エラー

-

3

製品がインストールされていません

TeamViewer がインストールされていません。割り当てを行う前に、TeamViewer をインストールしてください。

4

サービス設定 - アクセスに失敗しました

// ComAPI

割り当て設定を TeamViewer クラウドで検証できませんでした。  

後でもう一度お試しください。

400

(40 under Linux/FreeBSD)

MDv2Assignment - 無効な引数

コマンドライン構文にエラーがあるか、無効な割り当て ID が使用されているようです。コマンドライン構文全体を確認し、コピーした割り当て ID がManagement Consoleからの有効な構成であることを確認してください。 

 401

 (41 under Linux/FreeBSD)

MDv2Assignment - サービスが実行されていません

TeamViewer が正常に実行されていないため、割り当てを実行できません。TeamViewer サービスが実行されていることを確認してください。

402

 (42 under Linux/FreeBSD)

MDv2Assignment - サービス互換性のないバージョン

TeamViewer サービスは、実行された TeamViewer クライアントのバージョンと互換性がありません。インストールが正常に完了しなかったようです。インストールを確認し、必要に応じて TeamViewer を再インストールしてください。

403

 (43 under Linux/FreeBSD)

MDv2Assignment - オンラインではありません

TeamViewer クライアントは、デバイスを割り当てるために TeamViewer クラウドに接続できませんでした。クライアントがオンラインかどうか、インターネット接続が正常に機能しているかどうかを確認して、割り当てを再試行してください。この問題が頻繁に発生する場合は、コマンド ライン インターフェイスの再試行オプションの使用を検討してください。

404

 (44 under Linux/FreeBSD)

MDv2Assignment - すでに実行中

別の割り当てプロセスがすでに実行されています。その割り当てのステータスを確認してください。たとえば、デバイスがManagement Consoleで管理デバイスとしてすでに登録されているかどうかを確認することで、これを実行できます。 

405

 (45 under Linux/FreeBSD)

MDv2Assignment - timeout

割り当ての試行がタイムアウトしました。もう一度お試しください。この問題が頻繁に発生する場合や、モバイル ネットワークなどのネットワークが不安定な場合は、コマンド ライン インターフェイスでタイムアウトを増やすことを検討してください。

406

 (46 under Linux/FreeBSD)

MDv2Assignment - 失敗

不明な理由により割り当てが失敗しました。ログを保存してサポートにお問い合わせください。

407

 (47 under Linux/FreeBSD)

MDv2Assignment - アクセス拒否

割り当てを実行するために必要な権限がありません。ユーザーにローカル管理者権限があることを確認してください。

408

(48 under Linux/FreeBSD)

MDv2Assignment - ポリシーにより拒否

このデバイスで有効な TeamViewer ポリシーにより、既存の割り当て状態を削除できません。Management Consoleでポリシーを無効にしてください。 


注意: 再割り当ては既存の状態を削除するため、再割り当ても拒否されます。

409
(49 under Linux/Free BSD)

MDv2Assignment - デバイスはすでに管理されています

 

このデバイスはすでに同じ割り当て IDで会社に割り当てられています。

 

割り当ての更新/上書き方法

すでに割り当てられたデバイスがあり、再度コマンドラインから割り当てを実行すると、デバイスの割り当ては新しいもので上書きされます。上書きは古い割り当てが削除されることを意味し、すでに割り当てられた管理者やポリシーは失われます。

注意: TeamViewer ポリシーの「アカウント割り当ての削除を防止」は、すでに割り当てられているデバイスへの新しい割り当てを防止するものです。

要件:

  • TeamViewer がすでにインストールされている。
  • TeamViewer full clientの場合、macOS で起動オプションを有効にする必要があります。

コマンドラインを使用して macOS デバイスを割り当てるには、以下の手順に従ってください。

  1. ターミナルを開きます。
  2. コマンド(下記参照)をコマンドラインに入力します。
  3. キーボードの Enter キーを押します。

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>]

新しいデバイスに対して、デバイス一覧で表示されるエイリアスを指定します。
すでに連絡先リストに登録されているデバイスには、エイリアスは適用されません。
このプロパティには、以下の値を指定できます:

  1. --alias(値なし)
    コンピューターのエイリアスは TeamViewer ID になります。
  2. --alias hello
    コンピューターのエイリアスは「hello」になります。

--offline

割り当て時にオフラインのデバイスを処理するために、割り当て情報は暗号化されたプロパティとしてレジストリに保存され、デバイスがオンラインになると自動的に実行されます。
このプロパティは、デバイスが正常に割り当てられると削除されます

割り当ての更新/上書き方法

すでに割り当てられたデバイスがあり、再度コマンドラインから割り当てを実行すると、デバイスの割り当ては新しいもので上書きされます。上書きは古い割り当てが削除されることを意味し、すでに割り当てられた管理者やポリシーは失われます。

注意: 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>]

新しいデバイスに対して、デバイス一覧で表示されるエイリアスを指定します。
すでに連絡先リストに登録されているデバイスには、エイリアスは適用されません。
このプロパティには、以下の値を指定できます:

  1. --alias(値なし)
    コンピューターのエイリアスは TeamViewer ID になります。
  2. --alias hello
    コンピューターのエイリアスは「hello」になります。

--offline

割り当て時にオフラインのデバイスを処理するために、割り当て情報は暗号化されたプロパティとしてレジストリに保存され、デバイスがオンラインになると自動的に実行されます。
このプロパティは、デバイスが正常に割り当てられると削除されます

割り当ての更新/上書き方法

すでに割り当てられたデバイスがあり、再度コマンドラインから割り当てを実行すると、デバイスの割り当ては新しいもので上書きされます。上書きは古い割り当てが削除されることを意味し、すでに割り当てられた管理者やポリシーは失われます。

注意: 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

割り当て時にオフラインのデバイスを処理するために、割り当て情報は暗号化されたプロパティとしてレジストリに保存され、デバイスがオンラインになると自動的に実行されます。
このプロパティは、デバイスが正常に割り当てられると削除されます

エラーコード

Error code
説明
問題/解決策

400

(40 under Linux/FreeBSD)

MDv2Assignment - 無効な引数

コマンドライン構文にエラーがあるか、無効な割り当て ID が使用されているようです。コマンドライン構文全体を確認し、コピーした割り当て ID がManagement Consoleからの有効な構成であることを確認してください。 

 401

 (41 under Linux/FreeBSD)

MDv2Assignment - サービスが実行されていません

TeamViewer が正常に実行されていないため、割り当てを実行できません。TeamViewer サービスが実行されていることを確認してください。

402

 (42 under Linux/FreeBSD)

MDv2Assignment - サービス互換性のないバージョン

TeamViewer サービスは、実行された TeamViewer クライアントのバージョンと互換性がありません。インストールが正常に完了しなかったようです。インストールを確認し、必要に応じて TeamViewer を再インストールしてください。

403

 (43 under Linux/FreeBSD)

MDv2Assignment - オンラインではありません

TeamViewer クライアントは、デバイスを割り当てるために TeamViewer クラウドに接続できませんでした。クライアントがオンラインかどうか、インターネット接続が正常に機能しているかどうかを確認して、割り当てを再試行してください。この問題が頻繁に発生する場合は、コマンド ライン インターフェイスの再試行オプションの使用を検討してください。

404

 (44 under Linux/FreeBSD)

MDv2Assignment - すでに実行中

別の割り当てプロセスがすでに実行されています。その割り当てのステータスを確認してください。たとえば、デバイスがManagement Consoleで管理デバイスとしてすでに登録されているかどうかを確認することで、これを実行できます。 

405

 (45 under Linux/FreeBSD)

MDv2Assignment - timeout

割り当ての試行がタイムアウトしました。もう一度お試しください。この問題が頻繁に発生する場合や、モバイル ネットワークなどのネットワークが不安定な場合は、コマンド ライン インターフェイスでタイムアウトを増やすことを検討してください。

406

 (46 under Linux/FreeBSD)

MDv2Assignment - 失敗

不明な理由により割り当てが失敗しました。ログを保存してサポートにお問い合わせください。

407

 (47 under Linux/FreeBSD)

MDv2Assignment - アクセス拒否

割り当てを実行するために必要な権限がありません。ユーザーにローカル管理者権限があることを確認してください。

408

(48 under Linux/FreeBSD)

MDv2Assignment - ポリシーにより拒否

このデバイスで有効な TeamViewer ポリシーにより、既存の割り当て状態を削除できません。Management Consoleでポリシーを無効にしてください。 


注意: 再割り当ては既存の状態を削除するため、再割り当ても拒否されます。

割り当ての更新/上書き方法

すでに割り当てられたデバイスがあり、再度コマンドラインから割り当てを実行すると、デバイスの割り当ては新しいもので上書きされます。上書きは古い割り当てが削除されることを意味し、すでに割り当てられた管理者やポリシーは失われます。

注意: TeamViewer ポリシーの「アカウント割り当ての削除を防止」は、すでに割り当てられているデバイスへの新しい割り当てを防止するものです。