Learn how to install, update, and uninstall TeamViewer Host or TeamViewer Full in a mass deployment scenario on macOS. Please ensure you have a basic understanding and knowledge of command-line installations on macOS, as it will be required to complete this process.
Required installer:
Steps:
Enter the following command into the terminal:
sudo installer -pkg "TeamViewer_Host.pkg" -target /
The parameter -target defines the path where you want your installation to be located.
Required installer:
Steps:
1) Create an XML file called (e.g.: choices.xml) and enter the following content:
<?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>
2) (Optional) verify if your configuration will be applied correctly
installer -showChoicesAfterApplyingChangesXML newChoices.xml -pkg Install\ TeamViewer_Host.pkg -target /
<?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>
Apply the configuration during the installation by adding the parameter "-applyChoiceChangesXML <your_filename>.xml"
sudo installer -applyChoiceChangesXML choices.xml -pkg Install TeamViewer_Host.pkg -target /
3) If you have an MDM system, you can use Privacy Preferences Policy Control (PPPC) payloads 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 ScreenCapture PPPC payload with AllowStandardUserToSetSystemService to allow non-admin users to grant this permission.
An example for an MDM configuration using Mobile Iron to roll out Accessibility access can be found here:
📄 MobileIron Integration - Add TeamViewer apps to macOS Mojave accessibility
Required installer:
Steps:
Summary of parameters
Required installer:
Steps:
1) Create an XML file called (e.g.: choices.xml) and enter the following content:
<?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>
2) (Optional) verify if your configuration will be applied correctly
installer -showChoicesAfterApplyingChangesXML newChoices.xml -pkg "TeamViewer_Host-idc<ConfigurationID>.pkg" -target /
<?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>
Apply the configuration during the installation by adding the parameter "-applyChoiceChangesXML <your_filename>.xml"
sudo installer -applyChoiceChangesXML choices.xml -pkg "TeamViewer_Host-idc<ConfigurationID>.pkg" -target /
3) If you have an MDM system, you can use Privacy Preferences Policy Control (PPPC) payloads 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 ScreenCapture PPPC payload with AllowStandardUserToSetSystemService to allow non-admin users to grant this permission.
An example for an MDM configuration using Mobile Iron to roll out Accessibility access can be found here:
📄 MobileIron Integration - Add TeamViewer apps to macOS Mojave accessibility
Required installer:
Steps:
sudo installer -pkg "TeamViewer_Full.pkg" -target /
The parameter -target defines the path where you want your installation to be located.
🚨 Settings cannot be provided during the installation process on macOS.
Required installer:
Steps:
1) Create an XML file called (e.g.: choices.xml) and enter the following content:
<?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>
2) (Optional) verify if your configuration will be applied correctly
installer -showChoicesAfterApplyingChangesXML newChoices.xml -pkg Install\ TeamViewer_Full.pkg -target /
<?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>
Apply the configuration during the installation by adding the parameter "-applyChoiceChangesXML <your_filename>.xml"
sudo installer -applyChoiceChangesXML choices.xml -pkg Install\ TeamViewer_Full.pkg -target /
3) If you have an MDM system, you can use Privacy Preferences Policy Control (PPPC) payloads 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 ScreenCapture PPPC payload with AllowStandardUserToSetSystemService to allow non-admin users to grant this permission.
An example for an MDM configuration using Mobile Iron to roll out Accessibility access can be found here:
📄 MobileIron Integration - Add TeamViewer apps to macOS Mojave accessibility
Updating TeamViewer corresponds to the steps that are required for an installation:
A reason to uninstall your TeamViewer might be that you want to switch from a TeamViewer Host Client Version to a Full Client Version.
📌Note: You can uninstall your TeamViewer only manually
Recommended way to uninstall TeamViewer:
TeamViewer has been uninstalled.
Prerequisites:
Steps:
Host version:
sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN> -group <GROUP> -alias <COMPUTERNAME> -grant-easy-access
Full version:
sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -api-token <YOUR_APITOKEN>
The following table shows the possible assignment options (they are all optional).
There are some parameters that need a value (–alias MyAlias) or do not need a value (–reassign).
The options need to be added on the command line.