Zasób DSC WindowsOptionalFeature

Dotyczy: Windows PowerShell 5.x

Zasób WindowsOptionalFeature w Windows PowerShell Desired State Configuration (DSC) zapewnia mechanizm zapewniający włączenie funkcji opcjonalnych w węźle docelowym.

Uwaga

Funkcja WindowsOptionalFeature działa tylko na komputerach klienckich z systemem Windows, takich jak Windows 10.

Uwaga

Ta dokumentacja tego zasobu DSC obejmuje wersję dołączoną do programu PowerShell przed wersją 7.2. Moduł PSDscResources zawiera nowe i zaktualizowane zasoby DSC, które są oficjalnie obsługiwane przez firmę Microsoft. Moduł PSDscResources jest dostępny w Galeria programu PowerShell.

Aby uzyskać więcej informacji i zaktualizowaną dokumentację, zobacz dokumentację referencyjną psDscResources.

Składnia

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

Właściwości

Właściwość	Opis
Nazwa	Wskazuje nazwę funkcji, która ma być włączona lub wyłączona.
NoWindowsUpdateCheck	Określa, czy kontakty DISM Windows Update (WU) podczas wyszukiwania plików źródłowych w celu włączenia funkcji. Jeśli $trueprogram DISM nie kontaktuje się z usługą WU.
RemoveFilesOnDisable	Ustaw wartość , aby $true usunąć wszystkie pliki skojarzone z funkcją, gdy opcja Upewnij się , że jest ustawiona wartość Nieobecny.
LogLevel	Maksymalny poziom danych wyjściowych wyświetlany w dziennikach. Akceptowane wartości to: ErrorsOnly, ErrorsAndWarning i ErrorsAndWarningAndInformation.
Ścieżka dziennika	Ścieżka do pliku dziennika, w którym dostawca zasobów ma rejestrować operację.

Wspólne właściwości

Właściwość	Opis
Dependson	Wskazuje, że przed skonfigurowaniem tego zasobu należy uruchomić konfigurację innego zasobu. Jeśli na przykład identyfikator bloku skryptu konfiguracji zasobu, który chcesz uruchomić jako pierwszy, to ResourceName, a jego typem jest ResourceType, składnia użycia tej właściwości to DependsOn = "[ResourceType]ResourceName".
Zapewnić	Określa, czy funkcja jest włączona. Aby upewnić się, że funkcja jest włączona, ustaw tę właściwość na wartość Włącz. Aby upewnić się, że funkcja jest wyłączona, ustaw właściwość na Wartość Wyłącz. Wartość domyślna to Włącz.
PsDscRunAsCredential	Ustawia poświadczenie do uruchamiania całego zasobu jako.

Uwaga

Właściwość pospolita PsDscRunAsCredential została dodana w programie WMF 5.0, aby umożliwić uruchamianie dowolnego zasobu DSC w kontekście innych poświadczeń. Aby uzyskać więcej informacji, zobacz Use Credentials with DSC Resources (Używanie poświadczeń z zasobami DSC).