https://github.com/dsccommunity/xdismfeature
THIS MODULE HAS BEEN DEPRECATED. See the README.md for more information.
https://github.com/dsccommunity/xdismfeature
Last synced: 8 months ago
JSON representation
THIS MODULE HAS BEEN DEPRECATED. See the README.md for more information.
- Host: GitHub
- URL: https://github.com/dsccommunity/xdismfeature
- Owner: dsccommunity
- License: mit
- Created: 2015-04-15T22:42:59.000Z (over 11 years ago)
- Default Branch: dev
- Last Pushed: 2020-03-29T06:01:11.000Z (over 6 years ago)
- Last Synced: 2025-04-03T07:04:32.990Z (over 1 year ago)
- Language: PowerShell
- Homepage: https://github.com/dsccommunity/xDismFeature/blob/dev/README.md
- Size: 40 KB
- Stars: 5
- Watchers: 18
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# **THIS MODULE HAS BEEN DEPRECATED**
It will no longer be released. If you have workloads that are in need of
the resource `xDismFeature` and where the resource [`xWindowsFeature`](https://github.com/dsccommunity/xPSDesiredStateConfiguration#xwindowsfeature)
or the resource [`WindowsCapability`](https://github.com/dsccommunity/ComputerManagementDsc)
cannot be used as a replacement, then please reach out in the [Slack #DSC channel](https://dsccommunity.org/community/contact/) and let the DSC
Community know.
## xDismFeature
[](https://ci.appveyor.com/project/PowerShell/xdismfeature/branch/master)
The **xDismFeature** module is a part of the Windows PowerShell Desired State Configuration (DSC) Resource Kit, which is a collection of DSC Resources produced by the PowerShell Team.
This module enables or disables Windows optional features that specifically need to be handled by DISM.exe.
The **xDismFeature** module contains a single resource, **xDismFeature**.
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
## Contributing
Please read the DSC Resources [contributing guidelines](https://github.com/PowerShell/DscResource.Kit/blob/master/CONTRIBUTING.md) if you would like to contribute.
## Description
The **xDismFeature** module contains the **xDismFeature** DSC Resource.
This DSC module enables the install and uninstall of features that require the use of DISM.EXE
## Resources
### xDismFeatureConsoleSetup
* **Ensure**: An enumerated value (Present, Absent) to indicate if the feature is or is not installed.
* **Name**: KEY - The name of the feature to be installed.
* **Source**: (Optional) Source for features with packages removed. Setting source will also make dism act in "/LimitAccess", or offline-mode.
## Versions
### Unreleased
* Update appveyor.yml to use the default template.
* Added default template files .codecov.yml, .gitattributes, and .gitignore, and .vscode folder.
### 1.3.0.0
* Added unit test
* Fixed issue that Test-TargetResource always fails on non-English OS [#11](https://github.com/PowerShell/xDismFeature/issues/11)
### 1.2.0.0
* xDismFeature: Resource no longer includes the Source parameter when it is not specified
* Converted appveyor.yml to install Pester from PSGallery instead of from Chocolatey.
### 1.1.0.0
* Remove UTF8 BOM
* Added source parameter for offline use
### 1.0.0
* Initial release with the following resources
* xDismFeature
## Examples
### Enable the Single Instance Storage feature on Windows Server
```powershell
Configuration SIS-Limited
{
Import-DscResource -Module xDismFeature
Node 'NodeName'
{
Ensure = 'Present'
Name = 'SIS-Limited'
}
}
Configuration SIS-Limited
{
Import-DscResource -Module xDismFeature
Node 'NodeName'
{
Ensure = 'Present'
Name = 'SIS-Limited'
}
}
```
### Disable the Single Instance Storage feature on Windows Server.
```powershell
Configuration SIS-Limited
{
Import-DscResource -Module xDismFeature
Node 'NodeName'
{
Ensure = 'Absent'
Name = 'SIS-Limited'
}
}
Configuration SIS-Limited
{
Import-DscResource -Module xDismFeature
Node 'NodeName'
{
Ensure = 'Absent'
Name = 'SIS-Limited'
}
}
```