Wprowadzenie do Desired State Configuration (DSC) dla systemu Windows

W tym artykule wyjaśniono, jak rozpocząć korzystanie z programu PowerShell Desired State Configuration (DSC) dla systemu Windows. Aby uzyskać ogólne informacje o usłudze DSC, zobacz Wprowadzenie do Windows PowerShell Desired State Configuration.

Obsługiwane wersje systemu operacyjnego Windows

Obsługiwane są następujące wersje:

• Windows Server 2022
• Windows Server 2019
• Windows Server 2016
• Windows 11
• Windows 10

Autonomiczny produkt Microsoft Hyper-V Server nie zawiera implementacji Desired State Configuration, więc nie można nim zarządzać przy użyciu rozszerzenia DSC programu PowerShell ani Azure Automation State Configuration.

Instalowanie rozszerzenia DSC

Program PowerShell Desired State Configuration jest dołączony do systemu Windows i aktualizowany za pośrednictwem Windows Management Framework. Najnowsza wersja to Windows Management Framework 5.1.

Uwaga

Nie musisz włączać funkcji systemu Windows Server "DSC-Service", aby zarządzać maszyną przy użyciu kontrolera DSC. Ta funkcja jest potrzebna tylko w przypadku kompilowania wystąpienia serwera ściągania systemu Windows.

Korzystanie z rozszerzenia DSC dla systemu Windows

W poniższych sekcjach opisano sposób tworzenia i uruchamiania konfiguracji DSC na komputerach z systemem Windows.

Tworzenie dokumentu MOF konfiguracji

Słowo kluczowe Windows PowerShell Configuration służy do tworzenia konfiguracji. W poniższych krokach opisano tworzenie dokumentu konfiguracji przy użyciu Windows PowerShell.

Instalowanie modułu zawierającego zasoby DSC

Windows PowerShell Desired State Configuration zawiera wbudowane moduły zawierające zasoby DSC. Moduły można również ładować ze źródeł zewnętrznych, takich jak Galeria programu PowerShell, przy użyciu poleceń cmdlet PowerShellGet.

Install-Module 'PSDscResources' -Verbose

Zdefiniuj konfigurację i wygeneruj dokument konfiguracji:

Configuration EnvironmentVariable_Path
{
    param ()

    Import-DscResource -ModuleName 'PSDscResources'

    Node localhost
    {
        Environment CreatePathEnvironmentVariable
        {
            Name = 'TestPathEnvironmentVariable'
            Value = 'TestValue'
            Ensure = 'Present'
            Path = $true
            Target = @('Process', 'Machine')
        }
    }
}

EnvironmentVariable_Path -OutputPath:"./EnvironmentVariable_Path"

Stosowanie konfiguracji do maszyny

Uwaga

Aby umożliwić uruchamianie rozszerzenia DSC, system Windows musi być skonfigurowany do odbierania poleceń zdalnych programu PowerShell nawet w przypadku uruchamiania localhost konfiguracji. Aby poprawnie skonfigurować środowisko, wystarczy Set-WsManQuickConfig -Force w terminalu programu PowerShell z podwyższonym poziomem uprawnień.

Dokumenty konfiguracji (pliki MOF) można zastosować do maszyny za pomocą polecenia cmdlet Start-DscConfiguration .

Start-DscConfiguration -Path 'C:\EnvironmentVariable_Path' -Wait -Verbose

Pobieranie bieżącego stanu konfiguracji

Polecenie cmdlet Get-DscConfiguration wysyła zapytanie o bieżący stan maszyny i zwraca bieżące wartości konfiguracji.

Get-DscConfiguration

Polecenie cmdlet Get-DscLocalConfigurationManager zwraca bieżącą metakonfigurację zastosowaną do maszyny.

Get-DscLocalConfigurationManager

Usuwanie bieżącej konfiguracji z maszyny

Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

Konfigurowanie ustawień w Configuration Manager lokalnej

Zastosuj plik MOF Meta Configuration do maszyny przy użyciu polecenia cmdlet Set-DSCLocalConfigurationManager . Wymaga ścieżki do metafiguracyjnego narzędzia MOF.

Set-DSCLocalConfigurationManager -Path 'c:\metaconfig\localhost.meta.mof' -Verbose

pliki dziennika Windows PowerShell Desired State Configuration

Dzienniki dsC są zapisywane w dzienniku zdarzeń systemu Microsoft-Windows-Dsc/Operational Windows. Możesz włączyć inne dzienniki do celów debugowania, wykonując kroki opisane w temacie Where Are DSC Event Logs (Gdzie są dzienniki zdarzeń DSC).