ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2009 Microsoft Corporation.
C:\Windows-7>Powershell get-help Restore-Computer -full
# 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.
# 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