Get-​Dsc​Local​Configuration​Manager

Gets LCM settings and states for the node.

Syntax

Get-DscLocalConfigurationManager
   [-AsJob]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [<CommonParameters>]

Description

The Get-DscLocalConfigurationManager cmdlet gets Local Configuration Manager (LCM) settings, or meta-configuration, and the states of LCM for the node. Specify computers by using Common Information Model (CIM) sessions. If you do not specify a target computer, the cmdlet gets the configuration settings from the local computer.

Examples

Example 1: Get LCM settings for the local computer

PS C:\> Get-DscLocalConfigurationManager

This command gets LCM settings for the local computer.

Example 2: Get LCM settings for a specified computer

PS C:\> $Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
PS C:\> Get-DscLocalConfigurationManager -CimSession $Session

This example gets LCM settings for 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 gets Local Configuration Manager settings for the computers identified by the CimSession objects stored in the $Session variable, in this case, the computer named Server01.

Optional Parameters

-AsJob

Indicates that this cmdlet runs the command as a background job.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CimSession

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet.

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ThrottleLimit

Specifies the maximum number of concurrent operations that can be established to run the cmdlet.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False