Come abilitare o disabilitare IPv6 e i suoi componenti in Windows utilizzando PowerShell

Poiché il mondo continua la sua transizione da IPv4 a IPv6, la necessità di strumenti e script che consentano ai professionisti IT di gestire le configurazioni IPv6 è diventata sempre più importante. Un requisito fondamentale è la possibilità di abilitare o disabilitare i componenti IPv6 sui sistemi basati su Windows. Oggi ci occupiamo di uno script PowerShell che consente di configurare con precisione l’IPv6 sui dispositivi Windows.

Background

L’IPv6, il successore dell’IPv4, risolve il problema dell’esaurimento degli indirizzi IP e apporta numerosi altri vantaggi. Tuttavia, durante la transizione o i test, i professionisti IT e i Managed Service Provider (MSP) potrebbero trovare la necessità di attivare, disattivare o modificare alcuni componenti IPv6. Sia per la risoluzione dei problemi che per la configurazione della rete o per la sicurezza, disporre di un metodo semplificato può essere prezioso. Lo script fornito fa proprio questo: è uno strumento per configurare IPv6 in Windows con flessibilità e precisione.

Lo 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 {}

 

Analisi dettagliata

Lo script è uno script PowerShell, indicato con l’estensione .ps1. Ecco una descrizione passo per passo del suo funzionamento:

• Parametri: Nella sua funzione centrale, lo script richiede all’utente di inserire componenti IPv6 specifici che desidera gestire o un valore diretto che rappresenta una determinata configurazione.
• Inizializzazione: Lo script imposta quindi il valore predefinito DisabledComponents a 0, il che significa che nessun componente è disabilitato. Lo script mappa quindi il nome di ciascun componente sul rispettivo valore esadecimale.
• Elaborazione: Per ogni componente fornito come input, lo script calcola un valore esadecimale cumulativo. Questo valore cumulativo determina quali componenti IPv6 devono essere disabilitati.
• Impostazione del registro: Con il valore esadecimale calcolato, lo script procede all’aggiornamento o alla creazione di una chiave di registro. È qui che avviene l’effettiva abilitazione o disabilitazione dei componenti IPv6. Lo script punta alla chiave DisabledComponents nel registro di Windows.
• Controllo dell’esecuzione: Lo script controlla se si dispone di diritti amministrativi prima di eseguire il processo principale. In caso contrario, chiede all’utente di eseguirlo con privilegi elevati.

Casi d’uso potenziali

Caso di studio: Immagina una amministratrice IT, Jane, che lavora per una grande azienda. Sta migrando un segmento della rete verso l’IPv6 ma ci sono applicazioni legacy che non funzionano bene con alcuni componenti IPv6, come Teredo. Utilizzando lo script, Jane può facilmente disabilitare Teredo su tutti i computer interessati, garantendo la compatibilità delle applicazioni senza disattivare completamente l’IPv6.

Confronti

Sebbene esistano metodi manuali, come la navigazione nell’interfaccia GUI o l’uso di comandi nativi di Windows, per disabilitare o abilitare i componenti IPv6, questi possono essere noiosi, soprattutto per le reti di grandi dimensioni. Questo script semplifica il processo, consentendo l’elaborazione in batch, l’automazione e la precisione.

Domande frequenti

• Come si esegue lo script?
  Eseguilo utilizzando PowerShell con diritti elevati.
• È necessario riavviare il sistema dopo l’esecuzione?
  Sì, per rendere effettive le modifiche è necessario un riavvio.
• Quali versioni di Windows sono supportate?
  Windows 10 e Windows Server 2016 e versioni successive.

Implicazioni

Sebbene l’IPv6 offra molti vantaggi, una configurazione errata può portare a vulnerabilità di sicurezza o a problemi di connettività. La possibilità di controllare i suoi componenti garantisce un ambiente di rete più sicuro e personalizzato.

Raccomandazioni

• Esegui sempre un backup del registro prima di apportare modifiche.
• Testa lo script su un singolo dispositivo prima della distribuzione su larga scala.
• Assicurati di avere una chiara comprensione di ogni componente IPv6 prima di disabilitarlo.

Considerazioni finali

Strumenti come NinjaOne possono migliorare ulteriormente l’esperienza fornendo funzionalità integrate di gestione e monitoraggio della rete. Se abbinati a script come questo, permettono ai professionisti IT di garantire una transizione IPv6 sicura e senza intoppi.