DSC WindowsOptionalFeature-erőforrásDSC WindowsOptionalFeature Resource

A következőkre vonatkozik: Windows PowerShell 5. xApplies To: Windows PowerShell 5.x

A Windows PowerShell desired State Configuration (DSC) WindowsOptionalFeature erőforrása olyan mechanizmust biztosít, amely biztosítja, hogy a választható funkciók engedélyezve legyenek a cél csomópontokon.The WindowsOptionalFeature resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to ensure that optional features are enabled on a target node.

Megjegyzés

A WindowsOptionalFeature csak Windowsos ügyfélszámítógépeken működik, például a Windows 10 rendszerű gépeken.WindowsOptionalFeature only works on Windows client machines like Windows 10.

SyntaxSyntax

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

TulajdonságokProperties

TulajdonságProperty LeírásDescription
NévName Megadja az engedélyezni vagy letiltani kívánt szolgáltatás nevét.Indicates the name of the feature that you want to ensure is enabled or disabled.
NoWindowsUpdateCheckNoWindowsUpdateCheck Megadja, hogy a DISM-névjegyek Windows Update (WU), amikor a forrásfájlok keresésekor engedélyezik a szolgáltatást.Specifies whether DISM contacts Windows Update (WU) when searching for the source files to enable a feature. Ha $true a DISM nem létesít kapcsolatot a Wu-vel.If $true, DISM does not contact WU.
RemoveFilesOnDisableRemoveFilesOnDisable A beállítással a $true szolgáltatáshoz tartozó összes fájlt el kell Ensure távolítani, ha a beállítás értéke hiányzik.Set to $true to remove all files associated with the feature when Ensure is set to Absent.
Naplózási szintLogLevel A naplókban látható maximális kimeneti szint.The maximum output level shown in the logs. Az elfogadott értékek a következők: ErrorsOnly, ErrorsAndWarningés ErrorsAndWarningAndInformation.The accepted values are: ErrorsOnly, ErrorsAndWarning, and ErrorsAndWarningAndInformation.
LogPathLogPath A naplófájl elérési útja, amelyen az erőforrás-szolgáltató naplózni kívánja a műveletet.The path to a log file where you want the resource provider to log the operation.

Közös tulajdonságokCommon properties

TulajdonságProperty LeírásDescription
DependsOnDependsOn Azt jelzi, hogy egy másik erőforrás konfigurációjának futnia kell az erőforrás konfigurálása előtt.Indicates that the configuration of another resource must run before this resource is configured. Ha például az az erőforrás-konfigurációs parancsfájl blokkja, amelyet először szeretne futtatni, ResourceName, és a típusa ResourceType, a tulajdonság használatának szintaxisa a következő: 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".
BiztosításaEnsure Megadja, hogy engedélyezve van-e a szolgáltatás.Specifies whether the feature is enabled. Ha biztosítani szeretné, hogy a szolgáltatás engedélyezve legyen, állítsa ezt a tulajdonságot az engedélyezéshez.To ensure that the feature is enabled, set this property to Enable. A szolgáltatás letiltásának biztosításához állítsa a tulajdonságot _letiltani_értékre.To ensure that the feature is disabled, set the property to Disable. Az alapértelmezett érték az Engedélyezés.The default value is Enable.
PsDscRunAsCredentialPsDscRunAsCredential Beállítja a teljes erőforrás futtatásához használt hitelesítő adatokat.Sets the credential for running the entire resource as.

Megjegyzés

A PsDscRunAsCredential Common tulajdonsága a WMF 5,0-ben lett hozzáadva, hogy bármely DSC-erőforrást más hitelesítő adatok kontextusában futtasson.The PsDscRunAsCredential common property was added in WMF 5.0 to allow running any DSC resource in the context of other credentials. További információ: a hitelesítő adatok használata a DSC-erőforrásokkal.For more information, see Use Credentials with DSC Resources.