DSC WindowsOptionalFeature-resurs

Gäller för: Windows PowerShell 5.x

WindowsOptionalFeature-resursen i Windows PowerShell Desired State Configuration (DSC) tillhandahåller en mekanism för att säkerställa att valfria funktioner är aktiverade på en målnod.

Anteckning

WindowsOptionalFeature fungerar bara på Windows-klientdatorer som Windows 10.

Anteckning

Den här dokumentationen för den här DSC-resursen omfattar den version som ingår i PowerShell före version 7.2. MODULen PSDscResources innehåller nya och uppdaterade DSC-resurser som stöds officiellt av Microsoft. Modulen PSDscResources är tillgänglig från PowerShell-galleriet.

Mer information och uppdaterad dokumentation finns i referensdokumentationen för PSDscResources.

Syntax

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

Egenskaper

Egenskap	Beskrivning
Name	Anger namnet på den funktion som du vill säkerställa är aktiverad eller inaktiverad.
NoWindowsUpdateCheck	Anger om DISM kontaktar Windows Update (WU) när du söker efter källfilerna för att aktivera en funktion. Om $truekontaktar DISM inte WU.
RemoveFilesOnDisable	Ange till $true för att ta bort alla filer som är associerade med funktionen när Se till är inställt på Frånvarande.
Loggnivå	Den maximala utdatanivån som visas i loggarna. De godkända värdena är: ErrorsOnly, ErrorsAndWarning och ErrorsAndWarningAndInformation.
LogPath	Sökvägen till en loggfil där du vill att resursprovidern ska logga åtgärden.

Gemensamma egenskaper

Egenskap	Beskrivning
DependsOn	Anger att konfigurationen av en annan resurs måste köras innan den här resursen har konfigurerats. Om till exempel ID:t för det resurskonfigurationsskriptblock som du vill köra först är ResourceName och dess typ är ResourceType är DependsOn = "[ResourceType]ResourceName"syntaxen för att använda den här egenskapen .
Säkerställa	Anger om funktionen är aktiverad. För att säkerställa att funktionen är aktiverad ställer du in den här egenskapen på Aktivera. För att säkerställa att funktionen är inaktiverad ställer du in egenskapen på Inaktivera. Standardvärdet är Aktivera.
PsDscRunAsCredential	Anger autentiseringsuppgifterna för att köra hela resursen som.

Anteckning

Den vanliga egenskapen PsDscRunAsCredential lades till i WMF 5.0 för att tillåta körning av valfri DSC-resurs i kontexten för andra autentiseringsuppgifter. Mer information finns i Använda autentiseringsuppgifter med DSC-resurser.