DEV Community

fecklesspleb
fecklesspleb

Posted on

Le Wi-Fi se coupe sans arrêt sous Windows 11 ? Trouvez où avec PowerShell avant de tout réinitialiser

Cet article est une traduction française, réalisée avec l'aide de l'IA, de mon article original en anglais : Wi-Fi keeps dropping on Windows 11? Find out where with PowerShell before you reset anything. Le code, les commandes et les chiffres ont été vérifiés par rapport à l'original et au dépôt avant publication.

Quand le Wi-Fi se coupe sans arrêt, le conseil habituel est une liste de réinitialisations : oublier le réseau, redémarrer le routeur, netsh winsock reset, réinstaller le pilote, réinitialiser le réseau. La page de Microsoft elle-même, « Fix Wi-Fi connection issues in Windows », les présente à peu près dans cet ordre, et c'est une bonne liste. Commencez par l'utilitaire de résolution des problèmes Réseau et Internet dans l'application Obtenir de l'aide.

Mais le guide de dépannage de Microsoft destiné aux professionnels de l'informatique fait une remarque qu'on saute facilement : relevez une situation de référence et notez quand le problème se produit avant de réinitialiser la pile réseau, de supprimer des profils sans fil ou de désinstaller le pilote. Et il y a une question à laquelle aucune réinitialisation ne répond : la coupure se situe-t-elle entre votre PC et votre routeur, ou au-delà du routeur ? Si elle est au-delà du routeur, vous aurez beau réinitialiser votre PC, cela n'y changera rien.

Dans cet article, on construit un petit fichier PowerShell, en lecture seule, qui répond à cette question en quatre parties :

  1. Ce que l'adaptateur indique en ce moment (netsh wlan show interfaces, sous forme d'objets).
  2. Ce que Windows a journalisé au moment de la coupure (les événements de déconnexion avec le texte de leur motif).
  3. Si Windows a le droit d'éteindre l'adaptateur pour économiser la batterie.
  4. Un journal de pings vers votre routeur et, si vous le souhaitez, vers une adresse sur Internet, avec un résumé qui vous dit où se trouvent les coupures.

Rien de tout cela ne modifie un paramètre. Le seul fichier écrit est le journal CSV dont vous indiquez le nom.

1. La liaison, sous forme d'objets

netsh wlan show interfaces affiche un bloc Key : Value pour chaque interface Wi-Fi : état, SSID, BSSID du point d'accès, bande, canal, type de radio, débits de réception et d'émission, et signal en pourcentage. C'est lisible, mais peu pratique à journaliser. Un petit parseur transforme tout cela en objets :

function ConvertFrom-WlanInterfaceText {
    [CmdletBinding()]
    param([Parameter(Mandatory)][AllowEmptyString()][string[]] $Text)

    $map = [ordered]@{
        'Name' = 'Name'; 'Description' = 'Description'; 'State' = 'State'
        'SSID' = 'SSID'; 'AP BSSID' = 'BSSID'; 'BSSID' = 'BSSID'
        'Radio type' = 'RadioType'; 'Authentication' = 'Authentication'
        'Band' = 'Band'; 'Channel' = 'Channel'
        'Receive rate (Mbps)' = 'ReceiveMbps'; 'Transmit rate (Mbps)' = 'TransmitMbps'
        'Signal' = 'SignalPercent'; 'Profile' = 'Profile'
    }
    $current = $null
    foreach ($line in ($Text -split "`r?`n")) {
        if ($line -notmatch '^\s+(?<key>[^:]+?)\s+:\s?(?<value>.*)$') { continue }
        $key = $Matches.key.Trim()
        $value = $Matches.value.Trim()
        if ($key -eq 'Name') {                      # a new interface starts
            if ($current) { [pscustomobject]$current }
            $current = [ordered]@{}
            foreach ($p in ($map.Values | Select-Object -Unique)) { $current[$p] = $null }
        }
        if ($null -eq $current -or -not $map.Contains($key)) { continue }
        $prop = $map[$key]
        switch ($prop) {
            'SignalPercent' { $current[$prop] = [int]($value -replace '[^\d]', '') }
            { $_ -in 'Channel', 'ReceiveMbps', 'TransmitMbps' } {
                $n = 0.0
                if ([double]::TryParse($value, [Globalization.NumberStyles]::Float,
                        [Globalization.CultureInfo]::InvariantCulture, [ref]$n)) { $current[$prop] = $n }
            }
            default { $current[$prop] = $value }
        }
    }
    if ($current) { [pscustomobject]$current }
}
Enter fullscreen mode Exit fullscreen mode

