PowerShell Logo Small


This is the built-in help made by Microsoft for the command 'Restore-DscConfiguration', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.


Reapplies the previous configuration for the node.


Restore-DscConfiguration [-AsJob] [-CimSession [<CimSession[]>]] [-ThrottleLimit [<Int32>]] [-Confirm] [-WhatIf] [<CommonParameters>]

Search powershellhelp.space


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.

Note that this cmdlet does not support the Confirm parameter.



Online Version: http://go.microsoft.com/fwlink/?LinkID=289470
Windows PowerShell Desired State Configuration Overview




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