Comment activer les fichiers Minidump sur Windows à l’aide de PowerShell

La pratique du débogage et du dépannage des systèmes informatiques fait souvent appel à des outils et à des scripts spécialisés. L’une de ces méthodes, essentielle pour de nombreux experts en informatique, est l’utilisation de fichiers minidump. Ces fichiers offrent un instantané (snapshot) de la mémoire active lorsqu’un ordinateur plante, ce qui fournit des données inestimables pour l’analyse après la panne. Cet article examine un script PowerShell conçu pour automatiser l’activation des fichiers minidump sur Windows.

Contexte

Pour les professionnels de l’informatique et les fournisseurs de services gérés (MSP), la capacité à capturer et à analyser les données de plantage est vitale. Cela leur permet de comprendre pourquoi un système est tombé en panne et d’éviter que cela ne se reproduise. Les fichiers Minidump, en particulier, fournissent assez de données sans consommer beaucoup d’espace disque, ce qui en fait un choix privilégié pour de nombreux experts. Cependant, la configuration manuelle de la génération de fichiers minidump peut s’avérer fastidieuse, et c’est là que l’automatisation entre en jeu. En utilisant des scripts tels que celui que nous allons étudier, les professionnels peuvent configurer efficacement leurs systèmes pour générer des fichiers minidump lorsque cela est nécessaire.

Le script

<#
.SYNOPSIS
    Turn on mini dumps if they are off, if other dumps are already enabled do not change the configuration.
.DESCRIPTION
    Turn on mini dumps if they are off, if other dumps are already enabled do not change the configuration.
    This will enable the creation of the pagefile, but set to automatically manage by Windows.
    Reboot might be needed.
.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).
#>
[CmdletBinding()]
param ()

begin {
    function Set-ItemProp {
        param (
            $Path,
            $Name,
            $Value,
            [ValidateSet("DWord", "QWord", "String", "ExpandedString", "Binary", "MultiString", "Unknown")]
            $PropertyType = "DWord"
        )
        # Do not output errors and continue
        $ErrorActionPreference = [System.Management.Automation.ActionPreference]::SilentlyContinue
        if (-not $(Test-Path -Path $Path)) {
            # Check if path does not exist and create the path
            New-Item -Path $Path -Force | Out-Null
        }
        if ((Get-ItemProperty -Path $Path -Name $Name)) {
            # Update property and print out what it was changed from and changed to
            $CurrentValue = Get-ItemProperty -Path $Path -Name $Name
            try {
                Set-ItemProperty -Path $Path -Name $Name -Value $Value -Force -Confirm:$false -ErrorAction Stop | Out-Null
            }
            catch {
                Write-Error $_
            }
            Write-Host "$Path$Name changed from $CurrentValue to $(Get-ItemProperty -Path $Path -Name $Name)"
        }
        else {
            # Create property with value
            try {
                New-ItemProperty -Path $Path -Name $Name -Value $Value -PropertyType $PropertyType -Force -Confirm:$false -ErrorAction Stop | Out-Null
            }
            catch {
                Write-Error $_
            }
            Write-Host "Set $Path$Name to $(Get-ItemProperty -Path $Path -Name $Name)"
        }
        $ErrorActionPreference = [System.Management.Automation.ActionPreference]::Continue
    }
    function Test-IsElevated {
        $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()
        $p = New-Object System.Security.Principal.WindowsPrincipal($id)
        $p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator)
    }
}
process {
    if (-not (Test-IsElevated)) {
        Write-Error -Message "Access Denied. Please run with Administrator privileges."
        exit 1
    }

    # Reference: https://learn.microsoft.com/en-US/troubleshoot/windows-server/performance/memory-dump-file-options
    $Path = "HKLM:SystemCurrentControlSetControlCrashControl"
    $Name = "CrashDumpEnabled"
    $CurrentValue = Get-ItemPropertyValue -Path $Path -Name $Name -ErrorAction SilentlyContinue
    $Value = 3

    # If CrashDumpEnabled is set to 0 or doesn't exist then enable mini crash dump
    if ($CurrentValue -eq 0 -and $null -ne $CurrentValue) {
        $PageFile = Get-ItemPropertyValue -Path "HKLM:SYSTEMCurrentControlSetControlSession ManagerMemory Management" -Name PagingFiles -ErrorAction SilentlyContinue
        if (-not $PageFile) {
            # If the pagefile was not setup, create the registry entry needed to create the pagefile
            try {
                # Enable automatic page management file if disabled to allow mini dump to function
                Set-ItemProp -Path "HKLM:SYSTEMCurrentControlSetControlSession ManagerMemory Management" -Name PagingFiles -Value "?:pagefile.sys" -PropertyType MultiString
            }
            catch {
                Write-Error "Could not create pagefile."
                exit 1
            }
        }
        Set-ItemProp -Path $Path -Name $Name -Value 3
        Write-Host "Reboot might be needed to enable mini crash dump."
    }
    else {
        Write-Host "Crash dumps are already enabled."
    }
    exit 0
}
end {}

 

