Начало работы с Desired State Configuration (DSC) для Windows

Статья
12/05/2023

В этой статье объясняется, как приступить к работе с PowerShell Desired State Configuration (DSC) для Windows. Общие сведения о службе настройки требуемого состояния см. в разделе Начало работы со службой настройки требуемого состояния Windows PowerShell.

Поддерживаемые версии операционной системы Windows

Поддерживаются следующие версии:

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

Автономный продукт Microsoft Hyper-V Server не содержит реализации Desired State Configuration поэтому вы не можете управлять им с помощью PowerShell DSC или служба автоматизации Azure State Configuration.

Установка DSC

Desired State Configuration в PowerShell входит в состав Windows и обновляется с помощью Windows Management Framework. Последняя версия — Windows Management Framework 5.1.

Примечание

Для управления компьютером с помощью DSC не нужно включать функцию DSC-service Windows Server. Этот компонент необходим только при создании экземпляра опрашиваемого сервера Windows.

Использование DSC для Windows

В следующих разделах описывается создание и запуск конфигураций DSC на компьютерах Windows.

Создание MOF-документа конфигурации

Для создания конфигурации используется ключевое слово Windows PowerShell (Configuration). В инструкциях ниже описывается создание документа конфигурации с использованием Windows PowerShell.

Установка модуля, содержащего ресурсы DSC

Desired State Configuration в Windows PowerShell включает встроенные модули, содержащие ресурсы DSC. Модули также можно загружать из внешних источников, таких как коллекция PowerShell, с помощью командлетов PowerShellGet.

Install-Module 'PSDscResources' -Verbose

Определите конфигурацию и создайте документ конфигурации:

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"

Применение конфигурации к компьютеру

Примечание

Чтобы разрешить выполнение DSC, Windows необходимо настроить для получения удаленных команд PowerShell, даже когда вы запускаете конфигурацию localhost. Чтобы правильно настроить среду, просто Set-WsManQuickConfig -Force в терминале PowerShell с повышенными привилегиями.

Документы конфигурации (MOF-файлы) можно применить к компьютеру с помощью командлета Start-DscConfiguration .

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

Получение данных о текущем состоянии конфигурации

Командлет Get-DscConfiguration запрашивает текущее состояние компьютера и возвращает текущие значения для конфигурации.

Get-DscConfiguration

Командлет Get-DscLocalConfigurationManager возвращает текущую метаконфигурацию, примененную к компьютеру.

Get-DscLocalConfigurationManager

Удаление текущей конфигурации с компьютера

Командлет Remove-DscConfigurationDocument.

Remove-DscConfigurationDocument -Stage Current -Verbose

Настройка параметров в локальном диспетчере конфигураций

Примените MOF-файл метаконфигурации к компьютеру с помощью командлета Set-DSCLocalConfigurationManager. При этом потребуется указать путь к соответствующему MOF-файлу метаконфигурации.

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

Файлы журнала Desired State Configuration в Windows PowerShell

Журналы для DSC записываются в Microsoft-Windows-Dsc/Operational журнал событий Windows. Вы можете включить другие журналы для отладки, выполнив действия, описанные в разделе Where Are DSC Event Logs.