Konfigurera LCM i PowerShell 4.0

  • Artikel

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 motorn Windows PowerShell Desired State Configuration (DSC). 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 visar egenskaperna för Lokala Configuration Manager och beskriver hur du kan ändra inställningarna för lokala Configuration Manager på en målnod.

Egenskaper för lokala Configuration Manager

Följande visar 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 True och False.
  • CertificateID: Tumavtrycket för ett certifikat som används för att skydda autentiseringsuppgifter som skickats 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 ingenting 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 avdrivs vidtas ingen åtgärd.
    • ApplyAndMonitor: Med det här alternativet (som är standard) tillämpar DSC alla nya konfigurationer, oavsett om du skickas direkt till målnoden eller identifieras på en pull-tjänst. Om konfigurationen av målnoden därefter 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 Desired State Configuration.
    • ApplyAndAutoCorrect: Med det här alternativet tillämpar DSC alla nya konfigurationer, oavsett om de skickas direkt till målnoden eller identifieras på en pull-tjänst. Om konfigurationen av målnoden därefter avviker från konfigurationsfilen rapporterar DSC avvikelsen i loggarna och försöker sedan justera målnodkonfigurationen så att den överensstämmer med konfigurationsfilen.
  • ConfigurationModeFrequencyMins: Representerar frekvensen (i minuter) där 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 hämtar den aktuella konfigurationen. Oavsett Värdet RefreshMode tillämpar konsekvensmotorn den senaste konfigurationen som laddades ned till målnoden vid det intervall som anges av ConfigurationModeFrequencyMins. RefreshFrequencyMins ska anges till en heltalsmultipel för ConfigurationModeFrequencyMins.
  • Autentiseringsuppgifter: Anger autentiseringsuppgifter (som med Get-Credential) som krävs för å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 modulhämtningshanteraren.
  • RebootNodeIfNeededed: Ställ in på så att $true resurser kan starta om noden med $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 antas 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 frekvensen (i minuter) där 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 angetts av RefreshFrequencyMins och hämtar den aktuella konfigurationen. Vid 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å ett heltalsmultipel för ConfigurationModeFrequencyMins avrundar systemet det. 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 valfri klientdator. I läget "pull" måste du konfigurera en pull-tjänst för lokal Configuration Manager för att kontakta och komma åt konfigurationsfilerna.

Anteckning

LCM startar ConfigurationModeFrequencyMins-cykeln baserat på:

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

För alla villkor där den tidsinställda processen upplever en krasch identifieras det inom 30 sekunder och cykeln startas om. En samtidig åtgärd kan fördröja att cykeln startas, om varaktigheten för den här åtgärden överskrider den konfigurerade cykelfrekvensen startar inte nästa timer.

Till exempel konfigureras metakonfigurationen med 15 minuters hämtningsfrekvens och en hämtning sker vid T1. Noden slutförs inte på 16 minuter. Den första 15-minuterscykeln ignoreras och nästa hämtning sker vid T1+15+15.

Exempel på uppdatering av inställningar för lokala Configuration Manager

Du kan uppdatera inställningarna för lokala Configuration Manager för en målnod genom att inkludera ett LocalConfigurationManager-block i nodblocket i ett konfigurationsskript, enligt 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"

När 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"

Anteckning

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 inställningarna för lokala Configuration Manager kan du använda cmdleten Get-DscLocalConfigurationManager. Om du anropar den här cmdleten utan parametrar hämtas som standard inställningarna för lokal Configuration Manager för den nod som du kör den på. Om du vill ange en annan nod använder du parametern CimSession med den här cmdleten.