{"id":208401,"date":"2024-01-22T10:27:49","date_gmt":"2024-01-22T10:27:49","guid":{"rendered":"https:\/\/www.ninjaone.com\/script-hub\/comment-deconnecter-a-distance-les-utilisateurs-windows-avec-powershell\/"},"modified":"2024-03-04T19:07:51","modified_gmt":"2024-03-04T19:07:51","slug":"comment-deconnecter-a-distance-les-utilisateurs-windows-avec-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/fr\/script-hub\/comment-deconnecter-a-distance-les-utilisateurs-windows-avec-powershell\/","title":{"rendered":"Comment d\u00e9connecter \u00e0 distance les utilisateurs Windows avec PowerShell"},"content":{"rendered":"

Dans le monde informatique moderne, la gestion des sessions utilisateur est essentielle. PowerShell, avec sa polyvalence, offre une excellente solution gr\u00e2ce \u00e0 ce script pour d\u00e9connecter \u00e0 distance les utilisateurs<\/strong>. Qu’il s’agisse de s’assurer que les sessions inutilis\u00e9es ne consomment pas de ressources ou de maintenir les protocoles de s\u00e9curit\u00e9 en veillant \u00e0 ce que les sessions non autoris\u00e9es soient interrompues, il est n\u00e9cessaire d’assurer une gestion efficace des sessions. Cette importance est d’autant plus grande si l’on consid\u00e8re l’essor du travail \u00e0 distance et les multiples sessions initi\u00e9es \u00e0 partir de diff\u00e9rents endroits.<\/p>\n

Contexte<\/h2>\n

Le script fourni sert un objectif simple mais crucial : d\u00e9connecter le ou les utilisateurs sp\u00e9cifi\u00e9s d’une machine Windows, \u00e0 l’exception de la session de la console. Si de nombreux professionnels de l’informatique et fournisseurs de services g\u00e9r\u00e9s (MSP)<\/a> s’interrogent sur son utilit\u00e9 compte tenu de la disponibilit\u00e9 d’outils bas\u00e9s sur une interface graphique, il ne faut pas oublier que les solutions automatis\u00e9es et \u00e9volutives requi\u00e8rent souvent des approches bas\u00e9es sur des scripts. Ce script permet aux administrateurs d’int\u00e9grer de mani\u00e8re optimale les fonctionnalit\u00e9s de d\u00e9connexion des utilisateurs dans des flux d’automatisation plus importants, ce qui est crucial pour les entreprises qui ont de nombreuses sessions d’utilisateurs \u00e0 g\u00e9rer.<\/p>\n

Le script<\/h2>\n
#Requires -Version 5.1\r\n\r\n<#\r\n.SYNOPSIS\r\n    Logs off user(s) specified. You can't log off a user from the console session.\r\n.DESCRIPTION\r\n    Logs off user(s) specified. You can't log off a user from the console session.\r\n.EXAMPLE\r\n     -User \"Administrator\"\r\n    Logs off Administrator user.\r\n.EXAMPLE\r\n     -User \"Administrator\",\"Guest\"\r\n    Logs off Administrator and Guest users.\r\n.EXAMPLE\r\n    PS C:> Logoff-User.ps1 -User \"Administrator\",\"Guest\"\r\n    Logs off Administrator and Guest users.\r\n.OUTPUTS\r\n    String[]\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Windows Server 2016\r\n    Release Notes:\r\n    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.COMPONENT\r\n    ManageUsers\r\n#>\r\n\r\n[CmdletBinding(SupportsShouldProcess = $True)]\r\nparam (\r\n    # User name(s) to log off\r\n    [Parameter(Mandatory = $true)]\r\n    [String[]]\r\n    $User\r\n)\r\n\r\nbegin {\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        if ($p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator))\r\n        { Write-Output $true }\r\n        else\r\n        { Write-Output $false }\r\n    }\r\n    Function Get-QueryUser() {\r\n        Param()\r\n        # Replaces all occurrences of 2 or more spaces in a row with a single comma\r\n        $Lines = @(query.exe user).foreach({ $(($_) -replace ('s{2,}', ',')) })\r\n        $Header = $($Lines[0].split(',').trim())\r\n        for ($i = 1; $i -lt $($Lines.Count); $i++) {\r\n            $Line = $($Lines[$i].split(',')).foreach({ $_.trim().trim('>') })\r\n            # Accounts for disconnected users\r\n            if ($Line.count -eq 5) {\r\n                $Line = @($Line[0], \"$($null)\", $Line[1], $Line[2], $Line[3], $Line[4] )\r\n            }\r\n            $CurUser = [PSCustomObject]::new()\r\n            for ($j = 0; $j -lt $($Line.count); $j++) {\r\n                $CurUser | Add-Member -MemberType NoteProperty -Name $Header[$j] -Value $Line[$j]\r\n            }\r\n            $CurUser\r\n        }\r\n    }\r\n}\r\nprocess {\r\n    if (-not (Test-IsElevated)) {\r\n        Write-Error -Message \"Access Denied. Please run with Administrator privileges.\"\r\n        exit 1\r\n    }\r\n    # Get a list of users logged on from query.exe, format it for powershell to process\r\n    $QueryResults = Get-QueryUser\r\n    # Accounts for only one user logged in\r\n    $QueryTest = $($QueryResults | Select-Object -First 1)\r\n    if (\r\n        $QueryResults.Count -or\r\n        (\r\n            $QueryTest.USERNAME -is [String] -and\r\n            -not [String]::IsNullOrEmpty($QueryTest.USERNAME) -and\r\n            -not [String]::IsNullOrWhiteSpace($QueryTest.USERNAME)\r\n        )\r\n    ) {\r\n        $script:HasError = $false\r\n        $QueryResults | Where-Object {\r\n    \r\n            # For each session filter out the user that weren't specified in $User\r\n            $_.UserName -in $User\r\n    \r\n        } | ForEach-Object {\r\n            Write-Host \"Found Logged In User: $($_.UserName)\"\r\n            if ($_.SessionName -like \"console\") {\r\n                # We can't log out a user that is at the console.\r\n                # We could do this logic in the Where-Object code block, but then there isn't an output of what was skipped.\r\n                # https:\/\/docs.microsoft.com\/en-us\/windows-server\/administration\/windows-commands\/logoff#remarks\r\n                # \"You can't log off a user from the console session.\"\r\n                Write-Host \"Skipping user, can't log off a user($($_.UserName)) from the $($_.SessionName) session.\"\r\n            }\r\n            else {\r\n                # Log off the user session with a matching ID\r\n                logoff.exe $_.Id\r\n                if ($LASTEXITCODE -gt 0) {\r\n                    $script:HasError = $true\r\n                    Write-Error \"logoff.exe $($_.Id) returned exit code: $LASTEXITCODE\"\r\n                }\r\n                else {\r\n                    Write-Host \"Logged Off User: $($_.UserName)\"\r\n                }\r\n            }\r\n        }\r\n        if ($script:HasError) {\r\n            exit 1\r\n        }\r\n    }\r\n    else {\r\n        Write-Output \"No Users Logged In\"\r\n        exit 2\r\n    }\r\n}\r\nend {}<\/pre>\n
 <\/p>\n\n
Acc\u00e9dez \u00e0 plus de 700 scripts dans le Dojo NinjaOne<\/p>\n
Obtenez l’acc\u00e8s<\/a><\/p>\n<\/div>\n
Description d\u00e9taill\u00e9e<\/h2>\n