PowerShell Logo Small

Get-DscConfigurationStatus



This is the built-in help made by Microsoft for the command 'Get-DscConfigurationStatus', 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.

SYNOPSIS

Retrieves data about completed configuration runs.

SYNTAX


Get-DscConfigurationStatus [-All] [-AsJob] [-CimSession [<CimSession[]>]] [-ThrottleLimit [<Int32>]] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Get-DscConfigurationStatus cmdlet retrieves detailed information about completed configuration runs on the system. By default, it returns the information about the last
configuration run. This cmdlet is useful for finding historical information about configuration runs, such as when the configurations were run, the status of the runs, the
number of resources in the configurations, and which resources succeeded or failed.



<

RELATED LINKS

Windows PowerShell Desired State Configuration Overview
Get-DscConfiguration
Get-DscLocalConfigurationManager
Restore-DscConfiguration
Start-DscConfiguration
Test-DscConfiguration

REMARKS

<

Examples


Example 1: Get information on the last configuration run

PS C:\>Get-DscConfigurationStatus



This command gets information on the last configuration run.






Example 2: Get information on all configurations

PS C:\>Get-DscConfigurationStatus -All



This command gets information about all the configurations that were run on the system, including the DSC consistency check.






Example 3: Get information on the configuration run on a remote machine

PS C:\>Get-DscConfigurationStaus -CimSession "Server01"



This command gets the configuration run details of the remote machine named Server01. This uses the WSMan transport to connect to the remote machine and requires that the
connecting user be an administrator on the remote machine.