Come verificare lo stato del ripristino configurazione di sistema con PowerShell: guida per professionisti IT

Vuoi imparare a verificare lo stato del ripristino configurazione di sistema con PowerShell? Il ripristino configurazione di sistema è una funzione fondamentale dei sistemi operativi Windows, che fornisce una rete di sicurezza agli utenti consentendo loro di ripristinare il sistema a uno stato precedente in caso di malfunzionamento o di modifiche indesiderate.

Per i professionisti IT e i Managed Service Provider (MSP), il monitoraggio dello stato del ripristino configurazione di sistema su più dispositivi è essenziale per mantenere l’integrità e l’affidabilità del sistema. Lo script PowerShell fornito è un potente strumento progettato per verificare lo stato del Ripristino configurazione di sistema su un dispositivo e, facoltativamente, registrare il risultato in un campo personalizzato.

Background

In un panorama in cui la stabilità del sistema è fondamentale, lo strumento di ripristino configurazione di sistema offre un servizio prezioso consentendo un rapido ripristino dei guasti del sistema. Per i professionisti IT, in particolare per quelli che gestiscono numerosi dispositivi, assicurarsi che il ripristino configurazione di sistema sia abilitato può evitare tempi di inattività significativi e perdite di dati.

Questo script semplifica il processo di verifica dello stato del ripristino configurazione di sistema e si integra perfettamente con NinjaOne, una popolare soluzione di gestione IT, per registrare lo stato in un campo personalizzato, se necessario.

Lo script per verificare lo stato del ripristino configurazione di sistema

#Requires -Version 5.1

<#
.SYNOPSIS
    Checks the status of System Restore on the device.
.DESCRIPTION
    Checks the status of System Restore on the device.
    When a Custom Field is specified the results will be saved to the Custom Field as "Enabled" or "Disabled".

.EXAMPLE
    (No Parameters)
    ## EXAMPLE OUTPUT WITHOUT PARAMS ##
    [Info] System Restore is Disabled

PARAMETER: -CustomFieldName "SystemRestore"
    Saves the results to a custom field.
.EXAMPLE
    -CustomFieldName "SystemRestore"
    ## EXAMPLE OUTPUT WITH CustomFieldName ##
    [Info] Attempting to set Custom Field 'SystemRestore'.
    [Info] Successfully set Custom Field 'SystemRestore'!
    [Info] System Restore is Enabled

.NOTES
    Minimum OS Architecture Supported: Windows 10, Windows Server 2016
    Release Notes: Renamed Script
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 (
    [Parameter()]
    [String]$CustomFieldName
)

