Assignment options - 5/6 (Legacy) - TeamViewer Support
<main> <article class="userContent"> <p><br></p><p>Before deploying TeamViewer on your devices, it is important to choose which <strong>assignment options</strong> you want to apply to your deployment.</p><p>You can define a large range of parameters for your deployment via the assignment options. Below are all the assignment options you can use and their respective actions.</p><div class="blockquote"><div class="blockquote-content"><p class="blockquote-line"><em>This article applies to </em><a href="unsafe:about:blank" rel="nofollow noreferrer ugc"><em>Corporate</em></a><em> and </em><a href="https://www.teamviewer.com/teamviewer-tensor/" rel="nofollow noreferrer ugc"><em>Tensor</em></a><em> license holders who want to deploy TeamViewer (14 or newer) on their Windows devices.</em></p></div></div><p><br></p><h3></h3><h2 data-id="assignment-options">Assignment options</h2><p><br></p><h4 data-id="-alias-name">--alias [<name>]</h4><p>Alias for the new device in the computers & contacts list. No alias will be applied if the device is already in the contact list. The property can take the following values:</p><ol><li>--alias (without value)<ul><li>alias of the computer will be the TeamViewer ID</li></ul></li><li>--alias hello<ul><li>alias of the computer will be "hello"</li></ul></li><li>Alias parameter not specified<ul><li> alias of this computer will be %computername%</li></ul></li><li>--alias %systemvariable%<ul><li>alias will be the used system variable e.g. %username%</li></ul></li></ol><p>Example:</p><pre class="code codeBlock" spellcheck="false" tabindex="0">msiexec.exe /i "[Path_To]TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--alias %systemvariable%" </pre><p><br></p><h4 data-id="-grant-easy-access">--grant-easy-access</h4><p>If you set this option, easy access is granted after the assignment (same as the "Grant easy access" option in the Security tab of the TeamViewer options).</p><p>Example:</p><pre class="code codeBlock" spellcheck="false" tabindex="0">msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--grant-easy-access" </pre><p><br></p><h4 data-id="-reassign">--reassign</h4><p>Assigns the device to the account even if the device is already assigned to an account.</p><p>Example:</p><pre class="code codeBlock" spellcheck="false" tabindex="0">msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--reassign" </pre><p>⚠ <strong>Important:</strong> The --reassign parameter resets the existing assignment and reapplies the parameters of the assignment script. This can have an impact if, for example, you change the alias or group assignment after the initial installation.</p><p><br></p><h4 data-id="-group-name">--group <name></h4><p>Name of the group to which the device will be added. If the group does not exist, it will be created automatically. If the device is already present in the list of computers and contacts of a different group, it will not be moved to the group defined in this parameter. However, if you also add the "--reassign" parameter, the device will be moved to the group defined in this parameter.</p><p>Example:</p><pre class="code codeBlock" spellcheck="false" tabindex="0">msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--group MyGroup" </pre><p>💡Not required if a custom host is used, as there is already a default group defined in the custom configuration.</p><p><br></p><h4 data-id="-group-id-id">--group-id <ID></h4><p>This option is an alternative to use the --group parameter if the id of the group is known. This might be useful in very large customer environments as it speeds up the assignment process. Usually using --group is sufficient.</p><p><strong>📌Note:</strong> The ID must be prepended with a literal "g".</p><p>You can find the group-id when logging into the Management Console, clicking on the group and checking the URL. At the end of the URL you will find "g/12345678".</p><p><strong>📌Note:</strong> Please remove the "/" in order to get your group-id.</p><p>Example:</p><pre class="code codeBlock" spellcheck="false" tabindex="0">msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--group-id g123" </pre><p><br></p><h4 data-id="-proxy-name%3Aport">--proxy <name>:<port></h4><p>Url of your proxy (only for the assignment) in the format <name>:<port>, e. g. --proxy yourproxy:3201</p><p>Example:</p><pre class="code codeBlock" spellcheck="false" tabindex="0">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" </pre><p>⚠<strong>URL without http://</strong></p><p><br></p><h4 data-id="-proxy-user-name">--proxy-user <name></h4><p>Username which is used for authentication against the proxy (only for the assignment).</p><p>Example:</p><pre class="code codeBlock" spellcheck="false" tabindex="0">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" </pre><p><br></p><h4 data-id="-proxy-pw-password">--proxy-pw <password></h4><p>Password which is used for authentication against the proxy (only for the assignment).</p><p>Example:</p><pre class="code codeBlock" spellcheck="false" tabindex="0">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" </pre><p><br></p><h4 data-id="-proxy-pw-base64-encoded_password">--proxy-pw-base64 <encoded_password></h4><p>Same as --proxy-pw, but the password needs to be entered as a Base64 encoded string. Useful for passwords with special characters.</p><p>Example:</p><pre class="code codeBlock" spellcheck="false" tabindex="0">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" </pre><p><br></p><h4 data-id="-monitoring-policyid-policy_id">--monitoring-policyid <policy_id></h4><p>This option is only available when installing TeamViewer_Full.msi. It specifies the policy id for Remote Management Monitoring that should be applied after the assignment has successfully been finished. This also requires --patchmanagement-policyid.</p><p>Example:</p><pre class="code codeBlock" spellcheck="false" tabindex="0">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>" </pre><p><br></p><h4 data-id="-patchmanagement-policyid-policy_id">--patchmanagement-policyid <policy_id></h4><p>This option is only available when installing TeamViewer_Full.msi. It specifies the policy id for Remote Management Monitoring that should be applied after the assignment has successfully been finished. This also requires --monitoring-policyid.</p><p>Example:</p><pre class="code codeBlock" spellcheck="false" tabindex="0">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>" </pre> </article> </main>
