Konfigurace LCM v PowerShellu 4.0

Platí pro: Windows PowerShell 4.0

Informace týkající se prostředí Windows PowerShell 5.0 a novějšího naleznete v tématu Konfigurace místního nástroje Configuration Manager.

Local Configuration Manager je modul Windows PowerShell Desired State Configuration (DSC). Běží na všech cílových uzlech a zodpovídá za volání konfiguračních prostředků, které jsou součástí konfiguračního skriptu DSC. V tomto tématu jsou uvedeny vlastnosti nástroje Local Configuration Manager a popsáno, jak lze upravit nastavení Local Configuration Manager na cílovém uzlu.

Vlastnosti místního nástroje Configuration Manager

V následujícím textu jsou uvedeny vlastnosti místního Configuration Manageru, které můžete nastavit nebo načíst.

• AllowModuleOverwrite: Určuje, jestli nové konfigurace stažené z konfigurační služby mohou přepsat staré konfigurace v cílovém uzlu. Možné hodnoty jsou True a False.
• CertificateID: Kryptografický otisk certifikátu používaného k zabezpečení přihlašovacích údajů předaných v konfiguraci. Další informace naleznete v tématu Chcete zabezpečit přihlašovací údaje v konfiguraci požadovaného stavu prostředí Windows PowerShell?.
• ConfigurationID: Označuje identifikátor GUID, který se používá k získání konkrétního konfiguračního souboru ze služby vyžádané replikace. Identifikátor GUID zajišťuje přístup ke správnému konfiguračnímu souboru.
• ConfigurationMode: Určuje, jak místní Configuration Manager skutečně použije konfiguraci na cílové uzly. Může nabývat následujících hodnot:
  • ApplyOnly: S touto možností DSC použije konfiguraci a neprovede žádnou další akci, pokud se nezjistí nová konfigurace, a to buď odesláním nové konfigurace přímo do cílového uzlu, nebo pokud se připojujete ke službě vyžádané replikace a DSC při kontrole pomocí služby vyžádané replikace zjistí novou konfiguraci. Pokud dojde k posunutí konfigurace cílového uzlu, neprovede se žádná akce.
  • ApplyAndMonitor: S touto možností (což je výchozí nastavení) DSC použije všechny nové konfigurace, ať už je odeslate přímo do cílového uzlu, nebo zjistíte ve službě vyžádání. Pokud se poté konfigurace cílového uzlu odchýlí od konfiguračního souboru, DSC nahlásí nesrovnalost v protokolech. Další informace o protokolování DSC najdete v tématu Použití protokolů událostí k diagnostice chyb v konfiguraci požadovaného stavu.
  • ApplyAndAutoCorrect: S touto možností DSC použije všechny nové konfigurace, ať už jsou odeslány přímo do cílového uzlu, nebo zjištěny ve službě vyžádání. Pokud se poté konfigurace cílového uzlu odchýlí od konfiguračního souboru, DSC nahlásí nesrovnalosti v protokolech a poté se pokusí upravit konfiguraci cílového uzlu tak, aby byla v souladu s konfiguračním souborem.
