Mass deployment on macOS - TeamViewer Support
<main> <article class="userContent"> <p><br></p><p>Learn how to install, update, and uninstall TeamViewer Host or TeamViewer Full in a <strong>mass deployment scenario</strong> on <strong>macOS</strong>. Please ensure you have a basic understanding and knowledge of command-line installations on macOS, as it will be required to complete this process.</p><div class="blockquote"><div class="blockquote-content"><p class="blockquote-line"><em>This article applies to </em><a href="https://service.teamviewer.com/en-de/overview" 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 using version 15.x. or newer. Supported macOS versions: 10.14, 10.15, 11, 12, 13</em></p></div></div><p><br></p><h3></h3><h2 data-id="install-the-standard-host-version-of-teamviewer">Install the standard Host version of TeamViewer</h2><p><strong>Required installer:</strong></p><ol><li>TeamViewer_Host.pkg: Download the file in the TeamViewer <a href="https://login.teamviewer.com/nav/deploy" rel="nofollow noreferrer ugc">Management Console</a> under "Design & Deploy" by clicking "Download installer" and choosing "PKG (Host & Full Client for macOS)".</li><li>Unzip the compressed file.</li></ol><p><strong>Steps</strong>:</p><p>Enter the following command into the terminal:</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo installer -pkg "TeamViewer_Host.pkg" -target / </pre><p>The parameter -target defines the path where you want your installation to be located.</p><p><br></p><h3 data-id="-1"></h3><h2 data-id="install-the-standard-host-version-of-teamviewer-silently">Install the standard Host version of TeamViewer silently</h2><p><strong>Required installer: </strong></p><ol><li>TeamViewer_Host.pkg: Download the file in the TeamViewer <a href="https://login.teamviewer.com/nav/deploy" rel="nofollow noreferrer ugc">Management Console</a> under "Design & Deploy" by clicking "Download installer" and choosing "PKG (Host & Full Client for macOS)".</li><li>Unzip the PKG.</li></ol><p><strong>Steps: </strong></p><p>1) Create an XML file called (e.g.: choices.xml) and enter the following content:</p><pre class="code codeBlock" spellcheck="false" tabindex="0"><?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict> <key>attributeSetting</key> <integer>1</integer> <key>choiceAttribute</key> <string>selected</string> <key>choiceIdentifier</key> <string>com.teamviewer.teamviewerhostSilentInstaller</string> </dict> </array> </plist> </pre><p><br></p><p>2) (Optional) verify if your configuration will be applied correctly</p><ul><li>Execute the following command:</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">installer -showChoicesAfterApplyingChangesXML newChoices.xml -pkg Install\ TeamViewer_Host.pkg -target / </pre><ul><li>This will result in an output that should look similar to this:</li></ul><p><br></p><pre class="code codeBlock" spellcheck="false" tabindex="0"><?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict> ... </dict> <dict> ... </dict> <dict> <key>attributeSetting</key> <false/> <key>choiceAttribute</key> <string>visible</string> <key>choiceIdentifier</key> <string>com.teamviewer.teamviewerhostSilentInstaller</string> </dict> <dict> <key>attributeSetting</key> <true/> <key>choiceAttribute</key> <string>enabled</string> <key>choiceIdentifier</key> <string>com.teamviewer.teamviewerhostSilentInstaller</string> </dict> <dict> <key>attributeSetting</key> <integer>1</integer> <key>choiceAttribute</key> <string>selected</string> <key>choiceIdentifier</key> <string>com.teamviewer.teamviewerhostSilentInstaller</string> </dict> </array> </plist> </pre><p>Apply the configuration during the installation by adding the parameter "-applyChoiceChangesXML <your_filename>.xml"</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo installer -applyChoiceChangesXML choices.xml -pkg Install TeamViewer_Host.pkg -target / </pre><p>3) If you have an <strong>MDM system</strong>, you can use <strong>Privacy Preferences Policy Control (PPPC) payloads</strong> to roll out Accessibility and Full Disk Access for TeamViewer in System Preferences ➜ Security & Privacy ➜ Privacy. Your users will still need to grant Screen Recording access themselves. Starting with macOS 11 Big Sur, you will need to use a <strong>ScreenCapture PPPC payload</strong> with <strong>AllowStandardUserToSetSystemService</strong> to allow non-admin users to grant this permission.</p><p>An example for an MDM configuration using Mobile Iron to roll out Accessibility access can be found here:</p><div class="js-embed embedResponsive" data-embedjson="{"body":"This article applies to all TeamViewer customers with a Corporate or Tensor license. This article applies to TeamViewer version 14.3 or newer. This article applies to macOS Mojave and newer (macOS 10.14+) Introduction This article explains how you can deploy TeamViewer in a mass deployment scenario to macOS Mojave by…","url":"https:\/\/community.teamviewer.com\/English\/kb\/articles\/63927-add-teamviewer-apps-to-macos-mojave-accessibility-with-mobile-iron","embedType":"link","name":"Add TeamViewer apps to macOS Mojave accessibility with Mobile Iron - TeamViewer Support"}"> <a href="https://community.teamviewer.com/English/kb/articles/63927-add-teamviewer-apps-to-macos-mojave-accessibility-with-mobile-iron" rel="nofollow noreferrer ugc"> https://community.teamviewer.com/English/kb/articles/63927-add-teamviewer-apps-to-macos-mojave-accessibility-with-mobile-iron </a> </div><p><br></p><h3 data-id="-2"></h3><h2 data-id="install-the-customized-host-version-of-teamviewer">Install the customized Host version of TeamViewer</h2><p><strong>Required installer</strong>:</p><ol><li>TeamViewer_Host.pkg: Download the file in the TeamViewer <a href="https://login.teamviewer.com/nav/deploy" rel="nofollow noreferrer ugc">Management Console</a> under "Design & Deploy" by clicking "Download installer" and choosing "PKG (Host & Full Client for macOS)".</li><li>Unzip the PKG.</li></ol><p><strong>Steps</strong>:</p><ol><li>Create a new customization or open an existing one (See <a href="https://community.teamviewer.com/English/kb/articles/3965-teamviewer-host-setup#customized-host" rel="nofollow noreferrer ugc">How to customize your Host</a> for details)</li><li>Copy the ConfigurationID from your customized Host.</li><li>Open the terminal or execute the pkg via a script.</li><li>Add the ConfigurationID to the filename in the command line:<ul><li>sudo installer -pkg "TeamViewer_Host-idc<ConfigurationID>.pkg" -target /</li></ul></li></ol><p>Summary of parameters</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/YOP5A89WT8ER/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/YOP5A89WT8ER/image.png" alt="image.png" height="93" width="790" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><h3 data-id="-3"></h3><h2 data-id="install-the-customized-host-version-of-teamviewer-silently">Install the customized Host version of TeamViewer silently</h2><p><strong>Required installer</strong>: </p><ol><li>TeamViewer_Host.pkg: Download the file in the TeamViewer <a href="https://login.teamviewer.com/nav/deploy" rel="nofollow noreferrer ugc">Management Console</a> under "Design & Deploy" by clicking "Download installer" and choosing "PKG (Host & Full Client for macOS)".</li><li>Unzip the PKG.</li></ol><p><strong>Steps</strong>: </p><p>1) Create an XML file called (e.g.: choices.xml) and enter the following content:</p><pre class="code codeBlock" spellcheck="false" tabindex="0"><?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict> <key>attributeSetting</key> <integer>1</integer> <key>choiceAttribute</key> <string>selected</string> <key>choiceIdentifier</key> <string>com.teamviewer.teamviewerhostSilentInstaller</string> </dict> </array> </plist> </pre><p><br></p><p>2) (Optional) verify if your configuration will be applied correctly </p><ul><li>execute the following command:</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">installer -showChoicesAfterApplyingChangesXML newChoices.xml -pkg "TeamViewer_Host-idc<ConfigurationID>.pkg" -target / </pre><ul><li>This will result in an output that should look similar to this: </li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0"><?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict> ... </dict> <dict> ... </dict> <dict> <key>attributeSetting</key> <false/> <key>choiceAttribute</key> <string>visible</string> <key>choiceIdentifier</key> <string>com.teamviewer.teamviewerhostSilentInstaller</string> </dict> <dict> <key>attributeSetting</key> <true/> <key>choiceAttribute</key> <string>enabled</string> <key>choiceIdentifier</key> <string>com.teamviewer.teamviewerhostSilentInstaller</string> </dict> <dict> <key>attributeSetting</key> <integer>1</integer> <key>choiceAttribute</key> <string>selected</string> <key>choiceIdentifier</key> <string>com.teamviewer.teamviewerhostSilentInstaller</string> </dict> </array> </plist> </pre><p>Apply the configuration during the installation by adding the parameter "-applyChoiceChangesXML <your_filename>.xml"</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo installer -applyChoiceChangesXML choices.xml -pkg "TeamViewer_Host-idc<ConfigurationID>.pkg" -target / </pre><p>3) If you have an <strong>MDM system</strong>, you can use <strong>Privacy Preferences Policy Control (PPPC) payloads</strong> to roll out Accessibility and Full Disk Access for TeamViewer in System Preferences ➜ Security & Privacy ➜ Privacy. Your users will still need to grant Screen Recording access themselves. Starting with macOS 11 Big Sur, you will need to use a <strong>ScreenCapture PPPC payload</strong> with <strong>AllowStandardUserToSetSystemService</strong> to allow non-admin users to grant this permission.</p><p>An example for an MDM configuration using Mobile Iron to roll out Accessibility access can be found here:</p><div class="js-embed embedResponsive" data-embedjson="{"body":"This article applies to all TeamViewer customers with a Corporate or Tensor license. This article applies to TeamViewer version 14.3 or newer. This article applies to macOS Mojave and newer (macOS 10.14+) Introduction This article explains how you can deploy TeamViewer in a mass deployment scenario to macOS Mojave by…","url":"https:\/\/community.teamviewer.com\/English\/kb\/articles\/63927-add-teamviewer-apps-to-macos-mojave-accessibility-with-mobile-iron","embedType":"link","name":"Add TeamViewer apps to macOS Mojave accessibility with Mobile Iron - TeamViewer Support"}"> <a href="https://community.teamviewer.com/English/kb/articles/63927-add-teamviewer-apps-to-macos-mojave-accessibility-with-mobile-iron" rel="nofollow noreferrer ugc"> https://community.teamviewer.com/English/kb/articles/63927-add-teamviewer-apps-to-macos-mojave-accessibility-with-mobile-iron </a> </div><p><br></p><h3 data-id="-4"></h3><h2 data-id="install-the-standard-version-of-teamviewer">Install the standard version of TeamViewer</h2><p><strong>Required installer: </strong></p><ol><li>TeamViewer_Full.pkg: Download the file in the TeamViewer <a href="https://login.teamviewer.com/nav/deploy" rel="nofollow noreferrer ugc">Management Console</a> under "Design & Deploy" by clicking "Download installer" and choosing "PKG (Host & Full Client for macOS)".</li><li>Unzip the PKG.</li></ol><p><strong>Steps</strong>:</p><ol><li> Open the terminal or execute pkg via a script.</li><li> Type the following command into the terminal</li></ol><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo installer -pkg "TeamViewer_Full.pkg" -target / </pre><p>The parameter -target defines the path where you want your installation to be located.</p><p>⚠Settings cannot be provided during the installation process on macOS.</p><p><br></p><h3 data-id="-5"></h3><h2 data-id="install-the-standard-version-of-teamviewer-silently">Install the standard version of TeamViewer silently</h2><p><strong>Required installer</strong>: </p><ol><li>TeamViewer_Full.pkg: Download the file in the TeamViewer <a href="https://login.teamviewer.com/nav/deploy" rel="nofollow noreferrer ugc">Management Console</a> under "Design & Deploy" by clicking "Download installer" and choosing "PKG (Host & Full Client for macOS)".</li><li>Unzip the PKG.</li></ol><p><strong>Steps</strong>:</p><p> 1) Create an XML file called (e.g.: choices.xml) and enter the following content:</p><pre class="code codeBlock" spellcheck="false" tabindex="0"><?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict> <key>attributeSetting</key> <integer>1</integer> <key>choiceAttribute</key> <string>selected</string> <key>choiceIdentifier</key> <string>com.teamviewer.teamviewerSilentInstaller</string> </dict> </array> </plist> </pre><p><br></p><p>2) (Optional) verify if your configuration will be applied correctly </p><ul><li>Execute the following command:</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">installer -showChoicesAfterApplyingChangesXML newChoices.xml -pkg Install\ TeamViewer_Full.pkg -target / </pre><ul><li>This will result in an output that should look similar to this:</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0"><?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict> ... </dict> <dict> ... </dict> <dict> <key>attributeSetting</key> <false/> <key>choiceAttribute</key> <string>visible</string> <key>choiceIdentifier</key> <string>com.teamviewer.teamviewerSilentInstaller</string> </dict> <dict> <key>attributeSetting</key> <true/> <key>choiceAttribute</key> <string>enabled</string> <key>choiceIdentifier</key> <string>com.teamviewer.teamviewerSilentInstaller</string> </dict> <dict> <key>attributeSetting</key> <integer>1</integer> <key>choiceAttribute</key> <string>selected</string> <key>choiceIdentifier</key> <string>com.teamviewer.teamviewerSilentInstaller</string> </dict> </array> </plist> </pre><p>Apply the configuration during the installation by adding the parameter "-applyChoiceChangesXML <your_filename>.xml"</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo installer -applyChoiceChangesXML choices.xml -pkg Install\ TeamViewer_Full.pkg -target / </pre><p> 3) If you have an <strong>MDM system</strong>, you can use <strong>Privacy Preferences Policy Control (PPPC) payloads</strong> to roll out Accessibility and Full Disk Access for TeamViewer in System Preferences ➜ Security & Privacy ➜ Privacy. Your users will still need to grant Screen Recording access themselves. Starting with macOS 11 Big Sur, you will need to use a <strong>ScreenCapture PPPC payload</strong> with <strong>AllowStandardUserToSetSystemService</strong> to allow non-admin users to grant this permission.</p><p>An example for an MDM configuration using Mobile Iron to roll out Accessibility access can be found here:</p><div class="js-embed embedResponsive" data-embedjson="{"body":"This article applies to all TeamViewer customers with a Corporate or Tensor license. This article applies to TeamViewer version 14.3 or newer. This article applies to macOS Mojave and newer (macOS 10.14+) Introduction This article explains how you can deploy TeamViewer in a mass deployment scenario to macOS Mojave by…","url":"https:\/\/community.teamviewer.com\/English\/kb\/articles\/63927-add-teamviewer-apps-to-macos-mojave-accessibility-with-mobile-iron","embedType":"link","name":"Add TeamViewer apps to macOS Mojave accessibility with Mobile Iron - TeamViewer Support"}"> <a href="https://community.teamviewer.com/English/kb/articles/63927-add-teamviewer-apps-to-macos-mojave-accessibility-with-mobile-iron" rel="nofollow noreferrer ugc"> https://community.teamviewer.com/English/kb/articles/63927-add-teamviewer-apps-to-macos-mojave-accessibility-with-mobile-iron </a> </div><p><br></p><h3 data-id="-6"></h3><h2 data-id="update-a-teamviewer-installation">Update a TeamViewer installation </h2><p>Updating TeamViewer corresponds to the steps that are required for an installation:</p><ul><li>Install the Standard Host Client Version of Teamviewer </li><li>Install the Customized Host Client Version of Teamviewer </li><li>Install the Standard Full Client Version of TeamViewer </li></ul><p><br></p><h3 data-id="-7"></h3><h2 data-id="uninstall-teamviewer">Uninstall TeamViewer </h2><p>A reason to uninstall your TeamViewer might be that you want to switch from a TeamViewer Host Client Version to a Full Client Version. </p><p>📌<strong>Note: </strong>You can uninstall your TeamViewer only manually</p><p>Recommended way to uninstall TeamViewer: </p><ol><li>Start the TeamViewer application.</li><li>Open TeamViewer ➜ Preferences ➜ Advanced.</li><li>Scroll down till <strong>Uninstall</strong>.</li><li>(Optional) check the box for <strong>Delete configuration files</strong>.</li><li>Click <strong>Uninstall</strong>.</li><li>Click <strong>OK</strong> when asked for confirmation.</li></ol><p> TeamViewer has been uninstalled.</p><p><br></p><h3 data-id="-8"></h3><h2 data-id="perform-an-assignment">Perform an assignment </h2><p><strong>Prerequisites:</strong></p><ul><li>TeamViewer is already installed. </li><li>The option <strong>Start with system</strong> is enabled. </li><li>TeamViewer service is running! </li><li>The assignment tool together with the application is installed under <ul><li>/Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment </li><li>(/Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment). </li></ul></li></ul><p><strong>Steps: </strong></p><ul><li>Run the assignment tool with sudo privileges on all devices that should be assigned. In order to do this in a mass deployment scenario, we advice you to use a script to call the assignment tool with the required parameters.</li></ul><p><em>Host version:</em></p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -group <GROUP> -alias <COMPUTERNAME> -grant-easy-access </pre><p><em>Full version:</em></p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> </pre><ul><li>The device is assigned to the account that created the Custom TeamViewer Host module. </li><li>Easy Access is (optionally) activated for the device. </li></ul><p><br></p><h3 data-id="assignment-options"><strong>Assignment options</strong></h3><p>The following table shows the possible assignment options (they are all optional). </p><p>There are some parameters that need a value (–alias MyAlias) or do not need a value (–reassign). </p><p>The options need to be added on the command line.</p><ul><li>If you have parameter values with blanks (e.g. for the group name) use "<GROUP_NAME_WITH_BLANK>".</li><li>sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -group "My Group" -alias "$ALIAS" </li><li>Parameter names are case sensitive</li><li>Proxy settings can be specified for the assignment within the ASSIGNMENTOPTIONS. There are additional proxy settings for the TeamViewer connection itself (as defined in the TeamViewer client options). These have to be set outside of the ASSIGNMENTOPTIONS. </li><li>You can also insert environment variables to your commands for installation/assignment to add dynamic values, e.g. for the alias. You can use environment variables by using $-notation. The following characters should not be contained in the variable values: $, @, `, ´ and variables should always be used within quotes. <ol><li><strong>Example</strong>: <ol><li>export GROUP="MyGroup" </li><li>export ALIAS="MyDevicename"</li><li> sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -group "$GROUP" -alias "$ALIAS"</li></ol></li></ol></li></ul><p> </p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/CRQGN2F5KBNJ/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/CRQGN2F5KBNJ/image.png" alt="image.png" height="838" width="1694" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/HRVOYCLQJHR5/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/HRVOYCLQJHR5/image.png" alt="image.png" height="198" width="1694" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><h3 data-id="-9"></h3><h2 data-id="for-you-to-copypaste">For you to copy/paste</h2><p><strong>Option</strong></p><p><strong>Description</strong></p><p>-api-token <YOUR_APITOKEN></p><p>API Token in order to do the assignment to the correct account</p><p>-alias [<name>]</p><p>Alias for the new device in the computers & contacts list. If the device is already in the contact list, no alias will be applied. The parameter can take the following values:</p><ul><li>-alias (without value) → alias of the computer will be the teamviewerID </li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -alias -group MyGroup </pre><ul><li>-alias hallo → alias of the computer will be "hello"</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -alias hello -group MyGroup </pre><ul><li>alias parameter not specified → alias of this computer will be %computername%</li></ul><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -group MyGroup </pre><p><br></p><p>-grant-easy-access</p><p>If you set this option, easy access is granted after the assignment (same as the "Grant easy access" option in the TeamViewer main window).</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -grant-easy-access -group MyGroup </pre><p><br></p><p>-reassign</p><p>Assigns the device to the account even if the device is already assigned to an account.</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -reassign -group MyGroup </pre><p><br></p><p>-group <name></p><p>Name of the group to which the device will be added.</p><p>When the group doesn't exist, it will be automatically created.</p><p>If the device is already in the computers & contacts list in a different group, it won't be moved to the group.</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -group MyGroup </pre><p>Only required if no custom host is used, as a default group is already defined in the custom configuration.</p><p><br></p><p>-group-id <ID></p><p>This option is an alternative to using the --group parameter if the group's id is known.</p><p>This might be useful in large customer environments as it speeds up the assignment process. Usually, using --group is sufficient.</p><p>Note that the ID must be prepended with a literal "g".</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -group-id g123 </pre><p><br></p><p>-wait <seconds></p><p>With this parameter, the waiting time for the assignment can be specified in seconds. The default value of 30 (secs) should usually be sufficient.</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -wait 45 -group MyGroup </pre><p><br></p><p>-proxy <name>:<port></p><p>URL of your proxy (only for the assignment) in the format <name>:<port>, e. g. --proxy yourproxy:3201</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -proxy yourproxy:3201 -proxy-user FooBar -proxy-pw mypass -group MyGroup </pre><p>⚠ <strong>Warning</strong>: URL without http://</p><p><br></p><p>-proxy-user <name></p><p>Username which is used for authentication against the proxy (only for the assignment).</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -proxy yourproxy:3201 -proxy-user FooBar -proxy-pw mypass -group MyGroup </pre><p><br></p><p>-proxy-pw <password></p><p>Password which is used for authentication against the proxy (only for the assignment).</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -proxy yourproxy:3201 -proxy-user FooBar -proxy-pw mypass -group MyGroup </pre><p><br></p><p>-proxy-pw-base64 <encoded_password></p><p>Same as --proxy-pw, but the password needs to be entered as a Base64 encoded string. Useful for passwords with special characters.</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -proxy yourproxy:3201 -proxy-user FooBar -proxy-pw-base64 bXlwYXNz -group MyGroup </pre><p> </p> </article> </main>
