Disable-ComputerRestore - PowerShell command help and examples

Disables the System Restore feature on the specified file system drive. (Disable-ComputerRestore)

... Examples      
 NAME
 
    Disable-ComputerRestore 

 SYNOPSIS
 
    Disables the System Restore feature on the specified file system drive. 

 SYNTAX
 
    Disable-ComputerRestore [-Drive] <string[]> [-Confirm] [-WhatIf] [<CommonParameters>] 

 DESCRIPTION
 
    The Disable-ComputerRestore cmdlet turns off the System Restore feature on one or more file system drives. As a result, attempts to restore the computer do not affect the specified drive. 

    To disable System Restore on any drive, it must be disabled on the system drive, either first or concurrently. 

    To re-enable System Restore, use the Enable-ComputerRestore cmdlet. To find the state of System Restore for each drive, use Rstrui.exe. 

 PARAMETERS
 
    -Drive <string[]> 
        Specifies the file system drives. Enter one or more file system drive letters, each followed by a colon and a backslash and enclosed in quotation marks, such as "C:\" or "D:\".  This parameter is required. 

        You cannot use this cmdlet to disable System Restore on a remote network drive, even if the drive is mapped to the local computer, and you cannot disable System Restore on drives that are not eligible for System Restore, such as external drives. 

        To disable System Restore on any drive, System Restore must be disabled on the system drive, either before or concurrently. 

        Required?                    true 
        Position?                    1 
        Default value                None 
        Accept pipeline input?       false 
        Accept wildcard characters?  false 

    -Confirm [<SwitchParameter>] 
        Prompts you for confirmation before executing the command. 

        Required?                    false 
        Position?                    named 
        Default value 
        Accept pipeline input?       false 
        Accept wildcard characters?  false 

    -WhatIf [<SwitchParameter>] 
        Describes what would happen if you executed the command without actually executing the command. 

        Required?                    false 
        Position?                    named 
        Default value 
        Accept pipeline input?       false 
        Accept wildcard characters?  false 

    <CommonParameters> 
        This cmdlet supports the common parameters: Verbose, Debug, 
        ErrorAction, ErrorVariable, WarningAction, WarningVariable, 
        OutBuffer and OutVariable. For more information, type, 
        "get-help about_commonparameters". 

 INPUTS
 
    None 
        You cannot pipe input to this cmdlet. 

 OUTPUTS
 
    None 
        This cmdlet does not generate any output. 

 NOTES
 

        Disable-ComputerRestore and Enable-ComputerRestore work only on client operating systems, such as Windows Vista and Windows XP. 

        To run a Disable-ComputerRestore command on Windows Vista and later versions of Windows, open Windows PowerShell with the "Run as administrator" option. 

        To find the file system drives that are eligible for system restore, in System in Control Panel, see the System Protection tab. To open this tab in Windows PowerShell, type "SystemPropertiesProtection". 

        This cmdlet uses the Windows Management Instrumentation (WMI) SystemRestore class. 

 Examples
    
EXAMPLE 1
 

    C:\PS>disable-computerrestore -drive "C:\"

     Description
 
    ----------- 
    This command disables System Restore on the C: drive. 

    
EXAMPLE 2
 

    C:\PS>disable-computerrestore "C:\", "D:\"

     Description
 
    ----------- 
    This command disables System Restore on the C: and D: drives. The command uses the Drive parameter, but it the omits the optional parameter name. 

RELATED LINKS 
    Online version: http://go.microsoft.com/fwlink/?LinkID=135207 
    Enable-ComputerRestore 
    Get-ComputerRestorePoint 
    Restore-Computer 
    Restart-Computer 

C:\Windows>powershell get-help Checkpoint-Computer -full 

Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.

ColorConsole [Version 3.7.1000] PowerShell 2.0-Export

Windows 11, 10, 8.1, 8, 7 / Server 2022, 2019, 2016