Configureren van de lokale Configuration Manager in eerdere versies van Windows PowerShellConfiguring the Local Configuration Manager in Previous Versions of Windows PowerShell

Van toepassing op: Windows PowerShell 4.0Applies To: Windows PowerShell 4.0

Zie voor informatie die betrekking hebben op de Windows PowerShell 5.0 en hoger configureren van de lokale Configuration Manager.For information related to Windows PowerShell 5.0 and later, see Configuring the Local Configuration Manager.

Lokale Configuration Manager is de engine voor Windows PowerShell Desired State Configuration (DSC).Local Configuration Manager is the Windows PowerShell Desired State Configuration (DSC) engine. Deze wordt uitgevoerd op alle doelknooppunten en is verantwoordelijk voor het aanroepen van de configuratie-resources die zijn opgenomen in een DSC-configuratiescript.It runs on all target nodes, and it is responsible for calling the configuration resources that are included in a DSC configuration script. Dit onderwerp worden de eigenschappen van de lokale Configuration Manager en wordt beschreven hoe u de instellingen van de lokale Configuration Manager op een doelknooppunt kunt wijzigen.This topic lists the properties of Local Configuration Manager and describes how you can modify the Local Configuration Manager settings on a target node.

Eigenschappen van lokale Configuration ManagerLocal Configuration Manager properties

