Zasób WindowsOptionalFeature DSCDSC WindowsOptionalFeature Resource

Dotyczy: Windows PowerShell 5. xApplies To: Windows PowerShell 5.x

Zasób windowsoptionalfeature w konfiguracji żądanego stanu (DSC) programu Windows PowerShell zapewnia mechanizm zapewniający, że funkcje opcjonalne są włączone w węźle docelowym.The WindowsOptionalFeature resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to ensure that optional features are enabled on a target node.

Uwaga

Windowsoptionalfeature działa tylko na komputerach klienckich z systemem Windows, takich jak Windows 10.WindowsOptionalFeature only works on Windows client machines like Windows 10.

SkładniaSyntax

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ściProperties

WłaściwośćProperty OpisDescription
NazwaName Wskazuje nazwę funkcji, która ma być włączona lub wyłączona.Indicates the name of the feature that you want to ensure is enabled or disabled.
NoWindowsUpdateCheckNoWindowsUpdateCheck Określa, czy program DISM kontaktuje się Windows Update (WU) podczas wyszukiwania plików źródłowych w celu włączenia funkcji.Specifies whether DISM contacts Windows Update (WU) when searching for the source files to enable a feature. Jeśli $true Narzędzie DISM nie kontaktuje się z usługą Wu.If $true, DISM does not contact WU.
RemoveFilesOnDisableRemoveFilesOnDisable Ustaw, aby $true usunąć wszystkie pliki skojarzone z funkcją, gdy Ensure jest to ustawienie nieobecne.Set to $true to remove all files associated with the feature when Ensure is set to Absent.
LogLevelLogLevel Maksymalny poziom wyjścia pokazywany w dziennikach.The maximum output level shown in the logs. Akceptowane są następujące wartości: ErrorsOnly, ErrorsAndWarningi ErrorsAndWarningAndInformation.The accepted values are: ErrorsOnly, ErrorsAndWarning, and ErrorsAndWarningAndInformation.
Ścieżka dziennikaLogPath Ścieżka do pliku dziennika, w którym dostawca zasobów ma rejestrować operację.The path to a log file where you want the resource provider to log the operation.

Wspólne właściwościCommon properties

WłaściwośćProperty OpisDescription
DependsOnDependsOn Wskazuje, że konfiguracja innego zasobu musi być uruchomiona przed skonfigurowaniem tego zasobu.Indicates that the configuration of another resource must run before this resource is configured. Na przykład, jeśli identyfikator bloku skryptu konfiguracji zasobu, który ma zostać uruchomiony jako pierwszy jest resourceName, a jego typ to ResourceType, Składnia służąca do użycia tej właściwości to DependsOn = "[ResourceType]ResourceName" .For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".
Upewnij się żeEnsure Określa, czy funkcja jest włączona.Specifies whether the feature is enabled. Aby upewnić się, że funkcja jest włączona, należy ustawić tę właściwość na wartość Włącz.To ensure that the feature is enabled, set this property to Enable. Aby upewnić się, że funkcja jest wyłączona, należy ustawić właściwość do wyłączenia.To ensure that the feature is disabled, set the property to Disable. Wartość domyślna to enable.The default value is Enable.
PsDscRunAsCredentialPsDscRunAsCredential Ustawia poświadczenia do uruchamiania całego zasobu jako.Sets the credential for running the entire resource as.

Uwaga

Właściwość PsDscRunAsCredential Common została dodana w programie WMF 5,0, aby umożliwić uruchamianie dowolnego zasobu DSC w kontekście innych poświadczeń.The PsDscRunAsCredential common property was added in WMF 5.0 to allow running any DSC resource in the context of other credentials. Aby uzyskać więcej informacji, zobacz Korzystanie z poświadczeń z zasobami DSC.For more information, see Use Credentials with DSC Resources.