DSC WindowsOptionalFeatureSet-resurs
Gäller för: Windows PowerShell 5.x
Resursen WindowsOptionalFeatureSet 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. Den här resursen är en sammansatt resurs som anropar Resursen WindowsOptionalFeature för varje funktion som anges i egenskapen Namn .
Använd den här resursen när du vill konfigurera ett antal valfria Windows-funktioner till samma tillstånd.
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
WindowsOptionalFeatureSet [string] #ResourceName
{
Name = [string[]]
[ RemoveFilesOnDisable = [bool] ]
[ LogPath = [string] ]
[ NoWindowsUpdateCheck = [bool] ]
[ LogLevel = [string] { ErrorsOnly | ErrorsAndWarning | ErrorsAndWarningAndInformation } ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Enable | Disable } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Egenskaper
Egenskap | Beskrivning |
---|---|
Name | Anger namnet på de funktioner som du vill kontrollera är aktiverade eller inaktiverade. |
NoWindowsUpdateCheck | Anger om DISM kontaktar Windows Update (WU) när de söker efter källfilerna för att aktivera funktioner. Om $true , kontaktar DISM inte WU. |
RemoveFilesOnDisable | Ange till för $true att ta bort alla filer som är associerade med funktionerna 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 resurskonfigurationsskriptblocket 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 funktionerna är aktiverade. För att säkerställa att funktionerna är aktiverade ställer du in den här egenskapen på Aktivera. För att säkerställa att funktionerna är inaktiverade 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.
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för