Get-DscLocalConfigurationManager

  • Referenz
Modul:
PSDesiredStateConfiguration

Ruft Lokale Configuration Manager (LCM)-Einstellungen und -Zustände für den Knoten ab.

Syntax

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

Beschreibung

Das Get-DscLocalConfigurationManager Cmdlet ruft LCM-Einstellungen oder Metakonfiguration und die Zustände von LCM für den Knoten ab. Geben Sie Computer mithilfe von CIM-Sitzungen (Common Information Model) an. Wenn Sie keinen Zielcomputer angeben, ruft das Cmdlet die Konfigurationseinstellungen vom lokalen Computer ab.

Beispiele

Beispiel 1: Abrufen von LCM-Einstellungen für den lokalen Computer

Get-DscLocalConfigurationManager

ActionAfterReboot              : ContinueConfiguration
AgentId                        : 47edd8c9-2798-4827-839a-b35cc87e69fb
AllowModuleOverWrite           : False
CertificateID                  :
ConfigurationDownloadManagers  : {}
ConfigurationID                :
ConfigurationMode              : ApplyAndMonitor
ConfigurationModeFrequencyMins : 15
Credential                     :
DebugMode                      : {NONE}
DownloadManagerCustomData      :
DownloadManagerName            :
LCMCompatibleVersions          : {1.0, 2.0}
LCMState                       : Idle
LCMStateDetail                 :
LCMVersion                     : 2.0
StatusRetentionTimeInDays      : 10
SignatureValidationPolicy      : NONE
SignatureValidations           : {}
MaximumDownloadSizeMB          : 500
PartialConfigurations          :
RebootNodeIfNeeded             : False
RefreshFrequencyMins           : 30
RefreshMode                    : PUSH
ReportManagers                 : {}
ResourceModuleManagers         : {}
PSComputerName

Mit diesem Befehl werden LCM-Einstellungen für den lokalen Computer abgerufen.

Weitere Informationen zu den einzelnen Attributen der Ausgabe finden Sie in der Dokumentation Konfigurieren des lokalen Configuration Manager.

Beispiel 2: Abrufen von LCM-Einstellungen für einen angegebenen Computer

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Get-DscLocalConfigurationManager -CimSession $Session

ActionAfterReboot              : ContinueConfiguration
AgentId                        : 169dfa57-a7f9-43be-a7a5-9dd06587e052
AllowModuleOverWrite           : False
CertificateID                  :
ConfigurationDownloadManagers  : {}
ConfigurationID                :
ConfigurationMode              : ApplyAndMonitor
ConfigurationModeFrequencyMins : 15
Credential                     :
DebugMode                      : {NONE}
DownloadManagerCustomData      :
DownloadManagerName            :
LCMCompatibleVersions          : {1.0, 2.0}
LCMState                       : Idle
LCMStateDetail                 :
LCMVersion                     : 2.0
StatusRetentionTimeInDays      : 10
SignatureValidationPolicy      : NONE
SignatureValidations           : {}
MaximumDownloadSizeMB          : 500
PartialConfigurations          :
RebootNodeIfNeeded             : False
RefreshFrequencyMins           : 30
RefreshMode                    : PUSH
ReportManagers                 : {}
ResourceModuleManagers         : {}
PSComputerName                 : Server01
PSComputerName                 : Server01

In diesem Beispiel werden LCM-Einstellungen für einen Computer abgerufen, der durch eine CIM-Sitzung angegeben wird. Das Beispiel erstellt eine CIM-Sitzung für einen Computer namens Server01 zur Verwendung mit dem Cmdlet. Erstellen Sie alternativ ein Array von CIM-Sitzungen, um das Cmdlet für mehrere angegebene Computer anzuwenden.

Der erste Befehl erstellt mithilfe des New-CimSession Cmdlets eine CIM-Sitzung und speichert dann das CimSession-Objekt in der variablen $Session. Der Befehl fordert Sie zur Eingabe eines Kennworts auf. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help New-CimSession.

Der zweite Befehl ruft lokale Configuration Manager Einstellungen für die Computer ab, die durch die cimSession-Objekte identifiziert werden, die in der $Session-Variablen gespeichert sind. In diesem Fall der Computer mit dem Namen Server01.

Parameter

-AsJob

Gibt an, dass dieses Cmdlet den Befehl als Hintergrundauftrag ausführt.

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

-CimSession

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines oder Get-CimSession CmdletsNew-CimSession.

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

-ThrottleLimit

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen des Cmdlets erstellt werden können.

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