DSC WindowsFeatureSet 리소스DSC WindowsFeatureSet Resource

적용 대상: Windows PowerShell 5.0Applies To: Windows PowerShell 5.0

PowerShell DSC(필요한 상태 구성)의 WindowsFeatureSet 리소스에서는 대상 노드에서 역할 및 기능을 추가 또는 제거하는 메커니즘을 제공합니다.The WindowsFeatureSet resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to ensure that roles and features are added or removed on a target node. 이 리소스는 Name 속성에 지정된 각 기능에 대해 WindowsFeature 리소스를 호출하는 복합 리소스입니다.This resource is a composite resource that calls the WindowsFeature resource for each feature specified in the Name property.

여러 Windows 기능을 동일한 상태로 구성하려는 경우 이 리소스를 사용합니다.Use this resource when you want to configure a number of Windows Features to the same state.

구문Syntax

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

}

속성Properties

속성Property 설명Description
이름Name 추가 또는 제거하려는 역할이나 기능의 이름입니다.The names of the roles or features that you want to ensure are added or removed. 이것은 Get-WindowsFeature cmdlet의 Name 속성과 동일하며, 역할이나 기능의 표시 이름은 아닙니다.This is the same as the Name property of the Get-WindowsFeature cmdlet, and not the display name of the roles or features.
자격 증명Credential 역할 또는 기능을 추가 또는 제거하는 데 사용할 자격 증명입니다.The credentials to use to add or remove the roles or features.
EnsureEnsure 역할이나 기능이 추가되는지 여부를 지정합니다.Indicates whether the roles or features are added. 역할이나 기능이 추가되도록 하려면 이 속성을 "Present"로 설정하고, 역할이나 기능이 제거되도록 하려면 이 속성을 "Absent"로 설정합니다.To ensure that the roles or features are added, set this property to "Present" To ensure that the roles or features are removed, set the property to "Absent".
IncludeAllSubFeatureIncludeAllSubFeature Name 속성에 지정하는 기능과 함께 모든 필수 하위 기능을 포함하려면 이 속성을 $true로 설정합니다.Set this property to $true to include all required subfeatures with of the features you specify with the Name property.
LogPathLogPath 리소스 공급자가 작업을 기록할 로그 파일의 경로입니다.The path to a log file where you want the resource provider to log the operation.
DependsOnDependsOn 이 리소스를 구성하려면 먼저 다른 리소스의 구성을 실행해야 함을 나타냅니다.Indicates that the configuration of another resource must run before this resource is configured. 예를 들어, 먼저 실행하려는 리소스 구성 스크립트 블록의 ID가 __ResourceName__이고 해당 형식이 __ResourceType__일 경우, 이 속성을 사용하기 위한 구문은 DependsOn = "[ResourceType]ResourceName"입니다.For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".
원본Source 필요한 경우 설치에 사용할 소스 파일의 위치를 나타냅니다.Indicates the location of the source file to use for installation, if necessary.

예제Example

다음 구성을 사용하면 Web-Server(IIS) 및 SMTP 서버 기능과 각각의 모든 하위 기능이 설치됩니다.The following configuration ensures that the Web-Server (IIS) and SMTP Server features, and all subfeatures of each, are installed.

configuration FeatureSetTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration
    Node localhost
    {

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