{"id":353637,"date":"2024-08-02T09:39:43","date_gmt":"2024-08-02T09:39:43","guid":{"rendered":"https:\/\/www.ninjaone.com\/script-hub\/redemarrer-le-service-teamviewer-powershell\/"},"modified":"2024-10-13T19:06:02","modified_gmt":"2024-10-13T19:06:02","slug":"redemarrer-le-service-teamviewer-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/fr\/script-hub\/redemarrer-le-service-teamviewer-powershell\/","title":{"rendered":"Comment g\u00e9rer et red\u00e9marrer le service TeamViewer avec PowerShell"},"content":{"rendered":"

En mati\u00e8re de gestion informatique, il est essentiel d’assurer la continuit\u00e9 et la fonctionnalit\u00e9 des services essentiels. TeamViewer, un outil d’assistance \u00e0 distance tr\u00e8s utilis\u00e9, doit souvent \u00eatre op\u00e9rationnel \u00e0 tout moment. Cependant, les services peuvent parfois \u00eatre interrompus, ce qui n\u00e9cessite d’agir rapidement pour les r\u00e9tablir. Cet article pr\u00e9sente un script PowerShell con\u00e7u pour red\u00e9marrer et g\u00e9rer le service TeamViewer<\/strong>, afin de garantir un temps d’arr\u00eat minimal et une productivit\u00e9 maximale.<\/p>\n

Contexte<\/h2>\n

Les scripts PowerShell sont des outils inestimables pour les professionnels de l’informatique et les fournisseurs de services g\u00e9r\u00e9s (MSP)<\/a>. Ils automatisent les t\u00e2ches de routine, renforcent la consistance et r\u00e9duisent le risque d’erreurs humaines<\/a>. Le script dont nous parlons aujourd’hui concerne le service TeamViewer.<\/p>\n

Compte tenu de son r\u00f4le dans l’assistance \u00e0 distance, tout temps d’arr\u00eat<\/a> peut avoir un impact significatif sur la prestation de services. Ce script ne se contente pas de red\u00e9marrer le service TeamViewer, il inclut \u00e9galement des m\u00e9canismes permettant de le r\u00e9activer s’il a \u00e9t\u00e9 d\u00e9sactiv\u00e9, ce qui en fait un outil polyvalent dans l’arsenal d’un professionnel de l’informatique.<\/p>\n

Le script PowerShell\u00a0:<\/h2>\n
#Requires -Version 5.1\r\n\r\n<#\r\n.SYNOPSIS\r\n    Restarts the TeamViewer Service. Use \"Set to Automatic\" if the service was disabled.\r\n.DESCRIPTION\r\n    Restarts the TeamViewer Service. Use \"Set to Automatic\" if the service was disabled.\r\n.EXAMPLE\r\n    (No Parameters)\r\n    \r\n    Status   Name               DisplayName                           \r\n    ------   ----               -----------                           \r\n    Running  TeamViewer         TeamViewer                            \r\n    Attempt 1 has completed!\r\n    TeamViewer has restarted successfully!\r\n\r\nPARAMETER: -Enable\r\n    Re-Enables disabled TeamViewer services.\r\n\r\nPARAMETER: -Attempts \"7\" \r\n    Overrides the number of attempts the script will make to restart the service. Simply replace 7 with your desired number of attempts.\r\n\r\nPARAMETER: -WaitTimeInSecs \"30\"\r\n    Overrides the amount of time in between attempts. Defaults to 15.\r\n\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Server 2016\r\n    Release Notes: Initial release\r\nBy 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.\r\n    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. \r\n    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. \r\n    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. \r\n    Warranty Disclaimer: The script is provided \u201cas is\u201d and \u201cas available\u201d, 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. \r\n    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. \r\n    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. \r\n    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).\r\n#>\r\n\r\n[CmdletBinding()]\r\nparam (\r\n    [Parameter()]    \r\n    [Switch]$Enable = [System.Convert]::ToBoolean($env:setToAutomatic),\r\n    [Parameter()]\r\n    [int]$Attempts = 3,\r\n    [Parameter()]\r\n    [int]$WaitTimeInSecs = 15\r\n)\r\n\r\nbegin {\r\n    if ($env:attempts -and $env:attempts -notlike \"null\") { $Attempts = $env:attempts }\r\n    if ($env:waitTimeInSeconds -and $env:waitTimeInSeconds -notlike \"null\") { $WaitTimeInSecs = $env:waitTimeInSeconds }\r\n\r\n    function Test-IsElevated {\r\n        $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()\r\n        $p = New-Object System.Security.Principal.WindowsPrincipal($id)\r\n        $p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator)\r\n    }\r\n\r\n    # Grabs initial set of services to try once.\r\n    $ServiceList = Get-CimInstance -ClassName \"win32_service\"\r\n\r\n    # Attempts to find the TeamViewer service using its executable name.\r\n    function Find-Service {\r\n        [CmdletBinding()]\r\n        param(\r\n            [Parameter(ValueFromPipeline)]\r\n            [String]$Name\r\n        )\r\n        process {\r\n            $ServiceList | Where-Object { $_.PathName -Like \"*$Name.exe*\" } \r\n        }\r\n    }\r\n\r\n    # Tests if the service was successful\r\n    function Test-Service {\r\n        [CmdletBinding()]\r\n        param(\r\n            [Parameter(ValueFromPipeline)]\r\n            [String]$Name\r\n        )\r\n        process {\r\n            $Running = Get-Service $Name | Where-Object { $_.Status -eq $Running }\r\n            if ($Running) {\r\n                return $True\r\n            }\r\n            else {\r\n                return $False\r\n            }\r\n        }\r\n    }\r\n\r\n    # Name of each TeamViewer exe.\r\n    $ProcessName = \"TeamViewer\", \"TeamViewer_Service\", \"tv_w32\", \"tv_x64\"\r\n}\r\nprocess {\r\n    if (-not (Test-IsElevated)) {\r\n        Write-Host \"[Error] Access Denied. Please run with Administrator privileges.\"\r\n        exit 1\r\n    }\r\n\r\n    # List of services to try\r\n    $Services = $ProcessName | Find-Service\r\n\r\n    # If no TeamViewer service is found\r\n    if (-not $Services) {\r\n        Write-Host \"[Error] TeamViewer appears to be missing its service. You will need to reinstall it.\"\r\n        exit 1\r\n    }\r\n\r\n    # Loops through each service and attempts to start them\r\n    foreach ($Service in $Services) {\r\n        $Failed = $True\r\n        $Attempt = 1\r\n        While ($Attempt -le $Attempts -and $Failed -eq $True) {\r\n\r\n            # If the service was disabled, check if -Enable was specified.\r\n            if ($Service.StartMode -ne \"Auto\" -and $Enable) {\r\n                # If so re-enable it.\r\n                $Service | Get-Service | Set-Service -StartupType \"Automatic\"\r\n            }\r\n            elseif ($Service.StartMode -ne \"Auto\") {\r\n                Write-Host \"[Error] The service is not set to start automatically. Use 'Set To Automatic' to change the startup type to automatic.\"\r\n                if($Service.StartMode -eq \"Disabled\"){ exit 1 }\r\n            }\r\n\r\n            # All possible service states\r\n            Switch ($Service.State) {\r\n                \"Running\" { $Service | Get-Service | Restart-Service -PassThru }\r\n                \"Paused\" { $Service | Get-Service | Resume-Service -PassThru }\r\n                \"Pending\" {\r\n                    $Service | Get-Service | Stop-Service\r\n                    Start-Sleep -Seconds 2  # Ensure the service has time to stop\r\n                    $Service | Get-Service | Start-Service -PassThru\r\n                }\r\n                \"Stopped\" { $Service | Get-Service | Start-Service -PassThru }\r\n            }\r\n\r\n            Start-Sleep -Seconds $WaitTimeInSecs\r\n\r\n            # Feedback on the number of attempts made. Multiple attempts may indicate that TeamViewer needs to be reinstalled.\r\n            Write-Host \"Attempt $Attempt completed.\"\r\n\r\n            $Attempt++\r\n            $Failed = $Service.Name | Test-Service\r\n        }\r\n    }\r\n    $Failed = $Services | Get-Service | Where-Object { $_.Status -ne \"Running\" }\r\n\r\n    if ($Failed) {\r\n        Write-Host \"[Error] Unable to start the service!\"\r\n        exit 1\r\n    }\r\n    else {\r\n        Write-Host \"TeamViewer has restarted successfully!\"\r\n        exit 0\r\n    }\r\n}\r\nend {\r\n    \r\n    \r\n    \r\n}\r\n<\/pre>\n
 <\/p>\n\n
<\/h2>
<\/p><\/div>
<\/a><\/div><\/div>\n
Description d\u00e9taill\u00e9e<\/h2>\n
La fonction principale du script est de red\u00e9marrer le service TeamViewer, avec des fonctionnalit\u00e9s suppl\u00e9mentaires pour configurer le service afin qu’il d\u00e9marre automatiquement s’il est d\u00e9sactiv\u00e9 et pour personnaliser le nombre de tentatives de red\u00e9marrage et les p\u00e9riodes d’attente entre les tentatives.<\/p>\n
Composants cl\u00e9s<\/h3>\n
\u00a01. Param\u00e8tres et initialisation<\/h4>\n
Le script commence par d\u00e9finir les param\u00e8tres suivants : $Enable, $Attempts et $WaitTimeInSecs. Ces param\u00e8tres permettent de personnaliser le script et de l’adapter \u00e0 diff\u00e9rents sc\u00e9narios.<\/p>\n
2. Contr\u00f4le de l’\u00e9l\u00e9vation<\/h4>\n
Le script comprend une fonction permettant de v\u00e9rifier s’il est ex\u00e9cut\u00e9 avec des droits d’administrateur, ce qui est n\u00e9cessaire pour les t\u00e2ches de gestion des services.<\/p>\n
3. D\u00e9couverte des services<\/h4>\n
Il r\u00e9cup\u00e8re une liste de tous les services et les filtre pour trouver ceux qui sont li\u00e9s \u00e0 TeamViewer.<\/p>\n
4. Contr\u00f4le de l’\u00e9tat des services<\/h4>\n
Une autre fonction v\u00e9rifie si le service sp\u00e9cifi\u00e9 est en cours d’ex\u00e9cution.<\/p>\n
5. Boucle de gestion des services<\/h4>\n
La boucle tente de red\u00e9marrer le service TeamViewer jusqu’au nombre de tentatives sp\u00e9cifi\u00e9, en faisant une pause entre les tentatives.<\/p>\n
Cas d’utilisation potentiels<\/h2>\n
Consid\u00e9rons un sc\u00e9nario d’assistance informatique dans lequel les services TeamViewer sur une machine distante s’arr\u00eatent de mani\u00e8re inattendue. Un professionnel de l’informatique peut utiliser ce script pour red\u00e9marrer le service \u00e0 distance, garantissant ainsi une interruption minimale des op\u00e9rations de support. Par exemple, lors d’une session d’assistance critique, si le service s’arr\u00eate, le script peut \u00eatre ex\u00e9cut\u00e9 pour le remettre en ligne sans n\u00e9cessiter d’intervention manuelle.<\/p>\n
Comparaisons<\/h2>\n
Ce script offre une approche simplifi\u00e9e par rapport aux red\u00e9marrages manuels ou \u00e0 l’utilisation d’autres outils tels que Windows Service Manager. Tandis que cette derni\u00e8re m\u00e9thode n\u00e9cessite des v\u00e9rifications manuelles et des red\u00e9marrages, ce script automatise le processus, garantissant ainsi des r\u00e9solutions coh\u00e9rentes et rapides.<\/p>\n
FAQ<\/h2>\n
Q\u00a0: Que se passe-t-il si le service est d\u00e9sactiv\u00e9 ?<\/h3>\n
R\u00a0: Le script peut r\u00e9activer le service si le param\u00e8tre -Enable est utilis\u00e9.<\/p>\n
Q\u00a0: Puis-je ajuster le nombre de tentatives de red\u00e9marrage ?<\/h3>\n
R\u00a0: Oui, utilisez le param\u00e8tre -Attempts pour sp\u00e9cifier le nombre de tentatives souhait\u00e9.<\/p>\n
Q\u00a0: Que se passe-t-il si le script n’est pas ex\u00e9cut\u00e9 avec des privil\u00e8ges d’administrateur ?<\/h3>\n
R\u00a0: Le script v\u00e9rifie l’\u00e9l\u00e9vation et se termine par un message d’erreur s’il n’est pas ex\u00e9cut\u00e9 en tant qu’administrateur.<\/p>\n
Implications<\/h2>\n
L’automatisation du red\u00e9marrage des services critiques tels que TeamViewer r\u00e9duit les temps d’arr\u00eat et am\u00e9liore les temps de r\u00e9ponse. Toutefois, il est essentiel de veiller \u00e0 ce que les scripts de ce type soient utilis\u00e9s de mani\u00e8re responsable et avec les autorisations appropri\u00e9es, car ils peuvent perturber les services s’ils sont mal configur\u00e9s.<\/p>\n
Recommandations<\/h2>\n