Hieronder vindt u de lokale Configuration Manager-eigenschappen die u kunt instellen of ophalen.The following lists the Local Configuration Manager properties that you can set or retrieve.

  • AllowModuleOverwrite: bepaalt of nieuwe configuraties van de configuration-service zijn mogen gedownload naar de oude versie in het doelknooppunt te overschrijven.AllowModuleOverwrite: Controls whether new configurations downloaded from the configuration service are allowed to overwrite the old ones on the target node. Mogelijke waarden zijn True en False.Possible values are True and False.
  • CertificateID: de vingerafdruk van een certificaat gebruikt voor het beveiligen van referenties doorgegeven in een configuratie.CertificateID: The thumbprint of a certificate used to secure credentials passed in a configuration. Zie voor meer informatie wilt beveiligen van referenties in Windows PowerShell Desired State Configuration?.For more information see Want to secure credentials in Windows PowerShell Desired State Configuration?.
  • ConfigurationID: geeft een GUID die wordt gebruikt voor het ophalen van een specifieke configuratie-bestand van een pull-service.ConfigurationID: Indicates a GUID which is used to get a particular configuration file from a pull service. De GUID zorgt ervoor dat de juiste configuratie-bestand wordt geopend.The GUID ensures that the correct configuration file is accessed.
  • ConfigurationMode: Hiermee geeft u op hoe de lokale Configuration Manager daadwerkelijk geldt de configuratie voor de doelknooppunten.ConfigurationMode: Specifies how the Local Configuration Manager actually applies the configuration to the target nodes. Het kan duren voordat de volgende waarden:It can take the following values:
    • ApplyOnly: met deze optie DSC geldt de configuratie en doet niets meer tenzij u een nieuwe configuratie wordt gedetecteerd, door u voor het verzenden van een nieuwe configuratie rechtstreeks naar het doelknooppunt of als u een verbinding met een pull-service en DSC een nieuwe configuratie detecteert wanneer er wordt gecontroleerd met de pull-service.ApplyOnly: With this option, DSC applies the configuration and does nothing further unless a new configuration is detected, either by you sending a new configuration directly to the target node or if you are connecting to a pull service and DSC discovers a new configuration when it checks with the pull service. Als het doelknooppunt configuratie drifts, wordt geen actie ondernomen.If the target node’s configuration drifts, no action is taken.
    • ApplyAndMonitor: met deze optie (dit is de standaardinstelling), DSC eventuele nieuwe configuraties van toepassing of door u rechtstreeks naar het doelknooppunt verzonden of op een pull-service gedetecteerd.ApplyAndMonitor: With this option (which is the default), DSC applies any new configurations, whether sent by you directly to the target node or discovered on a pull service. Als de configuratie van het doelknooppunt drifts uit het configuratiebestand, rapporten DSC daarna het verschil in Logboeken.Thereafter, if the configuration of the target node drifts from the configuration file, DSC reports the discrepancy in logs. Zie voor meer informatie over logboekregistratie van het DSC met behulp van gebeurtenislogboeken fouten opsporen in Desired State Configuration.For more about DSC logging, see Using Event Logs to Diagnose Errors in Desired State Configuration.
    • ApplyAndAutoCorrect: met deze optie DSC van toepassing is een nieuwe configuraties of door u rechtstreeks naar het doelknooppunt verzonden of op een pull-service gedetecteerd.ApplyAndAutoCorrect: With this option, DSC applies any new configurations, whether sent by you directly to the target node or discovered on a pull service. Daarna, als de configuratie van het doelknooppunt drifts uit het configuratiebestand, DSC rapporteert het verschil in Logboeken en probeert vervolgens de configuratie van het doel te brengen in overeenstemming met het configuratiebestand aanpassen.Thereafter, if the configuration of the target node drifts from the configuration file, DSC reports the discrepancy in logs, and then attempts to adjust the target node configuration to bring in compliance with the configuration file.
  • ConfigurationModeFrequencyMins: vertegenwoordigt de frequentie (in minuten) waarmee de achtergrondtoepassing van DSC probeert de huidige configuratie in het doelknooppunt te implementeren.ConfigurationModeFrequencyMins: Represents the frequency (in minutes) at which the background application of DSC attempts to implement the current configuration on the target node. De standaardwaarde is 15.The default value is 15. Deze waarde kan worden ingesteld in combinatie met RefreshMode.This value can be set in conjunction with RefreshMode. Wanneer RefreshMode is ingesteld op PULL, wordt het doelknooppunt neemt contact op met de configuration-service op basis van een interval instellen door RefreshFrequencyMins en downloadt de huidige configuratie.When RefreshMode is set to PULL, the target node contacts the configuration service at an interval set by RefreshFrequencyMins and downloads the current configuration. Ongeacht de waarde RefreshMode geldt de engine voor consistentie met het interval dat is ingesteld door ConfigurationModeFrequencyMins, de meest recente configuratie die is gedownload naar het doelknooppunt.Regardless of the RefreshMode value, at the interval set by ConfigurationModeFrequencyMins, the consistency engine applies the latest configuration that was downloaded to the target node. RefreshFrequencyMins moet worden ingesteld op een geheel getal veelvoud van ConfigurationModeFrequencyMins.RefreshFrequencyMins should be set to an integer multiple of ConfigurationModeFrequencyMins.
  • Referentie: Hiermee wordt aangegeven referenties (zoals met Get-Credential) vereist voor toegang tot externe resources, zoals contact opnemen met de configuration-service.Credential: Indicates credentials (as with Get-Credential) required to access remote resources, such as to contact the configuration service.
  • DownloadManagerCustomData: Hiermee geeft u een matrix met aangepaste gegevens die specifiek zijn voor het Downloadbeheer.DownloadManagerCustomData: Represents an array that contains custom data specific to the download manager.
  • DownloadManagerName: geeft de naam van de configuratie en de module Downloadbeheer.DownloadManagerName: Indicates the name of the configuration and module download manager.
  • RebootNodeIfNeeded: bepaalde configuratiewijzigingen op een doelknooppunt mogelijk moet u deze opnieuw worden opgestart voordat de wijzigingen worden toegepast.RebootNodeIfNeeded: Certain configuration changes on a target node might require it to be restarted for the changes to be applied. Met de waarde True, wordt deze eigenschap opnieuw opstarten van het knooppunt zodra de configuratie is volledig van toepassing is, zonder verdere waarschuwing.With the value True, this property will restart the node as soon as the configuration has been completely applies, without further warning. Als False (de standaardwaarde), de configuratie wordt voltooid, maar het knooppunt moet handmatig opnieuw worden gestart om de wijzigingen van kracht te laten worden.If False (the default value), the configuration will be completed, but the node must be restarted manually for the changes to take effect.
  • RefreshFrequencyMins: gebruikt wanneer u een pull-service hebt ingesteld.RefreshFrequencyMins: Used when you have set up a pull service. Vertegenwoordigt de frequentie (in minuten) waarmee de lokale Configuration Manager contact moet een pull-service opnemen voor het downloaden van de huidige configuratie.Represents the frequency (in minutes) at which the Local Configuration Manager contacts a pull service to download the current configuration. Deze waarde kan worden ingesteld in combinatie met ConfigurationModeFrequencyMins.This value can be set in conjunction with ConfigurationModeFrequencyMins. Wanneer RefreshMode is ingesteld op PULL, wordt het doelknooppunt neemt contact op met de pull-service op basis van een interval instellen door RefreshFrequencyMins en downloadt de huidige configuratie.When RefreshMode is set to PULL, the target node contacts the pull service at an interval set by RefreshFrequencyMins and downloads the current configuration. De engine voor consistentie met het interval is ingesteld door ConfigurationModeFrequencyMins, wordt de meest recente configuratie die is gedownload naar het doelknooppunt toegepast.At the interval set by ConfigurationModeFrequencyMins, the consistency engine then applies the latest configuration that was downloaded to the target node. Als RefreshFrequencyMins niet is ingesteld op een geheel getal veelvoud van ConfigurationModeFrequencyMins, het systeem wordt het naar boven afronden.If RefreshFrequencyMins is not set to an integer multiple of ConfigurationModeFrequencyMins, the system will round it up. De standaardwaarde is 30.The default value is 30.
  • RefreshMode: mogelijke waarden zijn Push (de standaardinstelling) en Pull.RefreshMode: Possible values are Push (the default) and Pull. In de configuratie van 'push', moet u een configuratiebestand op elk doelknooppunt plaatsen vanaf elke clientcomputer.In the “push” configuration, you must place a configuration file on each target node, using any client computer. In de modus 'pull', moet u een pull-service voor lokale Configuration Manager contact opnemen met en toegang tot de configuratiebestanden instellen.In the “pull” mode, you must set up a pull service for Local Configuration Manager to contact and access the configuration files.

