Powershell : comment activer ou désactiver les composants IPv6 sur Windows

Alors que le monde poursuit sa transition de l’IPv4 à l’IPv6, le besoin d’outils et de scripts permettant aux professionnels de l’informatique de gérer les configurations IPv6 est devenu de plus en plus important. Dans ce contexte, une exigence cruciale concerne la possibilité d’activer ou de désactiver les composants IPv6 sur les systèmes basés sur Windows. Aujourd’hui, nous mettons en avant un script PowerShell qui permet une configuration précise d’IPv6 sur les appareils Windows.

Contexte

IPv6, le successeur d’IPv4, résout le problème de l’épuisement des adresses IP et comporte de nombreux autres avantages. Il se peut cependant, que, lors de la transition ou des tests, les professionnels de l’informatique et les fournisseurs de services gérés (MSP) éprouvent le besoin d’activer, de désactiver ou de modifier certains composants IPv6. Qu’il s’agisse de dépannage, de configuration de réseau ou de sécurité, une méthode rationalisée peut s’avérer inestimable. Le script fourni permet justement de configurer IPv6 dans Windows avec souplesse et précision.

Le script

#Requires -Version 5.1

<#
.SYNOPSIS
    Enable or disable components for IPv6 on all network connections.
.DESCRIPTION
    Enable or disable components for IPv6 on all network connections.
    Rebooting is required for Windows to apply these settings.
.EXAMPLE
     -Components DisableAll
    Disables all IPv6 components.
.EXAMPLE
    PS C:> Disable-IPv6.ps1 -ComponentsValue 0xFF
    Disables all IPv6 components from custom value.
    See link for more options:
    https://docs.microsoft.com/en-us/troubleshoot/windows-server/networking/configure-ipv6-in-windows
.EXAMPLE
     -Components EnableAll
    Enables all IPv6 components.
.EXAMPLE
     -Components DisableAllTunnels
    Disables all IPv6 Tunnels.
.EXAMPLE
     -Components DisableAllTunnels, Disable6to4
    Disables All IPv6 Tunnels and 6to4 components.
.EXAMPLE
    PS C:> Disable-IPv6.ps1 -Components DisableAll
    Disables all IPv6 components.
.OUTPUTS
    None
.NOTES
    Minimum OS Architecture Supported: Windows 10, Windows 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).
.COMPONENT
    ProtocolSecurity
#>

[CmdletBinding(DefaultParameterSetName = "Components")]
param (
    [Parameter(Mandatory = $true, ParameterSetName = "Components")]
    [ValidateSet("EnableAll", "DisableAllTunnels", "Disable6to4", "DisableISATAP", "DisableTeredo", "PreferIPv4Over", "Disableall")]
    [string[]]
    $Components,
    [Parameter(Mandatory = $true, ParameterSetName = "Value")]
    [ValidateRange(0, 255)]
    [int]
    $ComponentsValue
)

begin {
    $DisableValue = 0
    if ($Components) {
        # Define values for names in $Components
        $EnableAll = 0
        $DisableAllTunnels = 0x01
        $Disable6to4 = 0x02
        $DisableISATAP = 0x04
        $DisableTeredo = 0x08
        $PreferIPv4Over = 0x20
        $Disableall = 0xFF

        # Create bit "list" and start at 0
        $DisableValue = 0
        $Components | ForEach-Object {
            # Add each item in $Components to $DisableList with bitwise-or operation
            $DisableValue = $DisableValue -bor $(Get-Variable -Name $_ -ValueOnly)
        }
    }
    elseif ($ComponentsValue) {
        $DisableValue = $ComponentsValue
    }
    function Set-ItemProp {
        param (
            $Path,
            $Name,
            $Value,
            [ValidateSet("DWord", "QWord", "String", "ExpandedString", "Binary", "MultiString", "Unknown")]
            $PropertyType = "DWord"
        )
        if ((Get-ItemProperty -Path $Path -Name $Name -ErrorAction SilentlyContinue)) {
            Set-ItemProperty -Path $Path -Name $Name -Value $Value -Force -Confirm:$false | Out-Null
        }
        else {
            New-ItemProperty -Path $Path -Name $Name -Value $Value -PropertyType $PropertyType -Force -Confirm:$false | Out-Null
        }
    }
    function Test-IsElevated {
        $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()
        $p = New-Object System.Security.Principal.WindowsPrincipal($id)
        if ($p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator))
        { Write-Output $true }
        else
        { Write-Output $false }
    }
}
process {
    if (-not (Test-IsElevated)) {
        Write-Error -Message "Access Denied. Please run with Administrator privileges."
        exit 1
    }
    $Path = "HKLM:SYSTEMCurrentControlSetServicesTcpip6Parameters"
    $Name = "DisabledComponents"
    $Value = $DisableValue
    try {
        Set-ItemProp -Path $Path -Name $Name -Value $Value
    }
    catch {
        Write-Error $_
        exit 1
    }
}
end {}

 

