Risorsa WindowsOptionalFeature DSC
Si applica a: Windows PowerShell 5.x
La risorsa WindowsOptionalFeature in Windows PowerShell DSC (Desired State Configuration) fornisce un meccanismo per specificare le funzionalità facoltative abilitate in un nodo di destinazione.
Nota
La risorsa WindowsOptionalFeature funziona solo nei computer client Windows come Windows 10.
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
WindowsOptionalFeature [string] #ResourceName
{
Name = [string]
[ NoWindowsUpdateCheck = [bool] ]
[ RemoveFilesOnDisable = [bool] ]
[ LogLevel = [string] { ErrorsOnly | ErrorsAndWarning | ErrorsAndWarningAndInformation } ]
[ LogPath = [string] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Enable | Disable } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Proprietà
Proprietà | Descrizione |
---|---|
Nome | Indica il nome della funzionalità che si vuole abilitare o disabilitare. |
NoWindowsUpdateCheck | Specifica se DISM contatta Windows Update (WU) durante la ricerca dei file di origine per abilitare una funzionalità. Se $true , DISM non contatta WU. |
RemoveFilesOnDisable | Impostare su $true per rimuovere tutti i file associati alla 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 | Indica se la funzionalità è abilitata. Per assicurarsi che la funzionalità sia abilitata, impostare questa proprietà su Enable. Per assicurarsi che la funzionalità sia disabilitata, impostare questa 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.
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per