begin {
    function Set-NinjaProperty {
        [CmdletBinding()]
        Param(
            [Parameter(Mandatory = $True)]
            [String]$Name,
            [Parameter()]
            [String]$Type,
            [Parameter(Mandatory = $True, ValueFromPipeline = $True)]
            $Value,
            [Parameter()]
            [String]$DocumentName
        )
    
        $Characters = $Value | Measure-Object -Character | Select-Object -ExpandProperty Characters
        if ($Characters -ge 10000) {
            throw [System.ArgumentOutOfRangeException]::New("Character limit exceeded, value is greater than 10,000 characters.")
        }
        
        # If we're requested to set the field value for a Ninja document we'll specify it here.
        $DocumentationParams = @{}
        if ($DocumentName) { $DocumentationParams["DocumentName"] = $DocumentName }
        
        # This is a list of valid fields that can be set. If no type is given, it will be assumed that the input doesn't need to be changed.
        $ValidFields = "Attachment", "Checkbox", "Date", "Date or Date Time", "Decimal", "Dropdown", "Email", "Integer", "IP Address", "MultiLine", "MultiSelect", "Phone", "Secure", "Text", "Time", "URL", "WYSIWYG"
        if ($Type -and $ValidFields -notcontains $Type) { Write-Warning "$Type is an invalid type! Please check here for valid types. https://ninjarmm.zendesk.com/hc/en-us/articles/16973443979789-Command-Line-Interface-CLI-Supported-Fields-and-Functionality" }
        
        # The field below requires additional information to be set
        $NeedsOptions = "Dropdown"
        if ($DocumentName) {
            if ($NeedsOptions -contains $Type) {
                # We'll redirect the error output to the success stream to make it easier to error out if nothing was found or something else went wrong.
                $NinjaPropertyOptions = Ninja-Property-Docs-Options -AttributeName $Name @DocumentationParams 2>&1
            }
        }
        else {
            if ($NeedsOptions -contains $Type) {
                $NinjaPropertyOptions = Ninja-Property-Options -Name $Name 2>&1
            }
        }
        
        # If an error is received it will have an exception property, the function will exit with that error information.
        if ($NinjaPropertyOptions.Exception) { throw $NinjaPropertyOptions }
        
        # The below types require values not typically given in order to be set. The below code will convert whatever we're given into a format ninjarmm-cli supports.
        switch ($Type) {
            "Checkbox" {
                # While it's highly likely we were given a value like "True" or a boolean datatype it's better to be safe than sorry.
                $NinjaValue = [System.Convert]::ToBoolean($Value)
            }
            "Date or Date Time" {
                # Ninjarmm-cli expects the GUID of the option to be selected. Therefore, the given value will be matched with a GUID.
                $Date = (Get-Date $Value).ToUniversalTime()
                $TimeSpan = New-TimeSpan (Get-Date "1970-01-01 00:00:00") $Date
                $NinjaValue = $TimeSpan.TotalSeconds
            }
            "Dropdown" {
                # Ninjarmm-cli is expecting the guid of the option we're trying to select. So we'll match up the value we were given with a guid.
                $Options = $NinjaPropertyOptions -replace '=', ',' | ConvertFrom-Csv -Header "GUID", "Name"
                $Selection = $Options | Where-Object { $_.Name -eq $Value } | Select-Object -ExpandProperty GUID
        
                if (-not $Selection) {
                    throw [System.ArgumentOutOfRangeException]::New("Value is not present in dropdown")
                }
        
                $NinjaValue = $Selection
            }
            default {
                # All the other types shouldn't require additional work on the input.
                $NinjaValue = $Value
            }
        }
        
        # We'll need to set the field differently depending on if its a field in a Ninja Document or not.
        if ($DocumentName) {
            $CustomField = Ninja-Property-Docs-Set -AttributeName $Name -AttributeValue $NinjaValue @DocumentationParams 2>&1
        }
        else {
            $CustomField = Ninja-Property-Set -Name $Name -Value $NinjaValue 2>&1
        }
        
        if ($CustomField.Exception) {
            throw $CustomField
        }
    }
    if ($env:customFieldName -and $env:customFieldName -ne "null") {
        $CustomFieldName = $env:customFieldName
    }
}
process {
    # If the registry value is 1, System Restore is enabled.
    $RegValue = Get-ItemPropertyValue -Path "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\SystemRestore\" -Name "RPSessionInterval" -ErrorAction SilentlyContinue

    $SystemRestoreStatus = if ($RegValue -ge 1) {
        # If either of the above conditions are met, System Restore is enabled.
        Write-Output "Enabled"
    }
    else {
        Write-Output "Disabled"
    }

    # If a Custom Field Name is provided, set the Custom Field with the System Restore Status.
    if ($CustomFieldName) {
        try {
            Write-Host "[Info] Attempting to set Custom Field '$CustomFieldName'."
            Set-NinjaProperty -Name $CustomFieldName -Value $SystemRestoreStatus
            Write-Host "[Info] Successfully set Custom Field '$CustomFieldName'!"
        }
        catch {
            Write-Host "[Error] Failed to set Custom Field '$CustomFieldName'."
        }
    }
    Write-Host "[Info] System Restore is $SystemRestoreStatus"
}
end {
    
    
    
}

 

Analisi dettagliata

Vediamo come funziona questo script PowerShell per verificare lo stato del ripristino configurazione di sistema.

Inizializzazione dello script

Lo script per verificare lo stato del ripristino configurazione di sistema inizia con alcuni metadati sotto forma di commenti, che illustrano lo scopo, gli esempi di utilizzo e i sistemi operativi supportati. Lo script supporta Windows 10 e Windows Server 2016, il che indica che è stato progettato per ambienti moderni.

Questa riga specifica che lo script per verificare lo stato del ripristino configurazione di sistema richiede PowerShell versione 5.1 o versioni successive.

Parametri

Lo script per verificare lo stato del ripristino configurazione di sistema definisce un unico parametro opzionale, CustomFieldName, che consente agli utenti di specificare un nome di campo personalizzato in cui verrà salvato lo stato.

Funzione di aiuto: Set-NinjaProperty

