Delen via


De LCM configureren in PowerShell 4.0

Van toepassing op: Windows PowerShell 4.0

Zie De lokale Configuration Manager configureren voor informatie met betrekking tot Windows PowerShell 5.0 en hoger.

Local Configuration Manager is de dsc-engine (Windows PowerShell Desired State Configuration). Het wordt uitgevoerd op alle doelknooppunten en is verantwoordelijk voor het aanroepen van de configuratieresources die zijn opgenomen in een DSC-configuratiescript. In dit onderwerp worden de eigenschappen van Local Configuration Manager beschreven en wordt beschreven hoe u de lokale Configuration Manager-instellingen op een doelknooppunt kunt wijzigen.

Eigenschappen van lokale Configuration Manager

Hieronder vindt u de lokale Configuration Manager eigenschappen die u kunt instellen of ophalen.

  • AllowModuleOverwrite: hiermee bepaalt u of nieuwe configuraties die zijn gedownload van de configuratieservice, de oude configuraties op het doelknooppunt mogen overschrijven. Mogelijke waarden zijn Waar en Onwaar.
  • CertificateID: De vingerafdruk van een certificaat dat wordt gebruikt voor het beveiligen van referenties die in een configuratie worden doorgegeven. Zie Wilt u referenties beveiligen in Windows PowerShell Desired State Configuration? voor meer informatie.
  • ConfigurationID: geeft een GUID aan die wordt gebruikt om een bepaald configuratiebestand op te halen uit een pull-service. De GUID zorgt ervoor dat het juiste configuratiebestand wordt geopend.
  • ConfigurationMode: hiermee geeft u op hoe de lokale Configuration Manager de configuratie daadwerkelijk toepast op de doelknooppunten. Het kan de volgende waarden hebben:
    • ApplyOnly: Met deze optie past DSC de configuratie toe en doet deze niets verder, tenzij er een nieuwe configuratie wordt gedetecteerd, hetzij door een nieuwe configuratie rechtstreeks naar het doelknooppunt te verzenden of als u verbinding maakt met een pull-service en DSC een nieuwe configuratie detecteert wanneer deze wordt gecontroleerd met de pull-service. Als de configuratie van het doelknooppunt afdrijft, wordt er geen actie ondernomen.
    • ApplyAndMonitor: met deze optie (de standaardinstelling) past DSC alle nieuwe configuraties toe, ongeacht of deze door u rechtstreeks naar het doelknooppunt worden verzonden of die zijn gedetecteerd in een pull-service. Daarna, als de configuratie van het doelknooppunt afdrijft van het configuratiebestand, rapporteert DSC de discrepantie in logboeken. Zie Gebeurtenislogboeken gebruiken om fouten in Desired State Configuration te diagnosticeren voor meer informatie over DSC-logboekregistratie.
    • ApplyAndAutoCorrect: Met deze optie past DSC alle nieuwe configuraties toe, ongeacht of deze door u rechtstreeks naar het doelknooppunt worden verzonden of die zijn gedetecteerd in een pull-service. Daarna, als de configuratie van het doelknooppunt afdrijft van het configuratiebestand, rapporteert DSC de discrepantie in logboeken en probeert vervolgens de configuratie van het doelknooppunt aan te passen om te voldoen aan het configuratiebestand.
  • ConfigurationModeFrequencyMins: Vertegenwoordigt de frequentie (in minuten) waarmee de achtergrondtoepassing van DSC de huidige configuratie op het doelknooppunt probeert te implementeren. De standaardwaarde is 15. Deze waarde kan worden ingesteld in combinatie met RefreshMode. Wanneer RefreshMode is ingesteld op PULL, neemt het doelknooppunt contact op met de configuratieservice met een interval dat is ingesteld door RefreshFrequencyMins en downloadt het de huidige configuratie. Ongeacht de waarde refreshmode past de consistentie-engine met het interval dat is ingesteld door ConfigurationModeFrequencyMins, de meest recente configuratie toe die is gedownload naar het doelknooppunt. RefreshFrequencyMins moet worden ingesteld op een veelvoud van het getal ConfigurationModeFrequencyMins.
  • Referentie: geeft referenties aan (zoals met Get-Credential) die vereist zijn voor toegang tot externe resources, zoals om contact op te maken met de configuratieservice.
  • DownloadManagerCustomData: vertegenwoordigt een matrix die aangepaste gegevens bevat die specifiek zijn voor de downloadmanager.
  • DownloadManagerName: geeft de naam aan van de configuratie- en moduledownloadbeheer.
  • RebootNodeIfNeeded: stel dit in op $true om resources toe te staan het knooppunt opnieuw op te starten met behulp van de $global:DSCMachineStatus vlag. Anders moet u het knooppunt handmatig opnieuw opstarten voor elke configuratie waarvoor dit is vereist. De standaardwaarde is $false. Als u deze instelling wilt gebruiken wanneer een voorwaarde voor opnieuw opstarten wordt uitgevoerd door iets anders dan DSC (zoals Windows Installer), combineert u deze instelling met de module xPendingReboot .
  • RefreshFrequencyMins: wordt gebruikt wanneer u een pull-service hebt ingesteld. Vertegenwoordigt de frequentie (in minuten) waarmee de Lokale Configuration Manager contact opneemt met een pull-service om de huidige configuratie te downloaden. Deze waarde kan worden ingesteld in combinatie met ConfigurationModeFrequencyMins. Wanneer RefreshMode is ingesteld op PULL, neemt het doelknooppunt contact op met de pull-service met een interval dat is ingesteld door RefreshFrequencyMins en downloadt het de huidige configuratie. Met het interval dat is ingesteld door ConfigurationModeFrequencyMins, past de consistentie-engine vervolgens de meest recente configuratie toe die is gedownload naar het doelknooppunt. Als RefreshFrequencyMins niet is ingesteld op een geheel getal van ConfigurationModeFrequencyMins, wordt het naar boven afgerond. De standaardwaarde is 30.
  • RefreshMode: mogelijke waarden zijn Push (de standaardinstelling) en Pull. In de push-configuratie moet u een configuratiebestand op elk doelknooppunt plaatsen met behulp van een clientcomputer. In de pull-modus moet u een pull-service instellen voor Lokale Configuration Manager om contact op te maken met en toegang te krijgen tot de configuratiebestanden.