Trois détails à connaître :

  • Deux libellés possibles pour le point d'accès. Selon la build de Windows, la ligne peut indiquer AP BSSID ou simplement BSSID. La table de correspondance accepte les deux.
  • L'expression régulière coupe au premier : (espace, deux-points), si bien qu'un BSSID comme aa:bb:cc:dd:ee:01 reste intact.
  • Les libellés peuvent être traduits. Si la langue d'affichage n'est pas l'anglais, les clés risquent de ne pas correspondre, et vous n'obtenez alors rien. Get-WifiStatus (la fonction d'enrobage qui lance réellement netsh) affiche un avertissement dans ce cas au lieu d'échouer en silence.
function Get-WifiStatus {
    [CmdletBinding()]
    param()
    if (-not (Get-Command -Name netsh.exe -ErrorAction SilentlyContinue)) {
        throw 'netsh.exe was not found. This function needs Windows.'
    }
    $raw = & netsh.exe wlan show interfaces
    $found = 0
    foreach ($interface in (ConvertFrom-WlanInterfaceText -Text $raw)) { $found++; $interface }
    if ($found -eq 0) {
        Write-Warning 'No Wi-Fi interface was found in the netsh output. If your Windows display language is not English, run "netsh wlan show interfaces" and read it directly.'
    }
}
Enter fullscreen mode Exit fullscreen mode

2. Ce que Windows a journalisé au moment de la coupure

Le service WLAN AutoConfig tient son propre journal d'événements : Journaux des applications et des services > Microsoft > Windows > WLAN-AutoConfig > Operational. L'événement 8001 correspond à une connexion réussie et le 8003 à une déconnexion. Chaque 8003 contient le SSID, l'adaptateur et, surtout, une chaîne Reason et un ReasonCode.

Le texte du motif se trouve dans le XML de l'événement, pas dans son message de résumé ; il faut donc lire les champs EventData par leur nom :

function ConvertFrom-WlanEventXml {
    [CmdletBinding()]
    param([Parameter(Mandatory)][string] $Xml, [datetime] $TimeCreated, [int] $Id)
    $doc = [xml]$Xml
    $data = @{}
    foreach ($d in $doc.Event.EventData.Data) { $data[[string]$d.Name] = [string]$d.'#text' }
    [pscustomobject]@{
        TimeCreated = $TimeCreated
        Id          = $Id
        SSID        = $data['SSID']
        Adapter     = $data['InterfaceDescription']
        Reason      = $data['Reason']
        ReasonCode  = $data['ReasonCode']
    }
}

function Get-WifiDisconnectEvent {
    [CmdletBinding()]
    param([ValidateRange(1, 90)][int] $Days = 7)
    $filter = @{
        LogName   = 'Microsoft-Windows-WLAN-AutoConfig/Operational'
        Id        = 8003
        StartTime = (Get-Date).AddDays(-$Days)
    }
    $events = @(Get-WinEvent -FilterHashtable $filter -ErrorAction SilentlyContinue)
    foreach ($e in $events) {
        ConvertFrom-WlanEventXml -Xml $e.ToXml() -TimeCreated $e.TimeCreated -Id $e.Id
    }
}
Enter fullscreen mode Exit fullscreen mode

-FilterHashtable filtre à l'intérieur du service du journal des événements, ce qui est beaucoup plus rapide que de faire passer tout le journal dans Where-Object. -ErrorAction SilentlyContinue est important ici : Get-WinEvent lève l'erreur « No events were found » quand le filtre ne trouve rien, alors qu'une semaine sans événement est une réponse tout à fait valable.

Get-WifiDisconnectEvent -Days 7 | Format-Table TimeCreated, SSID, Reason -AutoSize
Enter fullscreen mode Exit fullscreen mode

Regroupez par Reason pour voir si les coupures ont une cause commune. Un motif qui indique que le pilote a signalé la déconnexion oriente vers l'adaptateur ; un motif qui indique que c'est vous ou une stratégie qui avez déconnecté oriente vers tout autre chose.

Une réserve : quand un PC se met en veille puis se réveille à portée du même réseau, Windows peut ne pas journaliser de paire 8003/8001 ; une liste courte ne prouve donc pas qu'il n'y a pas eu de coupure. Pour avoir une vue complète, netsh wlan show wlanreport (à lancer en administrateur) génère un rapport HTML qui, selon les termes de Microsoft, résume les sessions sans fil récentes, les motifs de déconnexion, les informations sur l'adaptateur et les événements associés.

3. Windows a-t-il le droit d'éteindre l'adaptateur ?

« Le Wi-Fi se coupe quand le PC est resté inactif ou après une mise en veille » : c'est souvent le réglage d'économie d'énergie de l'adaptateur. Gestionnaire de périphériques > votre adaptateur Wi-Fi > Propriétés > Gestion de l'alimentation > Autoriser l'ordinateur à éteindre ce périphérique pour économiser l'énergie. Vous pouvez lire ce même réglage avec Get-NetAdapterPowerManagement, qui demande une fenêtre avec élévation de privilèges :

function Get-WifiAdapterPowerSetting {
    [CmdletBinding()]
    param()
    $wifi = @(Get-NetAdapter -Physical -ErrorAction Stop |
        Where-Object { $_.PhysicalMediaType -eq 'Native 802.11' })
    foreach ($a in $wifi) {
        $pm = Get-NetAdapterPowerManagement -Name $a.Name -ErrorAction SilentlyContinue
        $allow = if ($pm) { [string]$pm.AllowComputerToTurnOffDevice } else { 'Not reported' }
        [pscustomobject]@{
            Name                         = $a.Name
            Description                  = $a.InterfaceDescription
            Status                       = [string]$a.Status
            AllowComputerToTurnOffDevice = $allow
        }
    }
}
Enter fullscreen mode Exit fullscreen mode

Cette fonction ne fait que rapporter. Si vous décidez de décocher la case, faites-le dans le Gestionnaire de périphériques, où il suffit de la recocher pour annuler.

4. Routeur ou Internet ? Journalisez-le

Cette partie vous donne un journal horodaté à montrer à votre fournisseur d'accès. Toutes les quelques secondes, on pingue votre passerelle par défaut (votre routeur) et, si vous le souhaitez, une adresse publique. Chaque mesure est écrite dans un CSV avec le signal et le BSSID :

  • Le routeur ne répond plus → le problème se situe entre votre PC et votre routeur (signal, économie d'énergie, pilote ou routeur).
  • Le routeur répond, mais pas l'adresse sur Internet → votre Wi-Fi va bien ; le problème est au-delà du routeur.

Le ping utilise directement System.Net.NetworkInformation.Ping de .NET, qui devrait se comporter de la même façon dans Windows PowerShell 5.1 et dans PowerShell 7 (pas encore vérifié sous 5.1 ; Test-Connection a changé de paramètres et de sortie entre les deux) :

function Test-PingOnce {
    [CmdletBinding()]
    [OutputType([bool])]
    param([Parameter(Mandatory)][string] $Target, [int] $TimeoutMs = 1000)
    $ping = New-Object System.Net.NetworkInformation.Ping
    try { return ($ping.Send($Target, $TimeoutMs).Status -eq 'Success') }
    catch { return $false }
    finally { $ping.Dispose() }
}
Enter fullscreen mode Exit fullscreen mode

La passerelle est tirée de la route par défaut qui a la métrique la plus basse :

function Get-DefaultGateway {
    [CmdletBinding()]
    param()
    $route = Get-NetRoute -DestinationPrefix '0.0.0.0/0' -ErrorAction SilentlyContinue |
        Sort-Object -Property RouteMetric | Select-Object -First 1
    if ($route) { $route.NextHop }
}
Enter fullscreen mode Exit fullscreen mode

Le journaliseur ajoute une ligne par mesure avec Export-Csv -Append ; si vous l'arrêtez avec Ctrl+C, tout ce qui a été journalisé jusque-là est donc déjà sur le disque :

function Watch-WifiConnection {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory)][string] $Path,
        [ValidateRange(1, 1440)][int] $Minutes = 30,
        [ValidateRange(1, 300)][int] $IntervalSeconds = 5,
        [int] $Samples = 0,
        [string] $Gateway,
        [string] $InternetHost
    )
    if (-not $Gateway) { $Gateway = Get-DefaultGateway }
    if (-not $Gateway) { throw 'No default gateway found. Connect to Wi-Fi first, or pass -Gateway.' }
    if ($Samples -le 0) { $Samples = [math]::Max(1, [int](($Minutes * 60) / $IntervalSeconds)) }
    $haveNetsh = [bool](Get-Command -Name netsh.exe -ErrorAction SilentlyContinue)

    for ($i = 0; $i -lt $Samples; $i++) {
        $wifi = $null
        if ($haveNetsh) { $wifi = Get-WifiStatus -WarningAction SilentlyContinue | Select-Object -First 1 }
        $row = [pscustomobject]@{
            Time       = (Get-Date).ToString('yyyy-MM-ddTHH:mm:ss')
            State      = if ($wifi) { $wifi.State } else { '' }
            SSID       = if ($wifi) { $wifi.SSID } else { '' }
            BSSID      = if ($wifi) { $wifi.BSSID } else { '' }
            Signal     = if ($wifi) { $wifi.SignalPercent } else { '' }
            GatewayOk  = Test-PingOnce -Target $Gateway
            InternetOk = if ($InternetHost) { Test-PingOnce -Target $InternetHost } else { '' }
        }
        $row | Export-Csv -LiteralPath $Path -Append -NoTypeInformation -Encoding UTF8
        $row
        if ($i -lt $Samples - 1) { Start-Sleep -Seconds $IntervalSeconds }
    }
}
Enter fullscreen mode Exit fullscreen mode

