Windows용 DSC(필요한 상태 구성) 시작

  • 아티클

이 문서에서는 Windows용 PowerShell Desired State Configuration(DSC)를 사용하는 방법을 설명합니다. DSC에 대한 일반적인 내용은 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 Automation State Configuration 사용하여 관리할 수 없습니다.

DSC 설치

PowerShell 필요한 상태 구성은 Windows에 포함되어 있으며 Windows Management Framework를 통해 업데이트됩니다. 최신 버전은 Windows Management Framework 5.1입니다.

참고

DSC를 사용하여 컴퓨터를 관리하기 위해 Windows Server 기능 'DSC-Service'를 사용하도록 설정할 필요가 없습니다. 이 기능은 Windows 끌어오기 서버 인스턴스를 빌드할 때만 필요합니다.

Windows용 DSC 사용

다음 섹션에서는 Windows 컴퓨터에서 DSC 구성을 만들고 실행하는 방법을 설명합니다.

구성 MOF 문서 만들기

Windows PowerShell Configuration 키워드는 구성을 만드는 데 사용됩니다. 다음 단계에서는 Windows PowerShell을 사용한 구성 문서 작성에 대해 설명합니다.

DSC 리소스를 포함하는 모듈 설치

Windows PowerShell 필요한 상태 구성에는 DSC 리소스를 포함하는 기본 제공 모듈이 포함되어 있습니다. PowerShellGet cmdlet을 사용하는 PowerShell 갤러리 같은 외부 소스에서 모듈을 로드할 수도 있습니다.

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를 실행할 수 있도록 하려면 localhost 구성을 실행 하는 경우에도 PowerShell 원격 명령을 받도록 Windows를 구성 해야 합니다. 환경을 올바르게 구성하려면 관리자 권한 PowerShell 터미널에서만 Set-WsManQuickConfig -Force 작동합니다.

Start-DscConfiguration cmdlet을 사용하여 컴퓨터에 MOF 파일(구성 문서)을 적용할 수 있습니다.

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

구성의 현재 상태 가져오기

Get-DscConfiguration cmdlet은 머신의 현재 상태를 쿼리하고 구성에 대한 현재 값을 반환합니다.

Get-DscConfiguration

Get-DscLocalConfigurationManager cmdlet은 머신에 적용된 현재 메타 구성을 반환합니다.

Get-DscLocalConfigurationManager

머신에서 현재 구성 제거

Remove-DscConfigurationDocument

Remove-DscConfigurationDocument -Stage Current -Verbose

로컬 구성 관리자에서 설정 구성

Set-DSCLocalConfigurationManager cmdlet을 사용하여 메타 구성 MOF 파일을 머신에 적용합니다. 메타 구성 MOF의 경로가 필요합니다.

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

Windows PowerShell 필요한 상태 구성 로그 파일

DSC에 대한 로그는 Windows 이벤트 로그에 Microsoft-Windows-Dsc/Operational 기록됩니다. DSC 이벤트 로그 위치의 단계에 따라 디버깅을 위해 다른 로그를 사용하도록 설정할 수 있습니다.