Delen via

WindowsOptionalFeatureSet

  • Artikel

Synopsis

Meerdere optionele Windows-functies beheren met algemene instellingen.

Syntax

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

Description

Met de WindowsOptionalFeatureSet samengestelde resource kunt u meerdere optionele Windows-functies configureren. Als u één optionele Windows-functie tegelijk wilt configureren, gebruikt u de Resource WindowsOptionalFeature. Gebruik de WindowsFeature-resource om de functies en onderdelen van een Windows Server te beheren.

Vereisten

  • Op de doelcomputer moet een Windows-clientbesturingssysteem, Windows Server 2012 of hoger of Nano Server worden uitgevoerd.
  • De doelcomputer moet toegang hebben tot de DISM PowerShell-module.

Belangrijkste eigenschappen

Name

Geef de namen van de optionele Windows-functies op als een matrix met tekenreeksen.

Elke waarde voor deze eigenschap moet hetzelfde zijn als de eigenschap FeatureName van een optionele Windows-functie. Gebruik de Get-WindowsOptionalFeature cmdlet om de beschikbare optionele functies voor een computer weer te geven.

Type: System.String[]

Optionele eigenschappen

Zorgen

Geef op of de optionele Windows-functies moeten worden ingeschakeld. Stel deze eigenschap in om Present de optionele Windows-functies in te schakelen. Stel deze eigenschap in om Absent de optionele Windows-functies uit te schakelen.

De standaardwaarde is Present.

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

Logniveau

Geef de uitvoergegevens op die moeten worden weergegeven in het DISM-logboek als een tekenreeks. Geldige opties zijn onder andere:

  • ErrorsOnly - De resource registreert alleen fouten.
  • ErrorsAndWarning - Fouten en waarschuwingen in de resourcelogboeken.
  • ErrorsAndWarningAndInformation - Fouten, waarschuwingen en foutopsporingsgegevens in de resourcelogboeken.

De standaardwaarde is ErrorsAndWarningAndInformation.

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

Logboekpad

Geef het pad naar een bestand op om het in- of uitschakelen van de optionele Windows-functies te registreren.

Als deze niet is ingesteld, schrijft de resource het logboek naar %WINDIR%\Logs\Dism\dism.log.

Type: System.String
Default Value: None

NoWindowsUpdateCheck

Geef op of DISM-contactpersonen Windows Update (WU) bij het zoeken naar de bronbestanden om de optionele Windows-functies in te schakelen. Stel deze eigenschap in om $true te voorkomen dat DISM contact kan opnemen met WU.

De standaardwaarde is $false.

Type: System.Boolean
Default Value: false

RemoveFilesOnDisable

Geef op of de resource alle bestanden moet verwijderen die zijn gekoppeld aan de optionele Windows-functies bij het uitschakelen ervan. Stel deze eigenschap in om $true alle bijbehorende bestanden te verwijderen.

De standaardwaarde is $false.

Type: System.Boolean
Default Value: false

Voorbeelden