ナレッジベース

割り当てオプション

--alias [<name>] (エイリアス)

コンピュータ＆パートナー内の新しいデバイスのエイリアスです。デバイスがすでにコンピュータ＆パートナーリストにある場合、エイリアスは適用されません。このプロパティは、以下の値を取ることができます。

1. --alias (値なし)
   • コンピュータのエイリアスは、TeamViewer IDになります。
2. --alias hello
   • コンピュータのエイリアスは "hello "になります。
3. パラメータが指定されていないalias
   • このコンピュータのエイリアスは %computername% になります。
4. --alias %systemvariable%.
   • エイリアスは、使用されるシステム変数になります。(例: %username%)

例:

msiexec.exe /i "[Path_To]TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--alias %systemvariable%"

--grant-easy-access

このオプションを設定すると、割り当て後に簡易アクセスが許可されます (TeamViewer (Classic) オプションの [セキュリティ] タブにある [簡易アクセスの許可] オプションと同じです)。

例:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--grant-easy-access"

--reassign

すでにアカウントにデバイスが割り当てられている場合でも、アカウントにデバイスを割り当てます。

例:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--reassign"

🚨重要: --reassignパラメータは、既存の割り当てをリセットし、割り当てスクリプトのパラメータを再適用します。これは、例えば、初期のインストール後にエイリアスまたはグループの割り当てを変更した場合に影響を与える可能性があります。

--group <name>

デバイスを追加するグループの名前です。グループが存在しない場合は、自動的に作成されます。デバイスがすでにコンピュータ＆パートナーリストの別のグループに存在する場合、このパラメーターで定義されたグループには移動されません。 ただし、「--reassign」パラメーターを追加すると、デバイスはこのパラメーターで定義されたグループに移動されます。

例:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--group MyGroup"

💡カスタムhost を使用する場合は、カスタム構成ですでにデフォルトグループが定義されているため、必要ありません。

--group-id <ID>

このオプションは、グループIDが既知の場合、--groupパラメータを使用する代わりに使用することができます。これは、非常に大規模な顧客環境において、割り当て処理を高速化するために 有用です。通常は--groupを使用すれば十分です。

📌注意：IDの前には必ずリテラル "g "を付ける必要があります。

グループIDは、Management Console にログインして、グループをクリックし、URLを確認すると分かります。URLの末尾に「g/12345678」と表示されます。

📌注意：グループIDを取得するために、"/"を削除してください。

例:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--group-id g123"

--proxy <name>:<port>

<name>：<port>の形式のプロキシのURL（割り当てのみ） 例： --proxy yourproxy:3201

例:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypassword"

🚨http:// のないURL

--proxy-user <name>

プロキシに対する認証に使用されるユーザー名（割り当て時のみ）。

例:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypassword"

--proxy-pw <password>

プロキシに対する認証に使用するパスワード(割り当て時のみ)。

例:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypass"

--proxy-pw-base64 <encoded_password>.

--proxy-pwと同じですが、パスワードはBase64でエンコードされた文字列として入力する必要があります。特殊文字を含むパスワードに有効です。

例:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw-base64 bXlwYXNz"

--monitoring-policyid <policy_id>

このオプションは、TeamViewer_Full.msiをインストールする場合にのみ使用できます。割り当てが正常に終了した後に適用されるRemote Management モニタリングのポリシー ID を指定します。これには --patchmanagement-policyid も必要です。

例:

msiexec.exe /i "[Path_To]\TeamViewer_Full.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--monitoring-policyid <YOUR_MONITORING_POLICYID> --patchmanagement-policyid <YOUR_PATCHMANAGEMENT_POLICYID>"

--patchmanagement-policyid <policy_id>

このオプションは、TeamViewer_Full.msiをインストールする場合にのみ使用できます。割り当てが正常に終了した後に適用されるRemote Management モニタリングのポリシー ID を指定します。これには --monitoring-policyid も必要です。

例:

msiexec.exe /i "Path\To\TeamViewer_Full.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--monitoring-policyid <YOUR_MONITORING_POLICYID> --patchmanagement-policyid <YOUR_PATCHMANAGEMENT_POLICYID>"