DSC-Ressource „WindowsOptionalFeature“
Gilt für: Windows PowerShell 5.x
Die Ressource WindowsOptionalFeature in Windows PowerShell DSC (Desired State Configuration) bietet einen Mechanismus, um sicherzustellen, dass optionale Features auf einem Zielknoten aktiviert werden.
Hinweis
WindowsOptionalFeature funktioniert nur auf Windows-Clientcomputern wie Windows 10.
Hinweis
Diese Dokumentation dieser DSC-Ressource behandelt die Version, die in PowerShell vor Version 7.2 enthalten ist. Das PSDscResources-Modul enthält neue und aktualisierte DSC-Ressourcen, die offiziell von Microsoft unterstützt werden. Das Modul PSDscResources ist im PowerShell-Katalog verfügbar.
Weitere Informationen und aktualisierte Dokumentation finden Sie in der Referenzdokumentation zu PSDscResources.
Syntax
WindowsOptionalFeature [string] #ResourceName
{
Name = [string]
[ NoWindowsUpdateCheck = [bool] ]
[ RemoveFilesOnDisable = [bool] ]
[ LogLevel = [string] { ErrorsOnly | ErrorsAndWarning | ErrorsAndWarningAndInformation } ]
[ LogPath = [string] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Enable | Disable } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Eigenschaften
Eigenschaft | Beschreibung |
---|---|
Name | Gibt den Namen des Features an, das aktiviert oder deaktiviert werden soll. |
NoWindowsUpdateCheck | Gibt an, ob Windows Update (WU) von DISM kontaktiert wird, wenn die Quelldateien zum Aktivieren eines Features gesucht werden. Falls $true , wird WU nicht von DISM kontaktiert. |
RemoveFilesOnDisable | Legen Sie diese Einstellung auf $true fest, um alle zu dem Feature gehörigen Dateien zu entfernen, wenn Ensure auf Absent festgelegt wird. |
LogLevel | Die maximale Ausgabeebene, die in den Protokollen angezeigt wird. Zulässige Werte: ErrorsOnly, ErrorsAndWarning und ErrorsAndWarningAndInformation. |
LogPath | Der Pfad zu einer Protokolldatei, in der der Ressourcenanbieter den Vorgang protokollieren soll. |
Allgemeine Eigenschaften
Eigenschaft | BESCHREIBUNG |
---|---|
DependsOn | Gibt an, dass die Konfiguration einer anderen Ressource ausgeführt werden muss, bevor diese Ressource konfiguriert wird. Wenn beispielsweise die ID des Skriptblocks mit der Ressourcenkonfiguration, den Sie zuerst ausführen möchten, „ResourceName“ und dessen Typ „ResourceType“ ist, lautet die Syntax für das Verwenden dieser Eigenschaft DependsOn = "[ResourceType]ResourceName" . |
Ensure | Gibt an, ob die Funktion aktiviert ist. Um sicherzustellen, dass das Feature aktiviert ist, legen Sie diese Eigenschaft auf Enable fest. Um sicherzustellen, dass das Feature deaktiviert ist, legen Sie diese Eigenschaft auf Disable fest. Der Standardwert ist Enable. |
PsDscRunAsCredential | Legt die Anmeldeinformationen für die Ausführung der gesamten Ressource fest. |
Hinweis
Die allgemeine Eigenschaft PsDscRunAsCredential wurde in WMF 5.0 hinzugefügt, um das Ausführen einer beliebigen DSC-Ressource in Verbindung mit anderen Anmeldeinformationen zu ermöglichen. Weitere Informationen finden Sie unter Use Credentials with DSC Resources (Verwenden von Anmeldeinformationen mit DSC-Ressourcen).