Hur man aktiverar minidumpar på Windows med hjälp av PowerShell

Felsökning och debugging av datorsystem kräver ofta specialverktyg och skript. En sådan metod, som är avgörande för många IT-experter, är användningen av minidump-filer. Dessa filer ger en ögonblicksbild av det aktiva minnet när en dator kraschar, vilket ger ovärderliga data för analys efter kraschen. I den här artikeln beskrivs ett PowerShell-skript som är utformat för att automatisera aktiveringen av minidumpar på Windows-system.

Bakgrund

För IT-proffs och tjänsteleverantörer (MSP) är möjligheten att samla in och analysera kraschdata avgörande. På så sätt kan de förstå varför systemet kraschade och förhindra framtida händelser. I synnerhet minidumpfiler ger precis tillräckligt med data utan att förbruka mycket diskutrymme, vilket gör dem till ett förstahandsval för många experter. Att manuellt ställa in generering av minidumpar kan dock vara tråkigt, och det är här automatisering kommer in i bilden. Genom att använda skript som det vi ska titta närmare på kan professionella användare effektivt konfigurera sina system för att generera minidumpar vid behov.

Manus

<#
.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 {}

 

Detaljerad uppdelning

PowerShell-skriptet i fokus börjar med att kontrollera om systemet har administratörsbehörighet. Detta är viktigt eftersom ändringar i systemregistret, som avses i detta skript, kräver sådana behörigheter.

Den viktigaste registervägen av intresse är HKLM:SystemCurrentControlSetControlCrashControl. Inom denna sökväg finns det en specifik registernyckel, CrashDumpEnabled, som styr tillståndet för generering av kraschdumpar.

Om denna nyckel är satt till 0 eller inte existerar, indikerar det att crash dumps inte är aktiverade. Skriptet kommer sedan att vidta åtgärder för att aktivera skapandet av minidumpar. Dessutom kontrollerar skriptet om det finns en sidfil och skapar en om den saknas eftersom det är en förutsättning för att skapa minidumpar.

Potentiella användningsområden

Tänk dig en IT-expert, Bob, som arbetar i en medelstor organisation. Efter flera oförklarliga systemkrascher är Bob pressad att ta reda på grundorsaken. Istället för att gå igenom varje enskild dator distribuerar Bob skriptet över alla datorer i organisationen. Detta proaktiva tillvägagångssätt säkerställer att Bob har en minidumpfil redo för analys nästa gång en krasch inträffar. Bra jobbat, Bob!

Alternativt tillvägagångssätt

För att aktivera generering av minidumpar måste man vanligtvis navigera i flera Windows-menyer eller manuellt redigera registret – båda tidskrävande och felbenägna uppgifter. Detta skript utmärker sig genom att automatisera processen, vilket minskar risken för mänskliga misstag och säkerställer en konsekvent installation på flera maskiner.

Vanliga frågor

• Vilka är förutsättningarna för att använda detta skript?
  Skriptet stöder Windows 10 och Windows Server 2016 eller nyare.
• Är en omstart nödvändig efter att skriptet har körts?
  En omstart kan behövas för att slutföra aktiveringen av mini-crash dumps.
• Vad händer om mitt system redan har aktiverat crash dumps?
  Skriptet kommer att känna igen detta och avstå från att göra ändringar.

Konsekvenser

Att aktivera generering av minidumpar är ett tveeggat svärd. Även om det ger värdefulla data för felsökning, kan det innehålla känslig information. IT-ansvariga bör överväga att kryptera dessa filer eller se till att de lagras på säkra platser.

Rekommendationer

• Testa alltid skriptet i en kontrollerad miljö innan du distribuerar det.
• Granska och rensa minidumpfiler regelbundet för att spara diskutrymme och upprätthålla sekretessen.

Avslutande tankar

Automatiserade lösningar, som det diskuterade skriptet, förenklar IT-hanteringen. Plattformar som NinjaOne förstärker detta ytterligare genom att erbjuda centraliserad kontroll och en uppsättning verktyg som är skräddarsydda för IT-personalens behov, vilket säkerställer att systemen förblir optimerade och säkra.