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 or the resource WindowsCapability cannot be used as a replacement, then please reach out in the Slack #DSC channel and let the DSC Community know.

xDismFeature

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. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Contributing

Please read the DSC Resources contributing guidelines 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

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

    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.

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'
    }
}