Measure-WifiLog relit ensuite le CSV et compte les échecs vers le routeur, les mesures « routeur OK, Internet en échec », le signal le plus bas et le nombre de changements de BSSID (un passage vers un autre point d'accès ou une autre bande), puis affiche un verdict d'une ligne. Elle est dans le dépôt ; c'est un simple comptage sur Import-Csv.

Lancez-le pendant que le problème se produit :

. .\wifi-drop-diagnostic.ps1
Watch-WifiConnection -Minutes 30 -InternetHost 1.1.1.1 -Path .\wifi-log.csv
Measure-WifiLog -Path .\wifi-log.csv
Enter fullscreen mode Exit fullscreen mode

1.1.1.1 n'est qu'un exemple d'adresse publique qui répond aux pings. Si vous omettez -InternetHost, seul votre routeur est pingué.

Les pièges

  • Certains routeurs ignorent les pings. Si GatewayOk vaut false alors que tout fonctionne, le journaliseur ne peut pas vous aider sur ce réseau.
  • Un ping toutes les quelques secondes peut rater une coupure très brève. Diminuez -IntervalSeconds si vous avez besoin de plus de précision ; la valeur par défaut de 5 garde un journal léger.
  • Plusieurs adaptateurs Wi-Fi : le journaliseur enregistre le premier que netsh liste.
  • Windows dans une autre langue que l'anglais : Get-WifiStatus peut ne rien renvoyer et afficher un avertissement. Les pings et la lecture du journal d'événements devraient continuer à fonctionner, car ils ne lisent pas de texte affiché, mais cela n'a pas été testé.

Comment ça a été testé (et ce qui ne l'a pas été)

Le script s'analyse sans erreur, PSScriptAnalyzer ne signale rien (y compris avec sa règle de compatibilité syntaxique Windows PowerShell 5.1), et 12 tests Pester passent. Ces tests ont tourné sous PowerShell 7 sur Linux, avec un texte d'exemple écrit à la main au format de netsh, un XML d'événement d'exemple et des mocks pour le journal d'événements, le ping et la mise en attente. Il n'a pas encore été lancé sur un vrai PC sous Windows 10/11 ni sous Windows PowerShell 5.1. Comme il ne modifie rien, le pire scénario est un rapport faux ou vide, mais lisez-le avant de le lancer.

Pages Microsoft utilisées : « Fix Wi-Fi connection issues in Windows » (support Microsoft), « Wireless network connectivity issues troubleshooting » (Microsoft Learn) et la référence de Get-NetAdapterPowerManagement (Microsoft Learn). Les liens sont dans le README du dépôt.

Mon dépôt, avec le script complet, les tests et un README (gratuit, MIT) : https://github.com/fecklesspleb/wifi-drop-diagnostic


À propos de l'usage de l'IA : cet article a été traduit de l'anglais avec l'aide de l'IA ; l'article original et le code ont eux aussi été écrits avec l'aide de l'IA. Le code, les commandes et les chiffres ont été vérifiés par rapport à l'original et au dépôt avant publication. Sans affiliation avec Microsoft ni approbation de sa part.

Top comments (0)