Konfigurowanie programu LCM w programie PowerShell 4.0

  • Artykuł

Dotyczy: Windows PowerShell 4.0

Aby uzyskać informacje dotyczące Windows PowerShell 5.0 i nowszych wersji, zobacz Konfigurowanie Configuration Manager lokalnego.

Lokalny Configuration Manager jest aparatem Windows PowerShell Desired State Configuration (DSC). Jest on uruchamiany na wszystkich węzłach docelowych i jest odpowiedzialny za wywoływanie zasobów konfiguracji, które są zawarte w skry skryptu konfiguracji DSC. W tym temacie wymieniono właściwości Configuration Manager lokalnego i opisano sposób modyfikowania ustawień Configuration Manager lokalnych w węźle docelowym.

Właściwości Configuration Manager lokalnego

Poniżej wymieniono właściwości Configuration Manager lokalne, które można ustawić lub pobrać.

  • AllowModuleOverwrite: określa, czy nowe konfiguracje pobrane z usługi konfiguracji mogą zastąpić stare w węźle docelowym. Możliwe wartości to True i False.
  • CertificateID: odcisk palca certyfikatu używanego do zabezpieczania poświadczeń przekazanych w konfiguracji. Aby uzyskać więcej informacji, zobacz Chcesz zabezpieczyć poświadczenia w Windows PowerShell Desired State Configuration?.
  • ConfigurationID: wskazuje identyfikator GUID używany do pobierania określonego pliku konfiguracji z usługi ściągania. Identyfikator GUID zapewnia dostęp do poprawnego pliku konfiguracji.
  • ConfigurationMode: określa, jak Configuration Manager lokalne faktycznie stosuje konfigurację do węzłów docelowych. Może ona przyjmować następujące wartości:
    • ApplyOnly: W przypadku tej opcji rozszerzenie DSC stosuje konfigurację i nie wykonuje żadnych dalszych czynności, chyba że zostanie wykryta nowa konfiguracja, wysyłając nową konfigurację bezpośrednio do węzła docelowego lub jeśli łączysz się z usługą ściągania, a ROZSZERZENIE DSC odnajduje nową konfigurację podczas sprawdzania za pomocą usługi ściągania. Jeśli konfiguracja węzła docelowego dryfuje, nie zostanie podjęta żadna akcja.
    • ApplyAndMonitor: przy użyciu tej opcji (która jest domyślna), rozszerzenie DSC stosuje wszelkie nowe konfiguracje, niezależnie od tego, czy wysyłane bezpośrednio do węzła docelowego, czy odnalezione w usłudze ściągania. Następnie, jeśli konfiguracja węzła docelowego dryfuje z pliku konfiguracji, DSC zgłasza niezgodność w dziennikach. Aby uzyskać więcej informacji na temat rejestrowania DSC, zobacz Używanie dzienników zdarzeń do diagnozowania błędów w Desired State Configuration.
    • ApplyAndAutoCorrect: dzięki tej opcji rozszerzenie DSC stosuje wszelkie nowe konfiguracje, niezależnie od tego, czy wysyłane bezpośrednio do węzła docelowego, czy odnalezione w usłudze ściągania. Następnie, jeśli konfiguracja węzła docelowego dryfuje z pliku konfiguracji, DSC zgłasza niezgodność w dziennikach, a następnie próbuje dostosować konfigurację węzła docelowego, aby zapewnić zgodność z plikiem konfiguracji.
  • ConfigurationModeFrequencyMins: reprezentuje częstotliwość (w minutach), z jaką aplikacja DSC w tle próbuje zaimplementować bieżącą konfigurację w węźle docelowym. Wartość domyślna to 15. Tę wartość można ustawić w połączeniu z trybem RefreshMode. Gdy właściwość RefreshMode ma wartość PULL, węzeł docelowy kontaktuje się z usługą konfiguracji w interwale ustawionym przez polecenie RefreshFrequencyMins i pobiera bieżącą konfigurację. Niezależnie od wartości RefreshMode w interwale ustawionym przez configurationModeFrequencyMins aparat spójności stosuje najnowszą konfigurację pobraną do węzła docelowego. Właściwość RefreshFrequencyMins powinna być ustawiona na wielokrotność liczby całkowitej configurationModeFrequencyMins.
  • Poświadczenie: wskazuje poświadczenia (podobnie jak w przypadku polecenia Get-Credential) wymagane do uzyskania dostępu do zasobów zdalnych, takich jak kontakt z usługą konfiguracji.
  • DownloadManagerCustomData: reprezentuje tablicę zawierającą dane niestandardowe specyficzne dla menedżera pobierania.
  • DownloadManagerName: wskazuje nazwę menedżera pobierania konfiguracji i modułu.
  • RebootNodeIfNeeded: ustaw tę opcję, aby $true umożliwić zasobom ponowne uruchomienie węzła przy użyciu flagi $global:DSCMachineStatus . W przeciwnym razie konieczne będzie ręczne ponowne uruchomienie węzła dla każdej wymaganej konfiguracji. Wartość domyślna to $false. Aby użyć tego ustawienia, gdy warunek ponownego rozruchu zostanie uchwalony przez coś innego niż DSC (np. Instalator Windows), połącz to ustawienie z modułem xPendingReboot .
  • RefreshFrequencyMins: używany podczas konfigurowania usługi ściągania. Reprezentuje częstotliwość (w minutach), z jaką lokalny Configuration Manager kontaktuje się z usługą ściągania w celu pobrania bieżącej konfiguracji. Tę wartość można ustawić w połączeniu z configurationModeFrequencyMins. Gdy właściwość RefreshMode ma wartość PULL, węzeł docelowy kontaktuje się z usługą ściągania w odstępach czasu ustawionym przez polecenie RefreshFrequencyMins i pobiera bieżącą konfigurację. W interwale ustawionym przez configurationModeFrequencyMins aparat spójności stosuje najnowszą konfigurację pobraną do węzła docelowego. Jeśli właściwość RefreshFrequencyMins nie jest ustawiona na liczbę całkowitą wielu parametrów ConfigurationModeFrequencyMins, system zaokrągli go w górę. Wartość domyślna to 30.
  • RefreshMode: możliwe wartości to Wypychanie (wartość domyślna) i Ściąganie. W konfiguracji "wypychania" należy umieścić plik konfiguracji w każdym węźle docelowym przy użyciu dowolnego komputera klienckiego. W trybie "ściągania" należy skonfigurować usługę ściągania dla Configuration Manager lokalnej, aby kontaktować się z plikami konfiguracji i uzyskiwać do ich dostępu.

