NAME
Restore-DscConfiguration
SYNOPSIS
Reapplies the previous configuration for the node.SYNTAX
Restore-DscConfiguration [-AsJob] [-CimSession
[] [-Confirm] [-ThrottleLimit ] [-WhatIf] ] DESCRIPTION
The Restore-DscConfiguration cmdlet reapplies the previous configuration for the node, if a previous configuration
exists. Specify computers by using Common Information Model (CIM) sessions. If you do not specify a target computer, the cmdlet restores the configuration of the local computer. If there is no previous configuration for a particular node, this cmdlet returns an error message. This cmdlet does not support the Confirm parameter.PARAMETERS
-AsJob [
{{Fill AsJob Description}} Required? false Position? named Default value False Accept pipeline input? False Accept wildcard characters? false] -CimSession
@{Text=} Required? false Position? named Default value None Accept pipeline input? False Accept wildcard characters? false-Confirm [
Prompts you for confirmation before running the cmdlet. Required? false Position? named Default value False Accept pipeline input? False Accept wildcard characters? false] -ThrottleLimit
@{Text=} Required? false Position? named Default value None Accept pipeline input? False Accept wildcard characters? false-WhatIf [
Shows what would happen if the cmdlet runs. The cmdlet is not run. Required? false Position? named Default value False Accept pipeline input? False Accept wildcard characters? false] This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216). INPUTS
OUTPUTS
NOTES
Example 1: Restore the configuration for the local computer
PS C:\> Restore-DscConfiguration
This command restores the configuration for the local computer.Example 2: Restore configuration for a specified computer
PS C:\> $Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
PS C:\>Restore-DscConfiguration -CimSession $Session
This example restores configuration on a computer specified by a CIM session. The example creates a CIM session for a computer named Server01 for use with the cmdlet. Alternatively, create an array of CIM sessions to apply the cmdlet to multiple specified computers.The first command creates a CIM session by using the New-CimSession cmdlet, and then stores the CimSession object
in the $Session variable. The command prompts you for a password. For more information, type `Get-Help
New-CimSession`.
The second command restores the configuration for the computers identified by the CimSession objects stored in the$Session variable, in this case, the computer named Server01.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=821462Windows PowerShell Desired State Configuration Overview http://go.microsoft.com/fwlink/?LinkID=311940
Get-DscConfiguration
Get-DscConfigurationStatus
Start-DscConfiguration
Test-DscConfiguration