Share via

WindowsOptionalFeature

  • Artikel

Synopsis

Aktivera eller inaktivera en valfri Windows-funktion.

Syntax

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

Description

Med resursen WindowsOptionalFeature kan du se till att en valfri Windows-funktion är aktiverad eller inaktiverad på en Windows-klientdator. Om du vill hantera roller och funktioner i en Windows Server 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 namnet på den valfria Windows-funktionen som en sträng.

Det här värdet för den här egenskapen ska vara samma som egenskapen FeatureName för den valfria Windows-funktionen. 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 den valfria Windows-funktionen ska vara aktiverad. Ange den här egenskapen för Present att aktivera den valfria Windows-funktionen om den är inaktiverad. Ange den här egenskapen till Absent för att inaktivera den valfria Windows-funktionen om den är aktiverad.

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 den valfria Windows-funktionen.

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

Type: System.String
Default Value: None

NoWindowsUpdateCheck

Ange om DISM-kontakter Windows Update (WU) när du söker efter källfilerna för att aktivera den valfria Windows-funktionen. Ange den här egenskapen till $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 den valfria Windows-funktionen när den inaktiveras. Ange den här egenskapen till $true för att ta bort alla associerade filer.

Standardvärdet är $false.

Type: System.Boolean
Default Value: false

Skrivskyddade egenskaper

CustomProperties

Den valfria Windows-funktionens anpassade egenskaper som en matris med strängar.

Type: System.String[]

Description

Den valfria Windows-funktionens beskrivning som en sträng.

Type: System.String

DisplayName

Den valfria Windows-funktionens visningsnamn som en sträng.

Type: System.String

Exempel