Dela via

Konfigurera LCM i PowerShell 4.0

Gäller för: Windows PowerShell 4.0

Information om Windows PowerShell 5.0 och senare finns i Konfigurera den lokala Configuration Manager.

Lokal Configuration Manager är Windows PowerShell DSC-motorn (Desired State Configuration). Den körs på alla målnoder och ansvarar för att anropa de konfigurationsresurser som ingår i ett DSC-konfigurationsskript. Det här avsnittet innehåller egenskaperna för den lokala Configuration Manager och beskriver hur du kan ändra inställningarna för den lokala Configuration Manager på en målnod.

Egenskaper för lokal Configuration Manager

Här visas en lista över de lokala Configuration Manager egenskaper som du kan ange eller hämta.

  • AllowModuleOverwrite: Styr om nya konfigurationer som laddats ned från konfigurationstjänsten får skriva över de gamla på målnoden. Möjliga värden är Sant och Falskt.
  • CertificateID: Tumavtrycket för ett certifikat som används för att skydda autentiseringsuppgifter som skickas i en konfiguration. Mer information finns i Vill du skydda autentiseringsuppgifter i Windows PowerShell Desired State Configuration?.
  • ConfigurationID: Anger ett GUID som används för att hämta en viss konfigurationsfil från en pull-tjänst. GUID säkerställer att rätt konfigurationsfil används.
  • ConfigurationMode: Anger hur den lokala Configuration Manager faktiskt tillämpar konfigurationen på målnoderna. Det kan ta följande värden:
    • ApplyOnly: Med det här alternativet tillämpar DSC konfigurationen och gör inget ytterligare om inte en ny konfiguration identifieras, antingen genom att du skickar en ny konfiguration direkt till målnoden eller om du ansluter till en pull-tjänst och DSC identifierar en ny konfiguration när den kontrollerar med pull-tjänsten. Om målnodens konfiguration avviker vidtas ingen åtgärd.
    • ApplyAndMonitor: Med det här alternativet (som är standard) tillämpar DSC alla nya konfigurationer, oavsett om de skickas av dig direkt till målnoden eller identifieras på en pull-tjänst. Därefter, om konfigurationen av målnoden avviker från konfigurationsfilen, rapporterar DSC avvikelsen i loggarna. Mer information om DSC-loggning finns i Använda händelseloggar för att diagnostisera fel i önskad tillståndskonfiguration.
    • ApplyAndAutoCorrect: Med det här alternativet tillämpar DSC alla nya konfigurationer, oavsett om de skickas av dig direkt till målnoden eller identifieras på en pull-tjänst. Därefter, om konfigurationen av målnoden avviker från konfigurationsfilen, rapporterar DSC avvikelsen i loggarna och försöker sedan justera målnodens konfiguration så att den överensstämmer med konfigurationsfilen.
  • ConfigurationModeFrequencyMins: Representerar den frekvens (i minuter) med vilken bakgrundsprogrammet för DSC försöker implementera den aktuella konfigurationen på målnoden. Standardvärdet är 15. Det här värdet kan anges tillsammans med RefreshMode. När RefreshMode är inställt på PULL kontaktar målnoden konfigurationstjänsten med ett intervall som anges av RefreshFrequencyMins och laddar ned den aktuella konfigurationen. Oavsett RefreshMode-värdet, med det intervall som anges av ConfigurationModeFrequencyMins, tillämpar konsekvensmotorn den senaste konfigurationen som laddades ned till målnoden. RefreshFrequencyMins ska anges till en heltalsmultipel av ConfigurationModeFrequencyMins.
  • Autentiseringsuppgifter: Anger autentiseringsuppgifter (som med Get-Credential) som krävs för att få åtkomst till fjärrresurser, till exempel för att kontakta konfigurationstjänsten.
  • DownloadManagerCustomData: Representerar en matris som innehåller anpassade data som är specifika för nedladdningshanteraren.
  • DownloadManagerName: Anger namnet på konfigurations- och modulnedladdningshanteraren.
  • RebootNodeIfNeeded: Ställ in detta på $true att tillåta att resurser startar om noden med hjälp av $global:DSCMachineStatus flaggan. Annars måste du starta om noden manuellt för alla konfigurationer som kräver den. Standardvärdet är $false. Om du vill använda den här inställningen när ett omstartsvillkor utförs av något annat än DSC (till exempel Windows Installer) kombinerar du den här inställningen med modulen xPendingReboot .
  • RefreshFrequencyMins: Används när du har konfigurerat en pull-tjänst. Representerar den frekvens (i minuter) då den lokala Configuration Manager kontaktar en pull-tjänst för att ladda ned den aktuella konfigurationen. Det här värdet kan anges tillsammans med ConfigurationModeFrequencyMins. När RefreshMode är inställt på PULL kontaktar målnoden pull-tjänsten med ett intervall som anges av RefreshFrequencyMins och laddar ned den aktuella konfigurationen. Med det intervall som anges av ConfigurationModeFrequencyMins tillämpar konsekvensmotorn sedan den senaste konfigurationen som laddades ned till målnoden. Om RefreshFrequencyMins inte är inställt på en heltalsmultipel av ConfigurationModeFrequencyMins avrundar systemet det uppåt. Standardvärdet är 30.
  • RefreshMode: Möjliga värden är Push (standard) och Pull. I "push"-konfigurationen måste du placera en konfigurationsfil på varje målnod med hjälp av valfri klientdator. I "pull"-läget måste du konfigurera en pull-tjänst för att Local Configuration Manager ska kunna kontakta och komma åt konfigurationsfilerna.

Anmärkning

LCM startar ConfigurationModeFrequencyMins-cykeln baserat på:

  • En ny metaconfig tillämpas med hjälp av Set-DscLocalConfigurationManager
  • En omstart av datorn

För alla tillstånd där timerprocessen upplever en krasch kommer det att upptäckas inom 30 sekunder och cykeln kommer att startas om. En samtidig operation kan fördröja cykeln från att startas, om varaktigheten för denna operation överskrider den konfigurerade cykelfrekvensen kommer nästa timer inte att starta.

Metaconfig konfigureras till exempel med en hämtningsfrekvens på 15 minuter och en hämtning sker vid T1. Noden avslutar inte arbetet på 16 minuter. Den första 15-minuterscykeln ignoreras och nästa dragning sker vid T1+15+15.

Exempel på uppdatering av lokala Configuration Manager-inställningar

Du kan uppdatera de lokala Configuration Manager-inställningarna för en målnod genom att inkludera ett LocalConfigurationManager-block i nodblocket i ett konfigurationsskript, som du ser i följande exempel.

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"

Om du kör skriptet i föregående exempel genereras en MOF-fil som anger och lagrar önskade inställningar. Om du vill tillämpa inställningarna kan du använda cmdleten Set-DscLocalConfigurationManager , som du ser i följande exempel.

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

Anmärkning

För parametern Path måste du ange samma sökväg som du angav för parametern OutputPath när du anropade konfigurationen i föregående exempel.

Om du vill se de aktuella lokala Configuration Manager inställningarna kan du använda cmdleten Get-DscLocalConfigurationManager . Om du anropar den här cmdleten utan parametrar hämtar den som standard de lokala Configuration Manager-inställningarna för noden som du kör den på. Om du vill ange en annan nod använder du parametern CimSession med den här cmdleten.