Notitie

De LCM start de cyclus ConfigurationModeFrequencyMins op basis van:

  • Er wordt een nieuwe metaconfig toegepast met behulp van Set-DscLocalConfigurationManager
  • Een computer opnieuw opstarten

Voor elke situatie waarbij het timerproces vastloopt, wordt dit binnen 30 seconden gedetecteerd en wordt de cyclus opnieuw gestart. Een gelijktijdige bewerking kan het starten van de cyclus vertragen. Als de duur van deze bewerking de geconfigureerde cyclusfrequentie overschrijdt, wordt de volgende timer niet gestart.

De metaconfig wordt bijvoorbeeld geconfigureerd met een pull-frequentie van 15 minuten en een pull vindt plaats op T1. Het knooppunt werkt gedurende 16 minuten niet af. De eerste cyclus van 15 minuten wordt genegeerd en de volgende pull vindt plaats op T1+15+15.

Voorbeeld van het bijwerken van instellingen voor lokale Configuration Manager

U kunt de lokale Configuration Manager-instellingen van een doelknooppunt bijwerken door een LocalConfigurationManager-blok in het knooppuntblok op te plaatsen in een configuratiescript, zoals wordt weergegeven in het volgende voorbeeld.

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"

Als u het script in het vorige voorbeeld uitvoert, wordt een MOF-bestand gegenereerd waarin de gewenste instellingen worden opgegeven en opgeslagen. Als u de instellingen wilt toepassen, kunt u de cmdlet Set-DscLocalConfigurationManager gebruiken, zoals wordt weergegeven in het volgende voorbeeld.

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

Notitie

Voor de path-parameter moet u hetzelfde pad opgeven dat u hebt opgegeven voor de parameter OutputPath toen u de configuratie in het vorige voorbeeld aanriep.

Als u de huidige instellingen voor lokale Configuration Manager wilt zien, kunt u de cmdlet Get-DscLocalConfigurationManager gebruiken. Als u deze cmdlet zonder parameters aanroept, krijgt deze standaard de lokale Configuration Manager-instellingen voor het knooppunt waarop u de cmdlet uitvoert. Als u een ander knooppunt wilt opgeven, gebruikt u de parameter CimSession met deze cmdlet.