Recurso WindowsFeature de DSCDSC WindowsFeature Resource

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

O recurso WindowsFeature 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 WindowsFeature 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.

SintaxeSyntax

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

PropriedadesProperties

PropriedadeProperty DescriçãoDescription
NomeName Indica o nome da função ou recurso que você deseja garantir que seja adicionado ou removido.Indicates the name of the role or feature that you want to ensure is added or removed. É igual à propriedade Name do cmdlet Get-WindowsFeature, não o nome de exibição da função ou recurso.This is the same as the Name property from the Get-WindowsFeature cmdlet, and not the display name of the role or feature.
CredentialCredential Indica as credenciais que devem ser usadas para adicionar ou remover a função ou recurso.Indicates the credentials to use to add or remove the role or feature.
EnsureEnsure Indica se a função ou o recurso foi adicionado.Indicates if the role or feature is added. Para garantir que a função ou o recurso seja adicionado, defina essa propriedade como "Present"; para garantir que a função ou o recurso seja removido, defina a propriedade como "Absent".To ensure that the role or feature is added, set this property to "Present" To ensure that the role or feature is removed, set the property to "Absent".
IncludeAllSubFeatureIncludeAllSubFeature Defina essa propriedade como $true para garantir o estado de todos os sub-recursos necessários com o estado do recurso especificado com a propriedade Name.Set this property to $true to ensure the state of all required subfeatures with the state of the feature you specify with the Name property.
LogPathLogPath Indica o caminho até um arquivo de log em que você deseja que o provedor de recursos registre a operação.Indicates 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

WindowsFeature RoleExample
{
    Ensure = "Present" 
    # Alternatively, to ensure the role is uninstalled, set Ensure to "Absent"
    Name = "Web-Server" # Use the Name property from Get-WindowsFeature  
}