Voorbeeld van de lokale Configuration Manager-instellingen bijwerkenExample of updating Local Configuration Manager settings

U kunt de lokale Configuration Manager-instellingen van een doelknooppunt bijwerken door een LocalConfigurationManager blokkeren binnen het blok knooppunt in een configuratiescript, zoals wordt weergegeven in het volgende voorbeeld.You can update the Local Configuration Manager settings of a target node by including a LocalConfigurationManager block inside the node block in a configuration script, as shown in the following example.

Configuration ExampleConfig
{
    Node “Server001”
    {
        LocalConfigurationManager
        {
            ConfigurationID = "646e48cb-3082-4a12-9fd9-f71b9a562d4e"
            ConfigurationModeFrequencyMins = 45
            ConfigurationMode = "ApplyAndAutocorrect"
            RefreshMode = "Pull"
            RefreshFrequencyMins = 90
            DownloadManagerName = "WebDownloadManager"
            DownloadManagerCustomData = (@{ServerUrl="https://$PullService/psdscpullserver.svc"})
            CertificateID = "71AA68562316FE3F73536F1096B85D66289ED60E"
            Credential = $cred
            RebootNodeIfNeeded = $true
            AllowModuleOverwrite = $false
        }
# One or more resource blocks can be added here
    }
}

# The following line invokes the configuration and creates a file called Server001.meta.mof at the specified path
ExampleConfig -OutputPath "c:\users\public\dsc"

Het script uitgevoerd in het vorige voorbeeld, genereert een MOF-bestand dat Hiermee geeft u en de gewenste instellingen worden opgeslagen.Running the script in the previous example generates a MOF file that specifies and stores the desired settings. Om de instellingen toepast, kunt u de Set DscLocalConfigurationManager cmdlet, zoals weergegeven in het volgende voorbeeld.To apply the settings, you can use the Set-DscLocalConfigurationManager cmdlet, as shown in the following example.

Set-DscLocalConfigurationManager -Path "c:\users\public\dsc"

Opmerking: voor de pad parameter, moet u hetzelfde pad dat u hebt opgegeven voor de OutputPath parameter bij het aanroepen van de configuratie in het vorige voorbeeld.Note: For the Path parameter, you must specify the same path that you specified for the OutputPath parameter when you invoked the configuration in the previous example.

Overzicht van de huidige instellingen van de lokale Configuration Manager, kunt u de Get-DscLocalConfigurationManager cmdlet.To see the current Local Configuration Manager settings, you can use the Get-DscLocalConfigurationManager cmdlet. Als u deze cmdlet zonder parameters aanroept, krijgt het standaard maar de lokale Configuration Manager-instellingen voor het knooppunt waarop u het uitvoert.If you invoke this cmdlet with no parameters, by default it will get the Local Configuration Manager settings for the node on which you run it. Een ander knooppunt, gebruikt u de CimSession parameter met deze cmdlet.To specify another node, use the CimSession parameter with this cmdlet.