Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ikkxeer/psteamviewer
Graphic interface to facilitate the installation and automation of TeamViewer
https://github.com/ikkxeer/psteamviewer
automation installation powershell powershell-script teamviewer
Last synced: 28 days ago
JSON representation
Graphic interface to facilitate the installation and automation of TeamViewer
- Host: GitHub
- URL: https://github.com/ikkxeer/psteamviewer
- Owner: ikkxeer
- License: mit
- Created: 2024-07-31T10:19:49.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-08-01T07:15:13.000Z (3 months ago)
- Last Synced: 2024-10-11T20:41:26.743Z (28 days ago)
- Topics: automation, installation, powershell, powershell-script, teamviewer
- Language: PowerShell
- Homepage:
- Size: 37.1 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
PSTeamViewer
PSTeamViewer provides a graphical interface to install, uninstall and configure TeamViewer on Windows. It allows installation from a URL, a local file, and facilitates the assignment of IDs and the creation of shortcuts.
## Description
This PowerShell script provides a graphical user interface (GUI) to install, uninstall and configure TeamViewer on Windows systems. The basic characteristics of this are:
- Download and install TeamViewer from a URL.
- Install TeamViewer from a local file.
- Uninstall TeamViewer.
- Create a shortcut on the desktop.
- Assign a TeamViewer ID.
- Custom Config ID
- Device Alias
- Outlook Plugin
- Configuration File
## Functionalities
- **Download and Install from URL**: Allows you to enter a download URL to obtain the TeamViewer installer and proceed with the installation.
- **Install from Local File**: Allows you to select a local file (executables `.exe` or `.msi`) to install TeamViewer.
- **Uninstall TeamViewer**: Remove TeamViewer and clean associated files and registry entries.
- **Create Shortcut**: Offers the option of creating a TeamViewer shortcut on the desktop.
- **Assign ID**: Allows you to assign an ID to the TeamViewer installation.
- **Custom Config ID**: Allows you to use a Custom Config ID to the TeamViewer installation.
- **Device Alias**: Specify device name when assigning, otherwise the computer's hostname will be automatically entered.
- **Enable Outlook Plugin**: Enable or Disable Outlook Plugin.
- **Configuration File**: Allows you to use a .tvopt file to configure the installation.
## Requirements
- Windows 7 or higher.
- PowerShell 5.1 or higher.
## How to use
1. **Download the Repository and extract it on a folder**
```powershell
Start-BitsTransfer -source "https://github.com/ikkxeer/PSTeamViewer/archive/refs/heads/main.zip" -Destination "PSTeamViewer.zip"
```
3. **Run the Script**
Open PowerShell with **Administrator Privileges** and navigate to the cloned repository folder:
```powershell
cd path/to/repository
```
3. run the script with a Powershell Terminal:
```powershell
.\TeamViewerInstaller.ps1
```
## Interaction with the GUI
### Download and Install from URL
1. Click on the **"Download and Install by URL"** button.
2. Enter the TeamViewer installer URL in the dialog box that appears.
3. The script will download the `.exe` file from the provided URL and proceed with the silent installation.
### Install from Local Archive
1. Click the **"Download and Install by Local File"** button.
2. Select a local `.exe` or `.msi` file from the dialog box.
3. The script will install the selected file.
### Uninstall TeamViewer
1. Click the **"Uninstall TeamViewer"** button.
2. The script will uninstall TeamViewer from your system, stopping associated services and deleting files and registry entries.
### Create Direct Access
1. Check the box **"Create a desktop shortcut"** if you want to create a shortcut on the desktop after installation.
2. If you do not check the box, the shortcut will not be created.
### Assign ID
1. Enter the assignment ID in the **"Assignment ID"** text field.
2. Click on the **"Assign"** button.
3. The script will assign the TeamViewer ID to the current installation.
### CustomConfig ID
1. Enter the Custom Config ID in the **"CustomConfig ID"** text field.
2. Click on the **"Download and Install by Local File"** button.
3. Then when you install it will use this custom config id to configure the installation.
### Device Alias
1. Enter the Device Alias in the **"Device Alias"** text field.
2. Click on the **"Assign"** button.
3. Then, your device will be assigned to the id you entered with the name you indicated in Device Alias, if it is blank, the hostname will be used
### Enable Outlook Plugin
1. Enable or Disable the checkbox
2. Click on the **"Download and Install by Local File"** button.
3. It depends on your status, it will enable or not enable the Outlook Plugin
### Select Configuration File
1. Select the .tvopt configuration file
2. Click on the **"Download and Install by Local File"** button.
3. This will configure TeamViewer with the settings specified in the file.
## Example Image of the GUI
## Common Issues
- AccessDenied
- Execute the script with **Administrator Privileges**
- .MSI File is not installing
- Make sure you have **Administrator Permissions** and that the .msi file is valid
## Future improvements
- [x] Device Alias assigning ✅
- [ ] Install Security Key Redirection option
- [ ] View path of .tvopt file when selected
- [ ] Reassing optional with timeout
- [ ] Assign Device while installing option
- [ ] Export/Import Configuration
- [ ] Final installation report
- [ ] Remote Installation with parameters
## License
This project is licensed under the MIT License. Consult the file [LICENSE](LICENSE) for more details.
## Author
This script was authored by ``Ikkxeer``
For any inquiries or issues, please contact @ikkxeer
## Contributing
Contributions to enhance the script or address issues are welcome. Please open a GitHub issue or submit a pull request.