• ConfigurationModeFrequencyMins: Představuje frekvenci (v minutách), s jakou se aplikace DSC na pozadí pokusí implementovat aktuální konfiguraci na cílovém uzlu. Výchozí hodnota je 15. Tuto hodnotu lze nastavit ve spojení s RefreshMode. Pokud je RefreshMode nastavená hodnota PULL, cílový uzel kontaktuje konfigurační službu v intervalu nastaveném parametrem RefreshFrequencyMins a stáhne aktuální konfiguraci. Bez ohledu na hodnotu RefreshMode použije modul konzistence v intervalu nastaveném parametrem ConfigurationModeFrequencyMins nejnovější konfiguraci, která byla stažena do cílového uzlu. RefreshFrequencyMins by měl být nastaven na celočíselný násobek ConfigurationModeFrequencyMins.
• Přihlašovací údaje: Označuje přihlašovací údaje (jako u Get-Credential) potřebné pro přístup ke vzdáleným prostředkům, například ke kontaktování konfigurační služby.
• DownloadManagerCustomData: Představuje pole, které obsahuje vlastní data specifická pro správce stahování.
• DownloadManagerName: Označuje název správce stahování konfigurace a modulu.
• RebootNodeIfNeeded: Nastavením této možnosti umožníte $true prostředkům restartovat uzel pomocí příznaku $global:DSCMachineStatus . Jinak budete muset ručně restartovat uzel pro všechny konfigurace, které ho vyžadují. Výchozí hodnota je $false. Chcete-li toto nastavení použít v případě, že podmínku restartování provádí něco jiného než DSC (například Instalační služba systému Windows), zkombinujte toto nastavení s modulem xPendingReboot .
• RefreshFrequencyMins: Používá se při nastavení služby vyžádání replikace. Představuje frekvenci (v minutách), s jakou místní Configuration Manager kontaktuje službu vyžádané replikace, aby stáhla aktuální konfiguraci. Tuto hodnotu lze nastavit ve spojení s ConfigurationModeFrequencyMins. Pokud je RefreshMode nastavená hodnota PULL, cílový uzel kontaktuje službu vyžádání vyžádání v intervalu nastaveném parametrem RefreshFrequencyMins a stáhne aktuální konfiguraci. V intervalu nastaveném parametrem ConfigurationModeFrequencyMins pak modul konzistence použije nejnovější konfiguraci, která byla stažena do cílového uzlu. Pokud RefreshFrequencyMins není nastavený na celočíselný násobek ConfigurationModeFrequencyMins, systém ho zaokrouhlí nahoru. Výchozí hodnota je 30.
• RefreshMode: Možné hodnoty jsou Push (výchozí) a Pull. V konfiguraci "push" musíte umístit konfigurační soubor na každý cílový uzel pomocí libovolného klientského počítače. V režimu "pull" musíte nastavit službu pull pro Local Configuration Manager, aby kontaktovala konfigurační soubory a přistupovala k nim.

Poznámka:

LCM spustí cyklus ConfigurationModeFrequencyMins na základě:

• Nový metaconfig je aplikován pomocí Set-DscLocalConfigurationManager
• Restartování počítače

V případě jakéhokoli stavu, kdy dojde k chybě procesu časovače, bude zjištěna do 30 sekund a cyklus bude restartován. Souběžná operace by mohla zpozdit spuštění cyklu, pokud doba trvání této operace překročí nakonfigurovanou frekvenci cyklu, další časovač se nespustí.

Příklad: metaconfig je nakonfigurován na 15minutovou frekvenci pull a k pull dojde v T1. Uzel nedokončí práci po dobu 16 minut. První 15minutový cyklus je ignorován a další tah nastane v T1+15+15.

Příklad aktualizace nastavení místního Configuration Manager

Nastavení místního nástroje Configuration Manager cílového uzlu můžete aktualizovat zahrnutím bloku LocalConfigurationManager do bloku uzlu v konfiguračním skriptu, jak je znázorněno v následujícím příkladu.

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"

Spuštěním skriptu v předchozím příkladu se vygeneruje soubor MOF, který určuje a ukládá požadovaná nastavení. Pokud chcete nastavení použít, můžete použít rutinu Set-DscLocalConfigurationManager , jak je znázorněno v následujícím příkladu.

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

Poznámka:

Pro parametr Path musíte zadat stejnou cestu, kterou jste zadali pro parametr OutputPath při vyvolání konfigurace v předchozím příkladu.

Pokud chcete zobrazit aktuální nastavení místního Configuration Manager, můžete použít rutinu Get-DscLocalConfigurationManager . Pokud tuto rutinu vyvoláte bez parametrů, ve výchozím nastavení získá nastavení Local Configuration Manager pro uzel, na kterém ji spouštíte. Chcete-li zadat jiný uzel, použijte parametr CimSession s touto rutinou.