Description détaillée

Le script est un script PowerShell, désigné par son extension .ps1. Voici une description détaillée de son fonctionnement :

• Paramètres : À la base, le script demande à l’utilisateur de saisir soit des composants IPv6 spécifiques qu’il souhaite gérer, soit une valeur directe représentant une certaine configuration.
• Initialisation : Le script initialise ensuite la valeur par défaut DisabledComponents à 0, ce qui signifie qu’aucun composant n’est désactivé. Le script fait ensuite correspondre chaque nom de composant à sa valeur hexadécimale respective.
• Traitement : Pour chaque composant fourni comme entrée, le script calcule une valeur hexadécimale cumulative. Cette valeur cumulative détermine quels composants IPv6 doivent être désactivés.
• Réglage du registre : Avec la valeur hexadécimale calculée, le script procède à la mise à jour ou à la création d’une clé de registre. C’est ici qu’a lieu l’activation ou la désactivation des composants IPv6. Le script cible la clé DisabledComponents dans le registre Windows.
• Contrôle de l’exécution : Le script vérifie s’il dispose des droits d’administration avant d’exécuter le processus principal. Si ce n’est pas le cas, il invite l’utilisateur à l’exécuter avec des privilèges élevés.

Cas d’utilisation potentiels

Étude de cas : Imaginez une administratrice informatique, Adeline, travaillant pour une grande entreprise. Cette dernière migre un segment de son réseau vers IPv6 mais a des applications anciennes qui ne fonctionnent pas bien avec certains composants IPv6, comme Teredo. À l’aide du script, Adeline peut facilement désactiver Teredo sur toutes les machines concernées, ce qui garantit la compatibilité des applications sans désactiver complètement l’IPv6.

Comparaisons

Bien qu’il existe des méthodes manuelles, telles que la navigation dans l’interface graphique ou l’utilisation de commandes Windows natives, pour désactiver ou activer les composants IPv6, elles peuvent s’avérer fastidieuses, en particulier pour les réseaux de grande taille. Ce script simplifie le processus en permettant le traitement par lots, l’automatisation et la précision.

FAQ script et IPv6

• Comment exécuter le script ?
  Exécutez-le en utilisant PowerShell avec des droits élevés.
• Dois-je redémarrer le système ensuite ?
  Oui, un redémarrage est nécessaire pour que les changements prennent effet.
• Quelles sont les versions de Windows prises en charge ?
  Windows 10 et Windows Server 2016.

Implications

Bien que l’IPv6 présente de nombreux avantages, une mauvaise configuration peut entraîner des failles de sécurité ou des problèmes de connectivité. Savoir en contrôler les composants garantit un environnement de réseau plus sûr et mieux adapté.

Recommandations

• Sauvegardez toujours le registre avant d’y apporter des modifications.
• Testez le script sur un seul appareil avant de le déployer à grande échelle.
• Assurez-vous de bien comprendre chaque composant IPv6 avant de le désactiver.

Conclusion

Des outils tels que NinjaOne fournissent des capacités intégrées de gestion et de surveillance du réseau pour une expérience encore meilleure. En utilisant de tels outils avec des scripts comme celui-ci, les professionnels de l’informatique peuvent assurer une transition IPv6 en douceur et en toute sécurité.