DSC WindowsFeatureSet 리소스

적용 대상: Windows PowerShell 5.x

PowerShell DSC(필요한 상태 구성)의 WindowsFeatureSet 리소스에서는 대상 노드에서 역할 및 기능을 추가 또는 제거하는 메커니즘을 제공합니다. 이 리소스는 Name 속성에 지정된 각 기능에 대해 WindowsFeature 리소스를 호출하는 복합 리소스입니다.

여러 Windows 기능을 동일한 상태로 구성하려는 경우 이 리소스를 사용합니다.

참고

이 DSC 리소스에 대한 이 설명서에서는 버전 7.2 이전의 PowerShell에 포함된 버전을 다룹니다. PSDscResources 모듈에는 Microsoft에서 공식적으로 지원하는 새 DSC 리소스와 업데이트된 DSC 리소스가 포함되어 있습니다. PSDscResources 모듈은 PowerShell 갤러리에서 사용할 수 있습니다.

자세한 내용 및 업데이트된 설명서는 PSDscResources 참조 설명서를 참조하세요.

구문

WindowsFeatureSet [string] #ResourceName
{
    Name = [string[]]
    [ Source = [string] ]
    [ IncludeAllSubFeature = [Boolean] ]
    [ Credential = [PSCredential] ]
    [ LogPath = [string] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

속성

속성	Description
Name	추가 또는 제거하려는 역할이나 기능의 이름입니다. 이것은 Get-WindowsFeature cmdlet의 Name 속성과 동일하며, 역할이나 기능의 표시 이름은 아닙니다.
원본	필요한 경우 설치에 사용할 소스 파일의 위치를 나타냅니다.
IncludeAllSubFeature	Name 속성에 지정하는 기능과 함께 모든 필수 하위 기능을 포함하려면 이 속성을 $true로 설정합니다.
자격 증명	역할 또는 기능을 추가 또는 제거하는 데 사용할 자격 증명입니다.
LogPath	리소스 공급자가 작업을 기록할 로그 파일의 경로입니다.

공용 속성

속성	Description
DependsOn	이 리소스를 구성하려면 먼저 다른 리소스의 구성을 실행해야 함을 나타냅니다. 예를 들어, 먼저 실행하려는 리소스 구성 스크립트 블록의 ID가 ResourceName이고 해당 형식이 ResourceType일 경우, 이 속성을 사용하기 위한 구문은 DependsOn = "[ResourceType]ResourceName"입니다.
Ensure	역할이나 기능이 추가되는지 여부를 지정합니다. 역할이나 기능이 추가되도록 하려면 이 속성을 Present로 설정합니다. 역할이나 기능이 제거되도록 하려면 이 속성을 Absent로 설정합니다. 기본값은 Present입니다.
PsDscRunAsCredential	전체 리소스를 실행하기 위한 자격 증명을 설정합니다.

참고

PsDscRunAsCredential 공용 속성은 다른 자격 증명의 컨텍스트에서 DSC 리소스를 실행할 수 있도록 WMF 5.0에 추가되었습니다. 자세한 내용은 DSC 리소스로 자격 증명 사용을 참조하세요.

예제

다음 구성은 웹 서버 (IIS) 및 SMTP 서버 기능과 각각의 모든 하위 기능이 설치되도록 합니다.

configuration FeatureSetTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node localhost
    {

        WindowsFeatureSet WindowsFeatureSetExample
        {
            Name                    = @("SMTP-Server", "Web-Server")
            Ensure                  = 'Present'
            IncludeAllSubFeature    = $true
        }
    }
}