Description détaillée

Le script PowerShell en question commence par vérifier si le système dispose de droits d’administrateur. Ceci est crucial car les modifications du registre du système par ce script nécessitent ces autorisations.

Le principal chemin d’accès au registre qui nous intéresse est HKLM:SystemCurrentControlSetControlCrashControl. Dans ce chemin, il existe une clé de registre spécifique, CrashDumpEnabled, qui régit l’état de la génération du crash dump.

Si cette clé est définie sur 0 ou n’existe pas, cela signifie que les dumps de crash ne sont pas activés. Le script prendra alors des mesures pour activer la création de fichiers minidump. De plus, le script vérifie la présence d’un fichier de pages et en crée un s’il est manquant, car il s’agit d’une condition préalable à la création de fichier minidump.

Cas d’utilisation potentiels

Prenons l’exemple d’un professionnel de l’informatique, Bob, qui travaille dans une entreprise de taille moyenne. Suite à plusieurs pannes inexpliquées du système, Bob est contraint de trouver la cause initiale. Au lieu de procéder machine par machine, Bob déploie ce script sur tous les ordinateurs de l’entreprise. Cette approche proactive garantit que la prochaine fois qu’un plantage se produira, Bob disposera d’un fichier minidump prêt à être analysé. Bon travail, Bob !

Approche alternative

Traditionnellement, l’activation de la génération de fichiers minidump implique de naviguer dans plusieurs menus Windows ou de modifier manuellement le registre, deux tâches qui prennent du temps et sont sources d’erreurs. Ce script se distingue par l’automatisation du processus, ce qui réduit le risque d’erreur humaine et garantit une configuration homogène sur plusieurs machines.

FAQ

• Quelles sont les conditions préalables à l’utilisation de ce script ?
  Le script prend en charge Windows 10 et Windows Server 2016 ou une version plus récente.
• Un redémarrage est-il nécessaire après l’exécution du script ?
  Un redémarrage peut être nécessaire pour finaliser l’activation des mini-crash dumps.
• Que se passe-t-il si les crash dumps sont déjà activés sur mon système ?
  Le script s’en rendra compte et s’abstiendra d’apporter des modifications.

Implications

L’activation de la génération de fichiers minidump est une arme à double tranchant. Bien qu’il offre des données précieuses pour le débogage, il peut contenir des informations sensibles. Les professionnels de l’informatique devraient envisager de chiffrer ces fichiers ou de s’assurer qu’ils sont stockés dans des endroits sécurisés.

Recommandations

• Testez toujours le script dans un environnement contrôlé avant de le déployer.
• Examinez et effacez régulièrement les fichiers minidump afin d’économiser de l’espace disque et de préserver la confidentialité.

Conclusions

L’intégration de solutions automatisées, telles que le script évoqué, simplifie les tâches de gestion informatique. Des plateformes telles que NinjaOne renforcent encore cette approche en offrant un contrôle centralisé et une suite d’outils adaptés aux besoins des professionnels de l’informatique, garantissant ainsi que les systèmes restent optimisés et sécurisés.