WindowsOptionalFeatureSet

  • Artykuł

Streszczenie

Zarządzanie wieloma opcjonalnymi funkcjami systemu Windows za pomocą typowych ustawień.

Składnia

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

Opis

Zasób WindowsOptionalFeatureSet złożony umożliwia skonfigurowanie wielu opcjonalnych funkcji systemu Windows. Aby skonfigurować jedną opcjonalną funkcję systemu Windows naraz, użyj zasobu WindowsOptionalFeature. Aby zarządzać rolami i funkcjami systemu Windows Server, użyj zasobu WindowsFeature.

Wymagania

  • Na maszynie docelowej musi być uruchomiony system operacyjny klienta systemu Windows, Windows Server 2012 lub nowszy lub Nano Server.
  • Maszyna docelowa musi mieć dostęp do modułu DISM programu PowerShell.

Kluczowe właściwości

Nazwa

Określ nazwy opcjonalnych funkcji systemu Windows jako tablicę ciągów.

Każda wartość tej właściwości powinna być taka sama jak właściwość FeatureName funkcji opcjonalnej systemu Windows. Aby wyświetlić listę dostępnych funkcji opcjonalnych dla komputera, użyj Get-WindowsOptionalFeature polecenia cmdlet .

Type: System.String[]

Właściwości opcjonalne

Zapewnienia

Określ, czy mają być włączone opcjonalne funkcje systemu Windows. Ustaw tę właściwość na wartość , aby Present włączyć funkcje opcjonalne systemu Windows. Ustaw tę właściwość na wartość , aby Absent wyłączyć funkcje opcjonalne systemu Windows.

Wartość domyślna to Present.

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

LogLevel

Określ informacje wyjściowe, które mają być wyświetlane w dzienniku DISM jako ciąg. Prawidłowe opcje obejmują:

  • ErrorsOnly — Zasób rejestruje tylko błędy.
  • ErrorsAndWarning — Błędy i ostrzeżenia dotyczące dzienników zasobów.
  • ErrorsAndWarningAndInformation — Błędy, ostrzeżenia i informacje o debugowaniu dzienników zasobów.

Wartość domyślna to ErrorsAndWarningAndInformation.

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

Ścieżka dziennika

Określ ścieżkę do pliku, aby zarejestrować włączanie lub wyłączanie funkcji opcjonalnych systemu Windows.

Jeśli nie zostanie ustawiona, zasób zapisuje dziennik na .%WINDIR%\Logs\Dism\dism.log

Type: System.String
Default Value: None

NoWindowsUpdateCheck

Określ, czy kontakty DISM Windows Update (WU) podczas wyszukiwania plików źródłowych w celu włączenia funkcji opcjonalnych systemu Windows. Ustaw tę właściwość, aby $true uniemożliwić usłudze DISM kontaktowanie się z usługą WU.

Wartość domyślna to $false.

Type: System.Boolean
Default Value: false

RemoveFilesOnDisable

Określ, czy zasób powinien usuwać wszystkie pliki skojarzone z funkcjami opcjonalnymi systemu Windows podczas ich wyłączania. Ustaw tę właściwość na wartość , aby $true usunąć wszystkie skojarzone pliki.

Wartość domyślna to $false.

Type: System.Boolean
Default Value: false

Przykłady