Risorsa WindowsFeatureSet DSC

Si applica a: Windows PowerShell 5.x

La risorsa WindowsFeatureSet in Windows PowerShell DSC (Desired State Configuration) fornisce un meccanismo per specificare le funzionalità e i ruoli aggiunti in un nodo di destinazione o rimossi da quest'ultimo. Questa risorsa è una risorsa composita che chiama la risorsa WindowsFeature per ogni funzionalità specificata nella proprietà Name.

Usare questa risorsa quando si vogliono configurare diverse istanze di WindowsFeature nello stesso stato.

Nota

Questa documentazione di questa risorsa DSC illustra la versione inclusa in PowerShell prima della versione 7.2. Il modulo PSDscResources contiene risorse DSC nuove e aggiornate supportate ufficialmente da Microsoft. Il modulo PSDscResources è disponibile da PowerShell Gallery.

Per altre informazioni e la documentazione aggiornata, vedere la documentazione di riferimento di PSDscResources.

Sintassi

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

Proprietà

Proprietà	Descrizione
Nome	Nomi dei ruoli o delle funzionalità che si vogliono aggiungere o rimuovere. Corrisponde alla proprietà Name del cmdlet Get-WindowsFeature e non al nome visualizzato dei ruoli o delle funzionalità.
Source (Sorgente)	Indica il percorso del file di origine da usare per l'installazione, se necessario.
IncludeAllSubFeature	Impostare questa proprietà su $true per includere tutte le funzionalità secondarie necessarie insieme alle funzionalità specificata con la proprietà Name.
Credenziale	Credenziali da usare per aggiungere o rimuovere i ruoli o le funzionalità.
LogPath	Percorso di un file di registro in cui si vuole che il provider di risorse registri l'operazione.

Proprietà comuni

Proprietà	Descrizione
DependsOn	Indica che prima di configurare la risorsa è necessario eseguire la configurazione di un'altra risorsa. Ad esempio, se il valore di ID del blocco script di configurazione della risorsa che si vuole eseguire per primo è ResourceName e il tipo è ResourceType, la sintassi per usare questa proprietà è DependsOn = "[ResourceType]ResourceName".
Ensure	Indica se i ruoli o le funzionalità vengono aggiunte. Per assicurarsi che i ruoli o le funzionalità vengano aggiunti, impostare questa proprietà su Present. Per assicurarsi che i ruoli o le funzionalità vengano rimossi, impostare la proprietà su Absent. Il valore predefinito è Present.
PsDscRunAsCredential	Imposta le credenziali per l'esecuzione dell'intera risorsa.

Nota

La proprietà comune PsDscRunAsCredential è stata aggiunta in WMF 5.0 per consentire l'esecuzione di qualsiasi risorsa DSC nel contesto di altre credenziali. Per altre informazioni, vedere Usare credenziali con risorse DSC.

Esempio

La configurazione seguente garantisce che siano installate tutte le funzionalità e le funzionalità secondarie del server Web (IIS) e del server SMTP.

configuration FeatureSetTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node localhost
    {

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