Uwaga

Narzędzie LCM uruchamia cykl ConfigurationModeFrequencyMins na podstawie:

  • Nowa metakonfigura jest stosowana przy użyciu polecenia Set-DscLocalConfigurationManager
  • Ponowne uruchomienie maszyny

W przypadku dowolnego stanu, w którym proces czasomierza doświadcza awarii, zostanie wykryty w ciągu 30 sekund, a cykl zostanie uruchomiony ponownie. Współbieżna operacja może opóźnić rozpoczęcie cyklu, jeśli czas trwania tej operacji przekroczy skonfigurowaną częstotliwość cyklu, następny czasomierz nie zostanie uruchomiony.

Na przykład konfiguracja metakonfiguracji jest skonfigurowana z częstotliwością ściągnięcia na 15 minut, a ściąganie następuje w T1. Węzeł nie kończy pracy przez 16 minut. Pierwszy cykl 15 minut jest ignorowany, a następne ściągnięcie nastąpi w T1+15+15.

Przykład aktualizowania ustawień Configuration Manager lokalnych

Ustawienia lokalnego Configuration Manager węzła docelowego można zaktualizować, włączając blok LocalConfigurationManager wewnątrz bloku węzła w skrypcie konfiguracji, jak pokazano w poniższym przykładzie.

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"

Uruchomienie skryptu w poprzednim przykładzie generuje plik MOF, który określa i przechowuje żądane ustawienia. Aby zastosować ustawienia, możesz użyć polecenia cmdlet Set-DscLocalConfigurationManager , jak pokazano w poniższym przykładzie.

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

Uwaga

Dla parametru Ścieżka należy określić tę samą ścieżkę, która została określona dla parametru OutputPath podczas wywoływanej konfiguracji w poprzednim przykładzie.

Aby wyświetlić bieżące ustawienia lokalnego Configuration Manager, możesz użyć polecenia cmdlet Get-DscLocalConfigurationManager. Jeśli wywołasz to polecenie cmdlet bez parametrów, domyślnie uzyska on ustawienia lokalnego Configuration Manager dla węzła, na którym jest uruchamiany. Aby określić inny węzeł, użyj parametru CimSession z tym poleceniem cmdlet.