Share via


WindowsOptionalFeatureSet

Synopsis

Hantera flera valfria Windows-funktioner med vanliga inställningar.

Syntax

WindowsOptionalFeatureSet [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    Name = [String[]]
    Ensure = [String]
    [RemoveFilesOnDisable = [Boolean]]
    [NoWindowsUpdateCheck = [Boolean]]
    [LogPath = [String]]
    [LogLevel = [String]]
}

Description

Med WindowsOptionalFeatureSet den sammansatta resursen kan du konfigurera flera valfria Windows-funktioner. Om du vill konfigurera en valfri Windows-funktion i taget använder du resursen WindowsOptionalFeature. Om du vill hantera en Windows Server-roller och -funktioner använder du WindowsFeature-resursen.

Krav

  • Måldatorn måste köra ett Windows-klientoperativsystem, Windows Server 2012 eller senare eller Nano Server.
  • Måldatorn måste ha åtkomst till DISM PowerShell-modulen.

Nyckelegenskaper

Name

Ange namnen på de valfria Windows-funktionerna som en matris med strängar.

Varje värde för den här egenskapen ska vara samma som egenskapen FeatureName för en valfri Windows-funktion. Om du vill visa en lista över tillgängliga valfria funktioner för en dator använder du cmdleten Get-WindowsOptionalFeature .

Type: System.String[]

Valfria egenskaper

Säkerställa

Ange om valfria Windows-funktioner ska aktiveras. Ställ in den här egenskapen på Present för att aktivera valfria Windows-funktioner. Ställ in den här egenskapen på Absent för att inaktivera valfria Windows-funktioner.

Standardvärdet är Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

Loggnivå

Ange utdatainformationen som ska visas i DISM-loggen som en sträng. Giltiga alternativ är:

  • ErrorsOnly – Resursen loggar bara fel.
  • ErrorsAndWarning – Resursen loggar fel och varningar.
  • ErrorsAndWarningAndInformation – Resursen loggar fel, varningar och felsökningsinformation.

Standardvärdet är ErrorsAndWarningAndInformation.

Type: System.String
Accepted Values:
  - ErrorsOnly
  - ErrorsAndWarning
  - ErrorsAndWarningAndInformation
Default Value: ErrorsAndWarningAndInformation

LogPath

Ange sökvägen till en fil för att logga aktivering eller inaktivering av valfria Windows-funktioner.

Om den inte anges skriver resursen loggen till %WINDIR%\Logs\Dism\dism.log.

Type: System.String
Default Value: None

NoWindowsUpdateCheck

Ange om DISM kontaktar Windows Update (WU) när du söker efter källfilerna för att aktivera valfria Windows-funktioner. Ställ in den här egenskapen på $true för att förhindra att DISM kontaktar WU.

Standardvärdet är $false.

Type: System.Boolean
Default Value: false

RemoveFilesOnDisable

Ange om resursen ska ta bort alla filer som är associerade med de valfria Windows-funktionerna när du inaktiverar dem. Ställ in den här egenskapen på $true för att ta bort alla associerade filer.

Standardvärdet är $false.

Type: System.Boolean
Default Value: false

Exempel