Recurso do WindowsFeatureSet DSCDSC WindowsFeatureSet Resource

Aplica-se a: Windows PowerShell 5.0Applies To: Windows PowerShell 5.0

O recurso WindowsFeatureSet na Configuração de Estado Desejado (DSC) do Windows PowerShell fornece um mecanismo para garantir que funções e recursos sejam adicionados ou removidos em um nó de destino.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. Esse recurso é um recurso composto que chama o recurso WindowsFeature para cada recurso especificado na propriedade Name.This resource is a composite resource that calls the WindowsFeature resource for each feature specified in the Name property.

Use esse recurso quando desejar configurar vários Recursos do Windows para o mesmo estado.Use this resource when you want to configure a number of Windows Features to the same state.

SintaxeSyntax

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

}

PropriedadesProperties

PropriedadeProperty DescriçãoDescription
NomeName Os nomes de funções ou recursos que você deseja garantir são adicionados ou removidos.The names of the roles or features that you want to ensure are added or removed. É igual à propriedade Name do cmdlet Get-WindowsFeature, e não o nome de exibição das funções ou recursos.This is the same as the Name property of the Get-WindowsFeature cmdlet, and not the display name of the roles or features.
CredentialCredential As credenciais que devem ser usadas para adicionar ou remover as funções ou os recursos.The credentials to use to add or remove the roles or features.
EnsureEnsure Indica se as funções ou os recursos são adicionados.Indicates whether the roles or features are added. Para garantir que as funções ou os recursos sejam adicionados, defina essa propriedade como "Presente"; para garantir que as funções ou os recursos sejam removido, defina a propriedade como "Ausente".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 Defina essa propriedade como $true para incluir todos os sub-recursos com os recursos especificados com a propriedade Nome.Set this property to $true to include all required subfeatures with of the features you specify with the Name property.
LogPathLogPath O caminho até um arquivo de log em que você deseja que o provedor de recursos registre a operação.The path to a log file where you want the resource provider to log the operation.
DependsOnDependsOn Indica que a configuração de outro recurso deve ser executada antes de ele ser configurado.Indicates that the configuration of another resource must run before this resource is configured. Por exemplo, se a ID do bloco de script de configuração do recurso que você deseja executar primeiro for ResourceName e seu tipo for ResourceType, a sintaxe para usar essa propriedade será 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".
OrigemSource Indica o local do arquivo de origem que deve ser usado para a instalação, se necessário.Indicates the location of the source file to use for installation, if necessary.

ExemploExample

A configuração a seguir garante que os recursos Servidor Web (IIS) e Servidor SMTP e todos os sub-recursos de cada um sejam instalados.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
        } 
    }
}