Lo script per verificare lo stato del ripristino configurazione di sistema include una funzione di aiuto, Set-NinjaProperty, che è responsabile dell’impostazione del valore del campo personalizzato in NinjaOne. Questa funzione gestisce diversi tipi di dati e convalida gli input in base a criteri predefiniti.

Logica principale

Lo script per verificare lo stato del ripristino configurazione di sistema controlla quindi il registro per determinare se il ripristino configurazione di sistema è abilitato. Legge il valore RPSessionInterval dalla chiave di registro HKLM:SOFTWAREMicrosoftWindows NTCurrentVersionSystemRestore. Se il valore è maggiore o uguale a 1, il ripristino configurazione di sistema è considerato abilitato.

Se viene fornito un nome di campo personalizzato, lo script tenta di impostare questo campo con lo stato di ripristino configurazione di sistema utilizzando la funzione Set-NinjaProperty.

Casi d’uso potenziali

Immagina un professionista IT che gestisce un parco dispositivi Windows per un’azienda di medie dimensioni. Assicurarsi che lo strumento di ripristino configurazione di sistema sia abilitato su tutti i dispositivi è fondamentale per un rapido ripristino da potenziali problemi. Il professionista può utilizzare questo script insieme a NinjaOne per controllare e registrare regolarmente lo stato del ripristino configurazione di sistema su tutti i dispositivi, assicurandosi di poter agire rapidamente se la funzione è disabilitata su un qualsiasi computer.

Confronti

Esistono vari metodi per controllare lo stato del ripristino configurazione di sistema, ad esempio utilizzando l’interfaccia grafica o diverse utility a riga di comando. Tuttavia, questo script PowerShell offre un approccio semplificato e automatizzato per verificare lo stato del ripristino configurazione di sistema che si integra con NinjaOne, fornendo una soluzione scalabile per i professionisti IT che gestiscono più sistemi. A differenza dei controlli manuali, questo script per verificare lo stato del ripristino configurazione di sistema può essere programmato ed eseguito su tutti i dispositivi, risparmiando tempo e riducendo gli errori umani.

Domande frequenti

D: Questo script per verificare lo stato del ripristino configurazione di sistema può abilitare il Ripristino configurazione di sistema se è disabilitato?

R: No, lo script è progettato per verificare lo stato del ripristino configurazione di sistema e registrarlo. L’attivazione del ripristino configurazione di sistema richiederebbe ulteriori comandi.

D: Lo script per verificare lo stato del ripristino configurazione di sistema è compatibile con le versioni precedenti di Windows?

R: Lo script per verificare lo stato del ripristino configurazione di sistema è progettato per Windows 10 e Windows Server 2016. La compatibilità con le versioni precedenti non è garantita.

D: Cosa succede se il nome del campo personalizzato non viene fornito?

R: Se non è stato fornito alcun nome di campo personalizzato, lo script per verificare lo stato del ripristino configurazione di sistema fornirà semplicemente lo stato del ripristino configurazione di sistema senza tentare di registrarlo.

Implicazioni

Conoscere lo stato del ripristino configurazione di sistema su tutti i dispositivi gestiti aiuta i professionisti IT a garantire il ripristino dei sistemi in caso di guasti. Questo approccio proattivo può migliorare in modo significativo l’affidabilità del sistema e ridurre l’impatto di potenziali problemi.

Raccomandazioni

Quando utilizzi questo script per verificare lo stato del ripristino configurazione di sistema, assicurati che venga eseguito regolarmente per tenere traccia dello stato del ripristino configurazione di sistema. Integralo in una più ampia strategia di monitoraggio e gestione del sistema per mantenere il sistema integro. Testa sempre lo script per verificare lo stato del ripristino configurazione di sistema in un ambiente controllato prima di distribuirlo su più dispositivi per evitare problemi imprevisti.

Considerazioni finali

NinjaOne offre solidi strumenti per la gestione IT e script come questo per verificare lo stato del ripristino configurazione di sistema ne potenziano le capacità fornendo soluzioni automatizzate e scalabili per i controlli di routine. Assicurarsi che il ripristino configurazione di sistema sia abilitato su tutti i dispositivi è solo una delle tante attività che possono essere semplificate con NinjaOne, al fine di aiutare i professionisti IT a mantenere l’integrità, l’affidabilità e l’efficienza del sistema.