Risorsa WindowsOptionalFeatureSet DSC

Si applica a: Windows PowerShell 5.x

La risorsa WindowsOptionalFeatureSet in Windows PowerShell DSC (Desired State Configuration) fornisce un meccanismo per specificare le funzionalità facoltative abilitate in un nodo di destinazione. Questa risorsa è una risorsa composita che chiama la risorsa WindowsOptionalFeature per ogni funzionalità specificata nella proprietà Name.

Usare questa risorsa quando si vogliono configurare diverse istanze di Windows facoltative 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

WindowsOptionalFeatureSet [string] #ResourceName
{
    Name = [string[]]
    [ RemoveFilesOnDisable = [bool] ]
    [ LogPath = [string] ]
    [ NoWindowsUpdateCheck = [bool] ]
    [ LogLevel = [string] { ErrorsOnly | ErrorsAndWarning | ErrorsAndWarningAndInformation }  ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Enable | Disable }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Proprietà

Proprietà	Descrizione
Nome	Indica il nome delle funzionalità che si vogliono abilitare o disabilitare.
NoWindowsUpdateCheck	Specifica se DISM contatta Windows Update (WU) durante la ricerca dei file di origine per abilitare le funzionalità. Se $true, DISM non contatta WU.
RemoveFilesOnDisable	Impostare su $true per rimuovere tutti i file associati alle funzionalità quando Ensure è impostata su Absent.
LogLevel	Livello di output massimo per i log. I valori accettati sono: ErrorsOnly, ErrorsAndWarning e ErrorsAndWarningAndInformation.
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	Specifica se le funzionalità sono abilitate. Per assicurarsi che le funzionalità siano abilitate, impostare questa proprietà su Enable. Per assicurarsi che le funzionalità siano disabilitate, impostare la proprietà su Disable. Il valore predefinito è Enable.
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.