En matière de gestion informatique, il est essentiel d’assurer la continuité et la fonctionnalité des services essentiels. TeamViewer, un outil d’assistance à distance très utilisé, doit souvent être opérationnel à tout moment. Cependant, les services peuvent parfois être interrompus, ce qui nécessite d’agir rapidement pour les rétablir. Cet article présente un script PowerShell conçu pour redémarrer et gérer le service TeamViewer, afin de garantir un temps d’arrêt minimal et une productivité maximale.
Contexte
Les scripts PowerShell sont des outils inestimables pour les professionnels de l’informatique et les fournisseurs de services gérés (MSP). Ils automatisent les tâches de routine, renforcent la consistance et réduisent le risque d’erreurs humaines. Le script dont nous parlons aujourd’hui concerne le service TeamViewer.
Compte tenu de son rôle dans l’assistance à distance, tout temps d’arrêt peut avoir un impact significatif sur la prestation de services. Ce script ne se contente pas de redémarrer le service TeamViewer, il inclut également des mécanismes permettant de le réactiver s’il a été désactivé, ce qui en fait un outil polyvalent dans l’arsenal d’un professionnel de l’informatique.
Le script PowerShell :
#Requires -Version 5.1
<#
.SYNOPSIS
Restarts the TeamViewer Service. Use "Set to Automatic" if the service was disabled.
.DESCRIPTION
Restarts the TeamViewer Service. Use "Set to Automatic" if the service was disabled.
.EXAMPLE
(No Parameters)
Status Name DisplayName
------ ---- -----------
Running TeamViewer TeamViewer
Attempt 1 has completed!
TeamViewer has restarted successfully!
PARAMETER: -Enable
Re-Enables disabled TeamViewer services.
PARAMETER: -Attempts "7"
Overrides the number of attempts the script will make to restart the service. Simply replace 7 with your desired number of attempts.
PARAMETER: -WaitTimeInSecs "30"
Overrides the amount of time in between attempts. Defaults to 15.
.NOTES
Minimum OS Architecture Supported: Windows 10, Server 2016
Release Notes: Initial release
By using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https://www.ninjaone.com/terms-of-use.
Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms.
Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party.
Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider.
Warranty Disclaimer: The script is provided “as is” and “as available”, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations.
Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks.
Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script.
EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).
#>
[CmdletBinding()]
param (
[Parameter()]
[Switch]$Enable = [System.Convert]::ToBoolean($env:setToAutomatic),
[Parameter()]
[int]$Attempts = 3,
[Parameter()]
[int]$WaitTimeInSecs = 15
)
begin {
if ($env:attempts -and $env:attempts -notlike "null") { $Attempts = $env:attempts }
if ($env:waitTimeInSeconds -and $env:waitTimeInSeconds -notlike "null") { $WaitTimeInSecs = $env:waitTimeInSeconds }
function Test-IsElevated {
$id = [System.Security.Principal.WindowsIdentity]::GetCurrent()
$p = New-Object System.Security.Principal.WindowsPrincipal($id)
$p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator)
}
# Grabs initial set of services to try once.
$ServiceList = Get-CimInstance -ClassName "win32_service"
# Attempts to find the TeamViewer service using its executable name.
function Find-Service {
[CmdletBinding()]
param(
[Parameter(ValueFromPipeline)]
[String]$Name
)
process {
$ServiceList | Where-Object { $_.PathName -Like "*$Name.exe*" }
}
}
# Tests if the service was successful
function Test-Service {
[CmdletBinding()]
param(
[Parameter(ValueFromPipeline)]
[String]$Name
)
process {
$Running = Get-Service $Name | Where-Object { $_.Status -eq $Running }
if ($Running) {
return $True
}
else {
return $False
}
}
}
# Name of each TeamViewer exe.
$ProcessName = "TeamViewer", "TeamViewer_Service", "tv_w32", "tv_x64"
}
process {
if (-not (Test-IsElevated)) {
Write-Host "[Error] Access Denied. Please run with Administrator privileges."
exit 1
}
# List of services to try
$Services = $ProcessName | Find-Service
# If no TeamViewer service is found
if (-not $Services) {
Write-Host "[Error] TeamViewer appears to be missing its service. You will need to reinstall it."
exit 1
}
# Loops through each service and attempts to start them
foreach ($Service in $Services) {
$Failed = $True
$Attempt = 1
While ($Attempt -le $Attempts -and $Failed -eq $True) {
# If the service was disabled, check if -Enable was specified.
if ($Service.StartMode -ne "Auto" -and $Enable) {
# If so re-enable it.
$Service | Get-Service | Set-Service -StartupType "Automatic"
}
elseif ($Service.StartMode -ne "Auto") {
Write-Host "[Error] The service is not set to start automatically. Use 'Set To Automatic' to change the startup type to automatic."
if($Service.StartMode -eq "Disabled"){ exit 1 }
}
# All possible service states
Switch ($Service.State) {
"Running" { $Service | Get-Service | Restart-Service -PassThru }
"Paused" { $Service | Get-Service | Resume-Service -PassThru }
"Pending" {
$Service | Get-Service | Stop-Service
Start-Sleep -Seconds 2 # Ensure the service has time to stop
$Service | Get-Service | Start-Service -PassThru
}
"Stopped" { $Service | Get-Service | Start-Service -PassThru }
}
Start-Sleep -Seconds $WaitTimeInSecs
# Feedback on the number of attempts made. Multiple attempts may indicate that TeamViewer needs to be reinstalled.
Write-Host "Attempt $Attempt completed."
$Attempt++
$Failed = $Service.Name | Test-Service
}
}
$Failed = $Services | Get-Service | Where-Object { $_.Status -ne "Running" }
if ($Failed) {
Write-Host "[Error] Unable to start the service!"
exit 1
}
else {
Write-Host "TeamViewer has restarted successfully!"
exit 0
}
}
end {
}
Description détaillée
La fonction principale du script est de redémarrer le service TeamViewer, avec des fonctionnalités supplémentaires pour configurer le service afin qu’il démarre automatiquement s’il est désactivé et pour personnaliser le nombre de tentatives de redémarrage et les périodes d’attente entre les tentatives.
Composants clés
1. Paramètres et initialisation
Le script commence par définir les paramètres suivants : $Enable, $Attempts et $WaitTimeInSecs. Ces paramètres permettent de personnaliser le script et de l’adapter à différents scénarios.
2. Contrôle de l’élévation
Le script comprend une fonction permettant de vérifier s’il est exécuté avec des droits d’administrateur, ce qui est nécessaire pour les tâches de gestion des services.
3. Découverte des services
Il récupère une liste de tous les services et les filtre pour trouver ceux qui sont liés à TeamViewer.
4. Contrôle de l’état des services
Une autre fonction vérifie si le service spécifié est en cours d’exécution.
5. Boucle de gestion des services
La boucle tente de redémarrer le service TeamViewer jusqu’au nombre de tentatives spécifié, en faisant une pause entre les tentatives.
Cas d’utilisation potentiels
Considérons un scénario d’assistance informatique dans lequel les services TeamViewer sur une machine distante s’arrêtent de manière inattendue. Un professionnel de l’informatique peut utiliser ce script pour redémarrer le service à distance, garantissant ainsi une interruption minimale des opérations de support. Par exemple, lors d’une session d’assistance critique, si le service s’arrête, le script peut être exécuté pour le remettre en ligne sans nécessiter d’intervention manuelle.
Comparaisons
Ce script offre une approche simplifiée par rapport aux redémarrages manuels ou à l’utilisation d’autres outils tels que Windows Service Manager. Tandis que cette dernière méthode nécessite des vérifications manuelles et des redémarrages, ce script automatise le processus, garantissant ainsi des résolutions cohérentes et rapides.
FAQ
Q : Que se passe-t-il si le service est désactivé ?
R : Le script peut réactiver le service si le paramètre -Enable est utilisé.
Q : Puis-je ajuster le nombre de tentatives de redémarrage ?
R : Oui, utilisez le paramètre -Attempts pour spécifier le nombre de tentatives souhaité.
Q : Que se passe-t-il si le script n’est pas exécuté avec des privilèges d’administrateur ?
R : Le script vérifie l’élévation et se termine par un message d’erreur s’il n’est pas exécuté en tant qu’administrateur.
Implications
L’automatisation du redémarrage des services critiques tels que TeamViewer réduit les temps d’arrêt et améliore les temps de réponse. Toutefois, il est essentiel de veiller à ce que les scripts de ce type soient utilisés de manière responsable et avec les autorisations appropriées, car ils peuvent perturber les services s’ils sont mal configurés.
Recommandations
- Test dans un environnement contrôlé: Avant de le déployer dans un environnement réel, testez le script dans une configuration contrôlée pour vous assurer qu’il se comporte comme prévu.
- Contrôler l’état du service: Utilisez des outils de surveillance pour suivre l’état des services TeamViewer et déclencher automatiquement le script si des problèmes sont détectés.
- Maintenir le script à jour: Veillez à ce que le script soit mis à jour pour tenir compte de toute modification des noms de service ou des chemins d’accès aux exécutables.
Conclusion
L’utilisation de scripts pour gérer les services est une technique puissante pour les professionnels de l’informatique. Ce script particulier de redémarrage des services TeamViewer montre comment l’automatisation peut améliorer l’efficacité et la fiabilité. Pour les solutions de gestion informatique, NinjaOne fournit une plateforme de pointe qui peut intégrer de tels scripts, offrant un ensemble complet d’outils pour gérer efficacement l’assistance à distance et les opérations informatiques.