Sdílet prostřednictvím


Konfigurace LCM v PowerShellu 4.0

Platí pro: Windows PowerShell 4.0

Informace týkající se Windows PowerShell 5.0 a novějších najdete v tématu Konfigurace místního Configuration Manager.

Místní 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. Toto téma obsahuje seznam vlastností místního Configuration Manager a popisuje, jak můžete upravit nastavení místní Configuration Manager na cílovém uzlu.

Místní Configuration Manager vlastnosti

Následující seznam obsahuje místní Configuration Manager vlastnosti, které můžete nastavit nebo načíst.

  • AllowModuleOverwrite: Určuje, jestli nové konfigurace stažené z konfigurační služby můžou přepsat staré konfigurace na cílovém uzlu. Možné hodnoty jsou True a False.
  • CertificateID: Kryptografický otisk certifikátu, který se používá k zabezpečení přihlašovacích údajů předaných v konfiguraci. Další informace najdete v tématu Chcete zabezpečit přihlašovací údaje v Windows PowerShell Desired State Configuration?.
  • 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 mít následující hodnoty:
    • ApplyOnly: Při použití této možnosti DSC použije konfiguraci a neprovede nic dalšího, dokud se nezjistí nová konfigurace, 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 zjistí novou konfiguraci při kontrole se službou vyžádané replikace. Pokud dojde k posunu konfigurace cílového uzlu, neprovedou se žádné akce.
    • ApplyAndMonitor: Při použití této možnosti (která je výchozí) DSC použije všechny nové konfigurace bez ohledu na to, jestli jste je odeslali přímo do cílového uzlu, nebo zjistili ve službě vyžádané replikace. Pokud se poté konfigurace cílového uzlu odchyluje od konfiguračního souboru, DSC nahlásí nesrovnalosti v protokolech. Další informace o protokolování DSC najdete v tématu Diagnostika chyb v Desired State Configuration pomocí protokolů událostí.
    • ApplyAndAutoCorrect: Při použití této možnosti DSC použije všechny nové konfigurace, ať už je odešlete přímo do cílového uzlu nebo zjistíte ve službě vyžádané replikace. Pokud se poté konfigurace cílového uzlu odchyluje od konfiguračního souboru, DSC nahlásí nesrovnalosti v protokolech a pak 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 je možné nastavit ve spojení s funkcí RefreshMode. Když je RefreshMode nastavený na PULL, cílový uzel kontaktuje konfigurační službu v intervalu nastaveném v RefreshFrequencyMins a stáhne aktuální konfiguraci. Bez ohledu na hodnotu RefreshMode použije modul konzistence v intervalu nastaveném configurationModeFrequencyMins nejnovější konfiguraci staženou do cílového uzlu. RefreshFrequencyMins by měl být nastavený na celočíselné násobky ConfigurationModeFrequencyMins.
  • Credential: Označuje přihlašovací údaje (jako u příkazu 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 konfigurace a správce stahování modulů.
  • RebootNodeIfNeeded: Tuto možnost nastavte, $true aby prostředky mohly restartovat uzel pomocí příznaku $global:DSCMachineStatus . V opačném případě budete muset uzel restartovat ručně u jakékoli konfigurace, která to vyžaduje. Výchozí hodnota je $false. Chcete-li toto nastavení použít, když je podmínka restartování přijata něčím jiným než DSC (například Instalační službou systému Windows), zkombinujte toto nastavení s modulem xPendingReboot .
  • RefreshFrequencyMins: Používá se při nastavení služby vyžádané replikace. Představuje frekvenci (v minutách), s jakou místní Configuration Manager kontaktuje službu vyžádané replikace za účelem stažení aktuální konfigurace. Tuto hodnotu lze nastavit ve spojení s ConfigurationModeFrequencyMins. Když je RefreshMode nastavená na PULL, cílový uzel kontaktuje službu vyžádané replikace 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í. Výchozí hodnota je 30.
  • RefreshMode: Možné hodnoty jsou Push (výchozí) a Pull. V konfiguraci nabízených oznámení musíte na každý cílový uzel umístit konfigurační soubor pomocí libovolného klientského počítače. V režimu vyžádání replikace musíte nastavit službu vyžádání pro místní Configuration Manager pro kontaktování a přístup ke konfiguračním souborům.

Poznámka

LCM spustí cyklus ConfigurationModeFrequencyMins na základě:

  • Použije se nová metakonfigura. Set-DscLocalConfigurationManager
  • Restartování počítače

U všech podmínek, kdy dojde k chybovému ukončení procesu časovače, se zjistí do 30 sekund a cyklus se restartuje. Souběžná operace může zpozdit spuštění cyklu. Pokud doba trvání této operace překročí nakonfigurovanou frekvenci cyklu, další časovač se nespustí.

Metakonfiguruje se například na 15minutové frekvenci vyžádání a k vyžádání změn dochází v T1. Uzel nedokončí práci po dobu 16 minut. První 15minutový cyklus se ignoruje a další přijetí změn proběhne v T1+15+15.

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

Nastavení místního 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í skriptu v předchozím příkladu vygeneruje soubor MOF, který určuje a ukládá požadovaná nastavení. Nastavení můžete použít pomocí rutiny 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á místní Configuration Manager pro uzel, na kterém ji spustíte. Pokud chcete zadat jiný uzel, použijte s touto rutinou parametr CimSession .