Restore-Computer - PowerShell command help and examples

Starts a system restore on the local computer. (Restore-Computer)

... Examples      
 NAME
 
    Restore-Computer 

 SYNOPSIS
 
    Starts a system restore on the local computer. 

 SYNTAX
 
    Restore-Computer [-RestorePoint] <int> [-Confirm] [-WhatIf] [<CommonParameters>] 

 DESCRIPTION
 
    The Restore-Computer cmdlet restores the local computer to the specified system restore point. 

    A Restore-Computer command restarts the computer. The restore is completed during the restart operation. 

 PARAMETERS
 
    -RestorePoint <int> 
        Specifies the sequence number of the restore point.  To find the sequence number, use Get-ComputerRestorePoint. This parameter is required. 

        Required?                    true 
        Position?                    1 
        Default value 
        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
 

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

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

 Examples
    
EXAMPLE 1
 

    C:\PS>restore-computer -RestorePoint 253 

     Description
 
    ----------- 
    This command restores the local computer to the restore point with sequence number 253. 

    Because the RestorePoint parameter is positional, you can omit the parameter name. 

    
EXAMPLE 2
 

    C:\PS>restore-computer 255 -confirm 

    Confirm 
    Are you sure you want to perform this action? 
    Performing operation "Restore-Computer" . 
    [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): 

     Description
 
    ----------- 
    This command restores the local computer to the restore point with sequence number 255. It uses the Confirm parameter to prompt the user before actually performing the operation. 

    
EXAMPLE 3
 

    C:\PS>Get-ComputerRestorePoint 

    C:\PS> Restore-Computer -RestorePoint 255 

    C:\PS> Get-ComputerRestorePoint -LastStatus 

     Description
 
    ----------- 
    These commands run a system restore and then check its status. 

    The first command uses the Get-ComputerRestorePoint cmdlet to get the restore points on the local computer. 

    The second command uses Restore-Computer to restore the computer to the restore point with sequence number 255. 

    The third command uses the LastStatus parameter of Get-ComputerRestorePoint cmdlet to check the status of the restore operation. Because the Restore-Computer command forces a restart, this command would be entered when the computer restarted. 

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

C:\Windows>powershell get-help Add-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